ЪДДДДДї ЪДЬЬЬДї ЪДДДДДї ЪДДДДДї ЪДДДДДї ЪДДДДДї ЪДДДДДї ЪДДДДДї і ЯЫЫЫ і ЫЫЫ і і ЯЯ і і ЯЫЫЫ і ЫЫЫЫ і ЯЯ і ЫЫЭ ЮЫЫ і ЯЯ і ЫЫЫЬ і і ЯЯЯ і і ЬЬ і ЫЫЫЬ і і ЫЫЫЫ і Ь ЯЬ ЫЫЭ ЮЫЫ і ЫЫЫЫ АДДДДДЩ АДДДДДЩ АДДДДДЩ АДДДДДЩ АДДДДДЩ АДЯДДДЩ АДДДДДЩ АДДЯЯЯЯ Online Store Supporting Checks or Credit Cards ЦДД· · ЦДД· · є є ТДД· є · ТДД· ЦДД· УДД· ЗДД· ЦДД· ТДД· ТДД· · ТДД· ЦДДТ УДДЅ У У У У У У УДДД УДДЅ У У УДДЅ ЗДДЅ ЗДДЅ У У У УДД¶ У У ДЅ ЪДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДї і SubscriP - Voted the #1 Commercial PCBoard PPE і АДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЩ Effective 01-21-95 SubscriP is no longer Commercial, but Shareware SubscriP is an online purchasing system that will allow you to upgrade users via check or credit card! If you don't support credit cards this PPE allows you to offer "instant" subscription upgrades to your users! It can keep track of how long you configured it to wait for the check, and if the check is "overdue" it will downgrade the user, unregister the user from "subscriber conferences", and send both the user and the SysOp a message about the downgrade and why. Of course, SubscriP also allows you to accept credit cards, if you support them that is. And it allows you to sell much more through your BBS as well as it is a full featured online shopping center as well! ЦДДД є ЦДД· ТДД· ДЧД ЦДД· ТДД· ДЧД ЦДДД УДДД УДДЅ У У У УДДД У У У ДДДЅ Page [01] Introduction - Table of Contents Page [02] The Many Features of SubscriP Page [03] SubscriP Installation Page [04] How It Works - Your "maintenance" responsibilities Page [05] SUBSCRIP.CNF (The main config file) & Log Files Page [06] List Files - PAYMENT.LST & SHIPPING.LST Page [07] List Files - CATEGORY.LST & ????????.LST (you name it) Page [08] List Files - DISPLAYS.LST & and Display Files Page [09] SUBSCRIP.OPT - Subscription Options, Pricing, Levels... Page [10] PROMPTS File / TPA Installation / Subscription Only Mode Page 01 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДї і Features і АДДДДДДДДДДЩ ю Accept instant subscriber upgrades via credit cards ю Accept instant subscriber upgrades via check (honor system) ю Definable Min and Max sec levels for accessing SubscriP ю Up to 255 different subscription security levels supported ю Sends message to SysOp that the user has purchased subscription ю Registers users in definable "subscriber" conferences ю If subscription is by check... ъ SubscriP monitors (via Notes PSA) to make sure payment is rec'd ъ Notes PSA line # is SysOp definable! ъ When payment is rec'd just blank out that users' Notes PSA entry ъ If payment is not rec'd in definable # days... ъ User security level is downgraded automatically ъ User is unregistered from "subscriber" conferences ъ User placed in TCAN file to prevent repeat occurances ъ "Customized" message sent to user explaining the downgrade ъ New message written to users' Notes PSA for SysOps' records ю SubscriP is a full-featured online product ordering system, supporting: ю Unlimited categories (Hardware, Software, Subscriptions etc) ю Unlimited product items within each category ю Each item has own price, weight, stock #, and product info screen ю (Definable) most major credit cards, checks or COD's ю Handling percentage for none, some or all payment methods ю Tax rate definable by State/Province or "all" purchasers. ю Each shipping method has own base rate, weight and "per/oz charge" ю Up to 30 items can be ordered on a single invoice! ю Downloadable price quote/invoice ю Users can view invoices before actually placing orders ю Detects bad or wrong format credit card numbers ю Most screens definable and customizable with ANSI, RIP or @x support ю TCAN files for user names or bad credit card numbers Page 02 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДДДДДДДДДДДї і SubscriP Installation і АДДДДДДДДДДДДДДДДДДДДДДДДЩ Ensure that you have the "Notes PSA" installed, this is a requirement for operation of SubscriP. Also, the Address PSA must be installed so SubscriP can read the address info. Then go to the CMD.LST and make a command called SUBSCRIP, SUB or other appropriate name. See below, and use an appropriate security level. If you want, you can set the level low in CMD.LST and set it higher in SUBSCRIP.CNF, so that users will be able to "view what you have", even if their sec level is too low to actually make a purchase. Can be used as an enticement to get them to upgrade to higher security level... Command Security PPE/MNU File -or- Keystroke Replacement НННННННННННННН НННННННН ННННННННННННННННННННННННННННННННННННННН 1) SUBSCRIP 10 D:\PPE\SUB\SUBSCRIP.PPE Within with the distribution file should be 2 ZIP files, one is called GRAPH.ZIP (the display files) and the other's SAMPLIST.ZIP (samples of the .LST and .OPT files). If this is a first time setup then unzip the contents of SAMPLIST.ZIP into the same dir as SUBSCRIP.PPE. If you are using a previous version of SubscriP, be careful not to overwrite any of your existing files! Then unzip GRAPH.ZIP into a GRAPH subdirectory that is off the PPE directory that SubscriP PPE is located in. In the above sample, the display files would be located in D:\PPE\SUB\GRAPH, and the .LST files are in the D:\PPE\SUB directory. Since there could possibly be 100's of display files (depending on how many items you've made available) we felt it best to have them located in their own dir! Also, add the name SUBSCRIP to your PCBoard TCAN file. This is because that is the "from name" of all messages posted to the SysOp. ---> If you're ONLY going to accept "credit cards" for subscriber upgrades, you DO NOT need to install the following procedure and you can skip to the "SUBSCRIP.CNF" section, but make sure you read the section about the PAYMENT.LST file (don't list CHECK as an option in PAYMENT.LST). Next, if you WILL be accepting checks for instant subscriber upgrades, we now need to install the "checking portion" of SubscriP. If you want SubscriP to check for the "due date" for you then it must be installed in one of the display screens with a commandline of S. I use it in my "security specific display screens" so that it only checks subscribers and not each user. My subscriber sec level 41 specific file (called 41 natcherly) contains one line and it looks like this (notice that there is an "S" on the PPE commandline): !D:\PPE\SUB\SUBSCRIP.PPE S Also notice that this is the same PPE. This checking feature is built right into the SubscriP PPE! The "checking portion" is now installed! If you would like to take the easier approach you can install the line above (!D:\PPE\SUB\SUBSCRIP.PPE S) in your NEWS or other logon file that is displayed to all users. Then you don't have to worry about all those "security specific logon display files". This might be better if you have an awful lot of subscription security levels. Page 03 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДї і How It Works і АДДДДДДДДДДДДДДЩ Let me explain how and why this works: When a subscription is purchased, a line is written into the notes PSA that looks similar to this (I use #3, you can use whichever you like): ЙНННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННН» є Edit User Record (Caller Notes) Record # of # є є є є Name : BILLY BROWN є є є Line 3 : 5 On 10-31-93 a check for $35.00 is due. ± When a subscription check arrives I go into that user's record, go to line 3 and tap the space bar to clear out this entry. Whenever one of my level 41 subscribers logs on SubscriP checks in the "notes PSA" to see if that user's check "has arrived". If a user calls after the date in the "Notes PSA" and I have not gotten a check (and have not cleared that user's "Notes PSA entry") then SubscriP will detect the date and then it "downgrades" the user to the expired security level I defined. Whenever a user subscribes SubscriP sends a message to the SYSOP so he or she is aware that a user is forwarding a check, and when it is due. Whenever a user's "due date" is past due, SubscriP sends a message to the both the user and the SysOp, informing both of the situation. You can customize this message to the user to suit your particular style. Of course, if you're also allowing credit cards to be used for instant subscriber upgrades, SubscriP does not monitor credit card purchases via this method. It is up to you to make sure the credit card purchase has "gone through". Again, always remember that when you receive the users' check for the subscription, you must go into the Notes PSA for that user and "clear" the SubscriP notation that a check is due. SubscriP has no way to tell that you received the check, so this is your way of letting it know to no longer monitor that particular user. Page 04 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДї і SUBSCRIP.CNF і АДДДДДДДДДДДДДДЩ There's an SPCONFIG.PPE and SPCONFIG.BAT to help make SUBSCRIP.CNF! Here is the SubscriP Config File. (It must be called SUBSCRIP.CNF and it must be located in the very same directory as SUBSCRIP.PPE.) Here's a breakdown of what each line in SUBSCRIP.CNF means: ЪДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДї і Your BBS Name і і 00000 (or your registration Number) і і Validation Code (assigned Upon Registration) і і Number of days to wait for check (we suggest 10-14 days) і і The line number in the "Notes PSA" to use (I use number 3) і * і The MINimum security level to permit purchases. і * і The MAXimum security level to permit purchases. і і Do you want to allow checks for purchases (Y or N) і і The name of file to flag for new subscriber, blank if none і ** і Your 2/3 char State or Province abbrev. (or ALL for "all") і і Tax rate (8.5% entered as 8.5) (place 0 to disable tax) і і Y or N if you want handling charges applied to COD orders і і Y or N if you want handling charges applied to Check ordersі і Y or N if you want handling charges applied to Credit Cardsі і Handling charge (5% entered as 5, or 0 to disable handling)і і Minimum age in YEARS (ie; 18 or 21) to allow purchases і *** і Number of the note line in user record where user's DOB is і і Using just one product category? (Y or N) і і Using just one shipping option? (Y or N) і і Using just one payment option? (Y or N) і і Operating SubscriP in a "subscription only" mode? (Y or N) і АДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЩ * If you put a sec level of 0 in CMD.LST, a 20 on line 6 and 50 on line 7 of CNF file, you can allow all users to "see" your options but limit actual usage to those between security levels 20 and 50. This is added for more flexibility. ** If you want to collect your state or province tax from all purchasers, then place ALL on this line and all orders, regardless of their state, will be charged the tax rate you defined. *** Birthday PPE will place the user's date of birth on the user note line that you configure here. PCBoard offers 5 lines in the users records when the user notes PSA is enabled. Make sure you do not assign this to a line that is already being used by another PPE. Numbers 1-5 are for the 5 lines in the "Notes PSA". If you'd like to use the Verification Code PSA for this, place a 6 on this line instead but you must then have the Verification PSA installed. If you'd like to use the "CWPPE TPA" to store the birthday info and save the Notes or Verification Code PSA for something else, place a 7 on this line instead. If you use Birthday PPE then SubscriP will be able to read this date and will enable this feature. 3 "subscription logs" are used, 1 for those who subscribed (for added sense of security) called SUBSCRIP.YES. It also keeps a badnames list called SUBSCRIP.BDL (BaDList) which is a list of user names of those who subscribed but never forwarded the check to you. This can prevent them from repeating this over and over. SubscriP will keep a third log (ORDER.LOG) of all invoices of check or credit card purchases. Page 05 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДДДї і Listing Files і АДДДДДДДДДДДДДДДДЩ There are currently 5 .LST files required by SubscriP. They are listed below and a detailed explanation of each will follow. Please note that each item in the list must start in column ONE. PAYMENT.LST (list of payment options provided ie CHECK/COD/MASTERCARD) SHIPPING.LST (list of shipment methods and each ones' respective rates) CATEGORY.LST (list of product categories ie SUBSCRIPTIONS/HARDWARE etc) ????????.LST (list of items, prices, weight, for individual categories) DISPLAYS.LST (list of display files located in PPEs GRAPH subdirectory) ЪДДДДДДДДДДДДДї і PAYMENT.LST і АДДДДДДДДДДДДДЩ This is a list of all payment options you want to accept. Use them as shown below (all CAPS and exact spelling). If there's an option you do NOT want to accept, then simply delete the option from PAYMENT.LST. CHECK COD MASTERCARD VISA AMERICAN EXPRESS DISCOVER CARTE BLANCHE DINERS CLUB OPTIMA JCB ЪДДДДДДДДДДДДДДї і SHIPPING.LST і АДДДДДДДДДДДДДДЩ This is a list of all "shipping methods" you want to support, a "base" rate, a maximum weight (in ounces) and a "rate per ounce" if the item ordered exceeds the "maximum weight for the base rate". Each entry in SHIPPING.LST has 4 lines to it. The 1st line is the description and is not to exceed 23 characters. A few samples are explained: NO SHIPPING NECESSARY ; This sample will not append any ship 0 ; charges if this method is selected. 0 ; 0 ; MAIL DISKETTE ; This method charges $1 for the 1st 2 1.00 ; ounces and 5› each ounce thereafter. 2 ; .05 ; CALL WITH REG NUMBER ; This method charges $1 regardless of 1.00 ; the order quantity amount or weight. 0 ; 0 ; Page 06 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДї і CATEGORY.LST і АДДДДДДДДДДДДДДЩ This file is a list of each category you want to offer, such as Hard- ware, Software, Subscriptions, Network Fees etc. And each category in the category list should be in the "category menu" that you defined in the DISPLAYS.LST file. With each category is a menu file for the items you offer "within" that category. I'll show mine and explain further. MENUSUB D:\PPE\SUB\SUBSCRIP.OPT MENUSW D:\PPE\SUB\SHAREWAR.LST The above CATEGORY.LST shows 2 categories. If a user of mine selects category 2, SubscriP displays the file MENUSW which shows all of the software I sell. The pricing and weight info is read in from the file D:\PPE\SUB\SHAREWAR.LST. This is an "item list" for all the items sold in the "shareware category". You will also notice that my subscription category uses a file called SUBSCRIP.OPT. This is hardcoded and that file must be named SUBSCRIP.OPT. I'll get to this file a little later, for now though, I'll explain the "item lists". ЪДДДДДДДДДДДДДДї і ????????.LST і <------- item lists that YOU defined in CATEGORY.LST АДДДДДДДДДДДДДДЩ This is a list that you defined in the above CATEGORY.LST file. Every category (except subscriptions) uses this file as it contains pricing, weights, item names etc, for each "item" in that category. Here is my NETWORK.LST file with comments on the right (remove any/all comments). Network Application Fee ; Product/Item Title/Description 35.00 ; Price or SHELL * (see below) NF ; Product Code ** (see below) Intelec ; Manufacturer Intelec Online ; Vendor 0 ; Weight in ounces # (or blank) ; In Stock Qty *** (see below) ; Not Used D:\PPE\SP\LISTS\OPT.LST ; Item Specifics **** (see below) ; Not Used * By putting the word SHELL here, you can run another PPE from item menu if you need to have an "ever changing" price for the item. The PPE you use must be able to write a one line file called "SHELLAMT.###" in the SubscriP directory (### is the current node number). If SubscriP reads in the price as SHELL it looks for SHELLAMT.### and uses that price... ** Product code is an 8 character or number you define for each item. For the "Product Info" feature, if there's a filename in the GRAPH subdir, with the same name as the product code, this can be displayed to offer further info for this particular item. *** If you don't use "in stock quantities" then leave this field blank. If you do, place the in stock quantity for this item on this line and the quantity purchased will be deducted whenever it is ordered. **** For this item's colors, etc. See "Item Specifics" section on next page Page 07 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДДДДДДДДї і Item Specifics List і АДДДДДДДДДДДДДДДДДДДДДЩ This file is 2 lines and a sample is shown and explained below: D:\PPE\SP\GRAPH\CLR-CAP Please select a CAP color from the above The first line can be 79 characters of text to display *or* the full the full path to another display file that could list detailed product information such as item colors, etc. The second line is the question you want to ask the user based on the text or display file on line 1. Responses are limited to 10 characters as a maximum. ЪДДДДДДДДДДДДДДї і DISPLAYS.LST і АДДДДДДДДДДДДДДЩ This is the list of display files SubscriP uses and this DISPLAYS.LST file must be located in the PPE directory (same dir as SUBSCRIP.PPE). SubscriP Display Files. These are files you create which are displayed at various stages of operation of SubscriP. I've placed samples of all in the GRAPH.ZIP file. You can rename these files to anything else you like but the names MUST be listed in DISPLAYS.LST and in this order. Language, security specific and graphic files are ALL supported so for a display file called WEL, you must list it in DISPLAYS.LST as WEL but you can have graphic files called WEL (ASCII) WELG (ANSI) WELR (RIP) WEL50 (level 50 users) WEL30G.SPA (level 30, graphic, Spanish) etc... But for the above, the entry in DISPLAYS.LST *must* be called WEL. There's currently 18 display files in the DISPLAYS.LST. DISPLAYS.LST is an ascii file with 1 filename (display file) per line. And you can rename the files to whatever you like but ALL display files must exist in the "GRAPH" subdirectory (the GRAPH subdirectory is a directory off of the SubscriP PPE directory. And if you mine shown below, remove the "- comment" at the right of the file names. DSPWEL - "Welcome screen" displayed when Subscrip is first run. DSPMNU - The main menu of SubscriP showing all the menu options. DSPADD - If "check method" used, this shows address or "pay to" info. DSPBDS - Dispalyed if user is in badnames list (didn't forward fee). DSPEXP - Message text for message to the user if check never arrived. DSPNOS - If the user's sec level is too low to use SubscriP. DSPTOO - If the user's sec level is too high to use SubscriP. DSPNXT - Displayed if user views subscriptions and doesn't subscribe. DSPUPG - Displayed if user is upgraded by purchasing subscription. DSPWRN - Warning displayed after welcome (credit card fraud, etc). DSPEND - Displayed when exiting the SubscriP PPE DSPCAT - Category display (1-Software, 2-Hardware, 3-Subscription etc) DSPSUB - Help or "Information File" for the subscription category DSPBCC - Displayed when the CC number entered was bad (or bad format) DSPBNUM - Displayed if user entered a CC number found in TCAN.NUM file. DSPBNAM - Displayed if user's name was found in the TCAN.NAM file. DSPSHIP - Displayed instead of letting SubscriP show shipping options. DSPCARD - Displayed instead of letting SubscriP show payment options. DSPPEND - Displayed when a "pending" subscriber tries to re-purchase. DSPTOYN - Displayed when user is under the age you defined for purchases. USERPOST - This is the message posted to the user when a purchase is made. DISPLAYS.LST goes into the [Drive]\[SubscriP PPE Path] directory All display files go into [Drive]\[SubscriP PPE Path]\GRAPH directory Page 08 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДДДДДДї і SUBSCRIP.OPT і АДДДДДДДДДДДДДДЩ This is the file that subscription information is read from and has a very specific format. First I'll show it, then I'll explain it: 40 5 365 25.00 341 41 5 365 40.00 341 342 343 40 5 730 45.00 341 342 343 344 345 41 5 730 70.00 341 342 343 344 345 346 347 Line 1 is for subscription option 1, line 2 is for option 2 and so on. The first number in each line is for the subscriber security level for that particular option. The second number in each line is for the "expired security level". If payment is not rec'd by due date then the user is downgraded to this. The third number in each line is for the "days to expire" better known as the good old expiration date. Mine are 365 and 730 for 1 and 2 year subscription terms. If you want to support subscription levels with no expiration date, set this number to 32768 and it will flag this option as expiring on 00-00-00 (no expiration date). The fourth number in each line is the cost of the subscription and it must be shown it "dollars". If I charge $25 for a level then it must show 25.00 as the 4th number for that option. The 5th through 14th #'s are for conferences that may be part of the subscription plan (ie CD-Rom conference, etc). You can have up to TEN conferences configured for a particular subscription. As part of the "due-date checking" feature, if a check isn't rec'd yet and a user is downgraded, ALL these conference registrations are also removed from the user's record. ЪДДДДДДДДДДї і TCAN.NAM і АДДДДДДДДДДЩ This is a list of user names you want SubscriP to not allow purchases from. ЪДДДДДДДДДДї і TCAN.NUM і АДДДДДДДДДДЩ This is a list of credit card numbers you don't want to be accepted by SubscriP. ЪДДДДДДї і HELP і АДДДДДДЩ This is the SubscriP Help File, one is included and you can modify it as you see fit. It must be located in the GRAPH subdirectory. Page 09 SubscriP: Online Store Supporting Check or Credit Cards! ЪДДДДДДДДДї і PROMPTS і АДДДДДДДДДЩ This is a list of promtps that SubscriP displays so you can modify the prompts as you see fit. Just do NOT alter the sequence of these prompts or you're not going to like the results... Also, if you are using RIP displays you can use a PROMPTSR file for RIP style prompts. ЪДДДДДДДДДДДї і CWPPE TPA і АДДДДДДДДДДДЩ If you use our BirthDay PPE then you will already be aware of the TPA support we included. This will allow you to use the user's date of birth entry that BIRTHDAY.PPE supplies to prevent (if you wish) the use of SubscriP by those under an age that YOU define. The TPA will be installed as outlined below: ЪДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДї і If you have already installed the CWPPE TPA, then skip this section! і ГДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДґ і Settings to install the "CWPPE" TPA in PCBSM. For additional info on і і installing TPA's please consult your PCBoard manual. After bringing і і down all your nodes, install the TPA with these settings: і і TPA Name: CWPPE і і Version: 1 і і Static: 256 і і Dynamic: 1 і і Key: CWPPE і і This TPA is installed for various "user specific settings" that some і і of my PPE utils will require. If you installed this TPA already for і і one of my other PPE's then you DON'T need to re-install it again. і АДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДЩ ЪДДДДДДДДДДДДДДДДДДДДДДДДї і SUBSCRIPTION ONLY MODE і АДДДДДДДДДДДДДДДДДДДДДДДДЩ If you are running SubscriP in a "subscription only" mode, there are a few areas that need to be touched on. CATEGORY.LST should have only 2 lines: The 1st is to be the subscription options menu. The 2nd is to be SUBSCRIP.OPT, the subscription information file. It is suggested that you use the "use one" of the Shipping Options and the Product Categories (lines 18 and 19 of the SUBSCRIP.CNF file). Line 21 of the SUBSCRIP.CNF file is to be made a "Y". For information regarding SUBSCRIP.OPT see the related section in this manual. UNREGISTERED VERSION Lastly, there are some features that are disabled in the unregistered version, such as; it will not support more than 1 subscription level, and it will not autoscan to make sure a check was received. You will have to do that manually until you register SubscriP. Page 10 SubscriP: Online Store Supporting Check or Credit Cards!