Easy Folder Listing Pro

We offer multiple products that list files and allow downloading. Each has its own feature set, with similarities and differences. To better understand which product will best suit your needs, please review the comparison table below:

Feature	Easy Folder Listing v2.8	Easy Folder Listing Pro v3.2	Advanced Folder Listing v1.6
Full Compatibility
Extension Type
Displays Files
Displays Subfolders
Automatic Sync (File Discovery)			1
Displays as Unordered List
Displays as HTML Table
Displays as Paginated Table
Displays in Explorer View
Hides Actual File Location
Displays File Name, Size, and Date
Allows Custom Text and Images
Allows File Preview (Using Google Docs Viewer)
On-Screen File Filter/Search		2	2
Multi-file Download as Archive (Zip, tar.gz)
Time Limited Download links
Companion Editor-Extender plugin
Price	Free	USD $20.00	USD $20.00
	Download	Buy	Buy

1. AFL uses Manual Sync, where the Administrator needs to click the "Sync" icon in the Files Manager. This will detect all the new files placed in the listing path.
2. Uses full AJAX search.

It is important to note that all the documentation you need comes with the extension. It is built into the extension itself, and is very easy to access. Currently, the documentation is only available in English. The explanation provided here shows you how to easily access the documentation that is available in the extension.

Dashboard Help

The first location to find documenation is found on the extension Dashboard. You can access this from the Components menu.

On the Dashboard, you will see the Help tab. In the Help tab, you will find an easy to use accordian that contains four sections:

Basic Documentation

Gives the introductions and basics on how to use the extension and how it works.

Attribute Override List

Lists every field available in the Profiles, and explain what they are. It also gives you the relevant attribute key to use inline in the shorcode, which will override what is set in the profile.

Common Solutions

A built-in Frequently Asked Questions that answer most of the common questions that users have asked.

Support Information

Lists the ways you may contact me for further assistance.

Help Files

This component comes pre-packaged with an extensive set of help files. The documentation is not located online at present. Each view of the component that can be accessed from the Administration has a help icon located in the top right hand corner of the screen. Just click on the help icon and the documentation for that view will be displayed. Look for the following icons:

Joomla 2.5:

Joomla 3.0+:

The Code Helper Plugin is a companion plugin to the Easy Folder Listing Pro version 3.0 extension. It works in conjuction with the component and content plugin that both make up the extension. It is a convenience plugin that facilitates ease of use in the creation of the Easy Folder Listing Pro shortcode. This documentation provides the user with an explanation of hwo to enable and use the code helper plugin.

Code Helper Notice

When you go to the Easy Folder Listing Pro Dashboard, you may see a notice that informs you of the status of all companion extensions. If you see a notice for the Code Helper, then you will need to enable it in the Plugins Manager.

Enable in Plugins Manager

1. Navigate to the Plugin Manager
2. Filter the view to display 'editor-xtd' plugins
3. Click on the 'Enable Plugin' button for 'Easy Folder Listing Pro Companion Code Helper Plugin'
4. The 'Enable Plugin' button will change from a red cross to a green check.

Code Helper Button

1. Go to the Article Manager and create or edit an article
2. You will now notice at the bottom of the article editor that there is an 'Easy Listing' button

Code Helper Dialog

• After clicking the 'Easy Listing' button, the code helper dialog will appear in a modal pop-up
• You can select the Profile you wish to use as the default settings for the listing
• Every other override option is disabled by default. If you want to specify a particular option that may be different from what it in the profile, you can enable it by selecting its checkbox.
• After you select that option, you may specify its override option value.
• Click 'Insert' to generate the custom shortcode and place it in the cursor's position in the article
• Select 'Select All' To enable all the options. Please note that this is not necessary unless you intend to have a custom value for each of the 64+ options. It is just present as a convenience.
• To close the dialog without inserting the shortcode, just click the 'x' icon in the top right had corner of the modal.

Shortcode Insertion

The generated shortcode will be inserted into the article, based on your selections. You may edited this shortcode directly, or delete it and create a new one, as needed.

The Easy Folder Listing Pro 3.0 Companion Content plugin is the heart of the extension. Without this content plugin, no listings will be rendered. It is needed to display all listings, and it even needed for the conpanion module to work.

In previous versions, all the parameters were configured in the plugin. However, as of version 3.0, all the options are configured in the component administration. As such, most of the documentation regarding configuring the extension is accessed via the help icons in the component views.

Content Plugin Notice

When you go to the Easy Folder Listing Pro Dashboard, you may see a notice that informs you of the status of all companion extensions. If you see a notice for the Content Plugin, then you will need to enable it in the Plugins Manager.

Enable in Plugins Manager

1. Navigate to the Plugin Manager
2. Filter the view to display 'listing' plugins
3. Click on the 'Enable Plugin' button for 'Easy Folder Listing Pro Companion Content Plugin'
4. The 'Enable Plugin' button will change from a red cross to a green check.

Configure Profile

1. Once enabled, click on the plugin name in the Plugin Manager to go to its properties
2. Different from previous versions of the plugin, there are only 2 parameters here.
3. The first parameter gives the option to choose the profile to be used as the base for all listings. After initial installation, only the 'Default' profile will be displayed. However, as you create more profiles, these will become available to choose from in the drop down list.
4. Second is a link that goes directly to the component Dashboard. From the Dashboard you can go to Profiles and create new profiles. If you ever need assistance in understanding profiles, just click on the 'Help' icon avaiable in that view.
5. Please Note: All the functionality and options for the extension are located and configured in the profiles.

The Easy Folder Listing Pro 3.0 Companion Module is a convenience extension that uses the Companion Content Plugin to display listings in module positions. Please note that without the content plugin, no listings will be rendered. All the options for the listing are configured in the component administration, and you only need to configure module only options in the Module Manager. As such, most of the documentation regarding configuring the listings is accessed via the help icons in the component views.

Please note that if you want to display a listing in the article body, do not use the Companion Module with the Joomla built-in Load Position plugin. Instead, use the Easy Folder Listing Pro Content Plugin directly.

Module Notice

When you go to the Easy Folder Listing Pro Dashboard, you may see a notice that informs you of the status of all companion extensions. If you see a notice for the Module, then you will need to enable it in the Extensions Manager.

Enable in Extensions Manager

1. Navigate to the Extensions Manager
2. Click on 'Manage' in the sub-menu
3. Search the list of extensions by typing 'listing' in the search field
4. Click on the 'Enable Plugin' button for 'Easy Folder Listing Pro Companion Module'
5. The 'Enable Plugin' button will change from a red cross to a green check.

Create a Module Instance

Table of Contents

• Known Issues
• Installation
• Usage
• Parameters

Known Issues:

Please note that the table transitions work best in Firefox 3.6+, Opera 10+ and IE 9+. Webkit-based browsers (Chrome, Safari) adds space between rows.

To get rid of the extra spaces, please reference the FAQ

As of Version 2.7, the extra spaces are no longer present. The fix was automatically applied.

Installation:

This plugin is designed for Joomla 1.5, 1.7, 2.5 and 3.0. To install go to the install/uninstall extensions page of Joomla Administrator and upload the package file. Then go to the Plugin Manager page and activate the plugin.

Usage:

To use this plugin as content in an article, first enable the plugin and configure the default parameters in the Plugin Manager. To control which types of users have access to this plugin, set the Access Level in the plugin.

Secondly, in the article, type {easyfolderlistingpro}. (If you choose to copy/paste this phrase, please be sure to Toggle Source Code in your Joomla editor to avoid issues with unwanted formatting characters.) It will work based on the default parameters if typed with no custom parameters.

To have multiple listings on the same page, just add each instance according to the following format:

{easyfolderlistingpro parameter='value' parameter='value'... parameter='value'}

for each instance you want. Please note that each instance should have something different about their listed parameters. The order in which the parameters are listed does not matter. The list of possible parameters can be found in the table below.

Example of list listing:

{easyfolderlistingpro method='list' extensions='1' folder='images' easing='linear' sortcolumn='size'}

Parameters: