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 Joomla search engine
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 What is the sync direction?... 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. Theme subscribers, install your theme pack in the same way, with Joomla standard installer.
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. To order the categories you can use drag n drop feature by clicking on the accordion.
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 To add files in a category, you can drag n drop files in the center part or click on Select files button
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. File category will be materialized in your article by a grey area.
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 Manage a single file has never been as simple as a click on a file. File option will be loaded at the right side.
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. To import files, choose the category on the left part then select the desired files and click on Import.
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. Go in Dropfiles category and click on theme you want. Since Dropfiles 2.0 themes can be set for each category.
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. In the option tab you need to set the option Prepare content to Yes
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 enable Drive SDK and Drive API Click the On button
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) This is the backend Dropfiles URL + &task=googledrive.authenticate
A new client ID will be generated
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 If you haven t made any mistake you should validate the authorization in a new window like bellow
Connection should be a success Then you can create Google drive folders and upload files in it!
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 Also if you erase a file from Google Drive you have to empty trash to erase it from Google Drive.