=== Media Hygiene: Remove or Delete Unused Images and More! ===
Author URI: https://www.mediahygiene.com/
Plugin URI: https://wordpress.org/plugins/media-hygiene/
Description: The Media Hygiene plugin removes unused media from the WordPress library to free up space, reduce clutter, and improve server performance. With features like bulk delete and deep folder scanning, it's a must-have for finding and deleting unused images and media.
Contributors: slui
Tags: unused media, clean, delete, remove, images
Requires at least: 5.3
Requires PHP: 7.4
Tested up to: 6.9.4
Stable tag: 4.0.2
License: Custom
License URI: Custom license, no Distribution allowed

== Description ==

The Media Hygiene plugin removes unused media from the WordPress library to free up space, reduce clutter, and improve server performance. With features like bulk delete and deep folder scanning, it's a must-have for finding and deleting unused images and media.

== Introducing Media Hygiene  ==

Introducing the Media Hygiene plugin - the ideal solution for optimizing your WordPress media library! With this powerful plugin, you can quickly and easily remove all unused images, reducing clutter, and freeing up valuable server space. This plugin is a must-have for anyone looking to delete unused images in WordPress or remove unused images from the media library.

Media Hygiene is fully compatible with major WordPress builders, including plugins like WooCommerce, custom fields and posts plugin, sliders, SEO, and more - making it versatile and convenient for all types of WordPress users. Unique features like "One shot delete" and "One-shot download" allow you to bulk delete media and download all images from the Wordpress media library make it easy to keep your media library organized and up-to-date.

Making offsite backups? Reduce the time and cost of disk space with a smaller backup file size. 

Say goodbye to a cluttered and disorganized WordPress media library, and hello to a cleaner, more efficient WordPress site! Whether you're an agency, blogger, photographer, or business owner, Media Hygiene is the perfect tool for keeping your media library in tip-top shape. 

Get it now and keep your WordPress site super clean!

### Some use cases for website owners

- Unable to keep track of unused media files in the media library.

- Uploading the same images in different sizes to figure out optimal size and forgetting which one was actually used.

- Switching out an image in a post with another and can’t find it media library file.

- Updating the logo with a new version and don’t want the old one to be indexed by Google.

- Images included with purchased theme but never deleted after site was launched.

- After a website was redesigned or rebranded, there may a number of old images or media files no longer in use.

- Before migrating to a new hosting provider, cleaning up the media library may make it a smoother and faster migration process.

- Getting a warning from your hosting provider that you are hitting the storage limit, make your backups smaller.

- You have guest posts or contributors who may have left behind a number of images.

- Changing your product listings or discontinuing products in e-commerce sites may mean images are left unused.

- After trying out a theme, deactivation of theme may leave behind media files.

### How is it Different?

 - [Media Hygiene Pro](https://mediahygiene.com) scans the entire website using a number of different techniques. One way is to “visualize images/media in page source code” to confirm the existence of a media file even when builders/plugins/themes use specialized custom posts to display their widgets on-screen.

### File Types:

* Media Hygiene will recognize most if not all major file types stored in the WordPress media library. This includes but not limited to PDF, jpg, png, gif, mp4, mp3, csv, zip, rar, and txt files. We also cover alternative extension spelling such as jpeg.

### Standard Features:

- Dashboard – shows list of all unused media by occupied space and by type.

- Notifications – get email notifications when new files have been uploaded and not scanned on a specific schedule (daily, weekly, bi-weekly, monthly, quarterly)

- Site builder compatibility – works with all major site builders such as Elementor (see list below).

- Whitelist – keep files safe from deletion. Perfect for files linked to from off-site sources.

- Filtering – files by name and date.

- Backup – download unused media file individually or by page.

- Delete – remove files individually or by page.

- Scan – scanning process for all media files not linked to any page/post or other theme settings.

- Support – only through WordPress repository.

### Changelog ###
**[Check latest here](https://mediahygiene.com/changelog/)**


### **[Compatibility](https://mediahygiene.com/compatibilities/)** 

Please check our website to see a completely list of compatible plugins/themes.

- Gutenberg – Standard

- Elementor Basic - Standard

- Bricks (builder)

- Divi (builder)

- WP Bakery Page Builder (builder)

- Beaver Builder (builder)

- Visual Composer (builder)

- Avada (theme)

- Enfold (theme)

- Flatsome (theme)

* More to come…


### **[Pro](https://mediahygiene.com)** (available now)

- Customer Support - directly from the plugin - Pro

- Faster scanning through the use of WP-CLI (Wordpress command line interface)

- Unique scanning process for multiple page builders with one click

- Advanced Filtering - Pro
    - Media Filter by Year
    - Media Filter by Type (jpg, png, gif, wmv, mp4, etc.)

- One Shot Download (all files)

- One Shot Removal (all files)

- Folder Scan (sub-folder scanning coming soon!)

- Woocommerce

- Custom Post Types

- SEO Plugins
    - All in One
    - Yoast
    - SEO Press

- Custom Fields Plugins - Pro
    - ACF
    - Pods
    - Custom Field Suite
    - Custom Post Suits

- Sliders
    - Meta Slider
    - Slider Revolution

### **[Pro](https://mediahygiene.com)** (coming soon)

- Custom Fields Plugins - Pro
    - Jet Engine (coming soon)
    - Meta Box (coming soon)
    - CPT UI (coming soon)

- Remote server backup and restore - Pro (coming soon)

- Scheduled Scans - Pro (coming soon)

- Custom Email Notifications - Pro (coming soon)

- WPML / Weglot / TranslatePress (coming soon)


== Installation ==
**From Your WordPress Dashboard**
 
1. Go to Plugins >**Add New**
2. Search for **Media hygiene**
3. Click on **Install Now** Button
4. Click on **Activate Now** After successfully installed in your site.

**From WordPress.org**
 
1. Download **[Media hygiene](https://wordpress.org/plugins/media-hygiene/)**
2. Upload the **media-hygiene** folder to the /wp-content/plugins/ directory
3. Activate **Media hygiene** plugin from your plugins page.

== Frequently Asked Questions ==

= How do I know which media files are unused and safe to delete? =

The Media Hygiene plugin has a built-in media scanner that looks at the WordPress database, theme and plugin(s) to identify which media files are no longer in use. You’ll be presented a list in our dashboard that is safe to delete.

Please backup your site before you delete the files.

= Will this plugin remove any media files that are still being used on my website? =

The Media Hygiene plugin will not remove media files that are in use on your website. This means that if a media file is being used in a post, page, or other database entry, it will NOT show up in the scanning results and be presented as an option to be deleted.

If you are certain that some files are being used on your site, you can whitelist that file and it will longer be considered for deletion.

= How does the plugin identify and remove the unused media files? =

The Media Hygiene uses a few scanning modes. The first mode compares the database entries of specific modules with the files. The second mode scans each folder in the wp-content/upload directory. It identifies files that are not listed in the database and considers them to be unused.

= Will this plugin remove any media files from my backups? =

The Media Hygiene plugin does not have the ability to look inside backups and/or remove any files from your backups.

= Will removing unused media files affect the performance of my website? =

While removing unused media files does not directly impact page loading times, removing unused media files can actually improve the performance of your server and indirectly improve loading times. Unused media files take up space on your server and can cause backups to take longer. 

= Is there any risk of data loss or corruption when using this plugin? =

Like any software, there is a small risk of data loss or corruption when using the Media Hygiene plugin. However, the developer has taken steps to minimize this risk by thoroughly testing the plugin and including safety features on various hosting platforms (e.g. shared, VPS, and dedicated). Please note: websites hosted on shared platforms have a greater probability of failure due to limited allowable resources dictated by the hosting provider.

Additionally, it is always recommended to keep a backup of your website before using any plugin that modifies your directories, just in case something goes wrong.

= How often should I run this plugin to keep my media library clean? =

The frequency at which you run the Media Hygiene plugin depends on how frequently you add media files to your website. There is an email notification feature that allows informs you of the number of files uploaded but not scanned.

If your website receives a high volume of traffic and media files are frequently added, it's recommended to set notifications more frequently, such as every week.

= Does this plugin have any limitations or potential conflicts with other plugins or themes? =

The Media Hygiene plugin is designed to work seamlessly with all the most popular WordPress themes and plugins. However, WordPress is a dynamic ecosystem where there are many changes occurring. The developers have tried to accommodate every possibility.

To our knowledge, the plugin does not have any known conflicts with other plugins or themes. 

We strongly recommend backing up the website and/or running the plugin on a staging or development environment.

If you do encounter any issues or conflicts, you can contact the developer for support and guidance. The developer will work to resolve the issue as soon as possible and provide a solution.

= Can I preview the media files that will be deleted before they are removed? =

Yes, the Media Hygiene plugin allows you to preview the media files that will be deleted before they are removed. The plugin's media scanner will provide a list of all the unused media files, including details such as the file name, image, location (URL), and size.

You can review the files and whitelist the file to prevent deletion.

= Is there any customer support available if I have any issues with the plugin? =

Yes, there is customer support available for the Media Hygiene plugin. The developer provides [basic support](https://wordpress.org/support/plugin/media-hygiene/) through the WordPress repository, where you can find answers to frequently asked questions and troubleshoot common issues. 

Pro users will have access to direct support inside the plugin. The support team will respond to inquiries as soon as possible, but response times may vary depending on the nature of the inquiry and the volume of support requests.

= Can I exclude certain media files or folders from being deleted? =

Yes, the Media Hygiene plugin allows you to exclude certain media files type from scan that do not display in unused files by adding files to a whitelist in the scan results list or It is for Folder Scan separate from Regular Media Scan. 

= Can I restore any media files that were accidentally deleted? =

The Media Hygiene plugin does not have a built-in feature to restore deleted media files. You can restore accidentally deleted media files by using a backup of your website. 

= Is there a way to schedule the plugin to run automatically at regular intervals? =

No, the Media Hygiene plugin does not allow you to schedule the plugin to run automatically at regular intervals. We will be including this in the Pro version of the plugin.

= Does this plugin work with multisite installation of WordPress? =

This feature is not available yet but coming.

= Can I see a log of all the media files that have been deleted by the plugin? =

This feature is not available yet but coming.

= Will this plugin remove any meta data associated with the media files? =

No, Media Hygiene will remove the file in its entirety from the WordPress media library. It does not remove metadata only.  

= Is the plugin compatible with the latest version of WordPress? =

The Media Hygiene plugin is designed to be compatible with the latest version of WordPress. The developer regularly updates the plugin to ensure that it continues to work seamlessly with the latest version of WordPress.

== Screenshots ==

1. Scan and See
2. Identify Unused Media Files
3. Remove Media Files 

= Minimum Requirements =

* PHP 7.4 or greater is recommended
* MySQL 5.6 or greater is recommended