=== WP Attachments ===
Contributors: Milmor  
Tags: attachments, media, file, list, classicpress  
Donate link: https://www.paypal.me/milesimarco  
Requires at least: 4.4  
Tested up to: 6.6  
Version: 5.1  
Stable tag: 5.1  
License: GPLv2 or later  
License URI: http://www.gnu.org/licenses/gpl-2.0.html  

A powerful solution to manage and display your WordPress media attachments in posts and pages.

== Description ==

WP Attachments enhances the download experience and file management in WordPress. It automatically displays attachments in your posts and pages, so you don’t need to manually insert download links.  
Easily attach, unattach, or reattach files directly from the media library.

**New in 5.1:**
- 🚀 Major code refactoring for improved stability and maintainability
- ⚡ Significant performance improvements
- 🔒 Enhanced security throughout the plugin
- 🛡️ Improved admin capabilities and permission handling
- 🆕 Brand new metabox for easier attachment management
- 🗂️ Refreshed admin columns for better overview and usability

**Key Features:**
- 🤖 Automatically displays attachments after post content
- ℹ️ Backend metabox for managing attachments
- 🔃 Quick Attach, Unattach, and Reattach actions in the Media Library
- 🔢 Download counter with anti-spam and logged-in user filtering
- 🧑‍💻 Developer hooks and filters for customization
- 🛍️ WooCommerce compatible
- 🎨 Five icon packs to choose from
- 📜 Supports posts, pages, and custom post types
- 🎢 Customizable themes (title, date, size, caption, and more)

[Video Overview](https://www.youtube.com/watch?v=J7gf0hxl_z8)

== Contributions ==

- Part of [WPGov.it](http://www.wpgov.it), providing open source solutions for Italian Public Government websites.
- Thanks to the Italian community [Porte Aperte sul Web](http://www.porteapertesulweb.it) for beta testing and ideas.
- Metabox based on [IJ Post Attachments](http://wordpress.org/plugins/ij-post-attachments/)
- Some icons by [Yusuke Kamiyamane](http://p.yusukekamiyamane.com/).

== Installation ==

1. Install via the WordPress.org plugin directory or upload the files to your server.
2. Activate the plugin. To customize, go to **Settings → WP Attachments**.
3. While editing a post, page, or custom post type, you’ll see a new metabox for managing attachments. Additional features are available in the Media Library: Attach, Reattach.

== Frequently Asked Questions ==

= How can I hide the attachment list for a specific page? =
In the edit screen, use the plugin’s metabox to disable the automatic listing by checking **Disable** at the bottom right.

= How can I avoid double listing? =
You don’t need to insert file links manually. When you upload a file, it’s automatically assigned to the content and displayed by WP Attachments. Just close the media popup after uploading.

= How can I reorder files? =
Drag and drop attachments in the WP Attachments metabox or Media Popup while editing.

= Developer Filters =
WP Attachments includes many filters for developers:

- **wpatt_list_html** — Filter the entire list output (`$html`)
- **wpatt_before_entry_html** — Filter single entry output before tag parsing (`$html`)
- **wpatt_after_entry_html** — Filter single entry output after tag parsing (`$html`)
- **wpatt_accepted_formats** — Filter which files are shown (`$mime`)

**Examples:**

```php
function my_custom_function( $html ) {
    // Alter final HTML
    return $new_html;
}
add_filter( 'wpatt_list_html', 'my_custom_function' );
```

```php
function my_custom_function( $mime ) {
    // Only show PDFs in the list
    return $mime == 'application/pdf';
}
add_filter( 'wpatt_accepted_formats', 'my_custom_function' );
```

== Screenshots ==

1. The generated attachment list
2. Simple and intuitive options
3. Demo from [www.sanpellegrinoterme.gov.it](http://www.sanpellegrinoterme.gov.it)
4. Backend metabox
5. Attach, unattach, and reattach files in the Media screen


== Changelog ==

= 5.1 2025-05-25 =
* Date placeholders in attachment templates now use the WordPress date format setting (`Settings > General > Date Format`) for better localization and consistency.
* Improved templating: You can now use WordPress date formatting in your custom templates, and templating settings are more flexible and reliable.
* Other minor fixes and improvements.
* Major code refactoring for improved stability and maintainability
* Significant performance improvements
* Enhanced security throughout the plugin
* Improved admin capabilities and permission handling
* Brand new metabox for easier attachment management
* Refreshed admin columns for better overview and usability

= 5.0.12 =
* Latest stable release

= 5.0.6 2023-02-15 =
* Compatibility check
* Security fixes
* Minor changes

= 5.0.4 2021-10-20 =
* Compatibility check
* Linked development workflows on [GitHub](https://github.com/WPGov/wp-attachments)
* Minor changes

= 5.0 2020-11-28 =
* WooCommerce compatibility: add files to client orders
* Major improvements and technical changes
* Rewritten add_media popup with custom behavior
* Removed old translation files, now using translate.wordpress.org
* Minor changes

= 4.4.2 2020-04-29 =
* Minor improvements

= 4.4.1 2020-02-20 =
* Compatibility check

= Version 4.4 18/11/2017 =
* **Fixed** critical bug for missing icons in WP 4.9
* Some problems may occur in previous WP versions for icons. Please update!

= Version 4.3.6 10/01/2017 =
* **Tested** with WP 4.7
* **Fixed** php warning in custom post types with capabilities mapped

= Version 4.3.4 06/07/2016 =
* 4.6 compatibility check

= Version 4.3.3 02/04/2016 =
* Fixed bug in metabox date
* Tested with WP 4.5

= Version 4.3.2 19/02/2016 =
* Fixed php notice error when debug active

= Version 4.3.1 18/02/2016 =
* Auto exclusion of dropdown if attachments < 2

= Version 4.3 23/12/2015 =
* Added option to show a dropdown for ordering
* Various improvements and bugfix
* Added support for translate.wordpress.org

= Version 4.2 02/08/2015 =
* Added developer functions and filters
* Minor improvements
* ReadMe changes (FAQS added)

= Version 4.1.2 6/07/2015 =
* Added es_ES translations by Joaquín Alejandro Duro Arribas
* ReadMe changes

= Version 4.1.1 1/06/2015 =
* Tested with latest beta version
* Readme changes

= Version 4.1 26/04/2015 =
* **Added** option to exlude logged-in users from download counter
* **Fixed** "extended" template
* Minor bugfixes
* Minor readme.txt changes

= Version 4.0.2 =
* Correct bug of 404 error when file title contains special characters (download counter only)
* Minor improvements

= Version 4.0.1 =
* Fixed download error 404 for some permalinks when counter enable

= Version 4.0 =
* New and better metabox
* Added download counter function
* Added icon themes
* Added multiple schemes
* Redesigned options
* Performance improvements (2x faster)
* Minor improvements

= Version 3.7 05/03/2015 =
* Added filter and option to restrict the plugin to single and page views
* Minor performance improvements
* Fixed wrong version in settings panel
* Better style for attachments list

= Version 3.6.1 28/02/2015 =
* Added check for password protected posts

= Version 3.6 28/02/2015 =
* Improved performance
* Improved metabox (faster & nicer)
* Improved option panel
* Added opton to deactivate the plugin on certain pages

= Version 3.5.6 21/10/2014 =
* **Fixed** css conflict with italian schools WordPress theme "pasw2015"

= Version 3.5.5 05/09/2014 =
* **Added** plugin icon
* **Added** serbian translation sr_RS
* readme.txt changes

= Version 3.5.4 26/07/2014 =
* **Fixed** possible conflict with other plugins (ex. Members)
* **Fixed** missing translation of "Update" button in the options panel (world-wide)

= Version 3.5.3 20/07/2014 =
* **Added** Brazilian Portuguese translations by Henrique Avila Vianna

= Version 3.5.2 15/07/2014 =
* **Fixed** add media button not being displayed when no file attached
* **Fixed** metabox not showing up for add-new "admin" pages
* **Upgraded** uploader to be the same as WordPress' integrated
* **Improved** add media button style to exactly match the WordPress' standard

= Version 3.5.1 12/07/2014 =
* **Tested** and working on WordPress 4.0 (beta)

= Version 3.5 09/07/2014 =
* Added **unattach** link in media admin page
* Added **unattach** link in page/post/cpt editor
* **Improved** back-end metabox
* **Improved** capability handling for attach/reattach/unattach functions
* **Improved** some variables handling
* **Added** function to check if a file doesn't exist and must skip filesize calculation (in order to avoid front-end errors)

= Version 3.4 08/07/2014 =
* Added **reattach** link in media admin page
* Added **attach** link for unattached file in media admin page

= Version 3.3 28/03/2014 =
* **Added** option to open files in a new tab [in Settings -> WP Attachments]
* **Fixed** conflict with "Members" plugin causing the metabox appearing in its options page
* **Added** an "eye" icon in the editor metabox showing that the file will be listed front-end

= Version 3.2.3 26/03/2014 =
* **Solved** conflict with some newsletter plugins by addind code for avoiding the attachments list if the given post id is null

= Version 3.2.2 12/03/2014 =
* Added support for **MP3**, **ODT**, **ODS**
* Changed size text for small files: now showing "< 1KB" instead of "n B"
* Better compatibility for Internet Explorer

= Version 3.2.1 03/03/2014 =
* Added wp_enqueue_style for loading css style
* Performance improved

= Version 3.2 03/03/2014 =
* New localization system. English & Italian already translations included
* New back-end metabox. That's in beta, but i'm sure you will like it!
* Better option page

= Version 3.1.4 4/11/2013 =
* Fixed missing 'Backend.php' (this function will be available in the next versions (3.2+)

= Version 3.1.3 27/10/2013 =
* Another bugfix

= Version 3.1.2 27/10/2013 =
* Fixed a bug causing content not to be loaded in some cases

= Version 3.1.1 19/10/2013 =
* List title is now hidden correctly

= Version 3.1 15/09/2013 =
* **Fixed** missing icon for images
* **Added** option to exclude images from being listed
* **Improved** settings page layout

= Version 3.0.4 24/08/2013 =
* **Readme** minor changes

= Version 3.0.3 23/08/2013 =
* **Improved** Css appearance

= Version 3.0.2 23/08/2013 =
* **Fixed** activation error: unespected output - 1 charater

= Version 3.0.1 22/08/2013 =
* **Fixed** missing external shortcode rendering
* **Fixed** reduntant css code
* **Improved** loop
* List header doesn't show up anymore for empty attachments

= Version 3.0 22/08/2013 =
* **Added** Css for showing icons
* **Added** file size
* **Added** attachment data
* **Added** options panel

= Version 2.0 04/07/2013 =
* First functional release. Enjoy!

= Version 1.0 07/01/2012 =
* First Release