fbpx

Dropfiles: Parameters

1. Main parameters

To access to Dropfiles parameters, go in Component > Dropfiles > Settings / Options. There are 3 tabs inside the Main Settings: Admin, Frontend and Advanced.

Admin tab

In option, you can define:

  • Allowed extensions: the file format you want to authorize on your website to be uploaded/downloaded
  • Max upload file size: it's set by your server php.ini value. You can define a lower limit here
  • Category owner: Add user as Category owner
  • Category restriction: apply file access restriction on file category using Joomla User group or Joomla access level
  • Single user restriction: add the possibility to select a single Joomla user to access a category or multiple users to view a file
  • Close categories: the option to load categories accordion open or closed by default
  • File importer activation: activate a server explorer to import files in Dropfiles categories
  • Use WYSIWYG editor: load a full text editor for file description
  • Add remote file: the possibility to add remote files among other (not hosted on your server)
  • Versioning number: Dropfiles stores history of files when you update it, you can setup the number of files to backup (0-100: limit per file)

 

settings-admin-tab

 

Frontend tab

  • Extensions preview: Extensions to open with Google Document viewer, otherwhise the preview button won't be diplayed
  • Open PDF in browser: to open PDF in a new browser tab instead of the Google drive viewer
  • User viewer: Use Google Documents viewer for file preview
  • SEO URL: The root URL used for file download, ex. files/myfile.zip
  • Date format: Upload and modified file date format
  • Load theme in category: load the theme selection and theme option in each file category
    If it's set to No, the default theme settings from the options apply
  • Download category: Allow users to download all the files or selective files from a category as a global .zip file using a button
  • Custom icon: Possibility to upload a custom image or icon for single files
  • Display empty folders on frontend

 

settings-frontend-tab

 

Advanced tab

  • Download function: includes readfile or fread
  • Google Drive sync logs: generate a Google Drive sync log to debug purpose
  • Track user download: by enabling this you will see the users' tracking on Dropfiles > Statistics dashboard.

 

settings-adv-tab

 

2. File importer

Dropfiles has a unique file importer available for Joomla. To enable it you should go in Component > Dropfiles and click on Options. Then set “File importer” to On.

Note that the importer will be only available in Dropfiles component in the backend for security reason, because it will display all server folders.

Then on the right part of your screen you’ll see the listing of your server files with 3 tools that allow you to Select, Unselect and Import files.

 

importer

 

To import files, choose the category on the left part then select the desired files and click on Import button.

3. ACL file permission

Dropfiles is Joomla user group and access levels to restrict file access. In the file restriction documentation we can separate the permission to view or download a file and the permission to manage the files.

First, to setup who is allowed to view or download the files you need to define in the component main parameters whether you want to restrict access by Joomla access level or Joomla user group. By default it's Joomla user group.

Then in the category settings (right column) you can allow a group to download files from a category or not. If a user is not allowed, he won't even see the category on frontend.

 

file-user-group

 

Note: The 'Inherited' status is applied to all new categories. That means sub-categories will automatically have parent category access right.

 

To setup who is allowed to view or download the files an additional parameter is available, still in the main parameters of the component: Single user access. This is the possibility to restrict the access to a file or a category of files for a single Joomla user.

This user can be selected from the Joomla user list in the category settings or in the single file settings. And a single file can be viewed by some users also.

 

single-file-user

 

Finally to setup the file permission regarding file management, you can access to the configuration still in the settings but in the Permissions tab. Each Joomla user group you have will be listed with the Dropfiles permissions.

For example if you want all users from the Administrator group to access and edit only their own files, set “Edit” to denied and edit own to “Allowed”. You can also restrict:

  • The global configuration access
  • The main Dropfiles interface access 
  • The files creation (upload)
  • The files deletion
  • All file edition
  • Own user file edition
  • Download files

 

File manager access per Joomla user group

 

Super admin user will always have access to all files and categories.

Manage personal user file repository

Dropfiles allows you to create and let your Joomla users manage their own files repository because you can define, as an admin, who own a category of files.

The first step is to setup in the Joomla user group user permission to: "Edit own category" only. Uncheck "Edit category", because users would be able to edit all exiting categories in this case. The other privileges are not mandatory, depending of what you want to allow.

 

permission-own-files

 

Then you can create file categories for your users, or if "Create category" is checked in his user group, they'll be able to do that by themself. Then, from the file category you've created, you can define who owns the category and therefore who'll be able to edit it.

 

category-owner

 

Note: the category owner definition setting must be activated from the configuration

4. Frontend file management

To manage files from frontend, you got 2 options (1-2 attached):

  • Use a menu with the same interface as backend: in this case the permissions have to be used to define the users rights on files. 
    See previous chapter about setting up ACL permissions.
  • Use an "Upload only" menu to upload file in a selected category

To add a frontend file management interface that match with the ACL permission, in your Joomla admin navigate to Menus > Your menu > New button > in the menu Type select Manage Files

 

menu-file-frontend

 

The users, from frontend, will need to login and depending of the ACL settings, he'll be allowed to do certain actions like add a file, edit a file, delete a file...

 

frontend-interface

 

It is recommended to use our template for frontend edition, in this case you'll get a full width interface to manage the files.

 

frontend-file-template

 

When a user is connected and have the edition rights, the user will see Manage files button on the top right. It helps user manage files in categories conveniently in frontend. 

 

manage-files-btn

 

 

To add a frontend file upload form only, in your Joomla admin navigate to Menus > Your menu > New button > in the menu Type select File upload form

 

frontend-upload-form

 

Then you can select the default file category where the file will be sent, still from the menu item management.

 

file-frontend-default-category

 

Finally, on frontend, you got a simple upload area to send or drag'n drop files.

 

Upload-form

 

Note: The frontend file upload form always require a login for obvious security reason (to avoid users to upload illegal or malicious files on your server or cloud accounts).

 

In order to display your latest files on frontend, you should navigate to Menus > Your menu > New button > in the menu Type select List Files

 

list-file-menu

 

Then you can select a Top Level Category to show the files or Select All if you want.

 

list-file-item

 

Finally, you will see the files in the selected category are listed on frontend.

 

file-list-frontend

 

5. File category themes

Dropfiles includes a pack of themes. A theme can be set for each category or as a global setting. That's why you have theme settings in the component options and also in the file categories. The category configuration will override the default configuration.

Default theme

 

default-file-theme

 

Tree theme

 

tree-file-theme

 

Google Drive like theme

 

GDD-file-theme

 

Table theme

 

table-file-theme

 

6. 3rd party: Docman file importer

You can import files from Joomla Docman extension in no time. There's a dedicated import tool that will automatically import to Dropfiles from the Docman:

  • Category of files
  • Files and documents
  • Files titles
  • Files descriptions

To launch the importer, got to Dropfiles > Options > Import tab. Then select a Docman root category to import, click on import and wait a little depending of the file quantity to import.

 

import-3rd

 

Dropfiles includes EDocman, JDownloads and Phoca download Importer.

 

file-importer

 

When using JCE Editor, you can insert Dropfiles link to text.
First, you need to select text in your article or click on Link icon in JCE Editor. 

link-icon

A popup window will be appeared and you can pick a file. Then click on Insert button.

 

insert-link-jce
 
 
Finally, the Dropfiles link is inserted into your text. That’s all!
 

8. Download statistics

You can go directly from Components > Dropfiles > Statistics, or a download statistics advanced dashboard is available from the Joomla admin (additionally to the Google Analytics event tracker).
You can create your statistics graph and detailed view using filters: 
  • File category: include one or several categories
  • Single file: include files one by one in the statistics calculation
  • Download per users: select users downloaded files
  • Filter by date range (date when files have been downloaded)

 

 
download-statistic-dropfiles