===== File Area Setup =====

File directories and subdirectories are similar to message conferences and
areas to set up in that they have a main section followed by sections
describing each subdirectory.

## Example Config

    [main]
    Visible Sec Level = 10
    Visible On Web = false
    Visible Req Flags = someflag anotherflag
    Visible Not Flags = thirdflag

    [Area One]
    Database = area_one
    Download Sec Level = 10
    Upload Sec Level = 99
    Upload Path = /path/to/MagickaBBS/files/area_one
    Download Req Flags = someflag
    Download Not Flags = anotherflag
    Upload Req Flags = thirdflag
    Upload Not Flags = someflag

    [Area Two]
    Database = area_two
    Download Sec Level = 10
    Upload Sec Level = 99
    Upload Path = /path/to/MagickaBBS/files/area_two

In the main section variables apply to the whole directory, 

  * Visible Sec Level
  
  This is the security level required to view the directory.

  * Visible On Web

  This is either true, false or authenticated if you want it visible and the
  files downloadable via the website.

  * Visible Req Flags

  Required flags (seperated by space) that a user needs to see this file
  directory. (Not required)

  * Visible Not Flags

  Required flags a user must not have to see this file directory. (Not 
  Required)

The section name for the sub-directory is the name of the sub directory.

  * Database
  
  is the name of the database that stores the information of the files, it is
  stored in the main BBS directory. No extension is required.

  * Download Sec Level
  
  This is the security level required to download files from the subdirectory.

  * Upload Sec Level
  
  This is the security level required to upload files to the subdirectory.

  * Upload Path
  
  This is the directory in which uploads are stored for the subdirectory, make
  sure it's writable for the BBS.

  * Upload Req Flags

  Flags required by a user to be able to upload in this directory. (Not 
  Required)

  * Upload Not Flags

  Flags a user is required not to have to be able to upload in this directory.
  (Not Required)

  * Download Req Flags

  Flags required by a user to be able to download from this directory. (Not 
  Required)

  * Download Not Flags

  Flags a user is required not to have to be able to download in this 
  directory. (Not Required)

==== Uploading Files ====

When a user (or the sysop) uploads a file, they are not *approved* by default,
so they will not be shown in the listings. To approve uploaded files, the
sysop should run the filecenter utility on the database.

    cd utils/filecenter
    ./filecenter -c ../../config/bbs.ini

This will list all the files in the database, and allow the sysop to toggle
the approved status, or remove the file entirely.

==== Mass Uploading ====

If you have a directory full of files you want to upload, you can use the
massupload perl script. This script will upload and approve all files in a
folder, and if they are ZIP files check for file_id.diz files and import them
into the description.

    ./utils/massupload/massupload.pl /path/to/MagickaBBS/files/area_one area_one.sq3

Note that you must use the FULL path of the directory the files are in.
.