Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SBRAIN.ZIP / SBRAIN.DOC < prev next >

Wrap

Text File | 1993-03-14 | 20.4 KB | 523 lines

3/14/93 THE BRAINEX SHOP MASTER A Credit Card Orders/Subcription Door (C) Copyright 1992 by Stanley Sheff Support BBS: The Brainex System (310) 275-2344 (310) 273-5234 > This door requires the Brainex Door Manager. If you have not done so, > please install The Door Manager BEFORE you attempt to setup this door. > Be sure that your BRAINEX.DAT is dated on or after the date of > SBRAIN.EXE. Welcome to the Shop Master. This door allows your callers to upgrade their subscriptions and levels or order products using a VISA, MASTER CARD, AMERICAN EXPRESS, DINER'S CLUB, CARTE BLANCHE or DISCOVER CARD. Shop Master also allows payment by CHECK, MONEY ORDER or C.O.D.. Shop Master creates it's own online product catalog, which may be downloaded or viewed online. * If you are a Teleflora Creditline user, Shop Master will work * with TelePC to verify user's orders online, or after they log off * the BBS. Amounts charged can be directly deposited into your * checking account! For more information, read TELEPC.DOC. Shop Master will write an invoice file with all the information needed to process a credit card order. Shop Master will check for a valid credit card number, but you will be required to verify the account by phone. GAP & PCBoard BBS: The door will automatically upgrade the user's level and subscription date online. PCBoard needs to write DOOR.SYS and USERS.SYS when running the door. Shop Master updates DOOR.SYS for GAP or any DOOR.SYS type BBS. USERS.SYS is updated for PCBoard. ===================================================================== If you have registered ORDER BRAIN before December 10, 1992, you can switch to The Shop Master at NO COST. First, you will need to convert your ORDER.DAT file to CATALOG.DAT. Run the included CONVERT.EXE. Next, call the Brainex System, and post your BBS Name and Registration number in private mail to the SYSOP. You will be issued a Shop Master registration number. If you register ORDER after December 10, 1992, you may apply your $25 Order Brain registration fee toward the purchase of The Shop Master. This makes the cost to switch only $20. ===================================================================== The Shop Master Files --------------------- SBRAIN.EXE <------------------ The Shop Master Program SBRAIN.DOC <------------------ Sysop's Information SBRAIN.HLP <------------------ Online Door Help CONVERT.EXE <------------------ Converts ORDER.DAT to CATALOG.DAT REGISTER.DOC <------------------ Registration information PRODUCTS.DOC <------------------ Latest Brainex Products! TELEPC.DOC <------------------ CreditLine Information (Registered Version) INVOICE.TXT <------------------ Sysop's Invoice Template RECEIPT.TXT <------------------ Customer's Receipt Template DEALS <------------------ ASCII Special Deals DEALSG <------------------ ANSI Special Deals HAGGLE <------------------ Haggle Data File HELLOG <------------------ ASCII "Use Door?" screen HELLO <------------------ ANSI "Use Door?" screen INFO <------------------ ASCII General Help File INFOG <------------------ ANSI General Help FIle LEVEL <------------------ ASCII Invalid Level Notice LEVELG <------------------ ANSI Invalid Level Notice MENU <------------------ ASCII Order Options/Prices MENUG <------------------ ANSI Order Options/Prices NOTICE <------------------ ASCII Warning Notice NOTICEG <------------------ ANSI Warning Notice SUB <------------------ ASCII Subscription Thank You File SUBG <------------------ ANSI Subscription Thank You File THANKS <------------------ ASCII Thank You (shown after an order) THANKSG <------------------ ANSI Thank You (shown after an order) FILE_ID.DIZ <------------------ Short Door Description SETUP.BAT <------------------ Door Installer Batch File NOTE-> If you have edited an ANSI info file and see a "MORE - Yes, No,..." prompt, you can either save the file with a longer line length (255) or use a text editor to insert a { character on the first line of the file. This disables the "MORE - Yes, No,..." prompt when the file is shown by the door. All of these files should be in this ZIP, if they are not, don't take a chance! Call The Brainex System and get a good copy or view the file on a few local boards to see if you can find a complete copy. To install, unzip these files into a work directory, then type: SETUP A BRAINEX\SBRAIN directory will be created. SBRAIN.EXE will be copied to the BRAINEX directory, the rest of the files to the BRAINEX\SBRAIN directory. You will then be taken to the Door Manager Door Install area. Shop Master Setup Questions/Options: Please enter your Shop Master Registration number, or 0 if unregistered. > When registered, Shop Master will save user's orderig information > to an ascii file you specify. Unregistered version will not save > to disk, but will otherwise function normally. Please enter the DRIVE\DIRECTORY\NAME of the text to write information about orders placed by callers. (Do NOT include a file extension.) > This is the name of the file that will hold all the information > about a user's order. If the order was processed successfully, > an extension of YES will be used, if the order did not pass > the verification process, an extension of NO will be used. If > you entered C:\CREDIT\ORDER as the file name, a good order would > be stored as C:\CREDIT\ORDER.YES. Save order information to PRINTER? > When an order is processed successfuly, the information can also be sent to your printer. Answer YES to print each order. Enter the minimum caller access level required to use this door. > Callers with an access level below this will not be able to > access the door. They will be shown the LEVEL file. Enter the level and above that will bypass this door? > This level is usually used for the sysop who has setup Shop Master > as a "logon" door, and does not wish to see the door during logon. Enter the Payment Methods you will allow: VISA=VS, MASTERCARD=MC, AMERICAN EXPRRSS=AM, DISCOVER=DS, DINER'S CLUB=DC, CARTE BLANCHE=CB, JCB=JB, CHECK=Check or Money, COD=C.O.D. When a user buys a BBS subscription, when should the user's additional subscription days begin? TODAY=New subscription period begins day of the order. EXPIRE=Add days after subscription expiration date. > If a user buys a BBS subscription, the new time period can begin > after the old on expires, or can begin on the day they order. > Example: A user has 10 days left on a previous subscription, buys > an additional 30 day subscription. If you set to TODAY, the user > will have a total of 30 days remaining, if you set to expire, > the user will have 30 new days added to the old 10, giving > them a total of 40 days. > Note: PCBoard adds additional days to the current expiration > date, so this option will not matter. Should Shop Master be allowed to lower a subscription level? YES=New user level can be lower than previous level NO=Only change if new level is above current level Enter the colors for displayed text (B=Bright, BBLUE is Bright Blue) RED, GREEN, BROWN, BLUE, MAGENTA, CYAN, WHITE BBLACK, BRED, BGREEN, YELLOW, BBLUE, BMAGENTA, BCYAN, BWHITE > This is used for catlog text searches. Enter the colors for search hit text (text found during searches) RED, GREEN, BROWN, BLUE, MAGENTA, CYAN, WHITE BBLACK, BRED, BGREEN, YELLOW, BBLUE, BMAGENTA, BCYAN, BWHITE Enter your Sales Tax Rate Percentage or NONE > Example: 8.25 Enter your two letter State Abbreviation > Use two letters only, do NOT add a period (CA.) > Caller's from this state will be taxed. Enter full State Name for tax > Caller's from this state will be taxed. Enter the DRIVE\DIRECTORY of Your TelePC software or }NONE > This program will process your merchant account orders > online without the need for a terminal! See the enclosed TELEPC.DOC > for information on how to obtain this software package! Shop Master can process orders in one of two modes: ONLINE-Uses second comport/modem while caller is online. * If you do not use TelePC, select ONLINE OFFLINE-Processes the order after caller logs off the BBS. Select ONLINE or OFFLINE. You may attach a TEXT FILE to user's receipts Please enter DRIVE\DIRECTORY\FILENAME.EXT or NONE. > This should be an ASCII text file. Enter your invoice start number. Invoices numbers will begin with this. > Any Number Enter the DRIVE\DIRECTORY where download files are located. > If you want users to be able to download files using Shop Master, > enter the directory location of the files. Enter NONE to disable > this option. Enter the DRIVE\DIRECTORY\FILENAME.EXT to your Files List (FILES.BBS) > Complete path and filename of file description text file. > This file uses a FILES.BBS type format. Each file should use the > following column format: FILENAME SIZE DATE DESCRIPTION 1<------------->13 14<------->21 24<-------->31 34<---------->78 Examples: ALADDIN.ZIP 89867 08/25/92 Aladdin's Magic Lamp Text Adventure SBRAIN.ZIP 123467 12/01/92 Shop Master - Credit Card Order Door Would you like to allow callers to log off the BBS after downloads? > YES or NO Enter the Maximum Number of Minutes users may stay in the Shop Master. > Any number from 1 to 32767 --------------------------------------------------------------------- CATALOG.DAT file ================ Use an ASCII text editor to create your CATALOG.DAT file. This is used by Shop Master to obtain specific information about the items you will offer to your users. CATALOG.DAT options: ITEM - Brief Product Description INFOFILE - DRIVE\DIRECTORY\FILENAME.EXT of Descriptive Text File PRICE - Price in Dollars and Cents format 00.00 (Don't use a $) TAX - If the caller is not from out of state, tax will be added if this option is TAX=YES SHIPPING - Shipping Fee in Dollars and Cents format 00.00 (Don't use a $) If using Shop Master for BBS subscriptions, you can use: LEVEL - Upgraded user level. If the user's level is below this level, the user will be upgraded to the indicated level. DAYS - Addtional Days added to user subscription period End each item section with three dashes --- Sample CATALOG.DAT file format: ITEM=One Month BBS Subscription INFOFILE=C:\BRAINEX\SBRAIN\INFO.TXT PRICE=15.00 LEVEL=90 DAYS=30 --- ITEM=Night Owl CD-ROM Volume 7 INFOFILE=C:\BRAINEX\SBRAIN\CDROM.TXT PRICE=30.00 TAX=YES SHIPPING=2.00 --- ITEM=Printed BBS Manual PRICE=2.00 --- You must include an item and a price. Other selections are optional. INVOICE.TXT (Sysops Invoice Record) RECEIPT.TXT (Customer's Receipt) ========================= These are text file templates that use special replacable commands: @INVOICE @CARDINFO @DATE @ADDRESS @TIME @HOMEPHONE @VERIFICATION @BBSNAME @USERNAME @BBSPHONE @TAX @SHIP @TOTAL @DISC @COD After an order, Shop Master replaces these "@" commands with the actual user information, then writes a file to disk as the FILENAME you specified above (order information file). RECEIPT.TXT may be read or downloaded by the user. Be sure to edit in your BBS information! Please EDIT these file as you wish using any ascii text editor. Be sure your editor does not use CONTROL Z to terminate a line. The replacable parameters should be the LAST ITEM on a line (@DATE, @TIME, etc.). These files should be located in BRAINEX\SBRAIN. HELLO ===== If you wish to ask user if they want to enter the door, add the SKIP= to the command line. Example: SBRAIN SKIP=110 Users with security level 110 and above will bypass the door, lower levels will be shown the HELLO prompt and asked if they want to use Shop Master. This is useful where Shop Master is run in a login door sequence. Omit this command if running the door from the BBS command prompt. DEALS.TXT ========= If you wish to offer any special deals, create this file and place it in your BRAINEX\SBRAIN directory. Optional ANSI version should be named DEALSG.TXT HAGGLE ====== If present in the BRAINEX\SBRAIN directory, Shop Master will allow you to offer a discount. Users can select the [H]aggle option before they place an order, and try to haggle a better price! You can select the name of the "haggler", the maximum discount percentage rate offered, and the a choice of remarks made by the haggler to the user. Sample HAGGLE file: ------------------------------------------------ MAXIMUM HAGGLE DISCOUNT=10 HAGGLER NAME=Crazy Murray You think I'm made of money? You'll have to do better than that, my friend! That's not an offer, that's a joke! Let's get real, ok? Talk to me when you get serious... I might be crazy, but I'm not THAT crazy! Talk some turkey! Hmmm... That's an interesting offer, but no deal! ------------------------------------------------- The maximum haggle discount is a percentage, so the above example would allow a maximum discount of 10% off the total purchase price. The discount will be indicated in receipts and invoices with the @DISC parameter. You may add as many haggle remarks as you like, just put each on a seperate line as shown above. Remove the HAGGLE file from the BRAINEX\SBRAIN directory to disable haggling. CATALOG ======= The first time you run Shop Master, it will create two catalog files in the BRAINEX\SBRAIN directory. CATALOG.STD - (Standard Catalog) Item, Price, Shipping CATALOG.DLX - (Deluxe Catalog) Item, Price, Shipping, Detailed Item Information (Derived from the text you supplied in INFOFILE=files) Users may View, Search, Order from the Catalog, or Download the catalog. DOWNLOADS REQUIRE DSZ or GSZ ============================ Place DSZ.COM or DSZ.EXE in the path. If you have an unregistered DSZ, Y-Modem G protocol will NOT function. If you wish to use GSZ, simply rename GSZ.EXE to DSZ.EXE, or you can edit the batch files that call GSZ. They are located in the BRAINEX directory, and are named: EXTSZ.BAT, EXTS1.BAT, etc. You should add an environment variable to set the dsz log file name, and if using gsz, the window size. If the DSZLOG varible is not set, NO download logs will be written. See the sample batch files below. RUNNING SHOP MASTER =================== Once you have created your CATALOG.DAT, you must then create a a batch file to call the door. A batch file for a GAP BBS might look like this: @ECHO OFF SET GSZWINDOW=23 SET DSZLOG=LOG1 SBRAIN Multinode BBSes use the NODE= command. Example: @ECHO OFF SET GSZWINDOW=23 SET DSZLOG=LOG2 SBRAIN NODE=2 You may specify different catalogs by using CATALOG= on the command line. If you named your CATALOG.DAT file to CAT1.DAT and placed it in a directory called C:\CATS, the command line would look like: SBRAIN CATALOG=C:\CATS\CAT1.DAT ======================================================================== TELEPC (Registered Version Only) Telepc-b.exe must be configured and working correctly. There are two modes of operation. 1. Online Mode. Using a second comport and modem, Shop Master will shell to Telepc-b.exe and process the order while the caller waits. 2. Offline Mode. Shop Master will shell to Telepc-b.exe when the user logs off the BBS. To use the offline function, run Order Brain with the offline option. SBRAIN NODE=2 OFFLINE or SBRAIN OFFLINE etc. If you use Shop Master in OFFLINE MODE with the Telepc Program, you will need to modify the batch file that runs your BBS: Sample GAP BBS Batch file (GAP.BAT) : @ECHO OFF GAPMENU IF ERRORLEVEL 99 GOTO SHOP GOTO END :SHOP SBRAIN OFFLINE GAP :END Sample PCBoard Batch File (BOARD.BAT) : @ECHO OFF C: CD \PCB SET PCB=/SWAP SET DSZLOG=C:\PCB\PCBDSZ.LOG IF EXIST REMOTE.BAT RENAME REMOTE.BAT REMOTE.SYS IF EXIST EVENT.BAT RENAME EVENT.BAT EVENT.SYS IF EXIST DOOR.BAT DEL DOOR.BAT IF EXIST ENDPCB DEL ENDPCB PCB145 IF EXIST REMOTE.BAT REMOTE IF EXIST DOOR.BAT DOOR IF EXIST EVENT.BAT EVENT IF EXIST ENDPCB GOTO END SBRAIN OFFLINE BOARD :END EXIT The above modifications are only required when using The Shopping Door in OFFLINE mode. ======================================================================= The following sysop functions are available while awaiting keyboard input : F5 - Shell to DOS. F8 - Twit user and return to BBS. F10 - Initiate chat with user. CF10 - Answer user page bell. Home - Main user stats. End - Displays sysop keys available. PgDn - Secondary user stats. Up Arrow - Increase user's time remaining by 5 minutes. Dn Arrow - Decrease user's time remaining by 5 minutes. One of the nicer features about using the TWIT key, is the user is not told that "the sysop wants them to return to the BBS". Instead, a very plain and simple message of "returning you to the BBS" is displayed. This way, the user is given no indication that the sysop is hovering about. When using the F5 shell to DOS key, to return to the door program, simply type EXIT at the DOS command prompt. It is not necessary to change directories back to the door directory. The Shop Master is smart enough to know which drive and directory the door program is in and will reset the defaults upon return from DOS. The Up and Down Arrow keys increase and decrease the user's time respectively by 5 minutes for each press of the key. There is no indication of what is occurring (except by the fact the user's time remaining will change), so the sysop should try not to have a lead finger. The increase or decrease is effective only while the user is in The Shop Master. -- -- -- This version of The Shop Master is a DEMO. No orders will be processed or written to file. It will become full featured upon registration. This door is released "As Is" and there is *NO* warranty or guarantee that it will work for you and not cause any problems. You have chosen to use this door, YOU are responsible for any unfortunate problems that may develop from its use or misuse. I will gladly listen to any suggestions or problems you may have, and I will do my best to fix whatever needs to be fixed. I can not be held responsible for any problems you may have, whether directly or indirectly due to the use of the door. Please read REGISTER.DOC for information on how you can register your copy of The Shop Master. For complete support, contact me on The Brainex System. Your questions will be quickly and cheerfully answered! Have Fun! Stanley Sheff The Brainex System 310-275-2344 HST 310-273-5234 V.32bis Voice Support for Registered Sysops!