share

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 Joomla 2.5Joomla 3.3
    Extension Type Module ComponentPluginModule ComponentPlugin
    Displays Files Yes Yes Yes
    Displays Subfolders Yes Yes
    Automatic Sync (File Discovery) Yes Yes 1
    Displays as Unordered List Yes Yes Yes
    Displays as HTML Table Yes Yes Yes
    Displays as Paginated Table Yes Yes
    Displays in Explorer View Yes
    Hides Actual File Location Yes Yes
    Displays File Name, Size, and Date Yes Yes Yes
    Allows Custom Text and Images Yes
    Allows File Preview (Using Google Docs Viewer) Yes Yes
    On-Screen File Filter/Search Yes2 Yes2
    Multi-file Download as Archive (Zip, tar.gz) Yes Yes
    Time Limited Download links Yes
    Companion Editor-Extender plugin Yes
    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

  • Go to the 'Module Manager'
  • Click on 'New' to create a new module instance of Easy Folder Listing Pro Companion Module
  • Click on 'Easy Folder Listing Pro Companion Module' from the list

  • Configure the Module Instance

    1. Once selected, give the module instance a descriptive name
    2. Specify the position that the module will be placed
    3. The Profile 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. Configure Features 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.
    6. Lastly, please remember to specify the desired Menu Assignment for the module
  • Table of Contents


    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:

    NameKeywordDefault ValueDescription
    Location of the Listing Folderfolderimages/storiesThis is the actual folder where the files are kept.
    Max Subfolder Levellevel3This is the maximum subfolder level that we are going to give access to.
    Show SubfolderssubfoldersYes (1)If this option is set to Yes, all subfolders will be listed.
    Enable Username SubfoldersuserfoldersNo (0)When enabled, files are listed from username folders inside the listing folder.
    Guest Folder Nameguestfolder__guestThis is the name of the folder where the files for guest users are kept.
    UTF-8 Options
    Force encode UTF-8** NO KEYWORD **NoneIf your non-English filenames are not showing correctly, choose one of these methods to correct it. Default is set to none. This parameter can *ONLY* be specified in the Plugins Manager.
    Source Encoding** NO KEYWORD **ISO-8859-1Character Encoding of the filename text taken from the server file system. This parameter can *ONLY* be specified in the Plugins Manager.
    Reset Header Charset to UTF-8** NO KEYWORD **No (0)If this option is set to Yes, the charset value in the php header be be reset to UTF-8. This parameter can *ONLY* be specified in the Plugins Manager.
    Add UTF-8 Meta Tag** NO KEYWORD **No (0)If this option is set to Yes, a META tag will be added to the webpaage to set charset to UTF-8. This parameter can *ONLY* be specified in the Plugins Manager.
    Mootools
    Mootools Compatibility** NO KEYWORD **Automatically DetectSpecify which Mootools minimum version to maintain compatibility with. This parameter can *ONLY* be specified in the Plugins Manager.
    Collapse SubfolderscollapseYes (1)If this option is set to Yes, all subfolders will be collapsed. If set to No, all subfolders will be expanded.
    Transition EasingeasingSine In and Out (sine:in:out)This specifies the type of easing that the transition will use. The other options include: linear, quad:in:out, cubic:in:out, quart:in:out, quint:in:out, circ:in:out, and pow:in:out.
    Transition DurationdurationnormalThis specifies the speed at which subfolder contents transitions to and from being viewed. Other options are short and long.
    Customize Content
    Show IconsiconsYes (1)If this option is set to Yes, each file will have an icon to describe the type of the file.
    Show File ExtensionsextensionsNo (0)If this option is set to No, each file name will be displayed without the file extension.
    Filename TextfiletextFilenameThis is the header text for the file column.
    Size TextsizetextSizeThis is the header text for the size column.
    Date TextdatetextDateThis is the header text for the date column.
    Show File SizesizeYes (1)If this option is set to Yes, the size of the file will be shown.
    Show DatedateYes (1)If this option is set to Yes, the date that each file was modified will be shown.
    Show Time (with the Date above)timeYes (1)If this option is set to Yes, the time stamp that each file was modified will be shown. If it is set to No, then only the Date will be shown. Note that if Date (above) is not shown at all, then time will not show either.
    Date FormatdateformatY-m-dThe format for the date only column. For help go to: http://www.php.net/manual/en/function.date.php
    DateTime FormattimeformatY-m-d H:i:sThe format for the date and time format. For help go to: http://www.php.net/manual/en/function.date.php
    Link To FileslinktofilesYes (1)If this option is set to Yes, each file will be hyperlinked for easy downloading.
    Link Targettarget_blankThis specifies the link taget when you Link To Files (above). Other options are _parent, _self, and _top.
    Download TargetdownloadiconThis specifies whether to allow users to download files. You can add a download icon (icon). Or, you can make them download by clicking the linked filename (link). Or you can disable it (none).
    Preview TargetpreviewiconThis specifies whether to allow users to preview files using Google Doc Viewer. You can add a preview icon (icon). Or, you can make them preview by clicking the linked filename (link). Or you can disable it (none).
    Preview Modal Widthmodalwidth640This sets the width of the modal window that previews the file in Google Docs Viewer.
    Preview Modal Heightmodalheight480This sets the height of the modal window that previews the file in Google Docs Viewer.
    Show Empty MessageshowemptyYes (1)If this option is set to Yes, the empty folder message below will be shown. If set to No, the empty folder message will not be shown.
    Empty Folder MessageemptyThere are no files to list.This is the message that will be displayed if a folder is empty.
    Filtering/Searching
    Show Filter TextboxshowfilterYes (1)If this option is set to Yes, the a filter textbox will be shown. If set to No, the filter textbox will not be shown.
    Filter LabelfilterlabelFilterThis is the lable that will be shown preceding the textbox.
    Filter Error MessagefiltererrorFile not found!This is the error message that will be displayed if a filter text is not found in the listing.
    Delay after typing (ms)filterwait500This is the time delay (in milliseconds) after the user stops typing in the filter textbox before the filter is applied.
    Cancel Filter with ESCescfilterYes (1)When set to Yes, the user can cancel the filter by pressing the ESCAPE key in addition to clicking the cancel button.If this option is set to Yes, all subfolders will be listed.
    Security
    Forbidden file types (separate by semi-colon)forbiddenhtm;html;phpThis is a black list of the file types that are forbidden to be listed (separated by semi-colon).
    Permitted file types (separate by semi-colon)whitelist*This is a white list of the only file types that are to be listed (separated by semi-colon). Use '*' to list any file type that is not forbidden above. This allows you to only list certain types of files from a folder with many different types.
    Excluded Files (separate by semi-colon)exfilesDesktop.ini; .@__thumb; .DS_StoreThis is a black list of the files that are to be excluded from the listing (separated by semi-colon).
    Excluded Folders (separate by semi-colon)exfolders.svn; CVS; .AppleDB; .AppleDesktop; .AppleDoubleThis is a black list of the folders that should be excluded from the listing (separated by semi-colon).
    Customize Display
    Display MethodmethodtableIf Table is selected, the folder listing will be displayed in an HTML TABLE. If List is selected, it will be displayed using the Unordered List element. Other option is list.
    Show Collapse / Expand AllshowcollapseexpandYes (1)This displays the option to expand or collapse all of the rows in the listing.
    Collapse TextcollapsetextCollapse AllSpecify the text you would like to display to indicate the action to Collapse All of the rows.
    Expand TextexpandtextExpand AllSpecify the text you would like to display to indicate the action to Expand All of the rows.
    List Item Bullet StyleliststylenoneThis specifies the style of the list item bullet. Other options are disc, circle, square, decimal, decimal-leading-zero, lower-roman, upper-roman, lower-greek, lower-latin, upper-latin, armenian, georgian, lower-alpha, and upper-alpha. This can be overridden in the styles.css stylesheet.
    Ratio of Column Widthsratio4:2:2.5This is the ratio of each of the column's width to one another. There are three columns in the following order, Filename:Size:Date
    Sort ColumnsortcolumnnameThis specifies the column that the list is sorted by. Other options are size and date.
    Sort DirectionsortdirectionascThis specifies whether we are sorting by ascending or descending order. Other option is desc.
    Odd Table Row Background Coloroddcolor#F0F0F6The background color of the odd table row.
    Even Table Row Background Colorevencolor#FFFFFFThe background color of the even table row.
    Heading Row Background Colorheadcolor#E6EEEEThe background color of the heading row.
    Sub Folder Background Colorsubcolor#EFEFEFThe background color of the table's subfolder rows.
    Border Colorbordercolor#CDCDCDThe color of the table's border.
    Hidden Parameters
    Offsetoffset0This is an integer to offset the number designation of the listing. Thus, if you want to show multiple articles that each have a listing, you can offset the listing ids so that they will not conflict.

About Us

Valor Apps is a registered business that is owned and operated by Michael Gilkes. The business is located and registered in Antigua and Barbuda.

We specialize in developing software for Joomla Content Management System (Joomla CMS), custom web apps, and custom desktop applications. We also provide computer support services to businesses located in Antigua.

Latest News

Important Notice about Joomla 2.5 January 10, 2015
Important Notice about Joomla 2.5 Joomla 2.5.28 was released on December 10, 2014, and is now officially the last release of the 2.5.x Joomla series. Official support for Joomla 2.5.28 ended on December 31, 2014. This means that there will be no new releases of the Joomla 2.5.x...
Site Upgrades and Updates August 15, 2014
Website Upgrade Please be advised that from 10:00am EST Friday, August 15, 2014 to 6:00pm EST Monday, August 18, 2014, the Valor Apps website will be involved in an ongoing upgrading process. The site will remain live. However, there will be changes to the appearance of the website that will occur during this time period. Most changes will occur within the first 24 hours. After that initial time...
First Quarter 2014 Online Newsletter April 26, 2014
Recent News! New Payment Option: FMX Tranpage Since the establishment of Valor Apps online, Paypal has been the only payment option available. As of December 2013, a new payment option was made available to all users: FMX Tranpage. If you are unable to use Paypal, or prefer not to use Paypal, you are invited to use FMX Tranpage. FMX Tranpage is a lightweight SSL-based cedit card payment...
New Releases Scheduled! April 23, 2013
New Releases Scheduled! For those who make feature requests and who contact us via email about bugs and custom features, you wait in almost over! Here is a schedule of upcoming releases with the tentative features: Advanced Folder Listing Version: 1.5 Expected Release Date: July 2, 2013 Features include: Ability to Link any Field (not just Filename) Multi-Lingual Support for Fields Compatibility with...
Pure Tabs v1.1 released! February 5, 2013
Pure Tabs Version 1.1 is now available! Updates to this version: Compatible with Joomla 3.0+ Go to the product page for a full product description.
keyboard_arrow_up