=== Plugin Name ===
Contributors: baba_mmx
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WZHXKXW5M36D4
Tags: nextgengallery, nextgen gallery, nextgen, tags, cloud tag, filter
Requires at least: 3.0.1
Tested up to: 3.4
Stable tag: 1.5.dev
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Extends NextGen Gallery to simplify the image filtering, providing a simple way to filter the gallery images with their own tags.

== Description ==

Extends NextGen Gallery to simplify the image filtering, providing a simple way to filter the gallery images with their own tags.
This plugin depends on NextGen Gallery.

Usage is very simple:

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:

* tagmenu_sep="," or tagmenu_sep=" | " or whatever char you want (default is ",")
* tagmenu_format=sel or tagmenu_format=list (default is "sel")
* all_word=all or all_word=tutti or all_word="click here to see all images" or... (default is "all")
* template=caption or one of other ngg templates (the same as nggallery shortcode)
* exclude=singletag or exclude="first tag, another one tag" to exlude one or more tags from be exposed
* include=singletag or include="first tag, another one tag" to include only these tags (see "Include notes" paragraph below)

You can also set more than one gallery using a comma separated list of IDs, for example:
`[nggpowertags gallery=1,2,3]`

= Include 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.


= 1.5.dev notes =

This version is not largely tested so please be careful using it and feel free to comment out on the support forum or on my personal website to help me in the improvement process.


Demo: [EscursioniAsinara.com](http://www.escursioniasinara.com/mercatino "Escursioni Asinara")

== Installation ==

1. Unzip the archive of the plugin or download it from the [official Wordpress plugin repository](http://wordpress.org/extend/plugins/nextgen-gallery-powertags/ "NextGen Gallery Powertags")
2. Upload the folder 'nextgen-gallery-powertags' to the Wordpress plugin directory (../wp-content/plugins/)
3. Activate the plugin through the 'Plugins' menu in WordPress (NextGen Gallery - of course - MUST be already enabled!)
4. Configure it under you posts/pages using the nggpowertags shortcode: `[nggpowertags gallery=X]` (where X is the gallery ID) and you have done.
5. Optionally you can add one or more attributes (see the description page)

You can also set more than one gallery using a comma separated list of IDs, for example:
`[nggpowertags gallery=1,2,3]`

== Frequently Asked Questions ==

= Do I need to edit any files? =
Nop, once followed the installation instruction you have done.

= I need some plugin modifications. How can I tell you what I want? =
Send me an email at **info@mauromascia.com** and we'll talk about it.

== Screenshots ==

1. Display All images
2. Display the first tag clicked
3. Display the second tag clicked

== Changelog ==

= 1.5.dev =
* NEW: Add the "include" attribute

= 1.4.1 =
* Fixed: Warning: Missing argument 2 for wpdb::prepare()
* Fixed: add the menu to the output, doesn't print it directly

= 1.4 =
* Fixed: [Clean permalinks issue](http://wordpress.org/support/topic/cleaner-permalinks "http://wordpress.org/support/topic/cleaner-permalinks")
* 2nd try to ["Warning: in_array() expects parameter 2 to be array, string given"](http://wordpress.org/support/topic/error-107 "topic/error-107")

= 1.3 =
* Fixed: [Picture sortorder issuey](http://wordpress.org/support/topic/sorting-broken-with-powertags "Fixed the picture sortorder issue")
* NEW: [Multiple galleries selection](http://www.mauromascia.com/portfolio/wordpress-nextgen-gallery-powertags/#comment-741049320 "Adding 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