This extensively configurable plugin comes packed with a bunch of features enabling media tagging, including search and media taxonomy.
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
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 :
- 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 :
- 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 :
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 :
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.
Requires: 3.0 or higher
Compatible up to: 3.7.1
Last Updated: 2013-12-6
0 of 2 support threads in the last two months have been resolved.
Got something to say? Need help?