This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
2018-05-14 09:08:22 +10:00

55 lines
2.2 KiB
Markdown

# 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
[Area One]
Database = area_one
Download Sec Level = 10
Upload Sec Level = 99
Upload Path = /path/to/MagickaBBS/files/area_one
[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** is the security level required to view the directory.
**Visible On Web** is either true or false if you want it visible and the files downloadable via the website.
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.
## 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.