Difference between revisions of "File Management Plugin"

Latest revision as of 15:38, 13 May 2009

Intro

The File Management Plugin is created by Blaine at Portal Parts. This plugin allows you to easily administer files which are available for download through your site. For installation instructions, please refer to the Readme file included with the plugin.

Accessing The File Management Plugin

After the plugin has been installed, you can access it administratively by:

1. Logging into your website as an administrator.
2. Clicking the Filemgmt Admin link in the Admins Only block.

The files in the File Management Plugin can be accessed through: http://www.example.com/filemgmt/

Settings

The Settings for the File Management Plugin can be changed by:

1. Logging into your website as an administrator.
2. Clicking the Filemgmt Admin link in the Admins Only block.
3. Clicking the Settings link.
4. Making your changes.
5. Clicking the Save button.

The options are self-explanatory. Remember that the "upload" option is related to files being added, not files being accessible. If you created the folders exactly as instructed in the installation instructions (i.e. if you did not create folders in a different location and/or with a different name), you should not need to change the directory or URL paths.

Categories

The form for adding categories, adding sub-categories and changing categories (including deleting them) are all on the same page. To access this page:

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Categories link.

Adding A Category

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Categories link.
4. Type the category name in the Title field under Add MAIN Category.
5. If you want an image associated with the category, click the Browse button to search for and select the image from your computer.
6. Click the first Add button (the one under Add MAIN Category).

Adding A Sub-Category

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Categories link.
4. Type the category name in the Title field under Add SUB-Category.
5. Select the main category to which the sub-category belongs.
6. Click the first Add button (the one under Add SUB-Category).

Modifying A Category

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Categories link.
4. Under Modify Category, select the category you want to modify.
5. Click the Modify button under Modify Category.
6. Make your changes.
7. Click the Save Changes button.

Deleting A Category

Warning: When you delete a category, all the files within the category are also deleted. If you want to keep the files, move them to another category firstly!

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Categories link.
4. Under Modify Category, select the category you want to delete.
5. Click the Modify button under Modify Category.
6. Click the Delete button.
7. You will get a pop-up asking you whether you want to delete the category.
8. Click the OK button to confirm.

Adding Files

Adding Files As An Administrator

If you add a file as an administrator, you will not need to approve the file firstly. To do this:

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Add File link.
4. Complete the form. The first three fields should be completed.
5. Click the Add button.

Adding Files As A Member

Members who do not have administrative access to add files directly need to submit them for approval firstly. This feature must be activated in the Settings before it can work. To do this, they must:

1. Log into the website (unless you allow anonymous uploads, which is not suggested).
2. Click the Upload A File link in the User Functions block.
3. Complete the form. The first three fields should be completed.
4. Click the Submit button.

Approving Files Submitted By Members

Files submitted by members who do not have administrative access to the site must be approved before they are included. You can also change the settings to disable this option or to enable or disable an automatic email to the member once their file is approved. Currently there is no option to automatically send an email when the file is declined.

To approve/decline a file:

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Downloads link. The link will have a number after it if there is a file waiting to be approved.
4. If necessary, you can make changes to the submission either at this point or after the file has been approved. There is also the option to download the file prior to approving it.
5. To approve the file, click the Approve button. To decline the file, click the Delete button.

Managing Broken Files

Members can report broken files through the File Management Plugin. Administratively, you can currently either ignore the report or delete the file. Ignore allows you to ignore the report and only deletes this reported entry. Delete allows you to delete the reported file entry in the repository but not the actual file.

To manage the reports:

1. Log into your website as an administrator.
2. Click the Filemgmt Admin link in the Admins Only block.
3. Click the Broken Files link. The link will have a number after it if there are reports.
4. Click the red X icon under the Ignore or Delete options to match your desired action. The Title is hotlinked so you can click on it to confirm the report. The Report Sender and Submitter names are also hotlinked so you can be taken to their profile.

Editing & Deleting Files

To edit or delete files, you must access the files through http://www.example.com/filemgmt/

Find the file you want to edit or delete, click on the Edit link associated with it, and make the appropriate changes.