home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / DVB320.ZIP / SYSOP.DOC < prev    next >
Text File  |  1995-01-05  |  22KB  |  585 lines
  1. Digital Genesis: Phone number (608)787-0735  &  FidoNet Address (1:2360/13)
  2.  
  3. 12/29/94
  4.  
  5. Digital Genesis presents...
  6.  
  7.                              Dream Voting Booth v3.20
  8.  
  9.                           Copyright (c) 1994 by James Sella
  10.                                All rights reserved.
  11.  
  12. NOTE: Dream Voting Booth currently supports only 'dorinfo1.def' that is
  13.       compatible with RA and 'door.sys'. Use a conversion program as
  14.       need be. And ANSI is the only color emulation that is fully
  15.       supported at this time. ASCII is there but is a bit choppy.
  16.  
  17. I always throw this in on the top so you see it... Registration is $20.
  18. More info later.
  19.  
  20.  
  21. ***Disclaimer:
  22.       This software, it's associated files and documentation is provided
  23.       "as is" without warranty of any kind, either expressed or implied.
  24.       The author, or anyone else involved with this program shall not be
  25.       liable for any direct, indirect, consequential or incidental damages,
  26.       including loss of profits, interruption of business, loss of
  27.       information, or any other claims, attributed to the use, or inability
  28.       to use this software. This software is guarrentied to do nothing more
  29.       than take up drive space.
  30.  
  31.  
  32. ***License:
  33.       This software is NOT freeware, it is shareware. You are given a chance
  34.       to try out this software before you buy it. If you have no intention of
  35.       registering this software please discontinue use of it. This software
  36.       may be copied as long as the original archive stays intact. This
  37.       software may NOT be sold or placed in any package without direct written
  38.       permission from the author.
  39.  
  40.  
  41. ***Installation:
  42.  
  43.  
  44. 1) UnArchive Dream Voting Booth into its own directory.
  45.  
  46. example of what your tree should now look like:
  47.  
  48.                   root (c:) ---> bbs ---> dreamvb ---> dreamvb.exe
  49.                                                        dvb0   .cfg
  50.                                                        dvb1   .cfg
  51.                                                        dreamvb.ctl
  52.                                                        sysop  .doc
  53.                                                        update .txt
  54.                                                        readme .txt
  55.                                                        dreamvb.ans
  56.                                                        dreamvb.asc
  57.                                                        dglogo .ans
  58.                                                        dglogo .asc
  59.                                                        files  .txt
  60.                                                        file_id.diz
  61.                                                       dveditor.exe
  62.                                                       dveditor.doc
  63.  
  64. 3) Use a text editor to modify DVB0.cfg, DVB1.cfg *AND* DREAMVB.ctl to fit your
  65.    BBS's set up. All the information that you will need is in the files
  66.    DVB0.cfg, DVB1.cfg, and DREAMVB.ctl. I always throw in a explanation
  67.    anyway... (This doesn't mean that it is a good one. :)
  68.  
  69. DVB#.cfg
  70.  
  71.           Discription                      Example
  72.           -----------------------------------------------------------
  73.           Drop file type                  | DORINFO1.def
  74.           Path to drop file               | c:\bbs\
  75.           Node Number                     | 2
  76.           Path to Dream V. B. directory   | c:\bbs\dreamvb\
  77.           Log File                        | DREAMVB.log
  78.  
  79.  
  80. DREAMVB.ctl
  81.  
  82.           Discription                      Example
  83.           -----------------------------------------------------------
  84.           SysOp Name                      | James_Sella
  85.           BBS Name                        | Digital_Genesis
  86.           Registration code               | 0123456789
  87.           SysOp's Security Level          | 100
  88.           Allow Anonymous booths?         | YES
  89.           Maximum number of min per visit | 30
  90.           Min Level allowed to make booth | 20
  91.           Min Level allowed to add choices| 25
  92.           Use IN_USE.flg system           | YES
  93.           Use the logo screen?            | YES
  94.           Use the graphs for results?     | YES
  95.           Type of Bad Word checking.      | PARTIAL
  96.           'Bad Words' list seperated with | meany|sucker|jerk
  97.           the pipe (|)
  98.  
  99.  
  100. NOTE1: In DREAMVB.ctl the SysOp Name,BBS Name, and Registration code the
  101.           capitalization is very important. Registrations codes will not work
  102.           unless the capitalization is perfect.
  103.  
  104. NOTE2: In DREAMVB.ctl the disableing of the logo screen will only work in the
  105.           registered version. Unregistered versions are defaulted to YES which
  106.           forces you to see the logo screen.
  107.  
  108. NOTE3: In DREAMVB.ctl the types of bad word checking are FULL, PARTIAL, and NONE
  109.              FULL will abort any process in which a defined bad word appears, the
  110.              PARTIAL setting will asterisk out the defined bad word and the NONE
  111.              setting will ignore the contents of the bad word list.
  112.  
  113. NOTE4: In DREAMVB.ctl the 'Bad Words' list must be seperated by the pipe (|).
  114.             All entries for 'Bad Words' must be on the same line, maximum length is
  115.             500 characters, and and you must remember that they are taken out of
  116.             the text one at a time, in the order that they appear on the line.
  117.  
  118.           This means if your list is: suck|sucker
  119.  
  120.           Then a message...
  121.  
  122.                        You are a sucker.
  123.  
  124.           Will come out as...
  125.  
  126.                        You are a ****er.
  127.  
  128.           If your list is: sucker|suck
  129.  
  130.           Then a message...
  131.  
  132.                        You are a sucker.
  133.  
  134.           Will come out as...
  135.  
  136.                        You are a ******.
  137.  
  138. What this comes down to is that order is important in the list.
  139.  
  140. Confused yet? Don't worry, you will get there... :)
  141.  
  142. 4) Create a menu option to call Dream Voting Booth from your BBS. Dream
  143.    Voting Booth should be called using a batch file. No command line
  144.    perameters are needed but Dream Voting Booth does *NEED* to be called
  145.    from it's own directory. If you don't, the program will not be able to
  146.    find it's .ctl file.
  147.  
  148.     NOTE: Refer to your BBS manual if you need help on setting up external
  149.           programs.
  150.  
  151. example 1 - batch file for normal use :
  152.  
  153.           ;Example Batch for Dream Voting Booth
  154.           c:
  155.           cd\bbs\dreamvb
  156.           dreamvb.exe dvb0.cfg
  157.           cd\bbs
  158.  
  159. example 2 - sample batch file for questionaire mode execution :
  160.  
  161.           ;Example Batch for Dream Voting Booth : Questionaire Mode
  162.           c:
  163.           cd\bbs\dreamvb
  164.           dreamvb.exe dvb0.cfg -Q
  165.           cd\bbs
  166.  
  167. example 3 - sample batch file for a bbs mode execution:
  168.  
  169.           ;Example Batch for Dream Voting Booth : BBS Mode
  170.           ;Starts DVB in Vote Option
  171.           c:
  172.           cd\bbs\dreamvb
  173.           dreamvb.exe dvb1.cfg -V
  174.  
  175. example 4 - sample batch file for a bbs mode execution:
  176.  
  177.           ;Example Batch for Dream Voting Booth : BBS Mode
  178.           ;Starts DVB in Make Booth Option
  179.           c:
  180.           cd\bbs\dreamvb
  181.           dreamvb.exe dvb2.cfg -M
  182.  
  183. Dream Voting Booth should now be operational in its UNREGISTERED form.
  184.  
  185. (Are you getting sick of reading 'Dream Voting Booth' yet? I sure am...
  186. I'm going to refer to it as DVB from now on... OK? Good. :)
  187.  
  188.  
  189. ***Command Line Options:
  190.  
  191.  
  192. -L or -Local    -  will start DVB in local mode. You will be prompted for your
  193.                      name. If you press <enter> with a blank line, the user
  194.                      name will be "SysOp".
  195.  
  196. -Q              -  will enable questionaire mode. DVB will run through all of
  197.  or                 the booths. Users must vote for a booth. This feature is
  198. -Questionaire       very nice for new user questionaires.
  199.  
  200. -N              -  will return to user the number of booths that he has not
  201.  or                voted on yet. ie: 'There are currently 4 booths that you have
  202. -Number            not voted on yet.'
  203.  
  204. -E              -  will start door in examine/list booths option.
  205.  or
  206. -Examine
  207.  
  208. -M              -  will start door in make booth option.
  209.  or
  210. -Make
  211.  
  212. -V              -  will start door in vote option.
  213.  or
  214. -Vote
  215.  
  216. -R             -  will start door in results option.
  217.  or
  218. -Results
  219.  
  220. -C              -  will start door in change a vote option.
  221.  or
  222. -Change
  223.  
  224. -D              -  will start door in delete a booth option.
  225.  or
  226. -Delete
  227.  
  228. -I              -  will start door in Information option. I ask as a favor that
  229.  or                you include this one when you set up the door in BBS Mode.
  230. -Information       I would like other SysOps to be able to see the name of the
  231.                    program. I get more copies out this way. Thanks!
  232.  
  233.           Here are a few examples of how to use command line options:
  234.  
  235.                                 dreamvb.exe dvb0.cfg -V
  236.  
  237.                                 dreamvb.exe dvb0.cfg -L -Q
  238.  
  239.                                 dreamvb.exe dvb3.cfg -R -Local
  240.  
  241.                                 dreamvb.exe dvb2.cfg -M
  242.  
  243.                                 dreamvb.exe dvb1.cfg -I
  244.  
  245.                                 dreamvb.exe dvb0.cfg -Examine
  246.  
  247.                                 dreamvb.exe dvb4.cfg -Local -Make
  248.  
  249.  
  250. ***Questionaire Mode:
  251.  
  252.   New to version 2.00+ is questionaire mode. This is for the SysOp
  253.   that wants to tabulate information from new users or current users.
  254.   Example booths to be asked of new users would be "What is the speed
  255.   of your modem?" or "Where did you hear about this BBS?". Usually you
  256.   will not want the users to add choices but this is up to you when you
  257.   make the booth.
  258.  
  259.   To invoke questionaire mode use the command line option -Q
  260.  
  261.         DREAMVB.exe dvb0.cfg -Q
  262.  
  263.   To invoke questionaire mode locally use the command line as follows
  264.  
  265.         DREAMVB.exe dvb0.cfg -Q -L
  266.  
  267.           or
  268.  
  269.         DREAMVB.exe dvb0.cfg -L -Q
  270.  
  271.   It is usually best to keep a seperate copy of DVB for the questionaire
  272.   mode if you are also using DVB as an online door for users to add
  273.   questions to and such. I suppose if you want, you can have users make
  274.   questions for new users? Up to you...
  275.  
  276.  
  277. ***BBS Mode:
  278.  
  279.   New to version 3.00+ is 'BBS Mode'. This is the set of commands that
  280.   start the door in various modes. This allows you to set up a menu in
  281.   your BBS and run the voting door from it rather than entering into
  282.   the door and running it from there. It also allows you to make your own
  283.   custom voting door in a way. You can leave out the Make option or
  284.   Delete option if you don't like those, ect.
  285.  
  286.   What BBS Mode does is gives you the feel that some BBS software comes
  287.   with. Renegade for example has a built in voting system. You can use
  288.   DVBs BBS Mode to emulate this.
  289.  
  290. NOTE: I suggest having at least a 500k drive cache util running if you are
  291. going to be using these command line options in BBS Mode. It will be nicer to
  292. your HD. :)
  293.  
  294.  
  295. ***Customizing DVB:
  296.  
  297.  
  298.    DVB will allow you to use any .ans or .asc that you wish to use.
  299.    The original ansi and ascii that you get were created by James Sella.
  300.    There are three other ansi pictures in the archive dvbmain.arj. These
  301.    ansi pictures were created by Mike Rudie. (You like mine better don't
  302.    you?) Anyway, you can use any of these but to do so you must rename
  303.    them to 'dgmain.ans' and 'dgmain.asc' or the program will not work.
  304.    You are free to alter them or make your own as you wish. Make sure that
  305.    they are in the correct directory as well. (The program directory)
  306.  
  307. ***Using DVB:
  308.  
  309. Things that the SysOp gets over the users...
  310.  
  311. a) The SysOp will always see the name of the user that created a booth. The
  312.    creator of the booth will also see this.
  313.  
  314.             The SysOp will see...
  315.  
  316.                  Entered by: Anonymous <Joe Blow>
  317.  
  318.             rather than...
  319.  
  320.                  Entered by: Anonymous
  321.  
  322. b) The SysOp can delete any booth that they want.
  323.  
  324. c) The SysOp can always add choices to a booth regardless of the creators
  325.    setting on the booth. The Creator will also be able to do this too.
  326.  
  327.      You will see a small <SysOp Override> next to the option to add choices.
  328.  
  329. d) You are cooler than the average user and you get your name shown when the
  330.    users exit the door!!!
  331.  
  332.  
  333.     1) Vote on booth
  334.  
  335.            Voting is done much as it looks. Press 1 or V to vote and enter
  336.            the number of the booth you want to vote on. During Voting you
  337.            will be able to add choices to the booth if the creator of the
  338.            booth selected that option. The SysOp and the Creator of the
  339.            booth will always be able to add more choices (up to 20 total).
  340.            You will see a small message such as <SysOp Override> if you
  341.            are given the choice to add over the normal selection by the
  342.            creator of the booth. After voting you will be returned to the
  343.            list of booths to continue voting. To return to the main or
  344.            list more booths (if available) press enter.
  345.  
  346.            HIDDEN OPTION: If you enter 999 for the booth to vote on, DVB
  347.            will pick one for you randomly from the ones you haven't voted
  348.            on.
  349.  
  350.            NOTE: The booths listed in blue are available for voting on, the
  351.            ones in grey are already voted on. This will be reversed when
  352.            trying to change your vote.
  353.  
  354.     2) Make a new booth
  355.  
  356.            Making a new booth is pretty simple too. The only rule you must
  357.            follow is that there must be at least on character in each field
  358.            up the the letter C. After that you can press enter to complete
  359.            the booth.
  360.  
  361.      3) Results of booth
  362.  
  363.             Again this is rather simple as it all is. :) Pick the booth you
  364.             want to see the results of. Your vote (if you voted on it) will
  365.             be in purple. If graphs are enabled there will be graphs that
  366.             go alone with the percentages. They are scaled so the highest
  367.             percentage will go to the far right side of the screen.
  368.  
  369.      4) List booths
  370.  
  371.              This will give you a list of the booths.
  372.  
  373.      5) Change vote
  374.  
  375.              You will be given the list to pick a booth from. The booths that
  376.              you can change your vote on are in blue and the ones that you
  377.              haven't voted on yet are in grey. Again you can enter 999 to
  378.              have the computer pick one for you. (Why, I don't know, but you
  379.              can.) You will be asked if you are sure and you will be shown
  380.              your current vote on this booth. If you pick yes you will be
  381.              shown the list to vote from.
  382.  
  383.              NOTE: If you press enter here your vote will be removed from
  384.              the booth all togeather. You will recieve a small message to
  385.              that tune.
  386.  
  387.      6) Delete booth
  388.  
  389.               You will be shown a list of booths. The SysOp is able to delete
  390.               any booth that they want. The user can delete a booth that he
  391.               created. No user can delete another users booth.
  392.  
  393.      7) Information
  394.  
  395.                Exactly what it says... it gives information. :)
  396.  
  397.      8) Quit to BBS
  398.  
  399.                Ummm...
  400.  
  401.  
  402. ***Beta Sites:
  403.  
  404.  
  405.               BBS Name: Digital Genesis     BBS Name: The Doghouse BBS
  406.               SysOp   : James Sella         SysOp   : Mike Rudie
  407.               FidoNet : 1:2360/13           FidoNet : 1:2360/18
  408.               Phone   : (608)787-0735       Phone   : (608)788-9657
  409.               Hours   : 24                  Hours   : 24
  410.               Max Baud: 28.8k               Max Baud: 28.8k
  411.               Lines   : 1                   Lines   : 2
  412.  
  413. ***Distribution and Support Sites:
  414.  
  415.  
  416.      The newest version of Dream Voting Booth can always be FREQ'ed with the
  417.      magic name DREAMVB or downloaded on the first call to:
  418.  
  419.         (Spanish version also available with magic name DVB_SP)
  420.  
  421. USA:
  422.      Digital Genesis   (608)787-0735  (1:2360/13)  (Zoom 28.8 V.FC)
  423.                            - or -
  424.      The Doghouse BBS  (608)788-9657  (1:2360/18)  (Zoom 28.8 V.FC)
  425.  
  426. CANADA:
  427.      Gil's PC          (819)689-4565  (1:12/60)    (USR 28.8 V.everything)
  428.  
  429.  
  430. ***Registration:
  431.  
  432.        Registration for Dream Voting Booth is $20.
  433.  
  434. What you get:
  435.  
  436.     1) DVB will say REGISTERED when you exit the door. (Oh, joy!)
  437.  
  438.     2) You will be able to disable the logo screen now! (Not too bad is it?)
  439.  
  440.     3) Questionaire Mode will no longer display the banner saying it is
  441.        UNREGISTERED. Much nicer looking operation.
  442.  
  443.     4) BBS Mode (Most command line options) will no longer display the banner
  444.        saying that it is UNREGISTERED. The users won't even know it is an
  445.        external door.
  446.  
  447.     5) Other things will be available to you...
  448.  
  449.  *  6) The number of booths will not max out at 10 any longer. It will go up
  450.        to 255 in the registered version. (Pretty good, huh?)
  451.  
  452.     7) Your hair line will start to return. (Yes, you've been noticing
  453.        lately that it's been moving south, haven't you?!)
  454.  
  455.     8) You will no longer be subjected the the most horrible delays that
  456.        drive every SysOp insane! (Oh, is that what I forgot to put in the
  457.        program... lucky for you... :)
  458.  
  459. NOTE: Number 7 doesn't apply to the ladies. Unless ya need it. :)
  460.  
  461. I was going to put in a guilt trip like in my other doc files but I can't think
  462. of a good one. Never the less, please feel guilty if you don't register. :)
  463.  
  464. All registrations can be sent to:
  465.  
  466.         Digital Genesis
  467.         c/o - James Sella
  468.         3400 Leonard St.
  469.         LaCrosse, Wi 54601
  470.  
  471.  
  472. * Please make all checks/money orders payable to: James Sella
  473.  
  474. * Please not that we do NOT have an online registration system at this time.
  475.  
  476. Registration Codes will be returned via NetMail to your BBS (directly, not
  477. routed) or through the U.S. Postal System. Registrations are final and are
  478. not transferable. Please allow 4 weeks for delivery... should be less than
  479. that though. :)
  480.  
  481. WHAT IS NEEDED FOR REGISTRATIONS:
  482.  
  483.           1) SysOp's Real Name
  484.           2) BBS's Name
  485.         * 3) Name of Program you are Registering
  486.           4) FidoNet Address or Mailing Address
  487.                   5) $20 US-FUNDS (checks/money order payable to James Sella)
  488.  
  489. I may be contacted most of the time on my BBS or though NetMail and I usually
  490. monitor Fido's DOORWARE echo.
  491.  
  492. The newest versions of my programs can be FREQed (1:2360/13) or downloaded from
  493. Digital Genesis (608)787-0735. If you are calling long distance, you may log on
  494. as 'Guest' with the password 'Guest' and download anything on your first call.
  495.  
  496. Dream Voting Booth magic name is DREAMVB
  497. Dream Voting Booth Spanish Version magic name is DVB_SP
  498.  
  499. Current list of files with MAGIC name FILES from (1:2360/13)
  500.  
  501. Digital Genesis (608)787-0735
  502. FidoNet NetMail to James Sella (1:2360/13)  (all year round)
  503. Internet Mail to sella_jm@cowley.uwlax.edu  (during school year)
  504.  
  505.  
  506. ***About the program:
  507.  
  508.  
  509. Dream Voting Booth is my third door. (Well, more like 2 1/2) This door wasn't
  510. written with my girlfriend sitting behind me like the others. :) I think she
  511. got sick of that.... better start to pay more attention to her, huh?
  512.  
  513. The entire reason that I wrote this voting door is because of one SysOp...The
  514. SysOp of The Doghouse BBS, Mike Rudie. He had been complaining that there wasn't
  515. a quality voting door around. Well now there is. :) (Almost sounds like I'm
  516. bragging doesn't it?)
  517.  
  518. Version 2.00 was the result of a request by Rob Butler for a questionaire
  519. modification to the door. While making these changes I found several bugs and
  520. patched those up in this version. May Rob's BBS rest in peace..
  521.  
  522. Version 3.00 was again the result of a request for command line options of
  523. all the modes and a few extras.
  524.  
  525. Version 3.20 is the result of even more requests.
  526.  
  527. It was written in C++ by James Sella in the late hours of several (30) nights. I
  528. would like to appologize for the lame docs. (I wrote these docs at 4:43 am)
  529.  
  530.  
  531. ***Bug Reports:
  532.  
  533.    If you feel that you have found a bug in the program, please contact me
  534.    thru NetMail to my BBS (1:2360/13) or contact Mike Rudie at (1:2360/18)
  535.  
  536.  
  537. ***Suggestions:
  538.  
  539.    If you feel that you have a good suggestion for an upgrade of DVB, you
  540.    can contact me concerning this thru NetMail. I can't think of all the
  541.    ideas you know! :)
  542.  
  543.  
  544. ***History:
  545.  
  546.  
  547. v0.1 - Un-Released version of Dream Voting Booth
  548.        6/05/94 - First working version - In Alpha testing
  549.  
  550. v0.9 - Released only to the beta sites
  551.        6/12/94 - All known (dumb) bugs fixed and lots of extra things added.
  552.  
  553. v1.0 - Released to the general public!
  554.         6/19/94
  555.  
  556. v1.01 -Released to the general public.
  557.         6/20/94 - Fixed a few minor bugs created with v1.0 and added DVEditor.
  558.  
  559. v2.00 -Released to the general public. (Again)
  560.         7/03/94 - Fixed minor spelling error.
  561.                 - Added Questionaire Mode
  562.                 - Found and Fixed a major bug with the database. Any booth
  563.                   created after booth 61 would be written over other booths.
  564.                   (Basically an integer rollover mistake)
  565.                 - Fixed same database bug in DVEditor v0.1. This resulted in
  566.                   DVEditor v0.2 :)
  567.  
  568. v2.10 -Released to the general public.
  569.         9/12/94 - Changed "Press any to continue" to "Press any key to continue"
  570.                 - Added much better multinode support
  571.                 - Added INT21h AX=1680 to be kinder to multitaskers.
  572.  
  573. v3.00 -Released to the general public.
  574.         9/23/94 - Added 'BBS Mode' command line options.
  575.                 - Fixed node number bug in IN_USE.flg file.
  576.  
  577. v3.01 -Released to the general public.
  578.         9/26/94 - Fixed small bug with door.sys.. GR taken as NG
  579.  
  580. v3.20 -Released to the general public.
  581.        12/29/94 - Added several options to .ctl file and changed format of
  582.                   .cfg and .ctl files. This version gives the SysOp more control.
  583.  
  584. <*** End of File ***> TOASTY!
  585.