If you want to see which media is used and where ? This plugin is for you !
By installing this plugin you will index where your media are used, display further informations about how they are used and also warn you about deleting used ones. Therefore, you will easily delete unused medias.
A table is created for indexing where media are used. This is done when saving contents but could also be forced with the wp-cli command or just by activating the plugin.
- WordPress 4.6+
- Tested up to 4.9.3.
- PHP 5.6+
At plugin activation, a single event will be added in order to index your contents. It generally takes 10-15 min to do so.
At plugin deactivation, all data stored by this plugin will be deleted to ensure not to weighing the DB and also for further safe reactivation.
- Download and install using the built-in WordPress plugin installer.
- Site activate in the "Plugins" area of the admin.
- Optionally drop the entire
bea-media-analyticsdirectory into mu-plugins. - Nothing more, this plugin is ready to use !
- Add repository source :
{ "type": "vcs", "url": "https://github.com/BeAPI/bea-media-analytics" }. - Include
"bea/bea-media-analytics": "dev-master"in your composer file for last master's commits or a tag released. - Nothing more, this plugin is ready to use !
For now the supported contents for indexation are post types by focusing on :
- Post content ( gallery, image, links )
- Post thumbnail
- Advanced Custom Fields PRO's fields :
- "content fields" :
- File
- Gallery
- Image
- Post object
- Page link
- Relationship
- Textarea
- Wysiwyg
- "structuring fields" which can reuse the above "content fields"
- Clone
- Flexible
- Group
- Repeater
- Component
- ACF Options
- "content fields" :
- Image Map Pro
In the single edit view, a bloc has been added to display the number of usages, where and what type.
In the media library modal view, when a media is selected, a bloc has been added to display the number of usages.
On the media admin library view, an admin column has been added to display the number of usages.
On media delete, if it has usages (based on indexed contents), a warning will prompt to confirm the media deletion.
This plugin has third party support with following plugins :
- Content Sync Fusion : the usage counter will now consider synced sites to reveal how many times a media has been used across all synchronized sites.
As you can see, some issues are feature requests :
- More fields support (excerpt, post meta, etc)
- More type of support (widget, etc)
- More support (elementor, visual composer, polylang, -wpml-, etc)
- Media expiration
- Media replacement
- More file's mime types
This plugin is translated into the following languages :
- English
- French
- More to come
Please refer to the contributing guidelines to increase the chance of your pull request to be merged and/or receive the best support for your issue.
If you identify any errors or have an idea for improving the plugin, feel free to open an issue. Please provide as much info as needed in order to help us resolving / approve your request.
If you want to translate BEA - Media Analytics, the best way is to use the official way : WordPress.org GlotPress.
You can, of course, just create a pull request to our repository if you already done the translation.
WP-CLi has been implemented to execute some useful commands.
Only on the given site, an indexation of all retrieved data from all supported contents : wp bea_media_analytics index_site
Optionally on a multisite :
- for a site :
wp bea_media_analytics index_site --url={url} - for the entire network :
wp bea_media_analytics index_site --url={url} - for all sites of all networks :
wp bea_media_analytics index_site --url=$(wp site list --fields=url)
Quickly retrieve unused media for the current site (even with Content Sync Fusion).
List all unused media : wp bea_media_analytics unused list
Delete all unused media : wp bea_media_analytics unused delete
The REST Api has been used to display the number of usage for an attachment. The route exemple.com/wp-json/wp/v2/media/{id}/ will return a custom field called bea_media_analytics_counter which represents how many times it has been used into supported contents.
WordPress is working a lot with the JSON API, that's why why the bea_media_analytics_counter attribute has been added into attachment's JSON responses.
Created by Be API, the French WordPress leader agency since 2009. Based in Paris, we are more than 30 people and always hiring some fun and talented guys. So we will be pleased to work with you.
This plugin is only maintained, which means we do not guarantee some free support. Consider reporting an issue and be patient.
If you really like what we do or want to thank us for our quick work, feel free to donate as much as you want / can, even 1€ is a great gift for buying cofee :)
BEA - Media Analytics is licensed under the GPLv3 or later.