Adam Bissonnette

This is a simple plugin to list files in a given directory using this shortcode: [MMFileList /].
Parameters:
<ul>
<li>folder: Relative to the base uploads directory of your wordpress install (e.g. siteurl.com/wp-content/uploads/mm/yy/ or siteurl.com/wp-content/ or siteurl.com/media). You can check your media settings from your WordPress dashboard in Settings -> Media. If you organize your uploads in the WordPress default month / year base folder you should either prepend this field with “/../../” or disable that setting before uploading files.</li>
<li>format: Tabular (format=”table”) or Unordered list (format=”li”) or comma-delimited (format=”comma”) or Unordered List of Images (format=”img” Note: this will put all files in tags) or Custom (format=”custom”) for using the Shortcode content to create a custom template (see Custom Formats section below for more information)</li>
<li>types: Only list given file types (e.g. types=”pdf,doc,txt”), If no types are specified then all files in the directory will be listed.</li>
<li>class: Only used for the “li”, “img” and “table” formats, applies a given class to the shortcode output (e.g. <ul class=”mmm-list”> / for more information on styling check out the FAQ)</li>
<li>limit: The default value will list all files in the directory. You can add a positive number of your choice and that amount of files will be displayed.</li>
<li>orderby: Current params can be either “name” (default) or “date” which sorts the files by date modified since date created seems to be hit and miss.</li>
<li>order: By default the order of the list is sorted descending (desc) from the highest value to lowest where value is determined by the “orderby” attribute. Ordering by date results in a list being displayed as newest to oldest and ordering by name results in a list descending through the alphabet (a-z). To reverse either of these defaults simply add order=”desc” into the shortcode parameters</li>
<li>target: This parameter lets you set a “target” for the links to the listed files (This is typically used to open the files in a new window)</li>
<li>prettyname: This replaces underscores and dashes with spaces and removes the file extension from the filename.</li>
<li>removesize: This removes the filesize from the default output</li>
<li>removeextension: This removes the file extension (leaving underscores and dashes)</li>
<li>regexstrip: Feeling like a wizard? Why not put in your own regex to strip out whatever you want from the filenames (no warranty provided, use proper formatting e.g. regexstrip=”/e/” will replace all e’s in the filename!)</li>
<li>regexreplace: Want to replace that content with something other than a blank space? Add whatever you want here to work with the regexstrip function</li>
<li>regexfilter: Filter out filenames that match a given regex pattern (See usage examples for more info)</li>
<li>regexfilterinclusive: Instead of picking out a few files to exclude you can use this to parameter to include anything that you want (See usage examples for more info)</li>
<li>dateformat: Adjust the format of the {date} variable in custom templates</li>
<li>headings: Adjust the headings of the table format by entering a comma delimited list</li>
<li>usecwd: If you can’t get the wp_upload_dir() folder to work you can try setting this to true to use your current working directory instead which should be your public_html folder</li>
</ul>
Output:
For all html formats you can expect to see the following output wrapped in styleable containers:
<ul>
<li>Filename (linked to the File Url)</li>
<li>File Size</li>
</ul>
At this point “comma” is the only available text output and it only outputs the url to the file in a comma delimited list (no links – just text).
If the folder you’ve entered isn’t found or there are no files with the extensions you’ve listed there will be some warning text output to let you know. This text is wrapped in a “mmm-warning” class in case you want to style it out (for more information on styling check out the FAQ)
Usage Examples:
Let’s say you’re using the default WordPress Media settings so we can expect your uploads folder to be in /wp-content/uploads/mm/yy/ with this in mind the shortcode “folder” attribute will look in a directory relative to this. With this base directory say we want to list “png” files in the folder “/wp-content/uploads/cats/” we would use the following shortcode:
[MMFileList folder=”/../../cats/” format=”table” types=”png” /]
If you have you disabled the setting to store uploads in the /mm/yy/ folder structure (you can do this within Settings -> Media) and wanted to display that same file you would use this shortcode:
[MMFileList folder=”/cats/” format=”table” types=”png” /]
This will result in a tabular list of all .png files in the /wp-content/uploads/cats/ folder.
Custom Formats
The “li” and “custom” formats allow you to define a template using the content portion of the shortcode. The difference between these two output formats is that “li” will still wrap all the output in a <ul> tag and each file will be wrapped in a <li> tag. Here is an example of how to create a custom template:
[MMFileList folder=”/cats/” format=”li”]<div class=”taco”><a href=”{url}”>{name} ({size})</a></div>[/MMFileList]
Variables that can be used with the custom templates are as follows:
<ul>
<li>{name} – This will output the filename</li>
<li>{size} – This will output the filesize</li>
<li>{url} – This will output the file url</li>
<li>{date} – This will ouput the file’s last modified date (use the format parameter to customize how this looks!)</li>
<li>If you would like more information available to be output don’t hesitate to a send in a request via the support forum</li>
</ul>
Regex and List Filtering
Regex or Regular Expressions are a really powerful tool but can seem intimidating at first. If you’re uncomfortable or having trouble feel free to reach out on the forums. For testing / trying to build your own pattens I recommend using https://regex101.com/ – it’s my goto. As a general rule for this plugin the pattern needs to be written with slashes <code>/likethis/</code> for it to work. With regex the general rule is to try to keep things simple.
Using the <code>regexfilter</code> parameter you can exclude or include only specified files.
Let’s say you have a list of cat pics you want to share but you have both dog and cat photos in the same folder. Luckily for you – they’re still labeled name-cat.jpg or name-dog.jpg. You can use the regexfilter feature to help with your predicament.
The following will EXCLUDE all files with the word doc in them. 
[MMFileList folder=”/myanimalpics/” regexfilter=”/dog/” /]
Another feature is the <code>regexfilterinclusive</code> option. Say for some reason your cousin Larry added a bunch of dog and frog photos to the folder but didn’t follow your naming conventions (dangit Larry!) well – have no fear. As long as you have a patten that matches your cat photos you can use this <code>regexfilterinclusive</code> toggle to show only those files. 
[MMFileList folder=”/myanimalpics/” regexfilter=”/cat/” regexfilterinclusive=”1″ /]
Note: that <code>regexfilter</code> is done before <code>regexstrip</code> and another filename changes (e.g. pretty name, file size/file name removal etc…) so if you’re having trouble this might be part of the issue. Base your pattern on the original filename and you should be good.
Using <code>regexstrip</code> allows you to remove text that matches a given pattern and <code>regexreplace</code> allows you to put in other text instead of just blank space. These are fairly advanced so I wouldn’t recommend using them unless you really know what you’re doing.

Mmm Simple File List

A very usefull plugin, using in my O2 projects to easily list files in a page for all the team members.

Good and work's with multisite

Plugin to list files in a given directory using a basic shortcode.

Diversified Technology Corp.

WPyog

Gagan Deep Singh

A plugin that allows you to easily upload files, create custom categories to store them in, display a customizable file list, generate text or a customizable button that 
automatically links to the most recent file of all of them or of a specific category. This plugin also allows for the creation of shortcode in your Menu items!
Shortcode Options:
[dtc-doc-documents-list] – Allows the displaying of a fully dynamic and customizable list of currently uploaded files.
Parameter Name: orderby 
Parameter Desc: Specifies the attribute to order the list by. Input is case-insensitive. 
Parameter Options: id, title, filetype, created, category, description, status 
Parameter Default: id 
Parameter Example 1: [dtc-doc-documents-list orderby=”category”] 
Parameter Example 2: [dtc-doc-documents-list orderby=”category,created”]
Parameter Name: sortorder 
Parameter Desc: Specifies the direction to sort the list in. That being ‘asc’ for ascending order or ‘desc’ for descending order. Input is case-insensitive. 
Parameter Options: asc, desc 
Parameter Default: asc 
Parameter Example: [dtc-doc-documents-list sortorder=”desc”]
Parameter Name: hidedisableddocs 
Parameter Desc: Specifies whether to list disabled documents or not. ‘true’ hides disabled documents, ‘false’ shows them. Input is case-insensitive. 
Parameter Options: true, false 
Parameter Default: true 
Parameter Example: [dtc-doc-documents-list hidedisableddocs=”false”]
Parameter Name: hidedisabledcats 
Parameter Desc: Specifies whether to list documents categorized under disabled categories or not. ‘true’ hides documents that are part of disabled categories, ‘false’ shows them. Input is case-insensitive. 
Parameter Options: true, false 
Parameter Default: true 
Parameter Example: [dtc-doc-documents-list hidedisabledcats=”false”]
Parameter Name: category 
Parameter Desc: Specifies which categories to display in this list. Input is case-insensitive. 
Parameter Options: all, Uncategorized, ALL USER CREATED CATEGORIES 
Parameter Default: all 
Parameter Example 1: [dtc-doc-documents-list category=”Forms”] 
Parameter Example 2: [dtc-doc-documents-list category=”Forms,Meeting Agenda”]
Parameter Name: itemsatatime 
Parameter Desc: The number of items to leave height for. This number is multiplied by 50px (the height of one entry) and set as the maximum height of the list window. 
Parameter Options: ALL X > 0 
Parameter Default: 10 
Parameter Example: [dtc-doc-documents-list itemsatatime=”10”]
[dtc-doc-recent-button] – Displays a button with the word ‘Latest’ followed by the name of the selected category, or ‘All’ depending on the input. Or, displays an error if no documents are found under the given category. Generates a formatted button with this text that then links to the most recent document of the given category.
Parameter Name: category 
Parameter Desc: Specifies the category to use the most recent document from. Input is case-insensitive. 
Parameter Options: all, Uncategorized, ALL USER CREATED CATEGORIES 
Parameter Default: all 
Parameter Example 1: [dtc-doc-recent-button category=”Forms”]
Parameter Name: cssstyles 
Parameter Desc: Sets the CSS style of the button div and text. 
Parameter Options: Any valid CSS style code. 
Parameter Default: BLANK 
Parameter Example: [dtc-doc-recent-button cssstyles=”background-color=’#ff0000′”]
Parameter Name: cssclasses 
Parameter Desc: Sets the CSS class of the button div. 
Parameter Options: Any valid CSS classes. 
Parameter Default: BLANK 
Parameter Example: [dtc-doc-recent-button cssclasses=”customexampleclass”]
Parameter Name: hidewhenempty 
Parameter Desc: Determines whether the error message indicating that no documents were found should show or not. 
Parameter Options: true, false 
Parameter Default: false 
Parameter Example: [dtc-doc-recent-button hidewhenempty=”true”]
[dtc-doc-recent-redirect] – Displays the selected category name, and error, or ‘All’ depending on the input. Links this text to the most recent document from the specified category, or all categories if category is set to ‘all’.
Parameter Name: category 
Parameter Desc: Specifies the category to use the most recent document from. Input is case-insensitive. 
Parameter Options: all, Uncategorized, ALL USER SPECIFIED CATEGORIES 
Parameter Default: all 
Parameter Example 1: [dtc-doc-recent-redirect category=”Forms”]
Parameter Name: cssclasses 
Parameter Desc: Allows the application of CSS classes to this shortcode element. 
Parameter Options: ANY VALID CUSTOM OR PRE-BUILT CSS CLASS 
Parameter Default: BLANK 
Parameter Example 1: [dtc-doc-recent-redirect cssclasses=”cssclass1”] 
Parameter Example 2: [dtc-doc-recent-redirect cssclasses=”cssclass1 cssclass2 cssclass3”]
Parameter Name: cssstyles 
Parameter Desc: Sets the CSS style of the redirect text. 
Parameter Options: Any valid CSS style code. 
Parameter Default: BLANK 
Parameter Example: [dtc-doc-recent-redirect cssstyles=”background-color=’#ff0000′”]
Parameter Name: displaytext 
Parameter Desc: Allows the user to specify what text should be displayed for the redirect text. This defaults to the category name or an error. 
Parameter Options: ANY VALID STRING 
Parameter Default: BLANK 
Parameter Example: [dtc-doc-recent-redirect displaytext=”testing one two three!”]
Parameter Name: hidewhenempty 
Parameter Desc: Determines whether the error message indicating that no documents were found should show or not. 
Parameter Options: true, false 
Parameter Default: false 
Parameter Example: [dtc-doc-recent-redirect hidewhenempty=”true”]
[dtc-doc-auto-redirect] – Automatically redirects visitors to the most recent document from the specified category, or all categories if category is set to ‘all’.
Parameter Name: category 
Parameter Desc: Specifies the category to use the most recent document from. Input is case-insensitive. 
Parameter Options: all, Uncategorized, ALL USER SPECIFIED CATEGORIES 
Parameter Default: all 
Parameter Example 1: [dtc-doc-auto-redirect category=”Forms”]
Parameter Name: seconds 
Parameter Desc: The time in seconds to wait before redirecting the user. 
Parameter Options: Any valid, positive integer, or zero. 
Parameter Default: 5 
Parameter Example: [dtc-doc-auto-redirect seconds=”0”]
<h3>Plugin Features</h3>
<ul>
<li>Upload any documents like pdf, word, jpg, png, etc.</li>
<li>Display a dynamic and custom file list.</li>
<li>Add / Edit custom categories for documents.</li>
<li>Add a button or href text that automatically points to the latest file in a specified category or all categories.</li>
</ul>

DTC Documents

A plugin that allows you to easily upload files, create custom categories to store them in, display a customizable file list, generate text or a custo …

Mmm Simple File List vs DTC Documents