home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / S / SVOTE300.ZIP / VOTE.DOC < prev    next >
Text File  |  1994-05-15  |  12KB  |  240 lines
  1. ┌─────┐ ┌─┐ ┌─┐ ┌─────┐ ┌─────┐ ┌──────┐   ┌─────────────────────────────────┐
  2. │ ┌───┘ │ │ │ │ │ ┌─┐ │ │ ┌───┘ │ ┌──┐ │   │  Super Vote v3.00               │
  3. │ └───┐ │ │ │ │ │ └─┘ │ │ └─┐   │ └──┘ │   │  Copyright 1994 by ArcticSoft   │
  4. └───┐ │ │ │ │ │ │ ┌───┘ │ ┌─┘   │ ┌─┐ ┌┘   │─────────────────────────────────│
  5. ┌───┘ │ │ └─┘ │ │ │     │ └───┐ │ │ │ └┐   │  Programmed by Mario Mueller    │
  6. └─────┘ └─────┘ └─┘     └─────┘ └─┘ └──┘   └─────────────────────────────────┘
  7.  
  8.            ** Super Vote v3.00 - (c) Copyright 1994 by ArcticSoft **
  9.            
  10. ┌────────────────────────────────┐
  11. │ I. Introduction to the Program │
  12. └────────────────────────────────┘
  13.  
  14.   Super vote is probably one of the best voting programs you will ever come
  15.   across.  I have used some other voting programs that had been lacking
  16.   some really important features.  Some of these voting programs were just
  17.   way too over priced.  I don't know where most of these shareware authors
  18.   get these prices.  Sometimes I think that PPE was invented for those
  19.   sysops that wanted to get revenge on those authors who charged so much
  20.   for a simple program.  Now I look at PPE as a more versatile programming
  21.   language for BBS communications.  One of the main reasons why I wrote
  22.   this program in PPE is because it required little hard drive space.  The
  23.   other reason why I wrote it in PPE would be because I run PCBoard BBS
  24.   software.  And PPE is simply the best language to use for PCBoard.
  25.   
  26. ┌─────────────────────────────┐
  27. │ II. Features of the Program │
  28. └─────────────────────────────┘
  29.  
  30.   The following is a list of features of this Program:
  31.     * Can be Installed almost anywhere in PCBoard
  32.     * Small and will not take up much hard drive space
  33.     * Enhanced Keyboard Support for ANSI Callers
  34.     * Usable in all Graphic Emulations
  35.     * Easy to Setup and Configure
  36.     * Keeps track of all of the Users who have Voted
  37.       and their Selections
  38.     * Allows users to add their own Options
  39.     * Supporting the RIP Graphics Emulation
  40.     * Unlimited number of Booths can be Created
  41.     * Optional Caller Logging
  42.     * Unlimited number of Options can be Created
  43.     * External DOS setup program for easy Configuration
  44.     * Calculates Percentages and Bar Graphs for Result
  45.       Display
  46.     * Configurable Security Levels for Each Command
  47.     * Online Booth Editing Commands
  48.     
  49. ┌─────────────────────────────┐
  50. │ III. Installing the Program │
  51. └─────────────────────────────┘
  52.  
  53.   The really nice thing about PPE, you can install it almost anywhere on
  54.   your bulletin board.  You probably will want to install this program at
  55.   the main menu as a command.  This is done by specifying the program in
  56.   the PCBoard CMD.LST.  Use the following process to accomplish this:
  57.   
  58.   * Execute the PCBSETUP program
  59.   * Select B for File Locations
  60.   * Select B once again for Configuration Files
  61.   * Use the Arrow keys to High-Light the CMD.LST File and Press F2
  62.   * Press ALT-I to Insert a fresh blank
  63.   * Specify the command name VOTE or any other command you would
  64.     rather use and press ENTER
  65.   * Specify the minimum security level as 0 or any other security
  66.     you would rather use and press ENTER
  67.   * Specify the PPE path and filename. Be sure to include the .PPE
  68.     file extension. (eg. D:\PPE\VOTE\VOTE.PPE)
  69.   
  70.   Once you have completed the above task, leave the PCBSETUP program and go
  71.   to the Super Vote directory.  You should then execute the setup program
  72.   SVSETUP.EXE to create the VOTE.CFG file.  The SVSETUP.EXE program is very
  73.   well documented and understandable.  You shouldn't have any problems with
  74.   creating your configuration file.  When you are done running the
  75.   SVSETUP.EXE program, you will be able to run Super Vote.
  76.   
  77.   I suggest reading the rest of this documentation to get a better
  78.   understanding on what options and commands are available for you.
  79.   
  80. ┌───────────────────────┐
  81. │ IV. Log User Commands │
  82. └───────────────────────┘
  83.  
  84.   Super vote has the option to LOG each of the commands that the user
  85.   decides to take.  Most doors don't log since they usually carry there own
  86.   type of log file.  Since this program is more attached to PCBoard, I like
  87.   to make it log to the actual PCBoard caller log.  Which is optional since
  88.   some Sysops don't like other programs writing to the caller log.
  89.   
  90.   I recommend this option to be activated for the safety of your system.
  91.   So if something strange goes wrong, you can check it out in the caller
  92.   log.  This option can be activated/de-activated by using the SVSETUP
  93.   program included with this program.
  94.                          
  95.   Super vote will then keep detailed logging on when the caller enter the
  96.   program and exited.  It will also log if a caller has voted, listed,
  97.   viewed, added, deleted, or edited a voting booth.  The following is an
  98.   example on what the logging will look like:
  99.   
  100.               *** Super Vote v3.00 (Closed) at (19:47:04) ***
  101.                     -> Quit and Exit to Main Menu
  102.                        * Booth (TEST) Deleted
  103.                     -> Delete an Existing Booth
  104.                        * Booth (TEST) Created
  105.                     -> Add a New Voting Booth
  106.                     -> Delete an Existing Booth
  107.                     -> Add a New Voting Booth
  108.                     -> List Available Voting Booths
  109.                        * Option (1) Selected
  110.                        * Booth (BOARD) Changed Vote
  111.                        * Booth (BOARD) Voted
  112.                     -> Vote on a Specified Booth
  113.                        * Booth (BOARD) Edited
  114.                     -> Edit an Existing Voting Booth
  115.               *** Super Vote v3.00 (Opened) at (19:46:25) ***
  116.  
  117.   * NOTE: This is just an example of SOME of the notifications left in
  118.           the caller log.
  119.           
  120. ┌───────────────────────┐
  121. │ V. Graphics Emulation │
  122. └───────────────────────┘
  123.  
  124.   Super vote is programmed to support any graphics emulation.  Even if you
  125.   have a user with a Macintosh, they will be able to use Super Vote.  If
  126.   you have a user with an XT without ANSI graphics, they will be able to
  127.   use the Super vote program.  One nice thing about Super vote is that it
  128.   supports the new RIP graphics emulation.  Although the RIP graphics
  129.   currently programmed into Super vote are quite basic.  In the near future
  130.   I plan to add more detail and mouse support to the RIP menus.
  131.   
  132.   If your caller supports Enhanced ANSI graphics (most IBM callers do),
  133.   your user will be able to interact with the program using the arrow keys
  134.   and high-lighting the commands they would like to execute.
  135.   
  136.   If you would like to use the arrow keys local, you must remember that UP
  137.   arrow is used for the the scroll back buffer.  In this case, you should
  138.   use the LEFT and RIGHT arrow keys or simply press the key displayed next
  139.   to the voting command.
  140.   
  141. ┌──────────────────────────────┐
  142. │ VI. Non-Voted Booth Notifier │
  143. └──────────────────────────────┘
  144.  
  145.   Just recently, I have added this external utility that will notify users
  146.   how many voting booths they haven't voted on.  This utility is not
  147.   required to be run.  It is only an optional external utility that you can
  148.   place in one of your logon screens.  An example, say a user of your BBS
  149.   adds a new voting booth.  You now have one new voting booth, when the
  150.   next user logs on, this utility will be executed and will check the data
  151.   files for any unvoted voting booths.  When it finds the new voting booth
  152.   the user has not yet voted on, it will notify him or her.
  153.   
  154.                        You haven't voted on 1 booth(s).
  155.                        
  156.   This is good if you would like promote the usage of the voting booth
  157.   program, it will help keep the users up-to-date on how many new booths
  158.   have been added, and if he or she needs to vote or not.
  159.   
  160.   How should you go about installing this utility?  You probably want to
  161.   put it somewhere in the logon screens.  This gives you the option of your
  162.   news screens, security screens, logon questionnaire, etc.  You select
  163.   which one works best with you.  The following is an example on how you
  164.   would execute this utility:
  165.   
  166.                            !D:\PPE\VOTE\CHKVOTE.PPE
  167.                            
  168.   You can also alter the text display of CHKVOTE.PPE by using SVSETUP.EXE
  169.   program. It will emulate MKPCBTXT so things should be quite familiar.
  170.                                
  171. ┌───────────────────────────────────┐
  172. │ VII. Bulletin Statistic Generator │
  173. └───────────────────────────────────┘
  174.  
  175.   Included with this program is a file with the filename SVSTAT.EXE.  It is
  176.   a program that simply creates a bulletin of all of booth results.  It can
  177.   be some what time consuming to go through each and every booth every day
  178.   to check out updated voting statistics.  This was made so that users can
  179.   quickly check out the results of all of the booths by simply viewing a
  180.   bulletin and not having to go into the voting program all the time.
  181.   
  182.   Setting up the program is very simple.  Simply go into the SVSETUP
  183.   program and specify the bulletin path in the 'Adjust Program Paths and
  184.   Filenames' section.  There will probably be a default already provided
  185.   for you.
  186.   
  187.   It is good to run the utility in your $$LOGOFF.BAT, this way it is
  188.   updated more often.  It won't take much time to create the bulletins, the
  189.   program is very fast.  If you still don't feel that it should go into
  190.   your $$LOGOFF.BAT program, then my other recommendation would be your
  191.   nightly event batch file.  Simply execute it with the following syntax:
  192.   
  193.                   SVSTAT.EXE (PATH AND FILENAME TO CONFIG)
  194.                   
  195.   Once that is done, the program will run and create the bulletin with the
  196.   specified filename in SVSETUP.
  197.  
  198. ┌─────────────────────────┐
  199. │ VIII. Other Information │
  200. └─────────────────────────┘
  201.  
  202.   This program is SHAREWARE and requires a fee of $10.  You may evaluate
  203.   the program for up to 30 days.  If you don't plan to register the
  204.   program, I ask you to remove it from your system.  If you would like to
  205.   continue using this program, please register it by reading the
  206.   registration form.  The program is fully functional when UNREGISTERED
  207.   except the 8 second delay and no more than 6 booths can be created.  When
  208.   the program is REGISTERED, there is no limit and there is no delay.  I
  209.   think the price for this program is fair unlike many other SHAREWARE
  210.   programs. I encourage anyone to distribute this program and upload it
  211.   to all your favorite bulletin boards.  ALL files in archive must be
  212.   included if you plan to distribute this program.  If you have any
  213.   comments or suggestions about the program, feel free to leave me mail at
  214.   the following net mail address if you have InterNet access:
  215.   
  216.                         mario.mueller@merchant.com
  217.                         
  218.   If you have access to Fido-Net style Crash mail, you can send me crash
  219.   mail at the Fido-Net node number 1:270/619. You can also FREQ the latest
  220.   version of Super Vote from the same node number with the MAGIC name SVOTE.
  221.                      
  222.   Latest versions are available for download on the support bulletin board
  223.   called The Antarctica Bulletin Board System (717) 755-2440 located in
  224.   York Pennsylvania.  I appreciate any comments and suggestions about any
  225.   of my programs.  I am open for ideas that you may have.
  226.     
  227.   I now have a SUPPORT conference on the support bulletin board for all of
  228.   the programs I have available.  You can find the LATEST versions of all
  229.   of the programs there.  If you logon to the system, simply type SUPPORT
  230.   at the main prompt and you will be taken to the support conference.
  231.   
  232.   Super Vote v3.00 was programmed in [PPL] PCBoard Programmable Language
  233.   for PCBoard v15.1 and above.  The SVSETUP.EXE program was programmed
  234.   in Turbo Pascal v7.0 used for creating and editing the VOTE.CFG file.
  235.   The CHKVOTE.PPE v3.00 was programmed in [PPL] PCBoard Programmable
  236.   Language for PCBoard v15.1 and above. The SVSTAT.EXE program was
  237.   programmed in Turbo Pascal v7.0 used for creating bulletins.
  238.   
  239. *** END OF DOCUMENT *** SUPER VOTE v3.00 ***
  240.