home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / programme / trionbbs110 / Trion / docs / 06_Groups.doc < prev    next >
Encoding:
Text File  |  1998-10-06  |  5.5 KB  |  179 lines
  1.  
  2.  
  3.   Introduction
  4.   ------------
  5.  
  6.    This chapter discusses the mail and file groups, which are
  7.    sub lists of sections, so that you can read new mail in
  8.    a group of sections with one command.
  9.  
  10.  
  11.   History
  12.   -------
  13.  
  14.    Had a real long think about how to do it RIGHT and implemented
  15.    more or less optional Group support. Groups (of mail or
  16.    file sections) could be easy if you have many sections.
  17.    It would be easier if a (sub) list of sections would fit
  18.    on one screen. Or why should an PC user see all the new
  19.    Amiga files (and vice versa).
  20.  
  21.    From what I have seen from systems as RemoteAccess and FrontDoor
  22.    (MS-DOS programmas I toyed with more then half a decade ago)
  23.    every sections has a character (a-z) to indicate to which group
  24.    they belong.
  25.    Which has its drawbacks, I have to change all programms because
  26.    the way sections are dealt with are changed, and what if you have
  27.    a Fido-netmail section, do you add it to the net-mail group or
  28.    to the Fido (echomail) group ?? Well .. wouldn't both be nice.
  29.    Or what if you would make a group with all programming sections
  30.    of all the mail nets you get.
  31.    Or how about a group with ALL sections, which is also
  32.    usefull for people (users or sysops) who don't want to use groups.
  33.  
  34.    So I added Group Support to TrionRM, programms that require
  35.    this option can get the information they need from TrionRM.
  36.    (Which is basically a couple of "Get Group Info" commands like:
  37.     GetFirstGroup, GetNextGroup, GetGroupOnNumber)
  38.  
  39.    With this system, the support for groups is separated from the
  40.    support for file and message sections. So nothing has to be
  41.    changed to programms like the mail processor, Areafix (which
  42.    has its own group system) and Allfiles.
  43.  
  44.    Also because of the way the BBS is written this system was
  45.    very easy to implement. Altough the code in the BBS programm
  46.    itself for messages and files is like 100KB+ C-code each.
  47.    The BBS programm uses a few functions to get the first
  48.    and next section to process. This is done because there
  49.    has to be checked if a user has access to a section.
  50.    For groups this access checking had to be extended with
  51.    group checking.
  52.  
  53.    When you don't want to Use groups you don't have to change
  54.    a thing. When there isn't a "trion:cfg/groups.cfg" (or
  55.    when there isn't a file or msgs group in the cfg) the system
  56.    makes an "All" group with all sections and the system should
  57.    work as before.
  58.  
  59.    Also you could use the system as before and use groups in
  60.    an other menu. If you have made ANSI screens to select
  61.    sections you probably don't need groups.
  62.  
  63.  
  64.   Menu commands for groups
  65.   ------------------------
  66.  
  67.     ListFileGroups         (like: ListFileAreas)
  68.     OtherFileGroup         (like: OtherFileArea)
  69.     ChangeFileGroup "n"    (like: ChangeFileArea)
  70.  
  71.     ListMessageGroups      (like: ListMessageAreas)
  72.     OtherMessageGroup      (like: OtherMessageArea)
  73.     ChangeMessageGroup "n" (like: ChangeMessageArea)
  74.  
  75.  
  76.  
  77. Cmd "G"
  78.    ClrScr
  79.    ListFileGroups
  80.    OtherFileGroup
  81.  
  82.    ClrScr
  83.    ListFileAreas            ;Or PrintFile "trion:text/FileAreas.ansi"
  84.    OtherFileArea
  85.    LogMessage "Changed to file area: ~301."
  86. EndCmd
  87.  
  88. Cmd "A"
  89.    ClrScr
  90.    ListFileAreas
  91. ;   PrintFile "trion:text/FileAreas.ansi"
  92.    OtherFileArea
  93.    LogMessage "Changed to file area: ~301."
  94. EndCmd
  95.  
  96. Cmd "O"
  97. ;   ClrScr
  98. ;   ListFileAreas
  99.    PrintFile "trion:text/FileAreas.ansi"
  100.    OtherFileArea
  101.    LogMessage "Changed to file area: ~301."
  102. EndCmd
  103.  
  104.  
  105.  
  106.  
  107.     When you want to use Groups you could add the ListFileGroups
  108.     and OtherFileGroup command to the "other area" command 
  109.     sequence in a menu. If you don't you get in the first group.
  110.  
  111.     When you want to make groups optional you could make a new command
  112.     to change Groups and leave the Change area command as before.
  113.     When the user logs in he is in the "All" groups and doesn't
  114.     have to choose a group.
  115.  
  116.     Or when you really want to annoy users you put the ListGroups
  117.     and OtherGroup command before the NewFileScan when a user logs
  118.     in. 
  119.  
  120.  
  121.    TildeCodes for groups
  122.    ---------------------
  123.  
  124.       ~350                  File Group number
  125.       ~351                  File Group name
  126.       ~352                  Messages Group number
  127.       ~353                  Messages Group name
  128.  
  129.  
  130.  
  131.  
  132.    Configuration
  133.    -------------
  134.  
  135.     The "trion:cfg/groups.cfg" is very simple.
  136.  
  137.     Just have a FILEGROUP or MAILGROUP line folowed with one
  138.     or more SECTIONS lines.
  139.     After a group line you put a group number and a group name
  140.     (separated with a comma !!!).
  141.     Check the suplied config for reference.
  142.  
  143.  
  144. FILEGROUP    1 , "All"
  145. SECTIONS     1 - 65535
  146.  
  147. FILEGROUP    2,  "Amiga-files"
  148. SECTIONS     1 - 15 , 20 - 59
  149.  
  150. FileGroup    3,  "PC-files"
  151. Sections     1 - 15 , 60 - 99
  152.  
  153.  
  154.  
  155. MAILGROUP    2 , "Sections on programming"
  156. SECTIONS     11, 111, 211, 311, 411, 511
  157. SECTIONS     611, 711, 811
  158.  
  159.  
  160.     It's important to have the Group "All" as first in the group
  161.     list to have the system operating as before.
  162.  
  163.  
  164.     Have an upload area in every file group (which can of cause
  165.     be the same area in all groups).
  166.     Note that if you are in a group all the global commands, like
  167.     newfiles or readGlobalNew work only on the sections in the
  168.     current group but you can go to all sections with change
  169.     sections commands. So you can put the ListGroups and
  170.     OtherGroup command before the newfiles command and the
  171.     user only sees the files he is really interested in.
  172.  
  173.  
  174.     You probably also want a menu command to change area without
  175.     having to change the group. (which is basically a command
  176.     like you have in use now).
  177.  
  178.  
  179.