The File List Pro plugin lists all, or a selection, of files attached to the current post or page. It also allows you to embed multiple file lists in a page or post – these can be limited by file types, by a date range, or by picking the files. Users can sort, filter, and search lists easily, making File List Pro perfect for download pages or Pdf newsletter lists.
To install File List Pro:
To list files ready for download you just need to attach them to the current page/post in the normal way:
To add a File List to your page you just need to click the File List Pro button in the editor. This will let you pick the options you want to use for the list and add a shortcode to your page or post.
The first thing you need to decide is if you want to pick files from a list, or filter the files by date range and type. You then need to click on the corresponding tab.
This is the best option if you want to list all files of a certain type (pdf newsletters for example), and you want the list to update itself as new files are attached to the current post.
The following options are available to you:
This option lets you create a file list with just the files you want to display. Just check the files you want to include by ticking them.
You can choose how the file list will be sorted initially, and in what direction - by title, by date uploaded, or randomly.
The rest of the options allow you to customise how the file list looks:
Once you have chosen all of your options click the Insert button and a shortcode will be entered into your content.
If you prefer you can enter the shortcode manually. Below is a shortcode with all possible attributes specified. When creating your own shortcode you can probably leave most of these out.
[prettyfilelist type="pdf,xls,doc,ppt,zip" filesperpage="10" openinnew="false" startdate="2010-07-04" enddate="2014-08-15" hidesearch="false" hidesort="false" tags="" hidefilter="false"]
Options for file lists can be set at a site level via the settings page. To access these settings go to Settings -> File List Pro.
The following options can be set:
You can create your own styles for File List Pro easily – the plugin has been designed so that future updates will not remove your styles.
Just create a /prettystyles/ folder in your active theme directory and copy one of the existing css files into it. This will then show in the File List Pro settings page with (custom) next to it. Make any changes you need to this file – most of the colours and core styles are at the bottom of the css files to make customisation easier.
The look and feel of the links themselves can be further changed by creating a custom html template. To create a custom template make a copy of the pflprotemplate.php file in the /templates/ folder of the plugin, and copy it into the root of your active theme. Any changes you make to this file will now be reflected in all lists.
The template system works by replacing certain tags just before display. The following tags are all valid:
Template changes should only really be done by somebody who is comfortable with html/css, and knows how to fix it if it goes wrong.
If you run into any problems during installation, use, or styling please feel free to get in touch with me so I can help.