Author: phd
The WP ImageTagger plugin provides the needed tools to categorize any image of your WordPress blog by associating these images to any defined tag or category. It includes a tagcloud widget that will make the process straightforward for everyone
Installation:
To install the WP ImageTagger plugin just follow this simple 10-step recipe :
Download the plugin and expand it to an empty directory of your local disk drive.
Copy the local wp-imagetagger folder created by the unzipper onto your server plugins folder (wp-content/plugins/). Make sure you end up with all the PHP files, readme.txt and screenshots in wp-content/plugins/wp-imagetagger directory.
Login into the WordPress administration area and click on the Plugins left menu. Expand the Installed view.
Locate the ImageTagger plugin and click on the Activate link.
Make sure your blog already holds posts or pages with images.
Make sure you already created a list of tags for your blog.
Start associating your blog images with any tag of your blog. Two methods for this purpose :
From your WordPress administration panel, go to Settings > ImageTagger and start associating the first image found to any tag in the Tag Editor
Or, still from the ImageTagger 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 image : from any post or page holding images, click on the image 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).
Make sure you can run PHP code from your page text (using plugins like runPHP).
From your WordPress editor, enter the single line code : <?php wpit_multisort_insert(); ?>
Check the result on the page containing this call.
Start playing with the options offered in the ImageTagger admin panel.
By default your search page is the same as your result page. You can also choose to activate the ImageTagger widget to integrate an image search tagcloud in your sidebar, or to manage the search page at a different address for a specific use.
Go !
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.
Thats all for today - Enjoy !
faq:
What are the prerequisites to run this plugin ?
At least one image should be present in your blog. Otherwise the ImageTagger admin panel will inform you that you need to start working on your blog !
Same comment for the tags declared in your blog.
How are defined the tags proposed for the image classification ?
By default the plugin will use the WordPress tags. Anyhow you can decide to use WordPress categories instead, or to combine tags and categories.
Can I create groups of tags ?
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.
Which image formats are supported ?
JPEG, GIF and PNG are supported.
Are the WordPress gallery themes supported ?
Yes, the images managed within WordPress galleries will be available for tagging as any other standalone image.
How do I tag the images of my blog ?
Having installed the plugin according to the instructions provided on the installation page, two alternatives are offered to tag your images :
From your WordPress administration panel, go to Manage > ImageTagger and start associating the first image found to any tag in the Tag Editor ;
Or, 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 image : from any post or page holding images, click on the image caption (being administrator) and make the association with any tag from the Tag Editor panel.
How do I know if an image is tagged or not ?
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 images and the associated tags. You are able to get any image tagging status from this page.
Additionally, in case your site theme displays image captions : a tooltip appears if you put your mouse pointer over the image caption in the page or post holding this image. This tooltip displays the tags associated to the image.
How do I change the tags already associated to an image ?
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 images and the associated tags. You are able to get any image tagging status from this page.
Additionally, in case your site theme displays image captions : click on the image caption (being administrator) and make the association with any tag from the Tag Editor panel.
How do I know the total number of images my site holds, and that can be tagged ?
This information is the X value displayed in light grey in the upper right part of the ImageTagger admin panel as X/Y/Z.
How do I know the number of images I already tagged ?
This information is the Y value displayed in light grey in the upper right part of the ImageTagger admin panel as X/Y/Z.
How do I know the number of images remaining to be tagged ?
This information is the Z value displayed in light grey in the upper right part of the ImageTagger admin panel as X/Y/Z. Consequently Y+Z=X.
How do I insert the ImageTagger search form on a page or post ?
Edit your page or post with the WordPress editor and insert <?php wpit_multisort_insert(); ?>. Then ensure this page is allowed to run PHP code (refer for instance to the runPHP plugin for this purpose).
Can I tag images without having yet inserted the ImageTagger form on my site ?
Yes, these are two separate processes. On one hand you build your database by tagging the images, on the other you run queries on this database through to the <?php wpit_multisort_insert(); ?> call.
What are the different display modes available to manage the search page ?
The search can be presented to the visitor under two different representations than can be mixed together into a third one :
a tag cloud display : the tags available for search are presented WordPress fashion ; this representation is compact but suitable for single tag search only
a form display : the tags are listed in a form ; the search is done by ticking one or more tags. This makes this representation more adapted for advanced, multi-criteria search, although requiring potentially much more room on your page in case of big tag collection.
a combined display : ultimately the 2 display styles can be merged in one ; the tag cloud is displayed above the search form, to bring at the same time the lightness and efficiency of the tag cloud method while proposing the search form for more advanced filtering.
Can the visitor switch between the three search display styles ?
This possibility is offered by default in the option panel. You can anyhow preset a default search display style, not switchable by visitors..
What are the different display modes available to manage the result page ?
This can be done using in three different ways :
itemized image list : the results are presented as a vertical list of images displayed with a title and the post they refer to. This mode is suitable for getting the maximum information on the search result, but not adequate when the number of results found is too important.
thumbnail gallery : the results are presented in a compact display consisting in a gallery of thumbnail images. More information can be obtained rolling the mouse over each image, although it is not the most adequate for having a direct reading of the image related information.
image captions list : this display mode does not display the image and restrict itself to the text information. It will be preferred by visitors looking for specific text information rather than pictorial impression.
These three modes are paginated. The number of result per page is an option accessible in the admin panel.
Can the visitor switch between the three result display styles ?
This possibility is offered by default in the option panel. You can anyhow preset a default result display style, not switchable by visitors.
Has the search page to be at the same address as the result page address ?
Although this possibility is offered, the search panel can redirect to a different page. See below for the implementation details.
How do I manage the calls to wpit_multisort_insert() ?
There are three possible implementations
Single page implementation :
Create a new page (or use existing one if you want).
Make sure you can run PHP code from your page text (using plugins like runPHP).
From your WordPress editor, enter the single line code : <?php wpit_multisort_insert(); ?>
Check the result on the page containing this call.
Play with the options offered in the ImageTagger admin panel to adjust the search and result format.
Search page different from the result page :
Manage the page embedding the search access :
Create a new page, for instance http://www.mysite.com/imagelibrary_search, or use existing one if you want.
Make sure you can run PHP code from your page text.
From your WordPress editor, enter the single line code : <?php wpit_multisort_insert("http://www.mysite.com/imagelibrary_result"); ?>, assuming you want your visitor to be directed and have the results displayed on page http://www.mysite.com/imagelibrary_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 argument passed to wpit_multisort_insert(), lets say http://www.mysite.com/imagelibrary_result (or use existing one if you want).
Make sure you can run PHP code from your page text.
From your WordPress editor, enter the single line code : <?php wpit_multisort_insert(); ?>.
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/imagelibrary_search ; you will be directed to the result page http://www.mysite.com/imagelibrary_result
Play with the options offered in the ImageTagger admin panel to adjust the search and result format.
Sidebar tag cloud widget :
In this case, the call to wpit_multisort_insert() is directly manage by the ImageTagger widget. Refer to the section below for the activation.
How do I activate the tagcloud widget ?
Before that you need to have defined your ImageTagger 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 ImageTagger result page according to the section How do I manage the calls to wpit_multisort_insert() ? above.
If you get the error 404 when clicking on the sidebar tag cloud, likely you misconfigured the Result page field.
What is the syntax of the call to wpit_multisort_insert() ?
The wpit_multisort_insert() function is 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 complete syntax is :
<?php
wpit_multisort_insert($result_page_url, $num_tags_displayed, $font_size_min, $font_size_max);
// $result_page_url = URI of the result page, for instance http://www.mysite.com/imagelibrary_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
// $font_size_min = maximum font size for the tag cloud
?>
This function 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 :
$result_page_url : when omitted, the result page is the same as the one containing the call to the function
$num_tags_displayed : when ommitted, the number of tags displayed is the one defined in the options set in the plugin admin panel.
$font_size_min : when ommitted, the minimum font size for the tag cloud is the one defined in the options set in the plugin admin panel
$font_size_max : when ommitted, the maximum font size for the tag cloud is the one defined in the options set in the plugin admin panel
Standard PHP function call syntax applies for passing the arguments. An argument can be omitted by ignoring it if it is after the last explicit argument, or by passing (empty single quotes) if it is before an explicit argument. Some examples :
Basic call, no argument (in fact : omission of all four args) :
<?php wpit_multisort_insert(); ?>
Result : a search panel (form, tag cloudor 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.
Omission of one argument before an explicit value passing, followed by the omission of the two last args :
<?php wpit_multisort_insert(, 10); ?>
Result : as well, the search panel and results are displayed on this same page. The number of tags is set to 10, and the font sizes are taken from the admin panel.
Explicit passing of all four arguments :
<?php wpit_multisort_insert(http://www.photos-dauphine.com/image_search_results, 10, 16, 35); ?>
Result : the four parameters are forced to the values passed in, and the corresponding options set in the admin panel are ignored. This example is the one used to format the call for the ImageTagger widget, holding a tag cloud in the side bar.
How is my WordPress database affected by this plugin ?
ImageTagger does not affect any of the existing WP data tables to avoid any risk of corrupting your database. The association you create between tags and images are stored in a new table wp_term_relationships_img.
ImageTagger options set in the admin panel as stored in the wp_options table, in accordance with WordPress plugin development guidelines.
What should I do to ensure I backup the image tagging information when I am run backups of my WordPress database ?
Make sure you include the wp_term_relationships_img table specifically created by this plugin to keep track of the image 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.
What are the available languages ?
English, French,
... 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.
Damned, my question is not listed there !!?
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 ImageTagger 2.4.1 | PHP 5.2.6-1+lenny4 | MySQL 5.0.32-Debian_7etch8-log
indicate the steps you follow to reach to 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 images, 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.
Ideas or suggestions ...
... are truly welcomed given that it will make this plugin even more valuable to the users community. Spin your suggestions this way.
WP ImageTagger 2.5.1 is nice Wordpress Plugin. We suggest you to install WP ImageTagger 2.5.1 to your Wordpress blog and view the features of the plugin. For your safety, please have a decent antivirus installed, with updated definitions that will protect you from virus threats.
Download
Downloadic guarantees that
WP ImageTagger 2.5.1 software is 100% clean, which means it does not contain any form of malware, including spyware, viruses, trojans and backdoors.