This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

NextGen Gallery Powertags

Description

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:
  • tagmenu_sep: to define a character to separate the tags (default is “,”)
  • tagmenu_format: can be “sep”, “list” or “select” or “empty” to hide the menu (default is “sep”, which stands for separator)
  • all_word: can be one of the translated strings see Translation notes (default is “All”)
  • template=caption or one of other ngg templates (the same as nggallery shortcode)
  • exclude: see “Include/Exclude notes”
  • include: see “Include/Exclude notes”
  • 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:

<div id="nggpowertags">
    <div class="nggpowertags-menu">...</div>
    <div class="ngg-galleryoverview">...</div>
</div>

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]

Screenshots

  • Display All images
  • Display the first tag clicked
  • Display the second tag clicked

Installation

  1. Unzip the archive of the plugin or download it from the official WordPress plugin repository
  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)

FAQ

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?

Nop, at the moment you can’t and there will not be new stuff for this plugin.
This plugin is minimally maintained: please make a donation to encourage future developments.

I would like to make a donation

Yes thanks, donations are always welcome!
You can make a donation using this link: Donate to this plugin »

Reviews

Should be way better

The only positive part is storing images in separate folders. Configuration is a nightmare and most of the views don’t work correctly.

Read all 6 reviews

Contributors & Developers

“NextGen Gallery Powertags” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

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

1.4

1.3

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