WP Attachments – Smarter File Management & Download Lists

1. 01Install via the WordPress.org plugin directory or upload the files to your server.
2. 02Activate the plugin. To customise it, go to Settings → WP Attachments .
3. 03While editing a post, page or custom post type you will find the Media Attachments metabox. Extra actions are available in the Media Library: Attach, Unattach and Reattach.

How do I hide the attachment list on a specific post or page?

Open the Media Attachments metabox while editing and switch off Display attachments in frontend , at the bottom left. The files stay attached, they are simply not listed on the site.

To hide the list for a whole post type, untick Enable Frontend under Settings → WP Attachments → Post Type Permissions .

How do I avoid the same file being listed twice?

Do not insert the link manually. A file uploaded from the editor is attached to the content automatically and listed by WP Attachments, so you can simply close the media popup after uploading.

How do I reorder the files?

Three ways, all of which save straight away:

• drag a row by the grip on its left;
• use the Move up / Move down buttons on each row;
• focus the grip and press the up or down arrow key.

How do I see which files belong to a post?

The Files column in the post and page lists shows how many files each one has, and an eye icon tells whether they are shown on the site. Click the number to open the Media Library filtered to just those files. The Files filter above the list finds posts with or without files, or with the list hidden.

Can I change the date format of the list?

Yes, under Settings → WP Attachments → Date Format . It accepts the standard PHP date characters and applies to the %DATE% tag. Leave it empty to follow Settings → General → Date Format .

Does the download counter count everything?

No. It skips browser prefetch requests and known crawlers, and it ignores repeat hits from the same visitor on the same file for a few minutes. Those requests still receive the file, they just do not move the number.

Which files can be previewed in the metabox?

Images, video, audio, PDF and plain text open in a preview dialog. Any other format shows its icon and a download link.

Developer filters

wpatt_list_html — the whole list markup ( $html ) wpatt_before_entry_html — a single entry, before the tags are replaced ( $html ) wpatt_after_entry_html — a single entry, after the tags are replaced ( $html ) wpatt_accepted_formats — return a falsy value to hide a file ( $mime ) wpatt_download_throttle — how long the same visitor is ignored for the same file ( $seconds , $attachment_id ) wpatt_count_download_request — whether the current request may increment a counter ( $countable ) wpatt_can_download — whether the current visitor may follow a download link ( $allowed , $attachment_id ) wpatt_should_render — whether the list is appended to this content ( $render , $post ) Examples

function my_custom_function( $html ) { // Alter the final HTML return $new_html; } add_filter( 'wpatt_list_html', 'my_custom_function' ); function my_pdf_only( $mime ) { // Only show PDFs in the list return $mime === 'application/pdf'; } add_filter( 'wpatt_accepted_formats', 'my_pdf_only' ); // Count each visitor at most once per hour add_filter( 'wpatt_download_throttle', function () { return HOUR_IN_SECONDS; } );

There is also wpatt_get_attachments_html( $parent_id ) , which returns the list for any parent ID without going through the the_content filter.