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.
[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.
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)
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.
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.