home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / MISSING / REGISTRY.ZIP / REGISTRY.DOC < prev    next >
Text File  |  1992-02-13  |  15KB  |  358 lines
  1. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2. +                                                                             +
  3. +                           REGISTRY OF USERS                                 +
  4. +                             Version 1.31                                    +
  5. +                                                                             +
  6. +                           by Jon Dietrich                                   +
  7. +                     Dietrich Software Enterprises                           +
  8. +                                          +
  9. +                 February 13, 1992                                +
  10. +                                          +
  11. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  12.  
  13.                 ┌──────────────┐
  14.                 │ INTRODUCTION │
  15.                 └──────────────┘
  16.  
  17.     One of the most interesting aspects of using a bulletin board is the
  18. variety of people that use it.  Many times you have a lot in common with other
  19. users.  But I find it very hard on WWIV BBSs to get to know things about other
  20. people, such as age, sex, etc, without asking them.  Having used some Galacti-
  21. comm Multiline BBSs, I found that their "Registry of Users" aspect was very
  22. helpful.  If you wanted to know what a person was like, you just did something
  23. and typed their name and you got a brief description.
  24.  
  25.     That is the basic idea behind REGISTRY OF USERS for WWIV.  It is a way for
  26. users to better get to know each other and to have more fun.  There have been
  27. many times I've scanned a message base, and wondered what that person was like
  28. who wrote the message. With this mod, you can press a button and get a
  29. description of them.
  30.  
  31.     Simply put, the sysop sets up prompts to be questions for the registry,
  32. such as age, interests, likes, dislikes, BBSs Owned, BBSs called, etc.  When a
  33. user logs on who does not have a registry, he/she is prompted to fill one out.
  34. After filling it out, that user's registry can be viewed by everybody else on
  35. the BBS.
  36.  
  37.     Hopefully, through knowing more about each other, users will get to know
  38. each other better, which should cause more e-mail, messages, etc.  I've tested
  39. it on two BBSs already (Thanks Karen and Larry) and both the sysops and the
  40. users have found it very worthwhile.
  41.  
  42.     The following files should be in the file REGISTRY.ZIP:
  43.  
  44.             REGISTRY.C  - The source code file
  45.             REGISTRY.H  - The header file
  46.             REGISTRY.HLP- The "help" file
  47.             REGISTRY.DOC- The file you are reading right now
  48.  
  49.               ┌──────────────────────────────────┐
  50.               │    HOW TO USE THE REGISTRY OF USERS │
  51.               └──────────────────────────────────┘
  52.  
  53.      The Registry of Users can be accessed by pressing the '$' key at the main
  54. menu.  At that point a very brief title screen will be shown, along with the
  55. Registry Main Menu.
  56.  
  57.      At the prompt, the standard user (not a co-sysop or sysop), the following
  58. options are available: E,L,U,I,?,and Q.
  59.  
  60.       Q : This simply quits back to the main menu of WWIV and allows the user
  61.           to access any other aspect of the BBS.
  62.  
  63.       I : This displays the file REGISTRY.HLP, which tells about the registry
  64.           and how to use it.
  65.  
  66.       ? : This redisplays the Registry Main Menu.
  67.  
  68.       U : This displays a list of users who have filled out a registry in
  69.           alphabetical order.
  70.  
  71.       E : This allows you to edit your registry.  If you do not have a registry,
  72.           the program will prompt you to press this key, which will allow you to
  73.           create your registry.  If you already have a registry, this will first
  74.           display your registry, then allow you to change any of the responses
  75.           that are in it.
  76.      
  77.       L : This lets you look at the registry of any user.  At the prompt, you
  78.           may enter either the alias or the number of the user whose registry
  79.       you wish to view.  You only need to enter part of the name of a user.
  80.       If you enter a name which does not exist as an alias, it will go back
  81.       to the Registry Main Menu, and if the user does not yet have a
  82.       registry it will tell you so.
  83.  
  84.   That's it for the regular aspects of this mod.  The following aspects are
  85. available for the sysop or co-sysop: S,1,2,3,4,5,and 6.
  86.  
  87.       S:  This displays the Registry of Users Sysop Menu.
  88.  
  89.       1:  This allows you to edit the questions.  This is probably the most
  90.           important sysop function because this is where you in fact set up the
  91.       registry. When you start off, there will only be one question, which
  92.       will be blank.  A prompt will be displayed with the following options:
  93.  
  94.                E: Edit a question.  Here you can select the number of a
  95.           question, and then change what the question asks.  It will
  96.           appear in registries exactly how you typed it at this prompt.
  97.           The colon is put there automatically, so you don't need to
  98.           include it.  There is a maximum length of a question, which
  99.           is set when you create the data file.
  100.  
  101.            C: This changes the length of the response for a question.  A
  102.           response can be allowed to be anywhere from 1 character to
  103.           the maximum length you set when you created the data files.
  104.           You would want to do this if for instance you were asking for
  105.           an age.  You would not want to have 50 characters available
  106.           for someone to enter something that only would take two.
  107.           The default value is fifty characters.
  108.  
  109.                I: Insert a question.  This will allow you to insert a question
  110.                   after another question in the list.  It will also insert a
  111.                   blank response in the space for the new question in all of the
  112.                   registries.  Use this if you want to add another question. 
  113.           You can have up to 35 questions.
  114.  
  115.                D: Delete a question.  This deletes a question from the list, and
  116.                   also deletes all the responses to that question that were in
  117.                   the registries of the users.  Obviously, you must have at
  118.                   least one question.
  119.  
  120.                Q: Quit.  This will take you back to the registry main menu.
  121.  
  122.        2: This allows you to edit several things that will alter the appearance
  123.           of the registry.  The following options are available:
  124.  
  125.                1: This will toggle whether or not "User Name: " and then the     
  126.                   name and number of the user will be displayed when a registry
  127.           is viewed.
  128.  
  129.            2: This will toggle whether on not usage of the registry will be
  130.           chronicled in the sysop's log.
  131.  
  132.            3: This lets you set the minimum SL (Security Level) to access
  133.           any aspect of the registry.  You may not want non-validated
  134.           users to have access, and you can set that here. The default
  135.           value is 10.
  136.  
  137.            4: This will allow you to change the minimum Security Level (SL)
  138.           to access the Registry Sysop Functions.  The default is 100,
  139.           which would allow all users with a SL of 100 or greater to
  140.           edit questions and to have access to the other Registry Sysop
  141.           functions.  For security concerns, the system password is
  142.           required in order to change the minimum SL.
  143.  
  144.            5: This changes the colors that questions will be displayed in
  145.           when a registry is viewed.
  146.  
  147.            6: This changes the response color.
  148.  
  149.        3: This allows you to edit the registry of any user.  It is similar to
  150.           pressing 'E' at the main menu to edit your own registry, except you
  151.           can choose which user to edit.
  152.  
  153.        4: This lets you delete the registry of a user.  When a user is deleted
  154.           from UEDIT, or automatically, the registry will be deleted.
  155.  
  156.        5: This creates the data files REGISTRY.DAT and REGISTRY.OFF.  This will
  157.       delete the existing registry, if there is one.  The system password
  158.       is required to do this.  If no registry file exists, you will be
  159.       prompted to do this.  See the "Installation" section of this file for
  160.       additional help with this.
  161.  
  162.   The next feature is probably the most useful of the functions in the registry.
  163. While scanning the message base (for example during a N-Scan) you can view the
  164. registry of the author of the message by pressing '$' at the prompt.  If your
  165. BBS is on a net, users will not be able to view the registries of users on other
  166. systems (at least not in this version!).  Registries of anonymous users also
  167. may not be viewed.
  168.  
  169.   Users spend the most time in the message scanning area, and pressing '$'
  170. allows quick access to the registries of users.  Be sure to tell your users
  171. about this feature, and possibly even put it onto the message scanning menu.
  172.  
  173.  ┌────────────────────────────────────────────────────────────────────────┐
  174.  │ *********************     MODDING DIRECTIONS     ********************* │
  175.  └────────────────────────────────────────────────────────────────────────┘
  176.  
  177.   1.) Move the files from REGISTRY.ZIP to the appropriate directories.
  178.  
  179.       REGISTRY.C  - the source code directory, where all the .C files are
  180.       REGISTRY.H  - also place this file in the source code directory
  181.       REGISTRY.HLP- your GFILES directory, where all the menus are
  182.  
  183.   2.) Call the file BBS.C into your text editor.
  184.  
  185.       A.) There are going to be one or more #include statements at the very
  186.       beginning.  Insert the following directly after them:
  187.  
  188.               #include"registry.h"
  189.               #include"registry.c"
  190.  
  191.       B.) Search for the mainmenu() function and find the following:
  192.  
  193.               case '.':
  194.             helpl=26;
  195.             do_chains();
  196.             break;
  197.  
  198.       And immeditaley afterwards, insert:
  199.  
  200.               case '$':
  201.             REGISTRY
  202.  
  203.       Keep in mind that C is a case sensitive language, and the word
  204.         "REGISTRY"  *MUST* be in all capital letters.
  205.  
  206.       C.) Save your BBS.C file.
  207.  
  208.   3.) If you are using WWIV v4.2, call up the file LILO.C into your editor, and
  209.     if you have any other version, call up the file BBSUTL.C.
  210.  
  211.       A.) At the beginning there will be one or more #include statements.
  212.       Insert the following immediatley after them:
  213.  
  214.                #include"registry.h"
  215.  
  216.       B.) Search for the function logon(), and find the following:
  217.  
  218.             prt(3,"You haven't voted yet.");
  219.             nl();
  220.             nl();
  221.               }
  222.  
  223.       And immeditaley afterward insert the following:
  224.  
  225.               REGISTRY_LOG_ON_STUFF
  226.  
  227.       Since C is case-sensitive, this *MUST* be in all capital letters
  228.  
  229.       C.) Save the file.
  230.  
  231.   4.) Call up the file MSGBASE1.C into your editor.
  232.  
  233.       A.) At the beginning there will be one or more #include statements.
  234.       Insert the following immediatley after it:
  235.  
  236.                #include"registry.h"
  237.  
  238.       B.) Search for the function scan() and find the following:
  239.  
  240.                if (s[1]==0) {
  241.              switch(s[0]) {
  242.  
  243.       And immeditaley afterward insert the following:
  244.  
  245.                case '$':
  246.             REGISTRY_FROM_MESSAGE_BASE
  247.  
  248.       C.) Save the file
  249.  
  250.   5.) Load the file UEDIT.C into your editor.
  251.  
  252.       A.) Find the function deluser() and search for the following:
  253.  
  254.                write_user(un,&u);
  255.  
  256.       And immeditaly after it add the following:
  257.  
  258.                deleteregistry(un);
  259.  
  260.       B.) Save the file
  261.  
  262.   6.) Re-compile the program and see the "Installation" section to install the
  263.       Registry of Users onto your system.
  264.  
  265.     This mod was tested using Turbo C++ Version 1.01, and should be compatible
  266.   with most other versions of C compilers.
  267.  
  268.     It was also tested using WWIV v4.20 and v4.12.  Keep in mind that it was
  269.   tested on a virgin copy of WWIV source code.  There might be (there shouldn't
  270.   be, but there might be) a conflict between this mod and another.  For those
  271.   boards out there that are really modded, this mod I think only uses 8 bytes
  272.   of DGROUP.  Originally it used about 5K of DGROUP, but that bug has been
  273.   fixed.
  274.  
  275.     Good luck and type carefully!
  276.  
  277.                    ┌──────────────┐
  278.                    │ INSTALLATION │
  279.                    └──────────────┘
  280.  
  281.    After you recompile the BBS, log on at the keyboard.  When you log on, it
  282. with prompt you to create the registry files.  If you don't do it now, it will
  283. keep asking every user that logs on until the files are created.
  284.  
  285.    That will create the files REGISTRY.DAT and REGISTRY.OFF in the main
  286. directory of WWIV.  It will ask you for the maximum length of a response.  When
  287. you create the questions, you can set up the maximum length for the responses
  288. to that question.  However, when you must specify this maximum length when you
  289. create the data files.  This can be anywhere in the range of 50 to 255.  THIS
  290. CANNOT BE CHANGED AFTER creating the files.
  291.  
  292.    The smaller the number, the less space the data file will occupy on the
  293. disk, but the downturn to this is that less space will be available for
  294. responses to questions.  If you aren't intending on having questions with long
  295. responses, then set the length to 60 or 70 or so.  Just experiment and find the
  296. best value.
  297.  
  298.    After doing that, you will need to set up the questions.  Do this by
  299. pressing '1' at the main menu.  See the "How to Use" section of this file for
  300. help with that.  It should be pretty much self-explanatory.
  301.  
  302.    The only other things you should have to do is put something about the
  303. registry in your menu files for the main menu and also for the message scanning
  304. menu.  You should also notify your users of the existence of the registry, and
  305. in general, have fun!
  306.  
  307.                   ┌───────┐
  308.                   │ NOTES │
  309.                   └───────┘
  310.  
  311.  
  312.     I hope this will be a worthwhile addition to your BBS.  All programming was
  313. done by Jon Dietrich, with a tiny bit of consulting from John Reames.  Thanks
  314. to Karen "Freddie" of The Furnace BBS and Larry Rubin of Microline BBS for
  315. letting me test this mod out on their systems.
  316.  
  317.     If there are ANY problems at all with this mod, or you have suggestions or
  318. donations (heheh doesn't hurt to try) feel free to ask.  I can be reached at
  319. the following address:
  320.  
  321.             Jon Dietrich
  322.             1337 Brook Road
  323.             Catonsville, MD 21228
  324.  
  325.     Also, I can be reached as "Gilligan" on The Furnace BBS (410)433-1149 or
  326. Microline BBS (410)922-3843.
  327.  
  328.     Please distribute this mod as much as you want.  I am declaring this
  329. in the public domain, but I only require that if you upload it to other boards
  330. you MUST upload the REGISTRY.ZIP file, with no changes made to it.
  331.  
  332.     Thank you for your support....
  333.  
  334.                    -- Jon
  335.                       2/13/92
  336.  
  337. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  338. +                                                                             +
  339. +                    REGISTRY OF USERS Version 1.3                            +
  340. +                                                                             +
  341. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.