Scoop allows three types of file uploads. To have any file uploads at all, the variable allow_uploads must be turned on. The different types of uploads are given to specific user groups using Scoop's permission system.
Story text uploading allows users to write stories in their favourite program and upload the text file when posting the article; the uploaded file is then placed into the ``Extended Copy'' textarea on the submit story form when they preview. The file is not displayed in the previewed story until they preview again, it is only placed in the ``Extended Copy'' textarea.
If a file is uploaded when there is already content in the ``Extended Copy'' textarea, the content is replaced with the contents of the file. This can be useful for long articles when the author sees errors when previewing; the author can fix the error in the external program, save the file, then re-upload the corrected file and preview.
Permission to upload files into the submit story form is given using the perm upload_content in the Groups Admin Tool. This feature is given on a per-group basis.
File upload gives the user their own directory on the server where they can upload any file, subject to the limits imposed by the admin on upload size and total directory size.
Each user has his own directory and can only change his own directory, but all users can browse a user's files through the files link on the user info page.
To set up the upload area, the variable upload_path_user must be set to an absolute local path. Apache must have full write permissions to the directory, so it can manage files in it. The directory must also be accessible from outside via the web. The variable upload_link_user must be set to an absolute external path or URL, the external address of the directory named in the previous variable. The directory named in the above two variables is used as a base directory; each user gets a subdirectory for his own files.
Permission to use the upload area is given using the perm upload_user in the Groups Admin Tool. This feature is given on a per-group basis.
The variables upload_delete and upload_rename determine whether or not users with permission to use the upload area can also delete and rename their files, respectively. Since the file upload feature can be used to store files used by the user in stories published on the site, refusing to allow the user to delete or rename uploaded files can prevent broken links within the site.
To set file size and disk space limits, the variables upload_max_file_size and upload_user_quota are set to a positive number. In both cases, a value of zero disables the size limits and allows any size file to upload.
The admin upload area is a shared upload directory. Each user with permission to manage this directory sees the same set of files. Permission to use the admin upload directory is given using the perm upload_admin in the Groups Admin Tool. This permission should only be given to administrative users, such as those in the Admin or Superuser groups.
To set up the upload area, the variable upload_path_admin must be set to an absolute local path. Apache must have full write permissions to the directory, so it can manage files in it. The directory must also be accessible from outside via the web. The variable upload_link_admin must be set to an absolute external path or URL, the external address of the directory named in the previous variable.
The variable upload_max_file_size applies to admin uploads as well as user uploads.