1. Start
  2. Installation
  3. Uploading files
  4. Adding a file list to your page
  5. Options and Settings
  6. Further Customisation
  7. Having problems? Get in touch.

File List Pro

List files easily


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.

Installation


To install File List Pro:

  1. Log in to your Wordpress site admin.
  2. Go to Plugins --> Add New.
  3. Choose the Upload option (near the top of the page).
  4. Click browse and select the zip file for File List Pro.
  5. Once you've selected the file click Install Now.
  6. Once the plugin is uploaded and installed choose Activate Plugin.

 

Uploading files


To list files ready for download you just need to attach them to the current page/post in the normal way:

  1.     Click the Add Media button.
  2.     Use the drag and drop uploader, or manually upload your files.
  3.     If you want to use the tag filter, enter your tags separated by commas.
  4.     Click Save All Changes.

Adding a file list to your page


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.

List files by criteria

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:

List files by picking them

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.

Sorting

You can choose how the file list will be sorted initially, and in what direction - by title, by date uploaded, or randomly.

Other options

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 and Settings


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:

Further Customisation


Creating your own style

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.

Using a Custom Template

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.

Having problems? Get in touch.


If you run into any problems during installation, use, or styling please feel free to get in touch with me so I can help.