Plugin Name

Extends NextGen Gallery (prior to version 2.0) / NextCellent Gallery to simplify the image filtering, providing a simple way to filter gallery images with their own tags. This plugin depends on NextGEN Gallery prior to version 2.0 or NextCellent Gallery. This plugin will not work with newer versions of NextGEN Gallery and IT WILL NOT BE UPDATED TO WORK WITH THEM. This plugin is minimally maintained: please make a donation to encourage future developments using this link Donate to this plugin ». = WARNING! NextGenGallery 2.0 update breaks all = NGG 2.0 has a completly different structure: Powertags will only work with NGG < 2.0 Please refer to this nextgen-gallery-200-conflicterror Usage

1. Add one or more tags to the gallery images
2. Insert the nggpowertags shortcode:[nggpowertags gallery=X] (where X is the gallery ID) and you have done.
3. Optionally you can add one or more attributes:
4. tagmenu_sep: to define a character to separate the tags (default is ",")
5. tagmenu_format: can be "sep", "list" or "select" or "empty" to hide the menu (default is "sep", which stands for separator)
6. all_word: can be one of the translated strings see Translation notes (default is "All")
7. template=caption or one of other ngg templates (the same as nggallery shortcode)
8. exclude: see "Include/Exclude notes"
9. include: see "Include/Exclude notes"
10. unique: you can add an unique value per gallery

You can also set more than one gallery using a comma separated list of IDs, for example: [nggpowertags gallery=1,2,3] Include/Exclude notes The include attribute has been set to have the precedence on the exclude attribute and can be also used to specify a custom ordered list of tags. To better understand the precedence, I show you an example of a gallery (name it with ID=1) with 3 images tagged as follow:

• image1: "dubai", "cool"
• image2: "cool"
• image3: "dubai"

This shortcodes are equivalent: [nggpowertags gallery=1 include=cool exclude=dubai] [nggpowertags gallery=1 include=cool] You'll end up with image1 and image2. Using this shortcode: [nggpowertags gallery=1 exclude=dubai] You'll end up with the image2 only. Custom ordered tags With the "include" attribute you can easily change the tag order as you like: if you have "dubai" and "cool" tags, you end up with the alphabetical order (cool / dubai), but if you specify the attribute "include": [nggpowertags gallery=1 include=dubai,cool] you end up with your personal ordered tags. Permalinks In order to have working parmalinks with Powertags, you have first to enable the permalinks in WordPress (using for example %postname%) then on NextGen Gallery (../wp-admin/admin.php?page=nggallery-options), checking "Activate permalinks" options. You can optionally change the gallery slug name, changing the "Gallery slug name" input field. In this way, you end up with something like this: http://www.yoursitename.com/yourpagename/gallery-slug-name/tags/yourtag Translation notes The default word used to describe all the images is set to "All". Someone asked me to add a translatable string, so I've added some useful words: "All", "Any", "Show All", "Show All Categories", "All Categories", "All Tags" Actually these are translated only on my mother tongue, which is the italian. If you need more translatable strings or more languages, please modify or create a new ".po" file and send it via mail to my email address (info@mauromascia.com). Note that, if you specify a different word (from the ones defined as translatable strings) in the "all_word" attribute, this will not be translated. Style The main structure is this: ` ... ... If you need to move the menu down, you can put some CSS (in your style.css) like this:div#nggpowertags { position: relative; } div.nggpowertags-menu { position: absolute; bottom: 0; } div.ngg-galleryoverview { padding-bottom: 30px; }` The style of the active tag can be changed using the "active-tag" class under the "nggpowertags-menu" div. If you need to hide the tag menu, you have to set the tagmenu_format to "empty": [nggpowertags gallery=1 tagmenu_format=empty]

1.6.5

• Add NextCellent Gallery as a required plugin.

1.6.1

• Fixed last commit

1.6.0

• Fixed ordered select

1.5.9

• NEW: Added ability to hide the tag menu (thanks to Petr).

1.5.8

• Better error handling.

1.5.7

• NEW: Added russian language (thanks to J-Skip).

1.5.6

• Fixed: Added a parent div above menu and content.

1.5.5

• Typo correction: changed "sel" to "sep" in the attribute options readme.

1.5.4

• Fixed: The tag slug must be used insted of the tag name in the taglist.

1.5.3

• Fixed: SVN commit error

1.5.2

• NEW: Added the "All" word (and others) translatable.

1.5.1

• NEW: Added the "select" option for the tagmenu_format attribute
• NEW: Added the "active-tag" class for the active tag, so you can easily add the style in your CSS stylesheet.

1.5.dev

• NEW: Added the "include" attribute

1.4.1

• Fixed: "Warning: Missing argument 2 for wpdb::prepare()"
• Fixed: added the menu to the output, doesn't print it directly

1.4

• Fixed: Clean permalinks issue
• Fixed: "Warning: in_array() expects parameter 2 to be array, string given"

1.3

• Fixed: Picture sort order issuey
• NEW: Multiple galleries selection

1.2

• Fixed: "exclude" attribute when there are multiple tags per image

1.1

• NEW: "exclude" attribute to hide one or more tags
• Fixed: the ability of filtering by the gallery ID

1.0

• First release