home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / BBSONLIN / REG-314.ZIP / REGISTRY.DOC next >
Text File  |  1993-01-22  |  15KB  |  342 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                          REGISTRY OF USERS  Version 3.14                    ║
  4. ║                                 for WWIV v4                                 ║
  5. ║                                                                             ║
  6. ║                                by Jon Dietrich                              ║
  7. ║                         Dietrich Software Enterprises                       ║
  8. ║                                                                             ║
  9. ║                                January 22, 1993                             ║
  10. ║                                                                             ║
  11. ╚═════════════════════════════════════════════════════════════════════════════╝
  12.  
  13.    Registry of Users is a program which allows a sysop of a WWIV BBS to set up
  14. a questionnaire with whatever questions he/she wants.  Each user answers the
  15. questions, and the responses can be viewed by all the users on the BBS.
  16. Basically, it allows each user to describe him/herself so that the other users
  17. will know them better.
  18.  
  19.     One of the most interesting aspects of using a bulletin board system is the
  20. variety of people that use it.  Many times you have a lot in common with other
  21. users.  I find it very hard on WWIV BBSs to get to know things about other
  22. people, such as age, sex, etc, without asking them.  Having used some Galacti-
  23. comm Multiline BBSs, I found that their "Registry of Users" aspect was very
  24. helpful.  If you wanted to know what a person was like, you just did something
  25. and typed their name and you got a brief description.
  26.  
  27.     That is the basic idea behind Registry of Users for WWIV.  It is a way for
  28. users to get to know each other better and to have more fun.  There have been
  29. many times I've scanned a message base, and wondered what the person was like
  30. who wrote a message.  With this addition to your BBS, you can press a button
  31. and get a description of them.
  32.  
  33.     Simply put, the sysop sets up prompts to be questions for the registries,
  34. such as age, interests, likes, dislikes, BBSs Owned, BBSs called, etc.  When a
  35. user logs on who does not have a registry, he/she is prompted to fill one out.
  36. After filling it out, that user's registry can be viewed by everybody else on
  37. the BBS.
  38.  
  39.     Hopefully, through knowing more about each other, users will get to know
  40. each other better.  This will hopefully create a friendlier atmosphere on your
  41. BBS and attract more users.  It should also induce more activity like message
  42. posting and e-mail because users will be more familiar with each other.  I've
  43. tested it on a couple of BBSs already and both the sysops and the users have
  44. found it very worthwhile.
  45.  
  46.     The following files should be in the file REG-314.ZIP:
  47.  
  48.             REGISTRY.EXE- The program
  49.             REGISTRY.H  - The header file
  50.             REGLOGON.EXE- The logon program
  51.             REGISTRY.DOC- The file you are reading right now
  52.  
  53.              ┌────────────────────────┐
  54.              │    * INSTALLATION *    │
  55.              └────────────────────────┘
  56.  
  57.     REGISTRY OF USERS can be installed as either a mod or as an on-line
  58.    game.  If you have the ability to mod your BBS, you should install it as
  59.    a mod, otherwise simply install it as an on-line game.
  60.  
  61.  
  62.    *************** INSTALLATION AS AN ON-LINE GAME *************************
  63.  
  64.    1.) Place the files REGLOGON.EXE and REGISTRY.EXE into the main BBS
  65.        directory (The one with BBS.EXE in it)
  66.  
  67.    2.) Add the file REGLOGON.EXE to your logon event batch file.  For more
  68.        information on how to set up the logon event file, see your WWIV docs.
  69.        Adding this will make it so that every time a user logs on, they will be
  70.        prompted to fill out a registry if they have not already done so.  This
  71.        is also needed to assure that registries are deleted when users are
  72.        deleted.
  73.  
  74.    3.) Enter the WWIV program and do a "//CHAINEDIT" command.  At that point,
  75.        you should press 'I' to indicate you want to insert a chain.  After
  76.        that, you should set everything up as follows:
  77.  
  78.       A. Description        Registry of Users
  79.       B. Filename           REGISTRY.EXE         <- Important
  80.       C. SL                 10
  81.       D. AR                 None
  82.       E. ANSI               Optional
  83.       F. DOS Interrupt      Used      <- Important
  84.       G. 300 Baud           Allowed
  85.       H. Shrink             No
  86.       I. Disable Pause      No
  87.  
  88.        Some of the options above may not be available on all versions of WWIV,
  89.        but as long as the entries labeled "Important" are entered, everything
  90.        should work.
  91.  
  92.        The only step left is to encourage your users to use Registry of Users.
  93.  
  94.  
  95.   ************************* INSTALLATION AS A MOD ***************************
  96.  
  97.    1.) Place the files REGLOGON.EXE and REGISTRY.EXE into the main BBS
  98.        directory (The one with BBS.EXE in it).
  99.  
  100.    2.) Add the file REGLOGON.EXE to your logon event batch file.  For more
  101.        information on how to set up the logon event file, see your WWIV docs.
  102.        Adding this will make it so that every time a user logs on, they will be
  103.        prompted to fill out a registry if they have not already done so.  This
  104.        is also needed to assure that registries are deleted when users are
  105.        deleted.
  106.  
  107.    3.) Add the file REGISTRY.H to the directory where all the WWIV source code
  108.        files are (like BBS.C, BBSUTL.C, CONIO.C etc...).
  109.  
  110.     2.) Load the file BBS.C into your editor.  Search for:
  111.  
  112.          do_chains();
  113.  
  114.     You will find it in the function mainmenu().  This will locate you in
  115.     the block of code that follows.  Then,
  116.  
  117.       AFTER this block of code:
  118.  
  119.           case '.':
  120.            helpl=26;
  121.            do_chains();
  122.            break;
  123.  
  124.       INSERT the following:
  125.  
  126.           case '$':
  127.            full_external("REGISTRY",0,1);
  128.            break;
  129.  
  130.       Type carefully and remember that C is a case sensitive language, so
  131.       if something is in lowercase above, it must be entered in lowercase
  132.       when modding.  The same goes for uppercase.  Basically, insert it
  133.       into your source code exactly like above.
  134.  
  135.       This part of the mod makes it possible to enter Registry of Users
  136.       from the Main Menu.
  137.  
  138.      3.) Load the file MSGBASE1.C into your editor.
  139.  
  140.      A.) Search for:
  141.  
  142.                 #include "vars.h"
  143.  
  144.          It should be right near at the beginning of the file.
  145.  
  146.          AFTER that line, on the next line, INSERT the following:
  147.  
  148.                 #include "registry.h"
  149.  
  150.  
  151.      B.) Search for:
  152.  
  153.                 switch(s[0]) {
  154.  
  155.          And INSERT the following immediatley after it:
  156.  
  157.                 REGISTRY
  158.  
  159.          Make sure that it is in all capital letters and that you hit
  160.          <ENTER> after you type it.
  161.  
  162.      4.) Save both the BBS.C and MSGBASE1.C files.  At this point, the only
  163.      step left is to re-compile the bbs.  After that you should be all set.
  164.  
  165.  
  166.               ┌──────────────────────────────────┐
  167.               │          * SETTING UP *          │
  168.               └──────────────────────────────────┘
  169.  
  170.      The first time you run Registry of Users you will be prompted to create
  171. the questions.  At each prompt, enter the question exactly as you want it to
  172. appear in all of the registries.  A colon (':') is automatically added to the
  173. end of a question when it is displayed in a registry.  Questions may be up to
  174. eighty (80) characters long.  If you have a registered version of this program,
  175. you are allowed up to fifty (50) questions.  Otherwise, you're only allowed
  176. seven (7).  To stop creating questions, simply hit <ENTER> when prompted for a
  177. question.  If you don't create any questions, the data files will not be
  178. created.
  179.      After you're done creating the questions, you will be asked how you want
  180. to run Registry of Users.  Select '1' if you installed the program as a mod by
  181. modding BBS.C and re-compiling WWIV.  Select '2' if you set up the program to
  182. run as an on-line game.  The number that you select has no effect on the
  183. execution of the program except that if it is running as an on-line game the
  184. user will not be prompted to hit '$' at the main menu to make their registry
  185. when they log on.
  186.      You will then be prompted to set up the parameters on which access to
  187. Registry of Users will be based.
  188.  
  189.  
  190.               ┌──────────────────────────────────┐
  191.               │    HOW TO USE REGISTRY OF USERS  │
  192.               └──────────────────────────────────┘
  193.  
  194.      If run as a mod, REGISTRY OF USERS can be accessed by pressing the '$' key
  195. at the main menu.  At that point a very brief title screen will be shown, along
  196. with the Registry of Users Main Menu.
  197.  
  198.      If run as an on-line game, REGISTRY OF USERS can be accessed by pressing
  199. '.' at the main menu, then selecting the number that corresponds to the program
  200. At that point, a title screen will be shown along with the Main Menu.
  201.  
  202.      At the prompt, the standard user (not a co-sysop or sysop), has the
  203. following options available: Q,I,?,U,N,E,Y and L.
  204.  
  205.       Q : This simply quits back to the main menu of WWIV and allows the user
  206.       to access any other aspect of the BBS.
  207.  
  208.       I : This displays information on how to use Registry of Users.
  209.  
  210.       ? : This redisplays the Main Menu.
  211.  
  212.       U : This displays a list of users in alphabetical order who have filled
  213.       out a registry.
  214.  
  215.       A : This command allows you to view all of the registries that have been
  216.       entered into the database.  If you have sysop access, you will be
  217.       able to edit and delete registries from within this function.  If you
  218.       are a normal user, you will be able to edit and delete your own
  219.       registry from this prompt.
  220.  
  221.       N : This lets you look at all the new registries since you last used
  222.       Registry of Users.
  223.  
  224.       E : This allows you to make changes to any of the responses that you put
  225.       in your registry.
  226.  
  227.       Y : If you have not yet filled out a registry, this command will allow
  228.       you to create your registry.  The letter 'Y' will be flashing (if you
  229.       have ANSI) to prompt you to do this.
  230.  
  231.       D : This allows you to delete your own registry.
  232.  
  233.       L : This lets you look at the registry of any user.  At the prompt, you
  234.       may enter either the alias or the number of the user whose registry
  235.       you wish to view.  You only need to enter part of the name of a user.
  236.       If the user who you entered does not have a registry it will tell you
  237.       so.
  238.  
  239.  If running as a mod, the next feature is probably the most useful of the
  240. functions in Registry of Users.  While scanning the message base (for example
  241. during a N-Scan) you can view the registry of the author of that message by
  242. pressing '$' at the prompt.  If your BBS is on a net, you will not be able to
  243. view the registries of users on other systems.  Registries of anonymous users
  244. also may not be viewed.  This feature is not available if the program is
  245. running as an on-line game.
  246.  
  247.   That's it for the regular aspects of this program.  The following aspects are
  248. available for the sysop or co-sysop: S,1,2,3,4,5 and 6.
  249.  
  250.       S:  This displays the Registry of Users Sysop Menu.
  251.  
  252.       1:  This allows you to edit the questions.  This is probably the most
  253.       important sysop function because this is where you in fact set
  254.       evrything up. When you start off, there will only be one question,
  255.       which will be blank.  A prompt will be displayed with the following
  256.       options:
  257.  
  258.            M: Modify a question.  This will allow you to modify a question.
  259.           You must first select which question, and then you will be
  260.           allowed to change it.  A colon will appear after the question
  261.           automatically when it is displayed, so you don't need to
  262.           include it.
  263.  
  264.            I: Insert a question.  This will allow you to insert a question
  265.           after another question in the list.  It will also insert a
  266.           blank response in the space for the new question in all of the
  267.           registries.  Use this if you want to add another question.
  268.           You can have up to 50 questions in the registered version,
  269.           but only 7 in the unregistered version.
  270.  
  271.                D: Delete a question.  This deletes a question from the list, and
  272.                   also deletes all the responses to that question that were in
  273.           the registries of all the users.
  274.  
  275.            L: This will relist the questions.
  276.  
  277.                Q: Quit.  This will take you back to the Registry Main Menu.
  278.  
  279.        2: This allows you to edit several things that will alter the
  280.       accesability of Registry of Users.  It also allows you to change
  281.       whether or not the program thinks it is running as an on-line game
  282.       or not.  See "SETTING UP" above for information on this parameter.
  283.  
  284.        3: This allows you to edit the registry of any user.  It is similar to
  285.       pressing 'E' at the main menu to edit your own registry, except you
  286.       can choose which user to edit.  The user must have a registry in order
  287.       for you to edit it; you cannot create other user's registries.
  288.  
  289.        4: This lets you delete the registry of a user.
  290.  
  291.        5: This function is if you want to delete the current set of 
  292.       registries and start over fresh.  You will recieve a
  293.       warning before it does this.
  294.  
  295.        6: This gives an address where I can be contacted.
  296.  
  297.   Users spend the most time in the message scanning area, and pressing '$'
  298. allows quick access to the registries.  If the program is running as a mod,
  299. be sure to tell your users about this feature, and possibly even put it onto
  300. the message scanning menu.
  301.  
  302.  
  303. ******************************** FINAL NOTES **********************************
  304.  
  305.   Registry of Users is distributed under the "shareware" principle.  This means
  306. that you may use the program at no cost for a small amount of time in order to
  307. evaluate it.  After evaluating the program, if you find it worthwhile and wish
  308. to continue using it, you must register it.  You are also free to distribute it
  309. as much as you like, as long as it is distributed in its original REG-314.ZIP
  310. form.
  311.  
  312.   If you register Registry of Users, you will be sent a new copy of a
  313. registered version, in which you will be able to have up to fifty questions
  314. instead of only seven.  You will also recieve the latest version with any
  315. updates that have been made, and plus you will be helping to encourage a
  316. fledling programmer like myself to make more programs like this.
  317.  
  318.   Registration is costs only $5, plus a floppy disk (any type) which will be
  319. used to send your new registered copy.  Just send a check along with your
  320. name and address to:
  321.  
  322.         Jon Dietrich
  323.         1337 Brook Road
  324.         Baltimore, MD 21228
  325.  
  326.   A copy of the C source code is available for $25 if you want it.
  327.  
  328.   PLEASE send me ANY problems, questions, suggestions, comments, or criticisms
  329. about this program.  I'd love to hear what you think of it so that I can make
  330. this program the best it can be.
  331.  
  332.   Lastly, I'd like to thank Freddie of The Furnace BBS (410) 433-1149 for
  333. allowing me to test this mod out on her BBS, and to the users of that board for
  334. putting up with filling out registries over and over again after something got
  335. screwed up.  Thank you...
  336.  
  337.   I hope you find this program a worthwhile addition to your BBS.  Thanks for
  338. taking the time to install it!
  339.  
  340.                        -- Jon
  341.  
  342.