List Attachments Shortcode

This WordPress plug-in allows users to easily list all of the attachments associated with a specific post or page within WordPress. For instance, if you want to create a long list of Word documents or PDF documents, you can simply attach them to the page or post, then insert the shortcode where you’d like that list to appear.

Usage

The simplest way to use this plug-in is just to use the shortcode. That will, by default, list the attachments with the most recent upload at the top of the list and the oldest upload at the end of the list. No heading will be included above the list. The list will be created as an unordered list with the CSS class of “attachment-list”.

[list-attachments]

Options

• type – a comma-separated list of file extensions that should be included in the list. If this is left empty, all attachments will be included
  orderby – any of the values that can be used with the WordPress query_posts() function
• order – indicate whether the list should be sorted in ascending or descending order
• groupby – if you would like the list split into specific groups, you can indicate any of the WordPress post object parameters as the value of this property. For instance, you can use a common “description” for your attachments to organize them into groups. In that case, you would use “post_content” as the “groupby” parameter for this shortcode
• before_list – any HTML code you want to appear before the list begins
  opening – the opening tag(s) for the list (defaults to
  )
  • closing – the closing tag(s) for the list (defaults to
  )
• before_item – the opening tag(s) for each item of the list (defaults to
• )
• after_item – the closing tag(s) for each item of the list (defaults to
)

This is the first version of this plug-in, so I’m certain there are a lot of features that still need to be added and bugs that need to be worked out. If you try out the plug-in and have any suggestions or notice any issues, please comment on this post and let us know.

Known Issues

• The HTML code arguments (before_list, after_list, before_item, after_item, etc.) only work when added through the visual editor. When added through the HTML editor, they are not sent properly through the shortcode.

To Do

• Re-do the method of handling the HTML code arguments
• Remove the handful of hard-coded HTML elements that are in the plug-in, making them configurable through shortcode arguments
• Add a widget to the plugin