Joomla Module – Easy Folder Listing

Easy Folder Listing

Copyright: Michael A. Gilkes
License: GNU/GPL v2

1 Star2 Stars3 Stars4 Stars5 Stars (20 votes, average: 4.50 out of 5)


  • Joomla 1.5+, 1.7+, 2.5+
  • PHP 5.2+


This is a simple-to-use module that is used to list the contents of a folder in either a table or a list. The folder listing can display the filename, with or without the extension, with or without the date modified and file size, as well as a icon representing the file type. It has the feature of allowing the user to specify whether the filename listed should be linked or not.

Download (Valor Apps):

Main features:

  • List files in a specified sub-folder of the Joomla root directory.
  • Show icons for file types
  • List files in either a table or a unordered list
  • Sorting in Acsending or Descening order, by filename, date modified or file size
  • Option to show/hide size, date, or date and time of the files
  • Option to link to the files or not
  • Option to specify a list of file types that should not be listed
  • Color scheme of the table rows and border can be customized
  • Module Manager colors available through custom Color Picker

Support and Documentation:

Feel free to visit my forum for online support. You may also contact me via the Valor Apps Contact Page

Please visit the digital store for documentation:


Silk icon set 1.3 by Mark James



104 Responses to “Joomla Module – Easy Folder Listing”

RSS Feed for Michael's Blog Site Comments RSS Feed


Doesn´t the Joomla Module – Easy Folder Listing run with Joomla 3.0?

Thanks und kind regards

@Udo. Yes it does. I just haven’t updated this page on my blog. Thanks for your question.


first I like to say thank you for this module.
I use it for an nonofficial website only to manage some information, to show different formulas …
I’ve one question regarding one option I can choose.
If I use the link the pdf document opens in the same window.
My users are watching the document or fill in the formula and then they close the pdf.
After this the whole website is closed.
Is it possible to open the document within a new website or with a new Tab.
I’m sorry, my English is not the best but I hope you are able to understand what I like to do?
Thank you very much.
Best regards

I’m not a programmer … I do not know what should I write in the article to load the module?
If I write: {loadposition position-50} does not work!


@Roberto. If you set it the module to position-50 and also set the module’s visability to “All Pages”, it will work. Please double-check that you did these two things. Let me know how it works out. I am happy to help you further, but please go to the support forum or send an email to support[at]valorapps[dot]com.

Michael: I am trying to create a user account on your web site so as to look at your demo of Easy Folder Listing Pro. But I am not receiving an activation link. Can you help me? Thanks, Jim F.

Thank you for useful and easy File Uploader and foldlisting. Great work.

Hi, great module, thanks.
Is there a way to change the colour of the filenames and links that have been clicked?
It does not take my templates colours, or does it take it from somewhere else?
Thanks in advance.

Ps, great captha. Three times now it tells me I am not human (great to hear, I always new), if you get this text at least I have been able to fool it on my fourth attempt.

i have installed this plugin in joomla 2.5, and it is giving me the follow lines on the top of download link file

Strict Standards: Non-static method modEasyFolderListingHelper::getFormattedListing() should not be called statically in C:\xampp\htdocs\modules\mod_easyfolderlisting\mod_easyfolderlisting.php on line 40

i will appreciate your help in it please..


@Ali. Thanks for bringing this to my attention. I will have to update this in the next release. To fix it, all you need to do is to open the helper.php file in an editor, and change “public function getFormattedListing()” to “public static function getFormattedListing()”.

hi, why i can’t find out the “public function getFormattedListing()” in helper.php?
can i know which line it is?

I’m using joomla 2.5.7.

@Bale. I think it is somewhere around line 67.

Awesome, i was scared I would have to write a module or code to do EXACTLY what this does. Still figuring out how to put it in an article but it is perfect so far!

Thank you for great plugin!

I have just installed it and have a question how to sort folders. My folders are years 2006, 2007, 2008 etc. I need to sort the folders descending. How to do it ?

Kind regards,

Hello again.

i use your module inside articles. Every time i calll the module i see an error above

“PHP Error Message

Warning: set_time_limit() has been disabled for security reasons in *****/libraries/joomla/filesystem/folder.php on line 548”

this i s a server error. Is it possible to stop disolaying this error message? if i call the module 3 times in an article, the error appears 3 times.

thanx in advance.
ps. any news about greek charset? i read your forum but the solution is not clear enough.thanx again.

Really excellent module, simple to use but adaptable and well thought out.


Really like your module, but is there any way I can change the table width?

I have to first say that you hav the most interesting captcha I have seen!!!! Wow did you make it? lol

The module is great! You don’t have to configure every file you just put them all into a folder! :):)

Wasn’t sure tho how to configure to display number of downloads.



I am using Easy Folder Listing 0.3 (J16) with Joomla 1.7. I have created 2 instances of the module at different module positions in order to reference 2 different directories / option sets.

I am using loadposition twice in the same page / article to reference each of these independently. Oddly, the second reference is treated as if it used the first module position. Therefore, the exact same set of files / options is used twice instead of seeing 2 different sets as expected.

Is loading this module at 2 different module positions within the same article a bug or limitation?

@George. Thanks for posting this. I will test it out today and get back to you. If it needs fixing I will post a new version by Monday. In the meantime, could you please open up a topic on this exact issue at my support forum so that others could benefit from the results:

@George. Please have a look at this topic on my support site for the solution to your problem:

Hello Michael, I have a problem with the module Easy Folder Listing Module 0.3 (J15), I can`t sort the files by name.

In module parameters I put in sort column order by name, and I dont know what happend.

@Gabriel. Thanks for posting. Could you please visit the support site and open up a topic there? Thanks.

A very good module. I used it several times on the website. Just copied and it workes like a charm.
Thanks for a good module.

Hi, I proube the module, and is very good. I would like to ask if it is posible to use the Easy Folder module to list the file of another server. I mean, have the site on server A and locate the file on server B.


@Virginia. It should be possible, but you will have to edit some of the code. i am quite willing to help you try it out. Just start a topic about it on my support site:


Thank you for your great job, it work perfectly.

I have a problem, I can’t find category option, is it there in the your extension or not?

@Nadir. Thanks for your comments. My module doesn’t have a category option available. If you think it should have one, please go to my support site and suggest the new feature, explaining how you expect it to work:

Hi: Easy folder listing seems to have a compatibility issue with Joomla 1.7. Pages containing the extension do not render correctly (they don’t render at all).

Are you aware of this? Any ideas on a fix, or will the extension be updated for J1.7?

@TC. Thanks for posting this. Joomla 1.7 just came out yesterday, so I haven’t been able to test my current plugins with it. So, i am not aware of this issue. I will have to install Joomla 1.7 and run some tests to see what is actually going on. I hope to eventually have all my plugins be updated for current versions of Joomla!

Thank you! I really like your plugins, and hope to have them working with 1.7 soon… There seem to be a number of minor bugs in 1.7, so I’m hoping a fix from Joomla may restore your plugin functionality too…

@TC. I just testing both Easy Folder Listing module and Easy Folder Listing Pro plugin on Joomla 1.7, and they both work flawlessly without modification. if you still insist that there is a problem, could you please provide me with a link to the site that exhibits what you describe? Or could you please provide information such as an error log entry of an error that was raised?

Also, it would be better if we continue this conversation at the support site:

At the support site, we can address this issue without clutter of comments, and others can find the discussion easier.


This module is awesome. It’s exactly what I needed. Just wondering, I didn’t see an option to add a class to the ul or table you use. I was going to hack your code, but if you had already developed that, I wouldn’t have to. I wanted to check first. If this ends up working for me, I’ll make a donation. Thanks.

@Stan. Thanks for your comments! I appreciate them! I don’t mind answering your question, but I would prefer if you post it at the support forum, so that others can benefit from the answer. Could you please re-post your question at the support forum? Thanks!

Is it posible to restrict access to folders? That’s a permission system to access, so if a user has a personal folder only he can access it.

Thank you for a great application! I was wondering if it is possible to create a separate sub-folder for each user, and then based on their user id only display that 1 folder for that user, not all of them?

@Clint. Currently, the module does not do that. However, if you want to customize it, you are welcomed to. Another user made a similar customization to the uploader extensions. Have a look at his post at the support site, and you may find it to be a good start for what you want to do.

I love your module, simple and effective, one thing is missing, the possibility when I say yes to “link the file”, the file opens in a new window (_blank), for example PDF files.
Thanks a lot
Best regards

Please check the support site on instructions on how to make that cutomization.

very usefull module, nice shot.

i was wondering why filenames in greek aren’t display properly and the module shows  or ???????????????
is it something i can do to fix this?
should i set different charset to a file of the module? The whole site is in greek.

thanks a lot.

@baysmi. Thanks for your response. This is actually something that I am currently working on. The next release should fix this issue. Until then, please have a look at the support site:

Also, I can better support your concerns at the support site. Thanks!


I’m new to Joomla, just tested it about 1 week+.

I’ve downloaded & tried to install to Joomla but version J16
Error! Could not find a Joomla! XML setup file in the package.

Tested with versionJ15 & no problem with it.

Tested with Bundle version, extracted to get 2 zip folder, from there tried to install the J16 version from Bundle version and it generated the same error as well.

My Joomla version’s 1.6.
How do I create or what should I do to make J16 works for my Joomla?

@vera. Thanks for using my plugin. I would love to assist you with your situation, however I can better address it at the support forum: Please include what version of Joomla you are using, and by that I don’t mean 1.6 or 1.5. I mean 1.6.1 or 1.5.20 or 1.6.3, or 1.5.9, etc. Also, please include your PHP version as well. Thanks. So, if you could kindly re-post your question at the forum, I would greatly appreciate it.

Hi there,
I have an problem with umlauts in Joomla 1.6. When the German filename has an umlaut (e.g. Büro) “Easy Folder Listing” only displays an question-mark and the file cannot be opened.
Does anyone have a clue how this prob can be fixed.
THX, Flo

@Flo. Thanks for using my module. Please have a look at the following entry at the support site:
I will have this updated in the next release.

Two questions related to publishing large numbers of documents:

1. does the module support subdirectories?

2. can the contents of different document folders be listed from within different articles?


@Timon. Thanks for your questions.
1. No. The module does not support subdirectories. The plugin pro version does, however.
2. Yes. Both module and plugin do this.

Thanks for your quick reply.

1. I’ve installed the module, and I can’t see a way to list the contents of different subdirectories in different articles.

2. I don’t understand how the root directory is managed. I get a dropdown list of (banners, icons & sampledata), but I don’t see these folders in my filesystem.

3. How do I get more info about the ‘pro’ version?

* Removed site and login info from public view *


Same for me…

I tried making another folder in images.

I gave it another position (z_list) and another name

In the second article I wrote: {loadposition z_list}

But still, only the first listing is working…

But anyway, amazing job with this module!! 🙂

@Pénélope. Thanks for using the module. I don’t quite understand your problem, but I am more than happy to help if I can. You should check out the support site:

@Timon. Thanks for your questions. Please visit the support site for further help.
1. Subdirectories are listed in the pro version. Also, you can check the demo site.
2. You can find them in the images folder


i’m having this problem and would like to know the solution…

Strict Standards: Non-static method modEasyFolderListingHelper::getFormattedListing() should not be called statically in C:\xampp\htdocs\dhila-rozi\modules\mod_easyfolderlisting\mod_easyfolderlisting.php on line 37

hope someone can help

@zila. First time that I’m seeing that error. However, just place the static keyword before function. That should do it. However, please visit my support forum to get help for issues like these:

TQVM! it works!

Cool module !
Works great for me on an intranet site running Joomla! 1.6.
Two suggestions for improvement though.

Add an extra option “Open in new window”.
I know I can change that by adding target=”_blank” to line 193 of helper.php, but that makes the change for all pages where the module is used. Making it an option would be more flexible.

The front-end is obviously not a big deal, and column names in the table header can be changed in lines 161, 164 and 168, but that does not do the trick for a multi-lingual site.

The back-end can obviously be translated in mod_easyfolderlisting.xml but having a language file would make life easier, particularly when multiple admins from around the globe maintain the site.

I really like this module, and it is great for me because it runs on 1.6.

Kind regards,

@Bert. Thanks for your suggestions. Internationalization is definitely something that I hope to do in the near future.

Great module! I alway worried about how to list the joomla folders, because I am all new to joomla. Now, your article clears all my doubts. I am very greatful for your useful information. Thanks a lot.

I would like to know how I can make the path a specific url so that i can use the same folder of files for multiple sites on the same domain but different sub domains. (Example: I have files on that i want to use on, and; this will allow me to use 1 directory of global files that i want to show on multiple sub-domains)

Any help would be appreciated. If you can help me solve this i will gladly donate a sub sandwich or 2 to you!


Hi micheal. My english is not so good. I have read all the posts here but yet couldn’t find my answer.
First of all thanks a lot for your useful module lika this.
1. my site’s bandwidth is small, so can we show the folder from another site? example “http://….com/files”

Hi Selcuk, thanks for posting and having interest in my extension. The module was only designed to display files located on the site it was installed. Now, if you know some PHP, you should be able to edit the module code to suit your needs. I don’t know if it would work, but you could edit the code to force it to use another site. However, that is up to you.

Thanks for so fast reply 🙂
actually i am still trying to change the code for my problem but i am not strong on “php”.
Althoughg thanks again for your reply my friend.

Hi Michael,

I’m new to joomla and of course extensions. I like what your extension can do, but I’m having a problem using it. I want to show files listed on an external harddrive. I’ve modified helper.php and mod_easyfolderlisting.xml to point to my default location but I’m getting this error when I try to view the folder:

Uncaught exception ‘Exception’ with message ‘Directory folder specified is not a valid directory: /media/LaCie/LACIE/entertainment/home videos/Clips’ in /var/www/modules/mod_easyfolderlisting/helper.php

the folder /media/LaCie/LACIE/entertainment/home videos/Clips’ is correct. Any idea what I’m doing wrong?


Hi, I am very happy with this module. Just one question, I have a pdf file in the folder and when you click on it it opens the pdf in my same folder. I would like it to start downloading instead. How can I do this?


Thank you so much for your module. I wonder if there is a way I can change the default parent folder in the Edit page of the module in Joomla 1.5

Look forward to your reply

Love the module. I would like to know how I can show the files on a sub domain if I have all of the files on the main domain.
Example: All the files I want to show are located on but I want to centralize them so that I can show them on & I have the module installed on each sub domain but i want the data to get pulled from the main website directory such as
If you can help me solve this I will buy you a footlong…
Thank you!

Hi Jon,
I am glad you like my module, and I hope it serves you well. I have been thinking about your question for most of the afternoon. I think that that easiest way you can accomplish this, or should be able to accomplish this, is by creating either a hard link or symbolic link to the folders, especially if the domain and subdomains share the same hosting space.

If you can’t do that then you might have to alter the code in the module, which will make the module only fit to your needs. Of course, I haven’t tested any of this, but it should work. Let’s continue the conversation at the support site. Start a topic there, and we can see how things progress.

Very slick clean module. Would you consider putting in a parameter that allows certain number of listings (IE: 5 most recent documents or a date range).


Hi Andre,

Thanks for your positive comments and support. I may consider adding that feature to a future release. To help me with that, I would appreciate it greatly if you share your idea at my support site: There you can give a more detailed explanation as to how you would like to see the feature implemented.

I also would request that the default folder be changed (or at least allow to easily modify) from images. Looks like a lot of us use this for documents. While it works, using the image folder requires moving my documents to a folder that is not logically organized. I suggest default to the root /.

Otherwise, I found nothing else that does what your module does as easily. It was exactly what I was looking for.


Found and it works on my website
In the Helper.php file, change the line 193 and 246 adding target=”_blank” at the end of the line before the > such as

href=”‘.JURI::base().$folder.’/’.$rows[$i][‘name’].’.’.$rows[$i][‘ext’].'” target=”_blank”>

Happy if it helps

As BFactorGroup and Bart, I’d like to open the linked file in a new window !!
How to ????
anyone can help ?

Hi Michael,

Is this module compatible with UTF-8 character encoding?
When I use this module in Joomla 1.5.22 I get squares where there should be swedish characters in filenames.


You have to change in the helper file version 1.1 (J16)the lines below to be compatible to UTF-8:

change line like this
lines 198 and 246 : $html .= ‘‘;

lines 196 and 249:$html .= utf8_encode($rows[$i][‘name’]);

I know the post is old but it can help.

I had the same issue with some files with greek titles displaying like diamonds with “?”.

Thing is that in the module manager, we see the option “Source Encoding” which is by default set to ISO-8859-1. Change this to the encoding of your files’ names (e.g. for my greek titles, the source encoding is ISO-8859-7) and then on the “Force Encode UTF-8” option, select “Use Plain iconv”.

Hey Michael,

Great respect for this great module!
I did the hungarian translate. Anybody can download here:

Have a nice day!

Great module!

I was wondering the same thing as Bart was.
How does one create it so a clicked document will open in a new window? Such as target=”_blank”?

thanks in advance!

Fantastic module and I am sure it will be one of the most popular Joomla modules!

Would it be possible to change the root folder from images to another folder on the server? I have tried adjusting the helper.php but just get an error saying “JFolder::files: Path is not a folder: ” when it is THE folder I am using for files.

Thank you again for such a wonderful addition to our sites!

HI. Thanks for the work on an excellent module. I would also like to request a subfolder file display function.
I am using this on a company Intranet to provide access to a hierarchical folder structure.
Is this something we could do ourselves by adding some code or could you provide an update?
Do you have any idea when a revision would be due?
Thanks again

Hi, and first of all thanks for your work on this excellent module. I just thought I’d add my vote for subfolder listings. Can’t seem to find any extentions that does this.

I am desperate for it to show directorys. Is it possible to do this. If you can direct me to where I might be able to learn how to add this function that would be great or if you could add it soon that would be even greater. I love the way your lister is formated much better than anything else I have seen so far. Thanks for a great module.

hi Michael,
thanks for you work. I manage to make it work for 1 directory listing, but I just wonder if it is possible to have two (or more) different directory listings on my site ? I have 3 directories that I want to make avalaible for downloads, with 3 types of files, and I want to put them on separate articles… is it possible ? thx


Hi Dave,

Thanks for using my module. The short answer to you question is YES. All you have to do is add different copies of the module, and give each copy its own settings and its own position. Then, you can have any many listings as you want. Hope this helps.


When I try and install another copy of the module I get Module Install: Another module is already using directory: “/hermes/bosweb/web017/b175/ipg.crtnorthnet/modules/mod_easyfolderlisting”
How do I add additional copies of the module if I don’t install them?

@Lisa. All you need to do is to click the New button in the tool bar in the Module Manager, and go from there. Hope this helps.

Got it to work with the copy function in Module manager, thanks for reply

@admin please remove all my previous posts except the last one from October 6, 2010 at 8:10 am. Thanks!

@thezak: did you tried using forward slashes to separate folders (or maybe backslashes on windows hosts)?
So choosing the parent folder “attachments” and putting in the field of the sub folder “article/529”, that should read the files within the sub-sub folder e.g. 529.
Is this what you meant?

Hi, i use “Attachments 2.0” to attach files on my article, now i want a list of all files in a single page, so i use your nice module.
i substitute on file “helper.php” (line 281) the word “images” with “attachments” to change directory, on file xml i substitute “directory=images” with directory=”attachments”…
But “Attachments 2.0” include files in a sub-sub folder like this:
attachments>article>526 (or 529 or…) , so fo every article i have a subfolder.. but your module can read only inside “article” folder..
I leave empty: “Location within the Parent Folder” , if i put the name of folder (ex. 526) he read correct, but of course i can’t put more than one subfolder.
there are any suggestion ?
thank you

Love it!
Super usefull!
But for a project i have to to display only the most updated file in the folder, I mean, not all the list in descending order, only the most recent.
There is a way to do it?
Thank you in advance (:

p.s. i can’t understand the captcha test, gosh!

Really like the extension. But how to make clicked documents appear in a new window? Like target=”_blank”

for some reason, its working now! weird… but thanks for the reply anyways 😀

I’m trying to display .pdf files. I have over 50 files in some directories. For some odd reason its only displaying up to 7 items. I put all permission set to 777 yet it still doing the same thing. weird….


For some odd reason, it doesn’t display more than 7 items per module. is there a setting to list all the files in the directory?



Actually, there is nothing in the code that limits it to 7 items. i have tested it with over 10 items. It should work. Maybe you can check whether the items that you are trying to display are listed in the forbidden file types. Thus, it should display everything in the folder. What file types are you displaying?

Love it. Only thing that would make this better would be to have a thumbnail generated of each document.

Thanks! That’s a pretty good suggestion. I’ll think about adding it in the next release.

I am new to Joomla and extensions. I can’t figure out what I am, doing wrong here. I loaded this , activated the plugin, made an article with the code in it, set the arbitrary position in the module and made a menu link (at bottom of home page in main menu – DIRT Board Packets) but when go to the link
I get a blank page …. any advice for what I missed here? I am hoping it will list all the PDFs in my directory as a list. Need this to work for several archived pages of info I have.

Did you specify the menu assignment to select either “All” or the specific article that is listed in the menu?

Just specify either “All” or select the menu item that refers to the article that has the code to list your PDFs.

Hope this helps.

Hello! Is this some kind of fork of JX File List? It would be great if it could list the folders and the files in the folders. Not just files in the “root” folder. Is this a feature you could easily add?


Hi Vegard,
Although the idea of a folder listing module is not an original idea, as I do know about JX File List, my project is not a fork of theirs. My code is my own, and made from scratch. I didn’t use any of their code, but the idea is basically the same.
Anyways, as to listing the folders. Hmmm… I did think about it when I was developing it, but I decided not to do it, because I didn’t really want to share the directory structure of any folder to the public, or even give the option to. I also didn’t want any traversing of a directory in Joomla. I guess I just didn’t think it was necessary. Technically, just listing the sub-folders is an easy feature to add, but I won’t allow any linking to it, though.
If more people want me to add the feature, I may do so in the next revision. (Maybe I need to open a forum for these modules… hmmm… we’ll see.)

Works okay for me on Windows OS, localhost, in Chrome, but not in Firefox. There seem to be issues for me with regard to mixed forward and backwards slashes. Also an extra “DS.” for $path set after JURI::base().

I like the simple concept! Thank you.

Thanks for the bug notice, Chay. I updated it, and tested it on Firefox. It works now. I have tested it in Chrome, Safari, IE8 and Firefox/Sea Monkey. Let me know if you find anything else.

[…] for Taking Charge of your DestinyThoughtsPeace & FreedomSoftwareEasy File UploaderEasy Folder ListingMy Online Store « It’s been too […]

Comments are closed.

  • Featured Apps

  • Archive

  • Users Online

    Users: 1 Guest, 1 Bot
  • Meta

  • Visitors

Liked it here?
Why not try sites on the blogroll...