DROPFILES SUPPORT
Dropfiles is a Joomla extension used to manages all your files and categorize them in a smart way. The main component is completed by a theme pack.
For more commercial information please visit: www.joomunited.com
Main advantages:
Add files and categories in 3 clicks Use Dropfiles from the text editor Google drive integration
AJAX multi upload
AJAX navigation in categories AJAX nested categories order
Order files with drag’n drop
Display customization without css Themes are expendable
INDEX
I. DROPFILES INSTALL ... 3
1.1 Install ... 3
1.2 Update ... 4
II. DROPFILES COMMON USE ... 4
2.1 Manage files from article ... 4
2.2 Manage file categories ... 5
2.2 Manage file ... 7
2.3 Manage single file ... 10
2.4 Update a file ... 11
2.4 Search plugin ... 12
III. DROPFILES PARAMS ... 13
3.1 Parameters ... 13
3.2 File importer ... 14
3.3 ACL permission ... 16
IV. THEME SUBSCIBERS ... 16
V. DROPFILES TIPS ANS TRICKS ... 17
5.1 Load a category in a HTML custom module ... 17
5.2 Override a Dropfiles theme ... 18
VI. GOOGLE DRIVE INTEGRATION ... 18
6.1 Create a Google drive App ... 18
6.2 Add Google Drive info to Dropfiles ... 22
6.3 How it works? What can I do with GG Drive? ... 24
How it works? ... 24
I. DROPFILES INSTALL
1.1 Install
In order to install our component you should use standard Joomla installer.
Then click on Browse > Install & upload button, component, modules and plugins will be installed activated by default.
It’s not just a component but also editor plugin.
Everything is built to be installed/uninstalled by default in one single action.
1.2 Update
In order to update Dropfiles install it over the old version, do the same for the theme package. Be careful to always use the last version of Dropfiles and theme package for compatibility reason.
Be careful, uninstalling the component will erase all your files!
II. DROPFILES COMMON USE
The main idea of Dropfiles is to set display parameters, size, and file format allowed in the component then manage files and categories directly from articles or any WYSIWYG editor. Dropfiles works on every Joomla WYSIWYG editor, both for frontend and backend. For example you can use it in a custom Joomla module.
2.1 Manage files from article
When Dropfiles is installed you have an editor plugin that is displayed bellow you editor. Click on it to open the main Dropfiles view.
Click on it to open the file manager.
2.2 Manage file categories
In order to create a category, click on New category in the left column
Note: a default category is already created during component install
The category accordion manager can be loaded open or closed in global parameters. To change the state you can click on the +/- buttons on the left side.
On the right size of the screen you can see category and theme options.
You can define a theme per category, note that when browsing category level the theme will remain the parent one. So the end user won’t be disturb during navigation on frontend.
Depending of the theme you’ve selected you have display options. The display option helps you to display or hide element on frontend.
Once you’re done with the category parameters, you can click on save button to store the preference.
2.2 Manage file
Then select one or some file to upload. The uploader is HTML 5 powered so you can send big files they will be uploaded. The only limit you’ll have will be defined by your server configuration.
A file ordering can be done in backend and, if you want to, save for the frontend. Click on the first column title # to activate the file ordering.
Since Dropfiles 2.0 you have also the option to click on the column title to order file with various option:
order type Title Description File size Date Version Hits
Once you made the ordering you’ll at the right side, in category options the ordering fields become green.
You can change and save the ordering for the frontend by saving the current option.
The column option checkbox helps you to clean backend interface to focus on the main files parameters you have ie. show only file title and version for example.
Finally, in order to insert a file category in your article, click on Insert this category in the right column.
Already done, you’ve added your first Dropfiles category!!
The first time you insert your category, save your article to see the result on frontend. To open again the category and reload the configuration you’ve done, click on it and click back on the dropfiles button.
2.3 Manage single file
Dropfiles allows you to define:
Title
Description (HTML allowed since version 2.0) Version
Hits
Then simply click on insert this file to add it in your article. By clicking on a single file you can now add it directly in your article.
2.4 Update a file
In order to update a file, just open Dropfiles, click on the file of your choice, then use the Send a new version bloc to replace the file.
You can change file format, size or whatever, all will be detected and updated. Since Dropfiles 2.0 you have also a file version history manager. You can download an old file version and put it back as the main file.
2.4 Search plugin
Dropfiles 2.0 introduce a Joomla search plugin. As files are added in articles you can search for files and display the Joomla content that contain files.
III. DROPFILES PARAMS
3.1 Parameters
To access to Dropfiles parameters, go in Component > Dropfiles > Options
In option, you can define:
The jQuery call to avoid conflict, don’t touch if it works ;) The file you want to authorize on your website to be uploaded The viewer type, Dropfiles include now the Google drive file viewer The max upload file size (set to your server php.ini max value by default) The file importer activation (see 3.2 chapter)
The SEO URL. Since Dropfiles 2 you can link files with a prefix. The file URL links are now fully SEO
optimized, it takes back the prefix and file name
The option to load categories accordion open or closed by default Hide or display Dropfiles update notation (in backend)
3.2 File importer
Droppics has a unique file importer available for Joomla. To enable it you should go in component > Dropfiles and click on Options.
Then set “show file import” to Yes.
This procedure will enable Dropfiles importer. Note that the importer will be only available in Dropfiles component in the backend for security reason, because will give access to all FTP to Joomla admin.
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 on import files.
3.3 ACL permission
The Joomla ACL integration have been enhanced since 2.0 version. You can now restrict access to action or file for file administrator.
For example if you want administrator user to access and edit only their own files, set “edit” to denied and edit own to “Allowed”. You can also restrict:
The global configuration The interface access The files creation The files deletion Edition/own edition
Super admin user will always have access to all files and categories.
IV. THEME SUBSCIBERS
If you’re a lucky subscriber of our Dropfiles theme pack you’ll have new element to configure in the component options. Themes are global to all the files categories.
V. DROPFILES TIPS ANS TRICKS
5.1 Load a category in a HTML custom module
Dropfiles is built to be used in every WYSIYG editor field, you just need to have content plugin to be called. Most of the time it’s activated by default.
It’s not the case in the Joomla HTML custom module, you need to activate it like above.
5.2 Override a Dropfiles theme
You can customize and add theme to Droppics, but we don't use the standard MVC Overrides but the Joomla default plugin system.
Droppics themes are in fact plugins and they are located in the folder /plugins/dropfilesthemes
You'll have to copy one plugin, change the name of the plugin to create your new plugin (pluginname.xml and the class name of the plugin). Then install it through Joomla standard installer, it should be shown in the list of themes. You can then do all changes you want in this theme, it will not be affected by updates.
VI. GOOGLE DRIVE INTEGRATION
6.1 Create a Google drive App
Dropfiles 2.0 introduce the Google Drive integration.
Go to https://console.developers.google.com/project and connect to your Google account then Click on « Create Project »
Type a project name and id and click « Create » button
Than wait for app creation, could take a minute...
Once it’s created you’re redirected to the app dashboard. On the top left part, click on Enable API
Then scroll to the top of the page and in the left menu click on « Credentials » and create a new client ID
And set the parameters as followed:
Web application
https://www.your-domain.com (put your domain name)
Fill the second field with this URL suffix http://your-domain.com
/administrator/index.php?option=com_dropfiles&task=googledrive.authenticate (put your domain name)
6.2 Add Google Drive info to Dropfiles
Then go back in Joomla administration and click on the option button and copy/paste the information:
Client ID Client secret
Then save and close.
Finally login to your google account by clicking on Google Drive button
Connection should be a success
6.3 How it works? What can I do with GG Drive?
How it works?
Dropfiles will generate a root folder on your Google Drive with the site name
All the category added in Dropfiles and in Google Drive will added as root under this folder
What is the sync direction?
It works in both direction! You can add a file from drive and see it Dropfiles or add a file in Dropfiles and see it in Google Drive. It means you can manage Joomla files from your desktop using Google Drive sync software. That’s crazy! Yes we know
