F
i
l
e

m
a
n
a
g
e
r

Introduction

The file manager enables user access to files and provides various functionality. The user’s level determines which folders they can browse and what permissions they have in each folder.


Accesing the file manager

When editing a page, use the "File Browser" button to open the file manager.


Controls and icons

Top bar

  1. Toggle view of folder tree
  2. Jump to root folder (this will be different depending on user permissions)
  3. Jump to user folder (in current year and month)
  4. Create folder (you may enter "multi/folder/path")
  5. Upload files - click button or drag and drop
  6. Overwrite status (if red, uploaded files will overwrite existing files of the same name)
  7. Current location in folder tree
  8. View options - view only images, only documents or both
  9. Toggle between list and grid view

Bottom bar

The contents of the bottom bar change slightly depending on the use of the file manager.

If a single file is selected, the path to that file (from the domain) is displayed. 

There will also be buttons allowing functionality, such as inserting an image into the page editor and closing the file manager.


Editing files and folders

Hover over a file or folder to view its edit options (these will vary depending on file type and user permissions).

Possible options are,

  • Edit (images only)
  • Rename 
  • Delete


Folder structure

Folders are created as needed so the initial structure is empty. Once files are uploaded the structure will be formed as follows

 - Organisation root
   - users
     - user[user_id]
       - [year]
         - [month]

User folders are named “user” followed by the user ID, for example “user1375”. Within each user folder is years named with 4 digits “2017” then months named with two digits “07”.

Folders can be added as needed (providing the user has suitable permissions) to build on the basic structure.


Hi resolution images

By default, images are scaled down if above 1024x1024px. Scaling can be disabled by adding a folder named "hi-res". Any image uploaded into a "hi-res" folder (or any folder that is a descendent of a "hi-res" folder) will not be scaled down.


Secure files

To control users access to files, place them under a folder named "secure". All files in this folder, and its sub folders, will be checked before being served to the user.

Secure files require a related object to exist on the system. The object must have it's 2nd datatype set as one of the following,

  • URL
  • Image URL
  • Audio URL
  • Video URL
  • Flash URL
  • Document URL

The system will check the user's permission on the object and return the file if allowed.

The entry in the URL field should not include the domain, just the file path including the initial forward slash, for example "/res/org99/secure/secret.jpg".


User permissions

User permissions are defined as follows,

User level User folder Organisation root
view upload rename edit delete view upload rename edit delete
Very advanced
Advanced
Standard
Restricted
below Restricted*

* Users with a level below Restricted only have access to the current month folder, they cannot navigate into other months or years.

In some cases, use of the file manager specifies a 'force folder'. In this situation, all users start in the specified folder and cannot navigate up beyond the 'force folder'. User persmissions are as follows,

  • View/upload - All users
  • Rename/edit - Advanced and above
  • Delete - Very advanced and above