home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / q / qpdoor1.zip / QPDOOR.DOC < prev    next >
Text File  |  1993-02-22  |  8KB  |  184 lines
  1.             Q-P Door - BBS Quiz/Poll Door
  2.                     by
  3.                 Frank Capo
  4.                   No Anchovies BBS
  5.                 216-466-1152 - 216-466-1153 HST 14.4 Duals
  6.  
  7.     What is Q-P Door?
  8.     -----------------
  9.         Q-P Door is trivia quizzes and user surveys for your BBS.  It is
  10.     designed so that the SysOp may add a quiz or survey from the keyboard
  11.     or import ones that are obtained from other sources.  Q-P Door stores
  12.     pertinent data on each quiz/poll and displays statistics based on
  13.     results from the users so the users may see how well they score compared
  14.     to other users (quiz) or how their opinions compare to other users (poll).
  15.     So it's a game, but it's not a game.  It's informative, yet fun!
  16.  
  17.     Installation
  18.     ------------
  19.         Q-P Door is written in QuickBASIC 4.5 using routines from the
  20.     GAPQBDR door library by Kenny Gardner.  As such, it will run on GAP
  21.     systems and PCBOARD systems with no special setup.  Other BBS systems
  22.     can use one of the many converters available to adapt to one of these
  23.     formats.  Make sure Q-P Door has access to the QuickBASIC runtime module
  24.     (BRUN45.EXE).
  25.         
  26.         - Q-P Door is network compatible and will operate on multi-node systems.
  27.  
  28.         - Place all the files from the ZIP into one directory as you would
  29.     for any door program.
  30.  
  31.         - Make a configuration file - name it what you wish - it should look
  32.     like this:
  33.  
  34.             c:\gap           <- path to your board's MAIN directory
  35.             No Anchovies PC  <- the name of your board
  36.             GAP              <- See Below
  37.             0000             <- Serial Number (registered version)
  38.             NONE             <- See Below
  39.  
  40.             Line #3 above can contain the following for your type of BBS:
  41.  
  42.                 GAP     <-GAP
  43.                 PCB     <-PCBoard
  44.                 WC3     <-Wildcat!
  45.                 SF      <-Spitfire
  46.                 WWIV    <-WWIV
  47.                 RBBS    <-RBBS
  48.  
  49.             Note: GAP, PCB and WC3 all use DOOR.SYS.  The others use whatever
  50.                   door file that system makes.  If you get error messages
  51.                   such as "overflow error" this indicates a value beyond the
  52.                   limits of "normal" door files is being used.  Please contact
  53.                   me and I'll help you overcome these problems.
  54.  
  55.             Line #5 above can be used for COM port setup.  If you're running
  56.             a non-standard IRQ or something, add lines #4 and #5 like this:
  57.  
  58.             c:\gap           <-as above
  59.             No Anchovies     <-as above
  60.             GAP              <-as above
  61.             5                <-IRQ
  62.             04F8             <-io base address in hex
  63.  
  64.         There's a QPDOOR.CFG file included in the ZIP.
  65.  
  66.     Running Q-P Door
  67.     ----------------
  68.         Q-P Door is actually two programs.  QPDOOR.EXE is the actual door.
  69.     QPSYSOP.EXE is the Quiz/Poll editor/installer.  At first, you'll need to
  70.     run QPSYSOP.EXE.
  71.  
  72.     QPSYSOP.EXE
  73.     -----------
  74.         The SysOp utility is used to make quizzes and polls for the users to
  75.     take.  The menu has 5 items to chose from.
  76.  
  77.     * (A> Add a Quiz/Poll - allows you to add new selections either from
  78.     the keyboard or from a disk file.  If you add from a disk file, the file
  79.     must one that was made with this utility.  This feature allows SysOps to
  80.     share files made by other SysOps.  More on this later.
  81.  
  82.         There are a few options to choose from when adding a new item to
  83.     the menu.  You can choose wether or not to show correct answers to
  84.     the users on a quiz.  You can choose to put a time limit on each
  85.     answer on a quiz.  You can choose to have point values for correct
  86.     answers on a quiz.  Polls do not have these options.
  87.  
  88.         * (D> Delete a Quiz/Poll - pretty self-explanatory.  This function will
  89.     NOT erase the question file (.QUE) however.  It just deletes the item from
  90.     the menu.
  91.  
  92.         * (E> Edit a Quiz/Poll - make changes in the actual text of the Quiz/Poll
  93.     or change one of the options of a Quiz/Poll.
  94.  
  95.         * (S> Show Menu - just shows you the menu of items you've installed
  96.     with the various options you've selected for each.
  97.  
  98.         Let's jump backwards and discuss (A> above in a little more detail.
  99.     When you add a new item, you're asked if you want to add from Disk or from
  100.     the Keyboard.
  101.     
  102.         Adding from the keyboard -
  103.             You'll be asked for the name of the item as you want it to appear
  104.         on the menu.  Make this as descriptive as possible so users know
  105.         something about the item.
  106.     
  107.             Next, you enter the disk filename you wish to use for this item.
  108.         follow DOS rules here.  NO EXTENSION!!!  8 characters max according to
  109.         DOS specs.
  110.  
  111.             Next, you'll be asked how many questions you wish to enter in
  112.         this quiz/poll.  You should have some idea ahead of time what you
  113.         want to enter.  The limit is 50 questions per quiz/poll.
  114.  
  115.             Next, do you want the correct answers displayed to the users?
  116.         This is for quizzes only.
  117.  
  118.             Next, will correct answers be worth points?
  119.         This is for quizzes only.
  120.  
  121.             Next, you're asked if you want a time limit for each question and
  122.         how many seconds (1-60) you want the limit to be.  Again, this is
  123.         for quizzes only.
  124.         
  125.             Now - you'll be prompted for the text of the quiz/poll.  Questions
  126.         are limited to three lines of text.  Answers are limited to 26 (A-Z).
  127.             
  128.             Save it and it's added to the menu.
  129.         
  130.         Adding from a disk file -
  131.             This feature is designed to allow Q-P Door SysOps to share items
  132.         with each other.  When you enter a new item from the keyboard
  133.         (see above) a file with a ".QUE" extension is created on disk.  If you
  134.         make these ".QUE" files available to other SysOps for download, they
  135.         can easily be installed using this feature.  All you need to know is
  136.         the ".QUE" filename (no extension).  Q-P Door will know if its a
  137.         quiz or a poll by the data in the ".QUE" file and ask the appropriate
  138.         questions to complete the addition of this new item.
  139.  
  140.         NOTE: My BBS will have a Q-P Door support Forum where registered
  141.               SysOps can up/download quiz/poll files.  I will make new
  142.               ones available as time permits.  I ask that SysOps share
  143.               their files with others by uploading them to my BBS.
  144.  
  145.     QPDOOR.EXE
  146.     ----------
  147.         The door itself is user friendly and needs no explanation.  After you
  148.     install a few quizzes/polls, go in and try it!
  149.  
  150.     Q-P Door Files
  151.     --------------
  152.         The door creates and maintains all files necessary for its operation.
  153.     Here's what they are and what they're for:
  154.  
  155.             QPUSER.DAT - random access file.  Contains user data.  Created
  156.                          by the door itself.
  157.             QPMENU.DAT - random access file.  Data on each of the items that
  158.                          appears on the menu.  Created by the SysOp utility.
  159.             QPSCR      - ASCII welcome file.
  160.             QPSCRG     - ANSI welcome file.
  161.             *.QUE      - binary data files. Contains question text and other
  162.                          info.  Created by the SysOp utility.
  163.             *.RES      - binary data files. Contains result data.  Created
  164.                          by the door itself.  If you need to restart a quiz
  165.                          or poll just delete this file from disk.
  166.  
  167.     Registration
  168.     ------------
  169.         To register, send $20 in check or money order to:
  170.  
  171.                            No Anchovies PC
  172.                            1205 Lake Avenue
  173.                            Ashtabula, OH.  44004
  174.  
  175.         Include your name and address and your BBS name and phone number.
  176.     Logon to No Anchovies BBS (the number is in the doc header).  You will
  177.     be able to download the latest updates as they become available.
  178.  
  179.         Q-P Door is already being updated and enhanced.  Only registered
  180.     sysops will have access to these updates.
  181.  
  182.         Any questions or comments about Q-P Door may be placed on No Anchovies
  183.     BBS (216)466-1152/1153 (HST 14.4 Duals).
  184. `