Ú¿ ÚÂÄ¿ ¿ ÚÄÂÂÄ¿ ÚÂÄÄ¿ Ú¿ ÚÂÄÄ¿ ÚÂÄÄ¿ ô ô ³ ³ ô ÃÅÄ Ã´ ÃÅÄ Ã´ ÀÙ ÀÙ ÀÄÙ ÀÙ ÀÁÄÄÙ ÀÁÄÄÙ ÀÁÄÄÙ ÀÁÄÄÙ ÚÂÄÄ¿ ÚÂÄÄ¿ ÚÂÄÄ¿ ÚÄÂÂÄ¿ Ú¿ ¿ ÚÂÄ¿ ÚÂÄ¿ ÚÂÄÄ¿ ÀÁÄ¿ ô ³ ÃÅÄ Ã´ ô ¿ ³ ÚÅÁÄÁ¿ ÃÅÄÁ¿ ÃÅÄ ÀÄÄÁÙ ÀÁÄÄÙ ÀÙ ÀÙ ÀÁÄÁÄÙ ÀÙ Ù ÀÙ Ù ÀÁÄÄÙ I n t e l e c S o f t w a r e ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ SubscriP ³ ÚÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³ ³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 keeps track of³³ ³how long you configured it to wait for the check, 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.³³ ³Now SubscriP supports PCBoard's Accounting PSA to let users order "credits"!³³ ³And 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 marketplace also! SubscriP supports LIVE CC PROCESSING!³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÚÄÄÄÄÄÄÄÄÄÄ¿ ³ Features ³ ÀÄÄÄÄÄÄÄÄÄÄÙ þ Accept instant subscriber upgrades via credit cards þ Supports LIVE credit card processing with LANtastic and TelePC! þ Support for credits via PCBoard's Accounting PSA! þ Definable Min and Max credits a user can purchase. þ Up to 255 different subscription security levels supported þ Accept instant subscriber upgrades via check (honor system) þ Definable Min and Max sec levels for accessing SubscriP þ Allow "shelling" to define customized product pricing! þ 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... ú Credits issued are revoked (if Accounting PSA is in use) ú User security level is downgraded automatically ú User is unregistered from "subscriber" conferences ú User placed in SubscriP 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 50 items can be ordered on a single invoice! þ Downloadable price quote/invoice þ Users can view invoices before actually placing orders þ Detects incorrectly formatted credit card numbers þ Most screens definable and customizable with ANSI, RIP or @x support þ TCAN files for user names or bad credit card numbers ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ SubscriP Installation ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Before installing SubscriP, make sure you have the NOTES and ADDRESS PSA's installed (and optionally the Accounting PSA). The Notes and Address PSA are currently required for SubscriP operation. Also, once registered, place a copy of your SUBSCRIP.KEY (or POWEPAK.KEY) in the PPE directory. Then you should add "SUBSCRIP" to your PCB TCAN file. This is because that's the "from name" of all messages posted to the SysOp by SubscriP. Next, go to the CMD.LST and make a command called SUBSCRIP, SHOP, 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 any users can "view what you have" even if their security 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\SP\SUBSCRIP.PPE Within the distribution file should be another ZIP called LISTGRAF.ZIP and this file contains the extra "list and display" files. I usually keep them in a separate directory off the ppe's directory called EXTRA (PPE\SP\ for the main ppe dir and \PPE\SP\EXTRA for the extra stuff). So if you unzip IS_SP_??.ZIP into \PPE\SP and LISTGRAF.ZIP into the \PPE\SP\EXTRA directory, you only have a few minor modifications to the list files (to customize to your exact "paths and sec levels") and you'll be all set to run! Bear in mind you can make any of these dir's anything that you like. The paths shown here are just how we do it. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ How It Works ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Let me explain how and why this works: First... if a user uses a credit card there's no need for SubscriP to track them. But if they used a check (honor system) for a subscription purchase, they DO need to be tracked. And SubscriP will handle this! When a subscription is purchased using a check (if you support it), a line is written into the notes PSA that looks similar to this: ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º 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 his subscription check arrives I go into his user record and go to line 3 (or whatever line you config'd) and I tap the space bar to "clear out" the entry. Whenever one of my level 41 subscribers logs on SubscriP checks in the "notes PSA" to see if the check "has arrived". If a user calls after the date in the "Notes PSA" and I haven't gotten a check (and I have not cleared that user's "Notes PSA entry") then SubscriP will detect the user calling after the due date and it will then it "downgrade" the user to the expired security level I defined. 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. 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. Read the following sections pertaining to various files that control how SubscriP will be configured to run on your system. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ IF YOU DON'T WANT TO ACCEPT CHECKS ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 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). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ IF YOU DO WANT TO ACCEPT CHECKS ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 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\SP\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\SP\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. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Not Used but must Exist ³ ³ Not Used but must Exist ³ ³ Not Used but Must Exist ³ ³ 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) ³ **** ³ Number of days to add to todays date for packing messsages ³ ³ The Minimum number of credits that a user can purchase. ³ ³ The Maximum number of credits that a user can purchase. ³ ³ What charge per credit (in cents) 100 equals 1 dollar. ³ ³ Log to caller log as if a door was opened. ³ ***** ³ Do you want to support LIVE credit card processing (Y/N) ³ ***** ³ Path to your TelePC directory ³ ***** ³ Full Path/FileName to your LANtastic NET.EXE ³ ***** ³ Commandline to pass to NET.EXE to run the server ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ * 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. ** 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. *New* If you are using Mario Mueller's Birthday Utility, place an 8 on this line. This will use the information stored in that TPA instead. **** If you put a 0 here, there will be no packout date. If you put a 10 here then it will add 10 to todays date to calculate a packout date. ***** See the LIVE PROCESSING section of this manual. ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Log Files ³ ÀÄÄÄÄÄÄÄÄÄÄÄÙ 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. SubscriP also keeps an ORDER.LOG of invoices. There's a 4th log file for the curious, which shows which users didn't subscribe, after viewing the subscriptions, called SUBSCRIP.NO. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Listing Files ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ There are currently 6 LIST files required by SubscriP. They are listed below and a detailed explanation of each will follow. 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) DISPLAYS.LST (list of display files located in PPEs GRAPH subdirectory) ????????.LST (list of items, prices, weight, for individual categories) SUBSCRIP.OPT (list of all your subscription options, including credits) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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. These are the supported methods of payment (CC's limited by PPLC) CHECK COD MASTERCARD VISA AMERICAN EXPRESS DISCOVER CARTE BLANCHE DINERS CLUB OPTIMA ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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 ; ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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. EXTRA\MENUSUB SUBSCRIP.OPT EXTRA\MENU-SW EXTRA\MENU-SW.LST The above CATEGORY.LST shows 2 categories. If a user of mine selects category 2, SubscriP displays the file MENU-SW which shows all of the software I sell. The pricing and weight info is read in from the file D:\PPE\SP\EXTRA\MENU-SW.LST (D:\PPE\SP\ being the PPE's directory). This is an "item list" for all the items sold in my "shareware category". You'll also see that my subscription category uses a file called SUBSCRIP.OPT. This filename is hardcoded and it must be located in the same directory as SUBSCRIP.PPE. I'll get to this file a little later... For now, I'll explain the "item lists". ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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 LISTGRAF.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 26 display files in the DISPLAYS.LST. DISPLAYS.LST is an ascii file with one filename (and optional subdirectory) per line. The PPE's directory will be prepended to the file. I recommend placing them in a subdirectory off the PPE directory to keep this cleaner. If you use my example below, remove the "comments" at the right of the filename. EXTRA\DSPWEL - "Welcome screen" when Subscrip is first run. EXTRA\DSPMNU - The main menu of SubscriP showing options. EXTRA\DSPADD - Shows your address and/or "pay to" info. EXTRA\DSPBDS - Displayed if user is in the badnames list. EXTRA\DSPEXP - Message to the user if check never arrived. EXTRA\DSPNOS - If sec level is too low to use SubscriP. EXTRA\DSPTOO - If sec level is too high to use SubscriP. EXTRA\DSPNXT - If user views subs and doesn't subscribe. EXTRA\DSPUPG - If user is upgraded by purchasing subscription. EXTRA\DSPWRN - Warning displayed after welcome. EXTRA\DSPEND - Displayed when exiting the SubscriP PPE EXTRA\DSPCAT - Product Categories (1-Software, 2-Hardware etc) EXTRA\DSPSUB - Help or "Info File" for subscription category. EXTRA\DSPBCC - Displayed when the CC number entered was bad. EXTRA\DSPBNUM - If user entered a CC number found in TCAN.NUM. EXTRA\DSPBNAM - If user's name was found in the TCAN.NAM file. EXTRA\DSPSHIP - Alternative to letting SP show shipping options. EXTRA\DSPCARD - Alternative to letting SP show payment options. EXTRA\DSPPEND - When a "pending" subscriber tries to subscribe. EXTRA\DSPTOYN - When the user is under the age you defined. EXTRA\USERPOST- Message posted to user when a purchase is made. EXTRA\RENEW - Displayed when user renews their subscription EXTRA\RENEWY - When using R command to activate renewal. EXTRA\RENEWN - When R command won't permit "early" renewals. EXTRA\DSPHELP - Help file for main SubscriP commands. EXTRA\DSPCRED - When a user picks a "C" credits options. EXTRA\PROC-N - If a credit card is not successfully processed EXTRA\PROC-Y - If a credit card IS successfully processed EXTRA\TIMEOUT - If a dial-out processing "time-out" occurs DISPLAYS.LST goes into the SubscriP PPE directory. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ????????.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) EXTRA\NF ; Product Code ** (see below) Intelec ; Manufacturer Intelec Online ; Vendor 0 ; Weight in ounces # (or blank) ; In Stock Qty *** (see below) ============================ ; Not Used EXTRA\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... Again, to use the SHELL method, run the PPE that is creating the file in the Display File for this menu list by adding the line somewhere in that file: !d:\path\ppename.PPE and make sure it knows where to create the file! ** Product code is a filename or number code you define for any item. For the "Product Info" feature, if the path and filename exists, it 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 ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Item Specifics List ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ This file is 2 lines and a sample is shown and explained below: EXTRA\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. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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: (Sample Line 1) N 40 5 182 10.00 0 (Sample Line 2) N 40 5 182 25.00 0 400 (Sample Line 3) N 41 5 365 25.00 0 (Sample Line 4) Y 45 5 32768 100.00 12500 396 397 398 399 400 (Sample Line 5) C 45 5 32768 0 0 400 Line 1 is for subscription option 1, line 2 is for option 2 and so on. ÚÄÄÄ ³ The FIRST field in each line is either an N or Y or C. ³ N is for a Non-credits/accounting type subscription purchase (normal). ³ Y is for a fixed number of credits and fixed price for these credits. ³ C Lets SubscriP Calculate how much to charge user defined credits amount. ³ ³ Lines 1-3 (with N) are forthose not using PCBoard's Accounting PSA. ³ Line 4 (with Y) is a "fixed" config charging $100 for 12,500 credits ³ and registering them in conferences 396 through 400. ³ Line 5 (with C) is a "calculated" config that lets the user enter ³ the number of credits they want to purchase and will calculate ³ the charge based on the number of credits they want. There's ³ a 0 there just to keep the numbers of "fields" straight, it's ³ not used but it must be kept there. Then after that 0 are all ³ the conferences that you want made available with that purchase. ÀÄÄ The SECOND field in each line is for the subscriber security level for that particular option. The THIRD 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 FOURTH 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 FIFTH field in each line has a different meaning if using N Y or C. If on an "N or Y line" it is the cost of the subscription (or credits) and it must be shown it "dollars". If I charge $25 for a level then it must show 25.00 as the 5th number for that option. If it is a "C line" then just put a 0 here, it means nothing but if it's missing, well, it will muck up the works. Basically there is no dollar amount there if a user is going to enter a credits amount for that option. The 6th field on each line must be there for all lines but is only used for lines starting with a Y. For "Y lines" it is the fixed number of credits you assigned for that subscription option. The 7th through ??? fields are for conferences that may be part of the subscription plan (ie CD-Rom conference, etc). ÚÄÄÄÄÄÄÄÄÄÄ¿ ³ TCAN.NAM ³ ÀÄÄÄÄÄÄÄÄÄÄÙ List of user names you want SubscriP to disallow purchases from. ÚÄÄÄÄÄÄÄÄÄÄ¿ ³ TCAN.NUM ³ ÀÄÄÄÄÄÄÄÄÄÄÙ List of credit card numbers you don't want to be accepted by SubscriP. ÚÄÄÄÄÄÄÄÄÄ¿ ³ PROMPTS ³ ÀÄÄÄÄÄÄÄÄÄÙ This is a list of prompts 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. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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. ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 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. Also, if you are using Mario Meuller's Birthday Utility, and are not using the CWPPE TPA for any other of our PPE's, you can use that instead of installing the CWPPE TPA. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ LIVE CREDIT CARD PROCESSING ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ If you have a dedicated server with phone line/modem and you use both LANtastic and TeleFlora's TelePC for processing, you can support live credit card processing within SubscriP! Fill out the 4 lines in the SUBSCRIP.CNF file (see the CNF file section) with the appropriate info as it pertains to your particular setup. Here's how I do it on my BBS: This PC is a dedicated server and has a phone line ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ and modem attached. By running the TELEPCB.BAT file ³ \\SERVER ³ on this server I am able to run TELEPC-B.EXE and ³ TELEPCB.BAT ³ if it's processed successfully SubscriP detects it. ÀÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÙ Your TelePC directory MUST be a directory accessible ³ by your nodes. TELEPCB.BAT is in the PATH on \\SERVER ³ LANtastic ³ ÚÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄ¿ This PC is where my nodes are located thusly where ³ WORKSTATION ³ SubscriP is run from. A sample of my TELEPCB.BAT ³ SUBSCRIP.PPE ³ is shown below. Modify it as you see fit or how it ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ pertains to your system. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ TELEPCB.BAT ³ That's it, it's that easy. Also, you must use the ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ -B version of TelePC for automated processing. My @ECHO OFF EXE is called TELEPC-B.EXE so I assume yours is too. D: If this setup doesn't work for you, please re-read CD\TELEPC this section to see if you might have missed some- TELEPC-B.EXE thing. SubscriP will wait for 2 minutes for a sign from TelePC that the charge has been processed successfully or not. SubscriP creates a temporary "busy file" so that no two users can use this feature at the same time. If the processing is completed after 30 seconds the "wait" is over and another user on another node is able to do a CC purchase. When the first processing is done, the "busy file" is deleted so the next attempt can be made. If there is a problem and the process is not completed after 2 minutes, SubscriP displays it's "time-out" display file. Lastly, if you are using this method, it won't upgrade users or process invoices if TELEPC-B.EXE reports a declined or failed CC process. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ 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.