home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / voters / vote_doc.txt
Text File  |  1992-12-31  |  11KB  |  310 lines
  1.  
  2.                              The Voters Booth        
  3.                       Copyright 1993 - Randy Rodrock
  4.                      The DarkSTar BBS (801)-269-8780
  5.                          USR Dual Standard 14400
  6.  
  7.                     FNET 633   FidoNet 1:311/21.0
  8.            AtariNet 51:201/1 TurboNet 100:290/5.0 NestNet 90:300/1013
  9.  
  10.  
  11. PART 1: Intro
  12. PART 2: Operation of VB
  13. PART 3: BBS Setup
  14. PART 4: Registration info
  15.  
  16.  
  17.  
  18. PART 1  Intro
  19.  
  20.         Voters Booth was created since there was not a real Voting program
  21.         for ST BBS's, the lack of something to do over the long winters
  22.         and the desire to program in GFA.  VB has a program that is run in
  23.         the Logon batch that reminds users to Vote.  It has the following 
  24.         list of Sysop definable options, allowing the users to enter 
  25.         questions and answers, and minimum time limits.
  26.  
  27.         Other features include error control, timeout and loss of carrier,
  28.         complete log of users actions while in the VB, checks disk space 
  29.         to see if disk space is sufficent for VB to write its files, checks
  30.         and cleans memory, built in user graphics, allows up to 300 users
  31.         and has its own program that creates its configuration file and
  32.         resets the Voters Booth when desired.
  33.  
  34.         I feel that Voters Booth is fairly easy to setup and maintain, 
  35.         All you have to do is run the init program and answer the questions
  36.         it asks you.  Of course you SHOULD read the docs before starting,
  37.         but hey, who reads docs anymore? <GRIN> Please read on for more info
  38.         on setting up The Voters Booth.
  39.  
  40.  
  41.  
  42.  
  43. PART 2  Operation of Voters Booth
  44.  
  45.  
  46.  
  47.         When VB is ran for the first time it will create 2 data
  48.         files that it uses to keep track of users current answers,
  49.         names and voting info.  For reason I prefer to use a seperate
  50.         folder for VB, it will create a few text files.
  51.  
  52.         After VB is set up and run for the first time it will create 
  53.         a file called Question.txt, and ANSWERx.txt (x equals the # of 
  54.         the question that the answers belong to.  Also anytime a user 
  55.         enters a question or answer the users name, date and the text 
  56.         entered will be tracked.
  57.  
  58.  
  59.         
  60.  
  61.  
  62.         Ok, on to setting VB up. all you need to do is to run the 
  63.         voteinit.prg and answer all its questions.  It will ask you 
  64.         for the path to your MAIN bbs program, where TURBO or FOREM.opt
  65.         reside, then on to where you want the VOTExxx.prg to reside,
  66.         then it will ask you if you want it to create the folder for you 
  67.         (See! as lil work as possible!) if not just point the direction to 
  68.         where the VOTExxx.prg will reside.  Then on to the NAME and PATH of 
  69.         the log it creates.  Then the brand of BBS that you run, Turbo or
  70.         Forem. It will ask you if you want to allow users to enter questions
  71.         and answers to those questions.  Last but not least, what the MINIMUM
  72.         amount of time allowed will be for ALL users to have left to enter
  73.         VB. One more item, the init prg will create the CFG file in the 
  74.         proper directory, LEAVE it there. VB will not run unless it finds 
  75.         the CFG file.  It will tell you if it cant find it.
  76.  
  77.         Note on adding or editing Q and A's for the program:
  78.         In order to add or edit the questions and answers you MUST not have
  79.         ANY extra carriage returns AFTER the last line in the text files!
  80.         ie...
  81.         
  82.         Proper text file:
  83.         What kind of Mode do you own?()
  84.         What BBS software do you prefer?()  <<<< NOTE LAST CR!!!!
  85.         
  86. ---------------------------------------------------------------------------
  87.         IMPROPER text file:
  88.         What kind of Mode do you own?()
  89.         What BBS software do you prefer?()  
  90.         ()                                    <<<<NOTE LAST CR!!!!!
  91.         
  92. ____________________________________________________________________________
  93.  
  94.         If your text files show up with EXTRA lines in them this is why.
  95.         A list of text edtiors that SHOW cr's follow,
  96.  
  97.         FLASH's text ed
  98.         Freeze Dried Term
  99.         And Tempus (If Setup right!)
  100.         
  101.         PLEASE DOUBLE check this, if you are not sure just edit mine 
  102.         and DO NOT hit return after the last line of input!  The one's in this
  103.         Archive were correct when they were zipped here. The date on the zip
  104.         was 12-31-92 if it has not be changed.
  105.         
  106.  
  107.         Currently VB only works on Turbo or Forem BBS systems.  If someone 
  108.         has the info I need on other BBS types I will incorperate it into 
  109.         the next version of VB.  
  110.  
  111.  
  112. PART 3 BBS Setup
  113.  
  114.         I will attempt to try and help out the new sysops and show 
  115.         them how to set up this prg on their BBS.  If I am wrong or 
  116.         there is a better or faster way, please contact me with any 
  117.         suggestions.
  118.  
  119.  
  120.  
  121.  
  122.         For Turbo II BBS: Installed as a main menu choice:
  123.         
  124.         First thing you need to do is load up a text edtior, 
  125.         then your menu.txt file, edit that to show the Letter
  126.         and name of the function. I used: V - Voters Booth
  127.         Then save that. 
  128.         
  129.         Run Tsysgen2.tos, choose V from the main menu and then A to
  130.         add a new command to the main menu, The TYPE will be a "!",
  131.         the KEY will be "V" or whatever you decide. Next is LEVEL,
  132.         decide on the min. access level that a user has to have to enter
  133.         VB. ATTRIBUTES, you need none, just pick EXIT, next it will ask
  134.         you for a FILESPEC, type in the name of the .bat file, ie.. 
  135.         VOTE.BAT. 
  136.         
  137.         Now you need to edit the VOTE.BAT file to suit your BBS's paths
  138.         while you are there, edit the LOGON.BAT file or add to your own.
  139.         And last but not least edit the VOTEMSG.TXT file to suit your 
  140.         needs. Also, if you are doing all this from DOS DONT FORGET to
  141.         RELOAD the Options from the Sysop menu.
  142.         
  143.  
  144.         For FOREM or Turbo as a DOORS:
  145.         
  146.         Lets see, If I remember right, edit your fdoorsx.bat file 
  147.         to show the path and name of the VOTExxx.prg, edit your 
  148.         doorsent.txt or doormenu.txt. I belive thats all there is to it. 
  149.         If any Forem sysops would care to write a better explanation 
  150.         please do so and I will include it in the next revision.
  151.         
  152.       
  153.  
  154.         A quick overview of Setup:
  155.         Edit the logon.bat Notice.bat file to run the cmpvote1.prg,
  156.         edit the votemsg.txt file for your use, setup the votexxx.prg
  157.         to your desire (As a doors prg or a main menu function for T2,
  158.         see above), run the initvote.prg (see above) and go! 
  159.  
  160.  
  161. PART 4  Registration Info
  162.  
  163.         Voters Booth is a CrippleWare program, unregistered it will only
  164.         allow 2 questions and 5 answers, no graphics and the users or 
  165.         sysop will not be able to add Questions OR answers from the main 
  166.         menu. 
  167.         
  168.         Ok, back onto how to register, 
  169.         Send 15$ and YOUR printed out Turbo.opt or Forem.opt file
  170.         and the following completed info file.
  171.         I need those to return your key file to you.
  172.         Send above to:        
  173.         
  174.         Randy Rodrock
  175.         4997 South Murray Blvd. #M38
  176.         Salt Lake City, Utah  84123-2628
  177.         USA
  178.         
  179.  
  180.  
  181.  
  182.         Registered users can FREQ updates from The DarkSTar BBS
  183.         (see node # listing at top) with the magic name of Voter
  184.         I will try to mail all keys to any user in a net that I am in
  185.         and send it in the mail. Any updates that come out will be going
  186.         into the AtariNet file echo and (hopefully) the NestNet. 
  187.         or you can ALWAYS call and download it from the DarkSTar.
  188.         I will try to get all Registered users a copy asap! And
  189.         I will have a Xnet Base if the need arises. Let me know if you 
  190.         would like to see one.
  191.         
  192.         When you register Voters Booth:
  193.         Please print out and send your TURBO.OPT or FOREM.OPT. Voters
  194.         Booth Key uses you BBS name from your Turbo.opt or Forem.opt
  195.         and I HAVE to have the EXACT name as specified in you .opt file!
  196.         Any mistake in spelling or you changing your BBS name at a later
  197.         date will make the key file inoperative!  
  198.  
  199.         Also any Bug reports or suggestions are GLADLY appreciated,
  200.         Please make any suggestion you wish and I will see what I can do 
  201.         to implement it. Also I have Beta tested this and think I have 
  202.         most all of the bugs wiped out, but you never know, please inform
  203.         me of any you find!
  204.         
  205.  
  206.  
  207.  
  208.         Special Thanks to the Following people:
  209.         
  210.         My Wife, for the understanding of the late nites!
  211.         Dick Pederson, Fnet 224 for the I/O code!!
  212.         Lawrence Gold and Steve Cole for all the help with lil' problems
  213.         Dave Marquardt, for his help on the screens.
  214.         And the developers of GFA basic for such a user friendly 
  215.         programming language!
  216.         And to all my users for helping me Beta Test it!
  217.                 
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.                                                     
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242. Sysop Name_________________________________________________________________
  243.  
  244. Address____________________________________________________________________
  245.  
  246. City_______________________________________________________________________
  247.  
  248. State______________________________________________________________________
  249.  
  250. Zip Code___________________________________________________________________
  251.  
  252. Country____________________________________________________________________
  253.  
  254. BBS Phone#_________________________________________________________________
  255.  
  256. Voice #(optional)__________________________________________________________
  257.  
  258. Node #'s of BBS: FNET FidoNet etc..________________________________________
  259. ___________________________________________________________________________
  260.  
  261. BBS Software Type__________________________________________________________
  262.  
  263. Bug Reports or Suggestions_________________________________________________
  264.  
  265. ___________________________________________________________________________
  266.  
  267. Comments___________________________________________________________________
  268.  
  269. ___________________________________________________________________________
  270.  
  271.  
  272. Make sure that you print out your Turbo.opt or Forem.opt file and include
  273. it along with 15$ US and I Will get you the Key file as soon as I get your 
  274. information!
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.