Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

Clean Image Filenames

Filenames with special characters or language accent characters can sometimes be a problem. This plugin takes care of that by cleaning the filenames.

Filenames with special characters or language accent characters, like Château de Ferrières.jpg and smörgåsbord.png, can sometimes be a problem for browsers or servers. This plugin takes care of that and cleans the filenames of files uploaded to the WordPress media library.

This plugin cleans the filenames from special characters like exclamation marks, periods, and commas and accent characters like Swedish and German umlauts. Special characters are remove, accent characters are converted to their non-accent equivalent, and blank spaces are converted into dashes.

Easily set the plugin to clean the filenames of images only or all files uploaded to the media library. Developers can take advantage of the built in filter to get really specific about what file types to clean the filenames of.

Features

  • Can be used for all file types, only image file types, or only specific file types
  • Is multisite compatible
  • Works with custom upload_dir setups
  • Doesn't alter your database or uploads settings

Plugin filter for developers

Developers can get really specific about what file types to clean by using the clean_image_filenames_mime_types filter in their plugins or themes. When using this filter, settings saved through the settings page are overridden. For a complete list of mime types, see Wikipedia.

The following example would make the plugin clean the filenames for PDF, JPEG and PNG files only.

function my_clean_image_filenames_mime_types() {
    $mime_types = array(
        'application/pdf', 
        'image/jpeg', 
        'image/png', 
    );
    return $mime_types;
}
add_filter('clean_image_filenames_mime_types', 'my_clean_image_filenames_mime_types');
Author Upperdog
Profile
Contributors Upperdog, Gesen
Tags files, images, media, upload
  1. clean-image-filenames screenshot 1

    Easily choose between cleaning the filenames of all files or images only.

  1. Upload the clean-image-filenames directory to the /wp-content/plugins/ directory.
  2. Activate the plugin through the 'Plugins' menu in WordPress.

1.1.1

  • Added uninstall script that deletes plugin settings when the plugin is uninstalled.

1.1

  • Added plugin settings to media settings page with option to convert all file types or just image file types.
  • Added shortcut to plugin settings from the plugins list.

1.0

  • Initial release.

Why does this plugin exist?

No matter how hard you try to teach people to name their files in a certain way before uploading, sooner or later you will end up with a media library with filenames like Château de Ferrières.jpg or Smörgåsbord.png. Sometimes browsers have a hard time displaying images with filenames like these and the images end up broken.

Can this plugin clean the filenames of existing files in the media library?

No, this plugin only cleans the filenames of files when they are being uploaded to the media library.

Share  
Download
Version 1.1.1

Requires WordPress version: 2.9 or higher

Compatible up to: 4.7.2

Last Updated 07 Dec 2016

Date Added: 03 Oct 2014

Evaluation
star1
star2
star3
star4
star5

4.9 stars
10 ratings
11,671 downloads

Compatibility

Not Enough Data

Reports:
Works: 0
Broken: 0

Probably Works.
Considering downloads, would expect problems reported.