home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / v611docs.zip / VMAIN611.ZIP / VC5 < prev    next >
Text File  |  1993-10-09  |  20KB  |  364 lines

  1.                                             VBBS 6.11 Documentation --  5-1
  2.  
  3.      ╔════════════════════════════════════════════════════════════════╗
  4.      ║  CHAPTER FIVE     NEW USER SIGNUP                              ║
  5.      ╚════════════════════════════════════════════════════════════════╝
  6.  
  7.                 When a user logs on as NEW on your system, he or she is
  8.          first presented with the NEWUSER.TXT file (which you definitely
  9.          should create before opening your BBS to the public) stored in
  10.          the \TXT directory defined in your PATHS Configuration.  The
  11.          NEWUSER.TXT file should provide enough information to get new
  12.          users started; it may also include anything else you wish.
  13.                 If you configured a "New User Password" in VCONFIG, the
  14.          new user will be asked to provide the password before the system
  15.          allows him or her to continue (for most "public-access" BBSs,
  16.          this is generally not done).
  17.                 At the end of the NEWUSER.TXT screen, the new user is
  18.          prompted to provide some basic information about himself or her-
  19.          self.  Depending on whether or not your system allows "aliases"
  20.          or "handles", the user will be prompted to provide a "handle" or
  21.          real name to use on the board.  VBBS checks what the user types
  22.          in against other entries in the USERFILE.DAT to make sure that
  23.          duplicate names are not used.  
  24.  
  25.          ╔═╗    If there are handles or names that you would prefer not
  26.          ╚═╝    to allow on your system, you may include them in a text
  27.                 file called TRASHCAN.TXT in your \TXT directory.  This
  28.                 file is created using an ASCII text editor and has one
  29.                 handle/name/word per line.  Most sysops use this to pre-
  30.                 vent users from having profanities as handles.
  31.  
  32.                 As the signup continues, the user is prompted for his ad-
  33.          dress, voice and data phone numbers, birthdate, password, and
  34.          other information pertaining to default settings used on the BBS.
  35.          The information provided goes into the USERFILE.DAT file.
  36.                 If you have chosen to allow auto-validation of visiting
  37.          sysops, VBBS will aske the user if he or she is a sysop.  If
  38.          the user answers "yes", he or she will be prompted for informa-
  39.          tion concerning his or her BBS and will then be given the SL
  40.          and time you have defined for visiting sysops in VCONFIG.
  41.  
  42.          ╔═╗    Again, there have been instances in which a user has
  43.          ╚═╝    given false information in order to gain sysop access
  44.                 to a BBS; use caution when allowing auto-validation.
  45.  
  46.                 If you have configured "yes" for automatic call-back
  47.          verification, VBBS will prompt the user (according to the area
  48.          code and prefix criteria you have established) to prepare to
  49.          receive an incoming call from your board, at which point VBBS
  50.          hangs up, calls the data phone number left by the user, and
  51.          confirms its authenticity by prompting the user answering the
  52.          callback to provide the password for the new account (see "The
  53.          Call-back Verifier" for more information).
  54.                                            VBBS 6.11 Documentation --  5-2
  55.  
  56.  
  57.                 New users are assigned the SL and time allowed on the
  58.         system according to what you have set up in VCONFIG.
  59.  
  60.  
  61.          New User Feedback and Validation
  62.          ════════════════════════════════
  63.  
  64.                 Generally, you do not want to give a new user too high 
  65.          an access level to your system until you are sure the informa-
  66.          tion provided you is accurate.  It is often desirable to have 
  67.          a new user leave a short introduction of himself or herself in
  68.          addition to the information given in the basic signup process.
  69.                 To have the system prompt for such "new-user feedback",
  70.          set the appropriate option in VCONFIG "on" and edit the file
  71.          LEAVEFB.TXT in your \TXT directory to ask for the sorts of in-
  72.          formation you'd like to have (of course, you don't want to get
  73.          TOO personal here, because that tends to catch new users off-
  74.          guard).  
  75.  
  76.          ╔═╗    It should be noted that a new user may choose to abort
  77.          ╚═╝    the feedback letter and go straight into the system
  78.                 without leaving any message to the sysop.  There are
  79.                 several ways of combatting this rudeness:
  80.  
  81.                 1)  Using an ASCII text editor, create a file in your 
  82.                     \TXT directory called NEWUMAIL.TXT.  It should in-
  83.                     clude some basic information about your system and 
  84.                     its standard operating procedures (but should not 
  85.                     be too long).  It will appear as a message from the 
  86.                     sysop in the new user's mailbox.  If the new user 
  87.                     reads the NEWUMAIL.TXT file, the system will send 
  88.                     you "oneliner" indicating that the message was read;
  89.                     sometimes, this is the only way a sysop knows a new 
  90.                     user has logged on, short of doing a complete user 
  91.                     listing.  If the user chooses to not read this 
  92.                     E-mail, no "oneliner" is delivered.
  93.          
  94.                 2)  Should you happen to notice that a new user has 
  95.                     signed up but has not left you any message announ-
  96.                     cing his presence, send him an E-mail, asking if 
  97.                     there was any particular reason the feedback was 
  98.                     aborted.  Many users are somewhat embarrassed to 
  99.                     draw this kind of "negative attention" to themselves
  100.                     and will promptly reply the next time they log on.
  101.                     They may not leave the information you requested in 
  102.                     LEAVEFB.TXT, but that's another story ...
  103.  
  104.                 3)  Simply ignore the new account until you receive 
  105.                     feedback from the user.  If new users have only 
  106.                     limited access to your system, the offending user 
  107.                     will either tire of logging on and not being able
  108.                     to do anything (and then send feedback), or will
  109.                     simply not call any more.  This is, of course,
  110.                     combatting rudeness with rudeness, and is one way
  111.                     your BBS can earn a bad reputation among users 
  112.                                           VBBS 6.11 Documentation --  5-3
  113.  
  114.  
  115.                     (word-of-mouth is still a powerful positive or nega-
  116.                     tive advertising tool, even among BBS users).
  117.  
  118.                 4)  Install one of the various script modifications avail-
  119.                     able that will truly FORCE the new user to leave feed-
  120.                     back or have the account deleted.  These may, of 
  121.                     course, be edited (with an ASCII editor) to convey 
  122.                     exactly the tone you wish, and while it may seem a 
  123.                     "brute-force" method of getting the information you 
  124.                     ask for, it IS effective.
  125.  
  126.                 If the new user DOES leave feedback (or even a regular 
  127.          E-mail), the sysop need only hit [V] from the E-mail submenu and
  128.          then enter the user's account in the user editor.  Once there,
  129.          the sysop can assign the user an appropriate security level and
  130.          time allowed on the system, set any access flags/ratio exemp-
  131.          tions/other variables as needed.
  132.  
  133.                 There are MANY options as to how you present your BBS to
  134.          new users, even without the use of scripts and/or source-code 
  135.          modifications.  Your login screen(s), LEAVEFB.TXT, NEWUMAIL.TXT,
  136.          and other informational screens make that all-important first 
  137.          impression.  First-time callers, and ESPECIALLY new BBSers, ap-
  138.          preciate friendliness and courtesy from the sysop, and USUALLY
  139.          respond in kind (of course, if you're running a "bash board"
  140.          and they EXPECT abuse on the first call ...).   :-)
  141.  
  142.  
  143.          NEW USER DEFAULTS
  144.          ═════════════════
  145.  
  146.                 One of the most important things a new user (including a
  147.          new sysop) should do is set his or her defaults.  Pressing [D] at
  148.          the Main Menu brings up a list of settings, which are described
  149.          below. New users are shown their default after registration also.
  150.  
  151.          1) Video Mode           The user may choose ASCII, ANSI, or En-
  152.                                   hanced ANSI (which enables pull-down
  153.                                   menus) as the default.  If a user wishes
  154.                                   to use Enhanced ANSI, he or she MUST
  155.                                   select it here; otherwise, ANSI auto-de-
  156.                                   tection determines default.
  157.          2) Expert Toggle        Expert mode disables the menu-at-every-
  158.                                   prompt mode.
  159.          3) Page Breaks          Number of lines per page.  A setting of 
  160.                                   0 produces continuous screen scrolling;
  161.                                   24 is default.
  162.          4) Password             Change password, if desired.
  163.          5) Autoposts            Toggles Autopost display at login.
  164.          6) Ctrl-A User Macro    User may create up to 2 macros, each con-
  165.          7) Ctrl-B User Macro     taining up to 79 characters (including
  166.                                   ANSI control characters).
  167.          8) ANSI Color Setup     User may customize screen colors to suit
  168.                                   to suit personal tastes.
  169.          
  170.  
  171.                                             VBBS 6.11 Documentation --  5-4
  172.  
  173.  
  174.          9) Full Screen Editor   Toggles between the full-screen editor 
  175.                                   (FSE) and a line editor; ASCII users get
  176.                                   the line editor.
  177.          A) Mailbox              Forward E-mail to another user or network
  178.                                   system, if desired.
  179.          B) Security             Displays a list of things the user has a
  180.                                   high enough SL to do.
  181.          C) Long Distance Cost   Allows user to keep track of LD usage and
  182.                                   billing by defining cost per minute and 
  183.                                   knowing the billing cycle.
  184.          D) Sort File Lists      Toggles between alphabetically- and nu-
  185.                                   merically-sorted file listings.
  186.          E) User Time Bank       User may deposit unused time for later
  187.                                   withdrawal.  Maximum time is set in 
  188.                                   VCONFIG (q.v.).
  189.          F) File List Display    Toggles between single- and double-line 
  190.                                   file listing.
  191.          Q) Quit                 Saves changes and quits to Main Menu.
  192.  
  193.                 The sysop should encourage new users to take time to set
  194.          their defaults early on; ANSI users should be encouraged to use
  195.          the full-screen editor for its superior cursor control and edi-
  196.          ting features.
  197.  
  198.  
  199.          THE USER EDITOR
  200.          ═══════════════
  201.  
  202.                 The user editor allows the sysop to view and edit users'
  203.          information, validate and/or delete users.  The user information
  204.          is divided into several fields, each of which is described below.
  205.  
  206.             User Number         User's account number.
  207.          a) User Handle         User's handle (if used/allowed).
  208.          b) User Real Name      User's real name.
  209.          c) Address             Street or P.O. box address
  210.          d) City
  211.          e) State
  212.          f) Zip
  213.          g) Security Level      User's SL; acceptable values are 1-255
  214.                                  (255 is sysop access); new-user SLs are
  215.                                  set in VCONFIG.
  216.          h) Access Flags        Flags used for specific database access,
  217.                                  given as a letter A-Z.  Certain data-
  218.                                  bases (such as sysops-only databases)
  219.                                  may be given an access flag; only those
  220.                                  users with the corresponding flag in
  221.                                  this field may access those databases.
  222.                                  The sysop should toggle all of these
  223.                                  flags ON for his or her account by 
  224.                                  pressing [H] and typing the alphabet;
  225.                                  this ensures that he or she cannot 
  226.                                  accidentally be locked out of any 
  227.                                  database.
  228.          
  229.  
  230.                                             VBBS 6.11 Documentation --  5-5
  231.  
  232.  
  233.          i) Flags               General flags used outside of databases,
  234.                                  given as a letter A-Z.  VBBS currently
  235.                                  uses four flags "out of the package":
  236.  
  237.                                    A -- Login autoposts on/off
  238.                                    F -- If set, user uses full-screen
  239.                                          editor
  240.                                    N -- User has received new-user
  241.                                          message
  242.                                    X -- Menus in expert mode
  243.  
  244.                                  Flags may be set or reset manually in
  245.                                  the user editor, or via scripts.
  246.          j) Password            User's password.
  247.          k) Phone 1             User's voice phone number.
  248.          l) Phone 2             User's data phone number
  249.          m) MaxTime             Maximum time allowed on per day.
  250.          n) Credits             User's credit total (see VSCRIPT.DOC for
  251.                                  more information).
  252.          o) Verify Birthday     User's birthday.  If toggled, will ask
  253.                                  user to re-enter birthday at login.
  254.          p) Ratio Exempt?       Allows you to exempt the user from up-
  255.                                  load/download ratio (if any).
  256.          q) U/L                 Files/kilobytes uploaded.
  257.          r) D/L                 Files/kilobytes downloaded.
  258.  
  259.          Ex1 - Ex8              User's $extra variables 1 through 8 (see
  260.                                  VSCRIPT.DOC for more information).
  261.          Page                   User's default page length.
  262.          Vid                    User's default video mode.
  263.          Calls                  Number of calls to your BBS the user has
  264.                                  made to date.
  265.          Time                   Total time the user has spent on your BBS
  266.                                  to date.
  267.          Last                   The date the user last called your BBS.
  268.          Posts                  Number of public posts the user has left
  269.                                  to date.
  270.          Email                  Number of E-mails the user has sent to
  271.                                  date.
  272.  
  273.  
  274.                 You may edit the information in fields a) through r) and
  275.          Ex1 through Ex8; the rest is pretty much "read-only" user-selec-
  276.          ted defaults or record-keeping information.
  277.  
  278.                 There are several commands to help the sysop get around
  279.          in the user editor:
  280.  
  281.          [/]            Prompts for a user number, handle, or real name 
  282.                          and searches on the information given.  In case 
  283.                          of duplicate information (e.g., two users with 
  284.                          the first name "Mike"), it will ask if the user 
  285.                          shown is the correct one.
  286.          [Enter]        Move to next record.
  287.          [-]            Move to previous record.
  288.  
  289.                                             VBBS 6.11 Documentation --  5-6
  290.  
  291.  
  292.          [!]            Delete user's account.  Sets SL to 0 and opens
  293.                          the account number for reassignment.  If you
  294.                          open several slots, a new user will be given
  295.                          the lowest-numbered slot available; the user
  296.                          list is NOT "packed" (renumbered) after dele-
  297.                          tions.
  298.          [Esc]          Quit to sysop menu or WFC, whichever the editor
  299.                          was invoked from.
  300.  
  301.  
  302.                 The user editor is a powerful tool for managing your
  303.          user base -- spotting bogus accounts, changing users' access
  304.          to various areas of the BBS, verifying information, and so on.
  305.          There are several utilities available that make use of the in-
  306.          formation stored in USERFILE.DAT; see "Virtual Tools" for more
  307.          information.
  308.  
  309.  
  310.          ONLINE FUNCTION KEYS
  311.          ════════════════════
  312.  
  313.                 When a user is online, the [F1] through [F10] keys func-
  314.          tion differently from the way they do at the WFC screen.  The
  315.          list of functions available when a user is online is given be-
  316.          low:
  317.  
  318.          [F1]           Enter/exit Chat mode.
  319.          [Shift-F1]     Enter split-screen Chat mode; [Esc] exits.
  320.          [F2]           Call up user editor; user sees a <Wait> prompt
  321.                          on his or her screen.  By exiting the [F2] user
  322.                          editor as another user, the sysop can "change
  323.                          into" that user.
  324.          [F3]           Add 1 minute to the user's session.
  325.          [Shift-F3]     Subtract 1 minute from the user's session.
  326.          [F4]           Increase user's SL by 5.
  327.          [Shift-F4]     Decrease user's SL by 5.  It should be noted that
  328.                          the [F4] and [Shift-F4] changes appear to be
  329.                          permanent; if you wish to give a user a higher
  330.                          SL temporarily, your best bet would be to go
  331.                          into the user editor using the [F2] key.
  332.          [F5]           Drop to DOS (VBBS stays in memory).
  333.          [Shift-F5]     Drop to DOS (VBBS shrinks out as per a door pro-
  334.                          gram).
  335.          [F6]           Pseudo-DOS multitasker; allows sysop to run small
  336.                          DOS commands from the console while the user is
  337.                          online and using the BBS.  One of the most un-
  338.                          derrated features of VBBS.
  339.          [F8]           Sysop alert; sets the computer to beep when the
  340.                          current user online logs off.
  341.          [F9]           Invoke the "Download Any File" convenience fea-
  342.                          ture.
  343.          [F10]          Boot user off the system, "cold".
  344.          [Ctrl-F10]     Display STORM.TXT (found in the \TXT directory),
  345.                          warning of inclement weather conditions, THEN
  346.  
  347.                                             VBBS 6.11 Documentation --  5-7
  348.  
  349.  
  350.                          boot the user off the system.
  351.          [Shift-F10]    Spurt some simulated "line noise" at the user,
  352.                          and boot him or her off the system.  Makes the
  353.                          user think a bad connection terminated the ses-
  354.                          sion.
  355.  
  356.  
  357.                                 * * * * * * * * *
  358.  
  359.  
  360.                 That just about does it for the "introductory" section of
  361.          the VBBS documentation.  The next section deals with the various
  362.          functions and features of VBBS.
  363.  
  364.