WP MediaTagger is an extensively configurable plugin and a superset of the former WP ImageTagger plugin. It provides all the tools required to categor …
WP MediaTagger is an extensively configurable plugin and a superset of the former WP ImageTagger plugin. It provides all the tools required to categorize your WordPress blog medias by associating it to any defined tag or category. Among many features, it comes packed with a tagcloud widget that will make the process straightforward for everyone and will permit a transparent integration. Initially developped to tag medias under the WP ImageTagger denomination, WP MediaTagger now covers a much wider scope and will tag as well most of the medias widely used on the web.
In brief, this plugin extends the concept of post based taxonomy natively supported by WordPress toward an media based taxonomy.
The following functionalities are available for your blog after installing the MediaTagger plugin package :
- Associate tags to medias from the Tag Editor
- List all the medias of your site and associated tags in one central place to ease the tagging process with the Media Explorer
- Associate tags to medias from any post or page by clicking on your media captions
- Provide access to deep media search on any media associated to a list of tags, through a tag cloud, tag form or combined search display
- Select a display mode for your result page : itemized media list, thumbnail gallery, or media captions
- Any combination of search mode and result display style is possible
- Seamless integration in your sidebar thanks to the MediaTagger tagcloud widget, with direct connection to the media tagging database you just built
- The MediaTagger media taxonomy can optionally supersede the default post taxonomy
- Database integrity checkers are provided along with the fixing routines
Willing to get a visual flavor of what’s in the box ? You can see the MediaTagger plugin in action here, or have a look at screenshots there. French reading visitors will get additional insights on this plugin genesis page.
To install the WP MediaTagger plugin just follow this simple 10-step recipe.
CAUTION : if upgrading from WP ImageTagger, backup your database, taking care to include the table wp_term_relationships_img and deactivate the ImageTagger plugin from the extensions administration page before activating WP MediaTagger (CRITICAL !). Refer to instructions at page bottom.
Start associating your blog medias with any tag of your blog. Two methods for this purpose :
- From your WordPress administration panel, go to Settings > MediaTagger and start associating the first media found to any tag in the Tag Editor
- Or, still from the MediaTagger administration area, switch to the Image Explorer mode, navigate to the file you want to tag and click on the file to select it back to the Tag Editor
- Or, assuming your site display captions below each media : from any post or page holding medias, click on the media caption (being administrator) and make the association with any tag from the Tag Editor panel.
Prepare a result page to present the search results :
- Create a new page (or use existing one if you want).
- From your WordPress editor, enter the MediaTagger shortcode :
[mediatagger]
– There are options you will learn later, but this simple form is perfect for a quick start.- Check the result on the page containing this call.
- Start playing with the options offered in the MediaTagger admin panel.
By default your search page is the same as your result page. You can also choose to activate the MediaTagger widget to integrate an media search tagcloud in your sidebar, or to manage the search page at a different address for a specific use.
Go ! And if you like it, why not proceeding with a small donation?
If you are interested in seeing the plugin in action, you might wish to go and have a look here.
More information on this plugin utilization can be found there.
Finally, if you have any questions, please refer to the FAQ bottom page, section – section Damned, my question is not listed there.
That’s all for today – Enjoy !
If you are upgrading from WP ImageTagger :
The tagging made on images will be preserved IF you follow these simple instructions:
BACKUP YOUR DATABASE, TAKING CARE TO INCLUDE THE wp_term_relationships_img TABLE – in case something turns wrong during the upgrade.
Deactivate ImageTagger plugin from the extensions administration page – OTHERWISE YOU RISK TO LOOSE THE TAGGING ALREADY DONE.
Install and activate MediaTagger plugin
On your result page : replace the shortcode [imagetagger] by [mediatagger], keeping the same options if you use some
If you were using the ImageTagger widget : go to Appearance > Widgets ; reposition the MediaTagger widget in the sidebar, all the settings formerly made for the ImageTagger plugin will be automatically restored.
You can de-install the WP ImageTagger plugin from the Extensions interface.
To install the WP MediaTagger plugin just follow this simple 10-step recipe.
CAUTION : if upgrading from WP ImageTagger, backup your database, taking care to include the table wp_term_relationships_img and deactivate the ImageTagger plugin from the extensions administration page before activating WP MediaTagger (CRITICAL !). Refer to instructions at page bottom.
Start associating your blog medias with any tag of your blog. Two methods for this purpose :
- From your WordPress administration panel, go to Settings > MediaTagger and start associating the first media found to any tag in the Tag Editor
- Or, still from the MediaTagger administration area, switch to the Image Explorer mode, navigate to the file you want to tag and click on the file to select it back to the Tag Editor
- Or, assuming your site display captions below each media : from any post or page holding medias, click on the media caption (being administrator) and make the association with any tag from the Tag Editor panel.
Prepare a result page to present the search results :
- Create a new page (or use existing one if you want).
- From your WordPress editor, enter the MediaTagger shortcode :
[mediatagger]
– There are options you will learn later, but this simple form is perfect for a quick start.- Check the result on the page containing this call.
- Start playing with the options offered in the MediaTagger admin panel.
By default your search page is the same as your result page. You can also choose to activate the MediaTagger widget to integrate an media search tagcloud in your sidebar, or to manage the search page at a different address for a specific use.
Go ! And if you like it, why not proceeding with a small donation?
If you are interested in seeing the plugin in action, you might wish to go and have a look here.
More information on this plugin utilization can be found there.
Finally, if you have any questions, please refer to the FAQ bottom page, section – section Damned, my question is not listed there.
That’s all for today – Enjoy !
If you are upgrading from WP ImageTagger :
The tagging made on images will be preserved IF you follow these simple instructions:
BACKUP YOUR DATABASE, TAKING CARE TO INCLUDE THE wp_term_relationships_img TABLE – in case something turns wrong during the upgrade.
Deactivate ImageTagger plugin from the extensions administration page – OTHERWISE YOU RISK TO LOOSE THE TAGGING ALREADY DONE.
Install and activate MediaTagger plugin
On your result page : replace the shortcode [imagetagger] by [mediatagger], keeping the same options if you use some
If you were using the ImageTagger widget : go to Appearance > Widgets ; reposition the MediaTagger widget in the sidebar, all the settings formerly made for the ImageTagger plugin will be automatically restored.
You can de-install the WP ImageTagger plugin from the Extensions interface.
By default the plugin will use the WordPress tags. Anyhow you can decide to use WordPress categories instead, or to combine tags and categories.
The tags can be gathered by groups. This grouping does not affect the search, it has only an effect on the tags presentation in the classification panel and in the search form. Grouping the tags by themes provides a more consistent presentation, and makes the appropriate selection faster.
The formats below can be tagged with WP MediaTagger :
Yes, the medias managed within WordPress galleries will be available for tagging as any other standalone media.
Having installed the plugin according to the instructions provided on the installation page, two alternatives are offered to tag your medias :
Go the the plugin admin panel and switch the view to Image Explorer mode. This gives you access to a page listing all your site medias and the associated tags. You are able to get any media tagging status from this page.
Additionally, in case your site theme displays media captions : a tooltip appears if you put your mouse pointer over the media caption in the page or post holding this media. This tooltip displays the tags associated to the media.
Go the the plugin admin panel and switch the view to Media Explorer mode. This gives you access to a page listing all your site medias and the associated tags. You are able to get any media tagging status from this page.
Additionally, in case your site theme displays media captions : click on the media caption (being administrator) and make the association with any tag from the Tag Editor panel.
This information is the X value displayed in light grey in the upper right part of the MediaTagger admin panel as X/Y/Z.
This information is the Y value displayed in light grey in the upper right part of the MediaTagger admin panel as X/Y/Z.
This information is the Z value displayed in light grey in the upper right part of the MediaTagger admin panel as X/Y/Z. Consequently Y+Z=X.
Edit your page or post with the WordPress editor and insert the specific MediaTagger shortcode[mediatagger]
. From this point the plugin will manage the calls to the adequate functions.
Yes, these are two separate processes. On one hand you build your database by tagging the medias, on the other you run queries on this database through to the [MediaTagger]
shortcode.
The search can be presented to the visitor under two different representations than can be mixed together into a third one :
All these modes can be freely combined.
This possibility is offered by default in the option panel. You can anyhow preset a default search display style, not switchable by visitors.
This can be done using in three different ways :
These three modes are paginated. The number of result per page is an option accessible in the admin panel.
This possibility is offered by default in the option panel. You can anyhow preset a default result display style, not switchable by visitors.
Although this possibility is offered, the search panel can redirected to a different page. See below for the implementation details.
There are three possible implementations :
Single page implementation :
- Create a new page (or use existing one if you want).
- From your WordPress editor, enter the MediaTagger shortcode :
[mediatagger]
.- Check the result on the page containing this call.
- Start playing with the options offered in the MediaTagger admin panel.
Search page different from the result page :
Manage the page embedding the search access :
- Create a new page, for instance http://www.mysite.com/medialibrary_search, or use existing one if you want.
- From your WordPress editor, enter MediaTagger shortcode, with one option :
[mediatagger result_page_url="http://www.mysite.com/medialibrary_result"]
, assuming you want your visitor to be directed and have the results displayed on page http://www.mysite.com/medialibrary_result.- Set the proper options in the Admin Panel to control the Search Format as you want.
- Check the result on the page containing this call, without running any search yet.
Manage the result page :
- Create a new page matching the URL passed inside the MediaTagger shortcode let’s say http://www.mysite.com/medialibrary_result (or use existing one if you want).
- From your WordPress editor, enter the MediaTagger shortcode :
[mediatagger]
.- Check the result on the page containing this call
- Set the proper options in the Admin Panel to control the Result Format as you want.
- Launch a search from your page http://www.mysite.com/medialibrary_search ; you will be directed to the result page http://www.mysite.com/medialibrary_result
- Play with the options offered in the MediaTagger admin panel to adjust the search and result format.
Sidebar tag cloud widget :
- In this case, the call to the MediaTagger API is directly managed by the widget. Refer to the section below for the activation.
Before that you need to have defined your MediaTagger result page, as described just above.
Then from your site admin page, go to Appearance > Widget and click on Add to add the widget to your sidebar. Configure then the widget in the right column clicking on the Edit link, followed by Done. Do not forget to Save Changes. Pay specific attention to the Result page address parameter. This parameter must be the address of a page of your site that you defined as your MediaTagger result page according to the section What are the possible implementations of the search and result pages ? above.
If you get the error 404 when clicking on the sidebar tag cloud, you likely misconfigured the Result page field.
In the WordPress glossary, a shortcode is a syntaxic expression that will trigger some functions. In our case, the shortcode is built around the mediatagger
keyword. The shortcode relies on a single scalable function, managing the search aspect as well as the result display under various shapes. It can be called with a variable number of arguments. The shortcode needs to be formatted as follows :
[mediatagger opt1="val1" opt2="val2" ...]
The 6 options available are :
$result_page_url = URI of the result page, for instance 'http://www.mysite.com/medialibrary_result'. Can be absolute (preferred) or relative to the site root $num_tags_displayed = number of displayed tags - If set to 0 (zero), the complete set of tags is displayed $font_size_min = minimum font size for the tag cloud (pt) $font_size_min = maximum font size for the tag cloud (pt) $font_color_min = color that will be used for the least frequently used tags (hex format : 4343f6 for instance) $font_color_max = color that will be used for the most frequently used tags (hex format : 4343f6 for instance)
The shortcode works with default arguments. Therefore it can be called without explicitly passing the complete list of arguments. When an argument is omitted, the behaviour is the following :
Some examples :
Shortcode with no argument :
[mediatagger]
Result : a search panel (form, tag cloud or combined) is displayed on the page holding this call. The search result is displayed on the same page. The number of tags and font sizes are the ones set in the admin panel.
Shortcode overriding the number of tags in the tag cloud :
[mediatagger num_tags_displayed="15"]
Result : as well, the search panel and results are displayed on this same page. The number of tags is set to 15, independantly from the setup done in the option panel ; other parameters are the ones set in the options panel.
Explicit passing of all 6 arguments :
[mediatagger result_page_url="http://www.mysite.com/search_result/" num_tags_displayed="15" font_size_min="8" font_size_max="25" font_color_min="4545fe" font_color_max="111132" ]
Result : the 6 parameters are forced to the values passed in, and the corresponding options set in the admin panel are ignored.
Yes, this is possible. 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+form
. Possible values for the display argument are : cloud, form, field, which can be combined together.
This option is meaningful when you are managing a large collection of medias. The idea is to tag the medias with MediaTagger, and let then the plugin automatically associate the relevant tags to the post holding these medias.
When the media taxonomy is activated, the WordPress database is updated to replace the tags manually associated to the posts by the media taxonomy (on top of updating the wp_term_relationships_img table which is the basic MediaTagger mechanism) :
Make sure you include the wp_term_relationships_img table specifically created by this plugin to keep track of the media tagging information you patiently grew over time. This table should be selected for your backup as well as the standard WordPress database tables, such as wp_options, wp_terms, wp_posts, etc.
English, French, Spanish
… and as much as you can contribute if you are fluent with a language not in this list. More details on the changelog page bottom, in project section.
Did you make sure you read carefully enough the FAQ I took time and care to build as complete and explanatory as possible ? I do my best to maintain it with the latest questions I got and answers I made to their author.
Although this is not my primary job, you might direct your questions to this page, I will do my best to timely answer. To help me answering faster, please provide me with the necessary data :
- copy paste the footnote line you see at the bottom of your plugin administration panel.
Ex : WP MediaTagger 3.0 | PHP 5.2.6-1+lenny4 | MySQL 5.0.32-Debian_7etch8-log | GD Lib 2.0 or higher- indicate step by steps what you did to get the issue
- describe as specifically as possible the issue you could observe (a screenshot is a plus), with any peripheral aspect
- information related to your site : specific server setup, redirections, number of medias, any special setup …
Although I would if I could … I would not be able to give a hand being only informed that it does not work. Thanks for your cooperation.
… are truly welcomed given that it will make this plugin even more valuable to the users community. Spin your suggestions this way.
A lot of some enhancements brought to MediaTagger were made thanks to your suggestions. Feel free to contribute with your own proposals :
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.Thanks to WebHostingHub for the spanish translation.
This is the final version of the WP ImageTagger plugin. This plugin is now obsoleted by WP ImageTagger plugin.
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”.http://wwww.mysite.com/media_library?tags=car+plane+airport&display=cloud
. Possible values for the display argument are : cloud, form, combined.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.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 :
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.
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.
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.
[mediatagger options...]
shortcode notation. Refer to the FAQ for any detail.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.<?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