Plugin Directory

Test out the new Plugin Directory and let us know what you think.

WP MediaTagger

Extensively configurable plugin packed with a bunch of features enabling media tagging, search and media taxonomy.

Future possible implementations

A lot of some enhancements brought to MediaTagger were made thanks to your suggestions. Feel free to contribute with your own proposals :

  • search field as widget
  • Check tags associated to medias in the wp_term_relationships table. Sometime there are many, although I would expect the only default tag '1' (default category) is there. Possibly cleanup if too mazy.
  • Plugin cleanup to make the HTML generated code strict XHTML compliant
  • Improved pagination for multipage results, displaying quick access page links
  • Log visitors search and make it visible to the administrator
  • Plugin internationalization : the mediatagger.pot file, required to translate the package to any other language, is provided for volunteers with the plugin files (contact me to make sure the *.pot file part of the package is up-to-date). If you are interested in internationalizing this plugin, I would certainly welcome your help. Simply let me know so that I can push your translation to the repository. If needed I can provide you the methodology, many tools are available to ease this task.


  • Updated Dutch translation


  • Fix of tooltips in the options dashboard
  • Fix of wrong JS code formatting with WP 4.2.3


  • Dutch translation now available - (Thanks Miriam)
  • Cleanup of deprecated API calls


  • Fixed bug linked to obsolete mysql_get_server_info()


  • Fixed negative logics for link to gallery image display mode.


  • Search display mode switchable / result display mode switchable bug fixed.


  • Default search mode bug fixed.


  • Read & write to new table secured with systematic table detection checking.


  • Fix widget parameter loading moving from before 4.0 to 4.x

4.0 - Major release, plugin redevelopped using OOP

  • Structural change : plugin ported to Object Oriented Programmation ; this drastically reduces the risk of variable collision with other plugin or WordPress codex itself.
  • Compatible with previous plugin releases.
  • Compatible with WordPress 3.8.
  • Graphical interface redesigned to make it more simple, although packed with more features :
  • Plugin setup now directly accessible from the left side column menu in the WordPress administration panel. 3 submenus :
  • Interface 1 : media explorer, to select media and manage tags; functionality widely enhanced to improve user experience. For instance a customer list of media can be built for later tagging. In the tagging view, easier navigation back and forth.
  • Interface 2 : player, to interact live with the database you populate while tagging.
  • Interface 3 : options ; the presentation is now much lighter.
  • Group (or 'bulk') tagging to tag similarly a group of media selected ; flexible media selection.
  • Tagging data now stored in wp_mediatagger table - not anymore in wp_term_relationships_img.
  • plugin options are now stored in a serialized option variable in the database to avoid jamming it with too many insertions related to the same plugin.
  • code cleaning : deprecated functions replaced with recommended equivalents.
  • new short code added, on top of the existing [mediatagger] used so far : [mediatagger_count] ; it displays the number of media available.
  • spanish version may not cover all the texts with this release - this will be fixed in the next release. This is due to many messages that were changed and not available anymore in the translation.
  • finally : this new version was extensively tested on my own database holding 2000 media. A user reported using with more than 40,000. I would rate it as pretty stable, waiting for your feedbacks...


  • The plugin is now available in spanish. It is by default in english, you can now localize it in french or spanish. In order to do so, add to your wp-config.php file :
  • French : define('WPLANG', 'fr_FR');
  • Spanish : define('WPLANG', 'es_ES');

Thanks to WebHostingHub for the spanish translation.

  • In the list view of the media explorer (admin), you can select the first photo to be listed on the page by typing 'start:xxx' in the seach field, xxx being the index of the first photo to be listed on the page. The newer the photo, the higher the index.


  • Changes made to bring compatibility with WP3.4. Indeed image caption shortcode is not supported anymore starting with 3.4. As a consequence it is not possible anymore to click on the caption to assign a tag to an image, when logged as admin.
  • Some opening php achors ("<?") were corrected to the compliant notation ("<?php")


  • Layout change in the search form and result display headers to improve usability
  • If there is no tag groups defined, the tags are listed alphabetically instead of by date of tag creation


  • New feature : when the media is not an image, the filename is displayed below the icon in gallery mode.
  • New feature : if the media is a PDF file and if the server support the thumbnail extraction routines, a thumbnail of the cover page is displayed (PNG format) instead of the generic PDF image. Server prerequisites : Imagemagick and Ghostscript must be properly installed and enabled.
  • New feature : the column layout of the tags form can now be forced, keeping the group names on the first line. Insert a blank line before the line defining the tag group. It will be interpreted as a column break when displaying the tag form. This overrides the rule defined by the parameters "number of tags per column" for the tag editor and search form ; these 2 parameters are greyed out in the administration panel and not used by the plugin.
  • New feature : an new search method is added, with a free search field. This field can be toggled on and off, as for the cloud and tag form. When triggered through this field, the search is done on the medias names rather than on the tags attached to the medias.


  • Fix : there was a risk of data loss with version 3.0 when upgrading from ImageTagger, if not deactivating the ImageTagger plugin before activating MediaTagger. Tagging stored in the wp_term_relationships_img table was reset under certain conditions. This is fixed with version 3.0.1, no more risk of data loss. Anyhow it is still mandatory to deactivate ImageTagger before upgrading, otherwise a fatal error is caused by function names conflict between the 2 plugins.

3.0 (first release under "WP MediaTagger" plugin denomination)

  • Formats now supported, on top of the original GIF, JPEG, PNG : TXT, RTF, PDF, MP3
  • Administration panel : added selection of media format that are selected for tagging ; by default GIF, JPEG and PNG are preselected
  • Result gallery : image resampling quality improved (antialias)
  • Search form : "Clear" button added to reset selected tags (last release under "WP ImageTagger" plugin denomination)

This is the final version of the WP ImageTagger plugin. This plugin is now obsoleted by WP ImageTagger plugin.


  • Debug comment remove from the administration panel.
  • Added "Settings" link in extension list panel (close to deactivate and modify)
  • Strengthened SQL queries error checking for database integrity audit function
  • Donation button added at bottom of administration panel ; donation link added in the extensions management page

  • XHTML strict : fixed parametrization form fields

  • Tag cloud fix : division by zero occuring in some cases

  • Minor fix : parameter layout in the plugin admin panel under WP 2.9.2

  • Fix : non UTF-8 alphabetical tags ordering in the tag cloud

  • Fix, major : 2.5.5 feature was preventing the form and tag cloud search.

  • Fix, minor : no tag selected case through the form or tag cloud, or tags selected not matching any media.


  • A search can now be done directly on the media database without going through the search form or tag cloud. All you have to do is to form URLs like http://wwww.mysite.com/media_library?tags=car+plane+airport, forming your tag list using tag slugs. In that example, the page media_library is the one set with the search form and/or tag cloud, that will be displayed with the tag cloud and/or search form, clean of any search result if requesting http://wwww.mysite.com/media_library. A tag slug is the tag name with no accent and spaces replaced by hyphens. For instance, the tag "l'automne en forêt" becomes "l-automne-en-foret".
  • By default the result page produced by explicit search URL will not hold any tag cloud or search form. Anyhow you can request to have this capability on top of the search results by forming URL like : http://wwww.mysite.com/media_library?tags=car+plane+airport&display=cloud. Possible values for the display argument are : cloud, form, combined.
  • Direct PHP call to function wpit_multisort_insert() was deprecated since 2.5.2 and is now unactivated from 2.5.5. Refer to the installation guide in case you are still using the direct PHP form.

  • Cleanup done in the code to eliminate any hard coded reference to the WordPress table names.
  • Audit tool translated to french.

New function in the admin panel : database integrity audit and repair tools are now available in the section Misceallenous. This new audit functionality will help you to better control what can sometime be a rather anarchic growing of your database. The following audit features are offered along with a repair solution :

  • Audit of the wp_posts table to detect the needless post revisions. You can optionally clean those entries.
  • Audit of the wp_posts table to detect attachments having still a proper entry in the table although not being referenced in any of the posts. You can optionally clean those entries.
  • Audit of the wp_term_relationships table to detect orphean entries : any post associated to tags although the post itself does not appear anymore in the wp_posts table. You can optionally clean those entries. This feature will help you better control your post taxonomy growth.
  • Audit of the wp_term_relationships_img table to detect orphean entries : any media associated to tags although the media itself does not appear anymore in the wp_posts table. You can optionally clean those entries. This feature will help you better control your media taxonomy growth.
  • Audit of the medias not being yet tagged.

Knowing how sensitive any cleanup of the database could turn to be, I tested extensively under various situations and found this feature pretty cool. Then you know the rule : before any cleanup of the WordPress database, run a complete backup, including all the database tables.

  • Fix : some "orphean media" cases were not covered and leading to some marginalities. Typically this happens when an media was uploaded as part of a post and the post was later deleted, the media being still a valid entry in the post table.
  • Fix : when an media is deleted from the database (through the WordPress media management menu, or manually in the database), the plugin needs to detect it and delete any orphean entry (entry related to an media not existing anymore in the database). This can be detected by comparing the total number of medias in the DB to the sum {medias untagged + medias tagged}, which must be equal. This case differs from above, where the media is still an entry in the "posts" table, but not referenced anymore by a post. This is an excellent opportunity to underline the risk one takes when trying to manually tweak the database instead of relying on the standard procedures. If you manage database modifications manually, be prepared to make some recovery ... manual as well.

  • New function in the admin panel, taxonomy section : a possibility is now offered to the user to run a batch on the complete posts taxonomy to align it on the media taxonomy. This option should be worth when you want to turn your post taxonomy into the media taxonomy just defined with this plugin after you installed it and properly built this media taxonomy. Then assuming you keep the media taxonomy function active, when you tag any media the taxonomy is automatically applied to the post containing this media.

Therefore this function should be used once after you defined the media taxonomy. If you want to make sure the plugin is then doing his job you can later track any deviation between the posts taxonomy and the medias one. If everything goes well both should be strictly the same.


  • This release is major in the sense it brings the media taxonomy feature into real life. I am glad to come to this achievement, I envisionned it as the objective for this plugin : having the tags you associate to the medias directly controlling the tags associated to the post containing those medias. Very nice for lazy people, as I tend to be sometimes. It should be a nice fit when your site content consists largely in medias. Note that this feature will take control over the standard WordPress tables wp_term_relationship and wp_term_taxonomy. As such, take some time reading the FAQ before deciding to activate this option and, although it has been extensively tested under various situations ... make a backup of your database before trying it out !

  • When linking the result gallery medias to the post containing the media, the permalink is used instead of the http://www.mysite.com/?p=41 notation.
  • Rich-text-tags now supported. An media used in the standard WordPress tag result header page will be linked back from the ImageTagger result page (if link parametrized as "link to post") on the tag result page.
  • New option in Admin Panel : the ImageTagger tag cloud can be displayed by ascending alphabetical order (default), descending rank order, or random.
  • New option in Admin Panel : the credit line displayed at the bottom of the search form in its plain version (not in accordance with the WP Plugins authoring guidelines, I concede) can now be disabled. In this case and assuming you enjoy this plugin, I let to your good willingness the possibility to include anywhere else on your site a credit line linking back to my home site (http://www.photos-dauphine.com). You decide. Be simply aware that this plugin requires that I spend a very significant amount of my spare time to answer the support requests, maintain and manage the evolution with bunch of new features.

  • All the ImageTagger supported formats (gif, jpeg, png) now take benefit of the thumbnail transfer optimization. In the previous version only the jpeg files had their transfer optimized.
  • Fix : some functions released to be used later (association of media tags to the post containing the medias) were causing servers in PHP 4.3 to fail at plugin init.

  • In marginal cases, the server side media resizing introduced in 2.5.3 was found not to provide the expected results. A new option was added in the Admin Panel / Output format / Optimize thumbnail transfer. By default this option is set to "No", which is the setup that will work in any case. To move to the optimized transfer mode, set this to "Yes", save the ImageTagger options and check that your search result displayed as a gallery properly displays the thumbnails. If not, revert this option setting to "No".

If the GD graphic library is not available on your server (check it in the page footnote), this option will be set to "No" and will not be selectable.


  • Dynamically resizes medias server side before transferring medias for gallery or media list result mode. This provides a much faster gallery display when transferring big number of medias. This improvement is only made available for sites being hosted on servers having the GD library module enabled. This setup is automatically detected by ImageTagger. To know if you benefit or not of this feature, check the footnote line in your admin panel : if you read GD Lib not available, your server does not support it. Otherwise, the GD library version is displayed.
  • Minor fixes for marginal cases (all medias tagged).


  • The plugin can now be inserted in a page or post using the safer [mediatagger options...] shortcode notation. Refer to the FAQ for any detail.
  • This improved implementation does not require anymore to have PHP execution enabled in your page.
  • The direct PHP call to the plugin function wpit_multisort_insert() is deprecated and should not be used anymore. It still works with a recommendation message, and will not be supported in future releases.


  • Minor bug fixes
  • Added gradient colors to the tag cloud (widget and plain page). The options can be parametrized from the ImageTagger admin interface for the plain page version, and from the ImageTagger widget control window for the widget implementation.


  • The plugin is now delivered with a widget interface. This new feature enables the ImageTagger tagcloud in your site sidebar.
  • There is currently no error checking on the widget input parameters - Be kind to him !


  • Various minor fixes in the Image Explorer (search functionality)


  • Admin panel : fixed Tag Editor and Image Explorer inconsistencies in specific cases (no media available, all medias tagged, all medias untagged)


  • Admin panel : expanded tagging control panel. Two views are now available : a first view ("Tag Editor", default) to tag the medias. This view scans the untagged medias and displays those for tagging ; a second view ("Image Explorer") listing all the site medias. This list can be filtered to show only the tagged medias, untagged medias, or all the referenced medias. This approach provides a way to rework tagging for sites themes not displaying captions under the medias. A search field is available to filter the listed medias.
  • Admin panel : the options setup panel can now be minimized to avoid screens unnecesarily overloaded with data not of immediate use.


  • various fixes, notably a possible path detection issue for specific twisted server setup cases. For that reason it is a major upgrade given the possible impact of the issue - get this one ASAP. In specific cases, the plugin could not detect medias due to broken media path reconstruction.


  • Fix : .png and .gif formats now supported on top of .jpeg.


  • Fix : various side effects


  • Images can now be associated not only to tags but as well as to categories defined in your blog. The admin panel allows to define the source for your keywords list : tags, categories, or tags and categories merged together.
  • Tags can be gathered by groups through the admin panel. This group display is used for both the admin panel and the search page tags form.


  • Admin panel : fixed font display problem
  • Admin panel : options presentation improved (fields now come aligned for better readability)


  • Added parametrization of tag cloud, forgotten in 2.0 : min / max font size and number of tags to display.


  • Tag cloud search representation added to the initial form, with capability to be combined with this form
  • Search result : media title list mode added
  • Possibility to have the search page address different from the result page address with explicit argument : <?php wpit_multisort_insert("http://www.mysite.com/medialibrary_result") ?> ; without argument the results are displayed at the same address as the search page address
  • All these new possibilities are parametrized through new admin panel options, plus additional parameters.


  • Irrelevant tags can be excluded from the tagging panel. The same possibility is offered to filter the list of tags displayed on the search page. This is parametrized through two separate CSV tag lists available in the Admin Panel.


  • PHP support extended down to PHP4. Any dependency on PHP 5 was removed. Now the requirements are the same as for WordPress (PHP 4.3 or greater, MySQL 4.1.2 or greater), therefore I don't expect anymore issue.


  • PHP version is checked to ensure the server complies with the minimum required (PHP 5).
  • Language localization now provided relying on I18n : english (default), french


  • Administration panel : input parameters are now validated against expected valid parameter ranges to make sure the plugin will not be shot by funky option settings. In case of improper entry, an explicit message is displayed while highlighting the faulty option entry line.


  • Admin panel offers now a bunch of settings, like capability to display the list of medias matching the searched tags in a gallery or itemized list mode.
  • Result page is paginated. Number of medias shown is a parameter.
  • Most of the messages are translated to English.


  • First release. ImageTagger concept implemented with the minimum features set enabling root functions. Plugin available in French. English localization on going.

Requires: 3.0 or higher
Compatible up to: 4.0.15
Last Updated: 2 years ago
Active Installs: 500+


4.4 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 50,2,1 100,1,1
100,1,1 100,2,2
100,1,1 100,1,1
100,1,1 50,2,1 0,1,0
50,2,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,2,2
100,1,1 50,2,1