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

  1.                                             VBBS 6.11 Documentation --  7-1
  2.  
  3.          ╔════════════════════════════════════════════════════════════════╗
  4.          ║ CHAPTER SEVEN     CUSTOMIZING VBBS                             ║
  5.          ╚════════════════════════════════════════════════════════════════╝
  6.  
  7.                 The configurability of VBBS can not be overstated.
  8.                 
  9.                 Because of the way VBBS is structured, it's possible to
  10.          configure the program to look and feel like some other BBS soft-
  11.          ware; you can borrow features from several different BBS soft-
  12.          wares to create your own design.  You might just take a vacation
  13.          from reality one night and decide to make VBBS look just like
  14.          GEnie or some other CIS.  Aside from the obvious limitations on
  15.          actual storage space, you could accomplish the "look-alike" to
  16.          the point where a user could not tell the difference!  By using
  17.          scripts (and the source code, if you've registered for it), you
  18.          can do many things that simply aren't possible with other BBS
  19.          softwares.
  20.                 Unlike source code, which normally contains strict rules
  21.          on code segment distribution (VBBS included), VSCRIPT-based ap-
  22.          lications, function blocks, and menus may be distributed freely
  23.          in full, or even in entire configuration sets.
  24.  
  25.  
  26.          Menus, Function Blocks, Scripts, and Mods
  27.          ═════════════════════════════════════════
  28.  
  29.                 Customization and modification of VBBS comes in several
  30.          forms: changing the menus to suit your personal tastes and set-
  31.          up, rearranging function-block commands, installing scripts for
  32.          special applications, and even modifying the source code (if
  33.          you've registered at the source level).
  34.                 Menus and function blocks are closely interrelated, so
  35.          if you find yourself flipping back and forth between the sec-
  36.          tions on the two, don't worry; it's normal.
  37.                 For the remainder of this manual, the term "script" will
  38.          apply exclusively to programs utilizing the VSCRIPT script lan-
  39.          guage; the term "mod" will refer exclusively to modifications
  40.          made at the source-code level.  It should be pointed out here
  41.          that you do not need to register VBBS to write scripts or ex-
  42.          change scripts with other sysops via VirtualNET; registration
  43.          and an additional fee ARE, however, required to obtain the VBBS
  44.          source code.  
  45.                 There are other good reasons to register VBBS; we'll get
  46.          to those presently.
  47.  
  48.         
  49.          "Heart-Code ANSI"
  50.          ═════════════════
  51.  
  52.                 If you've read this far, you've run across the term
  53.          "heart-code ANSI" a time or two.  Since customization often in-
  54.          volves changing colors and menus and adding system taglines,
  55.          this is probably a good place to explain what "heart-code ANSI"
  56.          is.
  57.  
  58.                                              VBBS 6.11 Documentation -- 7-2
  59.  
  60.  
  61.                 If you've ever used the DOS "type" command to look at a
  62.          file you've created using TheDraw or some other ANSI drawing
  63.          program, you know it consists mainly of "garbage" resembling
  64.          Chinese.
  65.  
  66.          This is the ANSI (American National Standards Institute) code
  67.          for introducing color changes into text files so that the colors
  68.          will show up onscreen; in order to display these color changes,
  69.          you need to have the statement
  70.  
  71.                 DEVICE=ANSI.SYS
  72.  
  73.          somewhere in your CONFIG.SYS file (remember, though, about the
  74.          ANSI bomb -- see "First-Time Startup" for details on alternate
  75.          ANSI drivers).
  76.                 A while back, a good number of BBS programs  began
  77.          using a method of color changing called "heart-code ANSI",
  78.          in which color changes were represented by a heart character
  79.          followed by an alphanumeric character.  The heart-code system
  80.          has the benefit of taking only two bytes to accomplish what
  81.          takes 4-6 bytes in "raw" ANSI, thereby reducing the size of
  82.          network transfers, especially where large numbers of color
  83.          changes are involved.
  84.                 In an effort to maintain compatibility other bulletin
  85.          board networks, VBBS was designed to handle heart-code
  86.          ANSI.  The heart-code colorization system has become the stan-
  87.          dard for these BBS softwares.
  88.                 When you're starting out with heart-code ANSI, it's a
  89.          good idea to go into the VBBS FSE and press [Ctrl-P][?], and
  90.          look at the color combinations that appear at the bottom of
  91.          the screen.  The same set of color combinations can be seen
  92.          when you go into your [D]efaults setup and start changing
  93.          your screen display colors; you might consider printing out
  94.          that screen using [Shift-Print Screen].
  95.  
  96.          --> IMPORTANT NOTE:  If you print-screen the default-menu
  97.                               color change information, be aware that
  98.                               all the codes are "off" by one; for exam-
  99.                               ple, the screen code for gray on black is
  100.                               1, but the heart-code for gray on black
  101.                               is 0 (zero).  Likewise, the bright-red on
  102.                               black is screen code 7, but heart-code 6.
  103.  
  104.          ╔═╗    Using heart-code ANSI takes some getting used to, but       
  105.          ╚═╝    with practice, it's not terribly more difficult than
  106.                 the "raw" ANSI produced by TheDraw or other ANSI draw
  107.                 programs.  Heart-code ANSI is best for menus, taglines,
  108.                 and other features that have patterned or infrequent
  109.                 color changes.
  110.                 
  111.                                              VBBS 6.11 Documentation -- 7-3
  112.  
  113.  
  114.                 The easiest way to produce a heart-code menu or tagline 
  115.          is to first use an ANSI drawing program to make the menu/tag-
  116.          line, then save it as a straight ASCII text file.  Then, pull
  117.          it into the VBBS FSE and use [Ctrl-P] codes to change the co-
  118.          lors (see Appendix C for details).
  119.                 To introduce a heart-code color change into an ASCII
  120.          text file, turn Num Lock ON; while holding down the [Alt] key, 
  121.          type in either "3" or "259" (whichever works) FROM THE NUMERIC 
  122.          KEYPAD.  A heart character should appear on your screen.  The 
  123.          second keystroke should be a number from 0-9 or a letter from
  124.          A-Z, depending on what color you want to produce.
  125.  
  126.  
  127.          Customizing Menus
  128.          ═════════════════
  129.  
  130.                 The VBBS archive includes a default set of function blocks
  131.          (see below) and their accompanying menus.  After running the de-
  132.          faults for a while, however, most sysops want to customize their
  133.          menus to more accurately reflect their personal tastes and give
  134.          their BBS a distinctive look.
  135.                 Default VBBS has four different types of menu files:
  136.  
  137.                         .MNU files (the default)
  138.                         .ANS and .ASC files
  139.                         .PDM files
  140.  
  141.          We'll take a moment to explain each one in detail (there is one
  142.          more menufile type if your BBS is set up to use the R.I.P.
  143.          (Remote Imaging Protocol).
  144.  
  145.          On startup, VBBS looks for menu files with the .MNU ex-
  146.          tension.  The .MNU files included with VBBS are done in heart-
  147.          code ANSI, and serve "double duty".  If the user's video display
  148.          will support ANSI graphics, the color changes will be included,
  149.          but if it won't (user's defaults set to ASCII), VBBS will strip
  150.          out the color changes for display to that user.  The main bene-
  151.          fit of this system is that by using the heart-code .MNU files, 
  152.          only one set of menu files is needed for both ANSI and ASCII 
  153.          users.  Another point in favor of the .MNU files is that they
  154.          seem to display a little bit faster -- this is probably due to
  155.          the fact that it takes only two bytes to make a color change.
  156.  
  157.                 The second set of menu formats -- .ANS and .ASC files --
  158.          is what VBBS will look for if it doesn't find .MNU files.  The
  159.          .ANS format is "raw" ANSI, such as that produced by TheDraw;
  160.          an .ASC extension represents an ASCII (text) menu.  The advan-
  161.          tages to having these files in lieu of .MNU files is that they
  162.  
  163.                                              VBBS 6.11 Documentation -- 7-4
  164.  
  165.  
  166.            1) are a little bit quicker to produce, i.e., you draw a 
  167.               menu directly in ANSI, save it twice (in .ANS format 
  168.               and in .ASC format), and you're done.
  169.            2) are easier to make, especially if you have very com-
  170.               plex menus and color changes; the heart-code system 
  171.               can be a little daunting if your menus are ornate.
  172.  
  173.          The downside of this method is that you must have two copies of
  174.          each menu, one for ANSI users and one for ASCII users; if a user
  175.          with ASCII defaults gets an .ANS menu, he/she will receive gar-
  176.          bage characters (as shown above) and probably won't call back.
  177.  
  178.                 The final set of files are VBBS' "pull-down" menus, which
  179.          have a .PDM extension.  These are for users who have selected
  180.          "Enhanced ANSI" as their screen display default.  These are ac-
  181.          tually ASCII text files that VBBS colorizes as part of the de-
  182.          fault color selection.  A user may opt to use .PDMs at any sys-
  183.          tem prompt by pressing the [Esc] key -- and you should try it
  184.          to see how they work.  The default FILES.PDM file is shown
  185.          below:
  186.  
  187.                 Directory
  188.                  C Change Directory [C]
  189.                  L List Files       [L]
  190.                  S Search All Dirs  [S]
  191.                  N New Files List   [N]
  192.                  F Find Description [F]
  193.                 Transfer
  194.                  D Download Files  [D]
  195.                  U Upload Files    [U]
  196.                  B Batch Functions [B]
  197.                  R Review Files    [R]
  198.                  Y Your Stats      [Y]
  199.                 Other
  200.                  J New File Scandate       [J]
  201.                  P Popular Downloads       [P]
  202.                  M Download Master List    [M]
  203.                  Q Quit to Main Menu       [Q]
  204.                  G Log Off                 [G]
  205.  
  206.          These files are preconfigured, but easily changed using any text
  207.          editor.  They don't need to be changed, though, unless you re-
  208.          group or add commands within the function blocks.  But --
  209.  
  210.          --> IMPORTANT NOTE:  Any changes you make in your .MNU or
  211.                               .ANS/.ASC menus should also be made in
  212.                               your .PDM files.
  213.  
  214.          
  215.                                              VBBS 6.11 Documentation -- 7-5
  216.  
  217.  
  218.  
  219.                 Creating your own .MNU menus is simple enough: after 
  220.          making backups of the original menu files (just in case), use 
  221.          your favorite drawing program (or even a text editor capable of 
  222.          handling "extended ASCII" characters, although this is a LOT 
  223.          more work) to make an ASCII menu file.  To add the color 
  224.          changes you want, pull the file into the VBBS FSE and use 
  225.          heart codes to add color (as described earlier).
  226.  
  227.          ╔═╗    Menus are a great means of customizing your BBS.  They're
  228.          ╚═╝    also the primary method by which a user interacts with
  229.                 your BBS, so you want to design menus that are as func-
  230.                 tional as possible.  Please note that complete script/
  231.                 function block/menu/pdm packages emulating the look and
  232.                 feel of several other bbs softwares have been developed.
  233.                 The most notable of these is MVMEN by David Bell with
  234.                 emulations of WWIV, Remote Access, WildCat, Renegade, and
  235.                 others, in addition to multi-language VBBS modules.
  236.  
  237.  
  238.          Function Blocks
  239.          ═══════════════
  240.  
  241.                 At the heart of VBBS' command structure is the FUNCTION
  242.          BLOCK, which is in turn represented by a menu.  A function block
  243.          is an easy-to-modify ASCII file which allows the sysop to define 
  244.          every single function of any menu -- what each key does, whether 
  245.          it is calling an internal function, an external VSCRIPT, external
  246.          .EXE file (shrinking or not shrinking VBBS out of memory as de-
  247.          sired), or calling another function block.
  248.                 Creating and editing function blocks may be done with any
  249.          ASCII text editor; the resulting files should be placed in the 
  250.          VBBS \V or \VSCRIPT directory you have set up in VCONFIG.  
  251.  
  252.          For example, for your FILES.FB, the first line of the function
  253.          block might now read FILE1.  This would instruct VBBS to display 
  254.          a menu file called FILE1.MNU, FILE1.ANS, FILE1.ASC, or FILE1.PDM
  255.          (depending on which menuing scheme you're using and the user's 
  256.          default display setting).  Similarly, your START.FB might call
  257.          up the MAIN.xxx menu file, while your SYSOP.FB might call up the
  258.          SYSOP1.xxx menu file.
  259.                 The second line holds the letter designators of any topic
  260.          areas that "go with" the function block.  For example, if you
  261.  
  262.                                              VBBS 6.11 Documentation -- 7-6
  263.  
  264.          have message topic areas A, B, C, and D, the second line of your
  265.          START.FB should read
  266.  
  267.                 ABCD
  268.  
  269.          Otherwise, your users would only see ONE topic area; the "A"
  270.          topic that came preconfigured as a default.  Many new sysops for-
  271.          get to add these other topic designators in; it's not difficult
  272.          to overlook this, even though it IS crucial.
  273.  
  274.                 Each subsequent line of a function block enables a "hot-
  275.          key" to perform a particular command or function.  Lines in the
  276.          "body" of a function block MUST follow this particular format
  277.          and appear in strict columns:
  278.  
  279.                 k xxx y cccccccccccc
  280.  
  281.          An explanation is given below.
  282.  
  283.          Part   Column(s)  Explanation
  284.          ─────  ─────────  ────────────────────────────────────────────
  285.          k          1      The letter or symbol serving as the hot-key
  286.          xxx       3-5     The minimum SL needed to access the function 
  287.                              (must be three digits, like "050" or "007")
  288.          y          7      The command type (a digit 0-5; more on that 
  289.                              below)
  290.          cccccc     9+     The name of the routine/script/.EXE command 
  291.                              line, etc.; this section is of variable 
  292.                              length, depending on what you're trying to 
  293.                              do.
  294.  
  295.                 The "y" in the command line represents a digit from 0
  296.          through 5 that tells VBBS how to execute the command, according
  297.          to the following list:
  298.  
  299.          Digit  Command-type Description                               
  300.          ─────  ───────────────────────────────────────────────────────
  301.            0    Null (no operation)
  302.            1    Internal command (like SENDEMAIL)
  303.            2    Script
  304.            3    DOS function (don't shrink VBBS out of memory)
  305.            4    DOS function (shrink VBBS out of memory)
  306.            5    Transfer control to a different function block
  307.  
  308.                 A sample function block to handle E-mail might look some-
  309.          thing like this (without the parts inside angle-brackets):
  310.  
  311.                 EMAIL           <name of menu file>
  312.                                 <no database attached; E-mail's automatic>
  313.                 e 001 1 sendemail
  314.                 m 001 1 reademailto
  315.                 f 001 1 feedback
  316.                 s 001 1 reademailsent
  317.                 q 000 5 start   <on quitting, return to START.FB>
  318.  
  319.                                              VBBS 6.11 Documentation -- 7-7
  320.  
  321.  
  322.          The Default START.FB
  323.          ────────────────────
  324.  
  325.                 VBBS could easily have been distributed with a blank menu;
  326.          instead, a default START.FB is included which reflects the con-
  327.          figuration of the software on the author's BBS, "Virtual Techno-
  328.          logies".  Note the columnation at the beginning of each line and
  329.          the topic-area designator on the second line.  Other points of
  330.          interest include:  1) the 255 SL required to transfer control to 
  331.          the SYSOP.FB function block; 2) the VBBS-AUX commands that shrink
  332.          the BBS out of memory to execute the associated program; and 3)
  333.          the nonalphabetic characters used as hot-keys.
  334.  
  335.                 MAIN
  336.                 A
  337.                 $ 001 1 choosetopic
  338.                 > 001 1 nextbase
  339.                 < 001 1 prevbase
  340.                 c 001 1 selectbase
  341.                 j 001 1 setquickscan
  342.                 s 001 1 scanmsg
  343.                 n 001 1 readnewmsg
  344.                 r 001 1 readseqmsg
  345.                 p 001 1 post
  346.                 e 001 1 sendemail
  347.                 y 001 1 reademailfrom
  348.                 m 001 1 reademailto
  349.                 q 001 1 quickmail
  350.                 f 001 1 feedback
  351.                 o 001 1 door
  352.                 z 001 4 vbbs-aux %1 telecon
  353.                 d 001 1 account
  354.                 l 001 1 pagesysop
  355.                 t 001 5 files
  356.                 b 001 4 vbbs-aux %1 textfiles
  357.                 k 001 1 listcallers
  358.                 u 001 4 vbbs-aux %1 listusers
  359.                 a 001 1 autopost
  360.                 v 001 4 vbbs-aux %1 vote
  361.                 i 001 1 sysinfo
  362.                 w 001 1 who
  363.                 x 001 4 vbbs-aux %1 listnet
  364.                 * 255 5 sysop
  365.                 g 000 1 logoffyn
  366.  
  367.                 Making changes is as simple as pulling the START.FB file
  368.          into a text editor (even the VBBS FSE, from WITHIN the board!)
  369.          and adding in the desired function(s).  For example, you might
  370.          add in the following line to invoke a script that shows a user
  371.          his/her credit total:
  372.  
  373.                 # 001 2 crcheck
  374.  
  375.          Notice that all this is presented in lower-case; function blocks
  376.          are NOT case-sensitive, so the number of commands you may have
  377.  
  378.                                              VBBS 6.11 Documentation -- 7-8
  379.  
  380.  
  381.          is limited to 26 letters + 10 digits + however many punctuation
  382.          and nonalphabetic characters you can come up with (of course, if
  383.          any FB ever gets that big, you'll probably want to split it into
  384.          smaller chunks anyway).
  385.  
  386.          ╔═╗    If you start breaking your function blocks into smaller
  387.          ╚═╝    pieces, it's important to choose letter commands -- "hot
  388.                 keys" -- in such a way that commands will be consistent
  389.                 across menus.  For example, if you have the [M] key set
  390.                 to jump to the Message Menu in one function block, try
  391.                 to make it do the same thing in ALL function blocks.
  392.                 This may not be easy, but your users will appreciate not
  393.                 having to learn a different set of hotkeys at each menu.
  394.  
  395.  
  396.          The Default FILES.FB and SYSOP.FB
  397.          ─────────────────────────────────
  398.  
  399.                 There are two other default function blocks: FILES.FB,
  400.          which governs the file transfer section(s), and SYSOP.FB, which
  401.          contains the commands for the sysop function block.  These func-
  402.          tion blocks are shown below:
  403.  
  404.          FILE1                          SYSOP1
  405.          F
  406.          g 000 1 logoffyn               m 255 1 readallemail
  407.          m 001 1 dlmasterlist           e 255 1 editfile
  408.          u 001 1 remoteupload           u 255 1 useredit
  409.          d 001 1 downloadfile           s 255 4 vbbs-aux %1 security
  410.          r 001 1 reviewfile             v 255 1 validate
  411.          c 001 1 selectbase             c 255 1 cleanup
  412.          j 001 1 setnewfilesscan        q 000 5 start
  413.          l 001 1 listfiles
  414.          n 001 1 newfiles
  415.          s 001 1 searchall
  416.          b 001 1 batchdl
  417.          f 001 1 findfiles
  418.          > 001 1 nextbase
  419.          < 001 1 prevbase
  420.          p 001 1 topdownloads
  421.          y 001 1 ratio
  422.          z 255 1 sysopupload
  423.          x 255 1 reviewuploads
  424.          q 000 5 start
  425.  
  426.  
  427.          One change to FILES.FB you might want to try right off the bat
  428.          -- if you have more than one files area and want to fiddle with
  429.          the function blocks (and if Roland hasn't added it in as a de-
  430.          fault command yet) -- is to add in this line:
  431.  
  432.                 $ 001 1 choosetopic
  433.  
  434.          No compilation is necessary ... just save it, and the the [$]
  435.          command to move between files topic areas is enabled, just like
  436.  
  437.                                              VBBS 6.11 Documentation -- 7-9
  438.  
  439.  
  440.          in the message bases!  Make sure, though, that you add the com-
  441.          mand in your menus so your users can take advantage of it.
  442.  
  443.                 Rearranging the commands in function blocks isn't that
  444.          difficult -- it's just a matter of making sure you don't leave
  445.          out any commands.  For example, I have separate function blocks
  446.          for the Main Menu (12 whole commands!), E-mail, transfers, and
  447.          subsystems, coupled with the ability to jump between FBs with
  448.          one keystroke.  Of course, my menu structure is quite different
  449.          from the default setup -- but that's the beauty of VBBS.  It
  450.          didn't blink an eye when I installed the changes!
  451.                 One caveat, however: your main function block MUST be
  452.          called START.FB.  It is the function block that takes over when
  453.          the START.V script finishes running.
  454.  
  455.  
  456.          Scripts and Mods
  457.          ════════════════
  458.  
  459.                 As stated earlier, the term "scripts" refers to programs
  460.          written using VSCRIPT and compiled using the program VCOM.EXE;
  461.          "mods" refers to source-code modifications (just a reminder).
  462.  
  463.                 The VSCRIPT language is one of the most powerful features
  464.          of VBBS (if not THE most powerful).  It's a small programming
  465.          language, somewhat similar to the REXX script language, that 
  466.          incorporates many of VBBS' functions into single command state-
  467.          ments (with or without command-line arguments).  All it takes 
  468.          is your favorite ASCII text editor or word processor and some 
  469.          familiarity with the VSCRIPT language (that's a separate part 
  470.          of the documentation; see Chapter 10  for details), and you can
  471.          be customizing your BBS via scripts in no time.
  472.                 As an example, let's take the script mentioned earlier
  473.          that allows users to check their credits.  It consists of only
  474.          three lines:
  475.  
  476.                 tr
  477.                 tr "You currently have " $credits " credits."
  478.                 tr
  479.  
  480.          Save this file in your \V or \VSCRIPT directory (as you have it
  481.          configured in VCONFIG) under the name CRCHECK.V (to maximize
  482.          efficiency, you might want to keep a copy of VCOM.EXE in this 
  483.          directory as well).  Compile the script:
  484.  
  485.                 VCOM CRCHECK.V
  486.  
  487.          and you will see two NEW files in the directory:  CRCHECK.COD
  488.          and CRCHECK.LIT.  These are the files VBBS will look for when
  489.          you execute the script from the function block in which it's
  490.          placed.
  491.                 There are literally dozens, if not hundreds, of VSCRIPT-
  492.          based applications available through VirtualNET (more about that
  493.          later).  Some enterprising programmers have created casino games,
  494.          alternate mail and voting routines, scripts to welcome new users
  495.  
  496.                                              VBBS 6.11 Documentation -- 7-10
  497.          
  498.  
  499.          and take them on a tour of the BBS, show user information ... 
  500.          it's difficult to describe the variety of scripts that have been 
  501.          written by sysops and users alike!  
  502.  
  503.                 VBBS may also be modified through direct changes to the
  504.          source code, a process known as "source modding" or simply "mod-
  505.          ding".  This DOES require that you have a copy of either Micro-
  506.          soft's QuickBASIC compiler (version 4.5 or later). The "QBASIC"
  507.          that comes with MS-DOS is NOT sufficient for this purpose.
  508.                 
  509.                 VBBS employs a mixed programming environment using assem-
  510.          bly-language routines for fast COM port and program I/O, while
  511.          using QuickBASIC as an affordable and easy-to-modify environment.  
  512.          This is in sharp contrast to many other BBS softwares, which re-
  513.          quire a knowledge of Pascal or C and their associated compilers.
  514.          It should be noted here, however, that in order to keep the 
  515.          source-code files from being too large, there are very few com-
  516.          ments in the default program; this can make for an -- <ahem!> -- 
  517.          INTERESTING time when you're looking for a particular routine or 
  518.          section of the code.  Just thought we'd let you know in ad-
  519.          vance ...!  :-)
  520.  
  521.          ╔═╗    Some helpful hints to make your source modding easier:
  522.          ╚═╝
  523.                 1) Make backup copies of the existing source code.  It
  524.                    might save you truckloads of grief later.
  525.                 2) Print out the source code (make a pot of coffee or
  526.                    something while you do ... it takes a while) and read
  527.                    through it BEFORE you start modding.  The files are
  528.                    simply too complex to try to keep up with on a screen-
  529.                    by-screen basis.  Highlighting's much easier, too; my
  530.                    source-code printout has so much red ink on it that it
  531.                    looks like a bad high-school English paper.
  532.                 3) Make sure you're thoroughly familiar with the functions
  533.                    and commands of VBBS; this will make it easier to spot
  534.                    their associated source routines.
  535.                    
  536.          --> IMPORTANT NOTE:  Access to the QB4.5 DOS source code is
  537.                               governed by a specific licensing agreement.
  538.                               You may not possess any portion of the source
  539.                               without having obtained a license to do so 
  540.                               from the VBBS author, and in no case shall 
  541.                               more than 100 lines of VBBS code be con-
  542.                               tained within a published modification at
  543.                               any time.
  544.  
  545.          ▒▒ OS/2 Version   :  Please note that source code is not made
  546.                               available for source modding. Full scripting
  547.                               is possible.
  548.  
  549.                                              VBBS 6.11 Documentation -- 7-11
  550.  
  551.  
  552.          Scripts and Mods on VirtualNET
  553.          ──────────────────────────────
  554.  
  555.                 Once your BBS is a VirtualNET node (more on that in a
  556.          bit), there are many message subs dedicated to VBBS scripts
  557.          and mods.  Two main subs are:
  558.  
  559.                        VBBS Script Technical Support
  560.                        VBBS Source Technical Support
  561.  
  562.          The "VBBS Script Technical Support" sub is for the discus-
  563.          sion of scripts and mods -- questions, troubleshooting, and the
  564.          like.  The "Virtual ModNET" is EXCLUSIVELY for the posting of
  565.          script/mod code -- no discussion.
  566.  
  567.          System Taglines
  568.          ═══════════════
  569.  
  570.                 Many sysops whose BBSs are part of VirtualNET like to
  571.          "personalize" posts originating from their system by adding a
  572.          system tagline to the posts.
  573.                 System taglines are optional; if they are used, however,
  574.          they must follow several guidelines:
  575.  
  576.                 1) They must include the name of the BBS, its geo-
  577.                    graphic location, VirtualNET node number, and
  578.                    version of VBBS being used;
  579.                 2) They must be 3 lines or less AND 300 bytes or
  580.                    less (i.e., a 3-line, 350-byte tagline is NOT
  581.                    acceptable);
  582.                 3) They must be colorized using ONLY heart-code 
  583.                    ANSI (no "raw" ANSI allowed).
  584.  
  585.                 Creating a system tagline is similar to creating a new
  586.          menu; you make and save an ASCII version of the tagline, then
  587.          bring it into the VBBS FSE to colorize it with heart codes.
  588.          Since any experimental color changes are also saved with the
  589.          tagline, it's usually a good idea to use your ASCII text edi-
  590.          tor to delete any unnecessary color changes after you've got
  591.          your tagline looking the way you want it.
  592.                 Taglines reside in your \TXT directory under the name(s)
  593.          TAGLINE.xxx, where "xxx" is a number from 1 to 999.  It should
  594.          be noted that single- or double-digit extensions to these files
  595.          should be just that, i.e., TAGLINE.1 or TAGLINE.22, and not
  596.          TAGLINE.001 or TAGLINE.022.
  597.  
  598.          ╔═╗    A word or two on system taglines:  they should be as dis-
  599.          ╚═╝    tinctive as possible without being gaudy or distracting
  600.                 from the body of the message.  "Eyesore" taglines are 
  601.                 sometimes the butt of jokes on VirtualNET.  In addition, 
  602.                 some sysops try to cram every bit of information they
  603.  
  604.                                              VBBS 6.11 Documentation -- 7-12
  605.  
  606.  
  607.                 can about their systems into their taglines; this is 
  608.                 frequently viewed as being distracting, and in general, 
  609.                 a "less-is-more" approach is best advised.  If you want 
  610.                 to advertise your huge file base or the 42 game doors
  611.                 your system currently has, it's usually better to make 
  612.                 a BBS ad for the "BBS Advertisements" sub instead
  613.                 of trying to cram this information into your tagline.
  614.  
  615.  
  616.          R.I.P. Remote Imaging Protocol GUI Interface
  617.          ════════════════════════════════════════════
  618.  
  619.                 VBBS is now compatible with R.I.P. graphic standards.
  620.          RipTerm is an optional mouse-driven terminal program which
  621.          interfaces with VBBS.  R.I.P. supports user's-end VGA graphics
  622.          (sorry, no VGA locally -- the "overhead" local VGA would intro-
  623.          duce would be of truly epic proportions) and is icon-driven.  As
  624.          of this writing, a number of communication programs now
  625.          support R.I.P. graphics.
  626.                 Details on R.I.P.may be found in the documentation that ac-
  627.          companies the RipTerm Program. Adding R.I.P screens is yet
  628.          another way you can customize your VBBS installation, and the
  629.          early reviews are enthusiastic, to say the least!
  630.  
  631.                 As you can see, there are quite a few ways you can cus-
  632.          tomize your VBBS to get exactly the "look-and-feel" you want.
  633.          It's pretty much a case of you being limited only by your imagi-
  634.          nation.  You can make the graphics, menus, and command structure
  635.          as simple or complex as you want them.  Just keep in mind that
  636.          when you make changes to your user interface, it should be to
  637.          make your users' lives easier, NOT to push everything to the
  638.          max for the sake of doing it.
  639.  
  640.