Release note / Piwigo 2.6.0

Mobile theme improved, New user manager, New mail system

Download Piwigo 2.6.0

Released on January 17th, 2014


Version 2.6 introduces new features for users, especially administrators. The mobile theme now has important improvements. The user manager has been redesigned from scratch. The new plugin "Admin Tools" will let you edit albums and photos from the gallery. A new mail system presents clean graphical themes and a robust engine. Version 2.6 also introduces technical features including simpler coding for plugin creators.

Mobile theme improvements

The mobile theme SmartPocket gets many new features: full menubar, search page, tags page, new layout for thumbnails and a complete page for each photo including all comments, detailed properties and ratings.

User manager new design

The user manager gets a new design. Full javascript/AJAX for faster actions: add user, edit each user separately or in batch.

Admin Tools

New plugin Admin Tools adds a toolbar on the top of each page of your gallery with a set of useful functions: quick links to specific admin sections, quick edit form of photos and albums, "add to caddie" and "set as album thumbnail" buttons, development tools (identical to the MultiView plugin).

The Quick Edit form opens on the gallery page (not in administration) for quick changes to your photos and albums. It also allows non administrators to edit their own photos (uploaded with Community plugin).

New mail themes

Emails sent by Piwigo can either use the clear theme (as above) or the dark theme. The email theme no longer depends on the gallery theme.

Geolocate visitors

Based on their IP address, find the geolocation of your visitor on page [Administration > Tools > History > Search] with an optional Google map.

Group manager new design

New layout for the group manager, based on the Photo Batch Manager.

New admin icons

New icons in the administration menubar and icons on sub-menus. Many administration tabs and links get icons too. Icons are displayed using the Fontello system and collections Font Awesome, Entypo, Iconic, Elusive and MFG Labs. Icons are compatible with high pixel density screens such as Retina and modern smartphones: whatever the zoom level, icons remain sharp and clean.

Tag filter

New filter text box on tags administration page.

Recent photos and albums

The recent photos section can't be empty anymore. Either Piwigo finds photos in the recent period (ie last 7 days by default) or it shows the last added photos.

Number of tags and comments

The number of tags and comments is now displayed in the menubar.

Comment manager

The new User Comment Manager lets you manage all comments, including validated comments.

Permission inheritance

With $conf['inheritance_by_default'] = true; in your local configuration (false by default), a sub-album will automatically inherit permissions of its parent album. If a private album "parties" is granted for user "Mark" then "Mark" will automatically get permission for new album "parties/birthdays".

Edit album improved

Added link to "edit this album" when managing sub-albums.

Added link "add photos" on album edit page, which goes to web upload form.

Default themes configuration

Elegant and SmartPocket themes get an admin page.

On Elegant you can define the behavior of slide panels.

On SmartPocket you can define the behavior during viewing and for slideshows.

TIFF support

If you upload a TIFF file, Piwigo will automatically store it as the "original" version and create a PNG representative picture. Switch to JPEG with $conf['tiff_representative_ext'] = 'jpg'; in your local configuration.

56 languages

Piwigo 2.6.0 adds language American English, which is slightly different from British English. 45 languages have been updated. Piwigo 2.6 supports 56 languages. Your participation is welcomed on our translation platform, for new languages, improvements and new strings to translate.

Technical Features

Please note that more detailed documentation is available about Technical changes in Piwigo 2.6. Please read it to make your extensions compatible with Piwigo 2.6.

Smarty 3 (details)

Smarty, our templating system, has been updated to version 3. Usage remains the same but some cool features have been added, in particular no more need to use {literal} or {ldelim} tags when writing Javascript/CSS.
We also added the modifier translate_dec intended to replace $pwg->l10n_dec.

Translation function (details)

The l10n function has been improved: one can provide additional parameters which will be used to perform a sprintf on the string; the same change applies to the translate template modifier.

WebServices (API)

The WebServices has been considerably enhanced in this version, the main changes are :

New methods (details)
New options (details)

Each parameter can be defined with a type which will be checked by the WS controller (no more need to do it in the method declaration). Available types are : WS_TYPE_BOOL, WS_TYPE_INT, WS_TYPE_FLOAT, WS_TYPE_POSITIVE, WS_TYPE_NOTNULL, WS_TYPE_ID.

The PwgServer::addMethod function can take a sixth parameter, an array of boolean options: hidden, admin_only, post_only.

Email system (details)

The email functions have also been rewritten for better compatibility with mail readers and more features for plugin developers.
We use the PHPMailer library for all technical operations and have implemented templates for nice and customizable displays.
Additionally the new system supports secure connections for SMTP (SSL/TLS).

GPS Metadata (details)

Piwigo 2.6 will always synchronize GPS Metadata (latitude and longitude) if the EXIF sync is activated. The data are stored in the images table, not used by the core but available for any plugin.

Fallback language

The translation system has been improved with fallback languages, it allow us to define a language as child of another (for instance Canadian French is a child of French). This brings better and faster translations for some languages.

Javascript libraries updated (details)

jQuery has been updated to 1.10.2, the major changes are listed on the jQuery website.

jQuery UI has been updated to 1.10.1, the main change is the renaming UI effects filenames.

TokenInput has been updated to 1.6.1, the parameter allowCreation was renamed into allowFreeTagging and the location of the stylesheet changed.

jGrowl has been update to 1.2.12, the location of the stylesheet changed.

We have added jQuery DataTables 1.9.4 and underscore 1.5.2, both located in themes/default/js/plugins folder.

Improvements for plugin creators

Better support of new public sections (details)

New simpler and cleaner way to add a new page in the public part of Piwigo: declare $page['is_external']=true; and assign your page content to the $CONTENT template variable. Template creators must display the variable on index.tpl.

New maintenance class (details)

In order to deal with naming conflicts we have introduced the PluginMaintain interface. It is used to define the maintenance functions of a plugin (in file) in a uniquely named class.
The same interface exists for themes : ThemeMaintain..

Rename trigger functions (details)

We decided to rename the meaningless trigger_event and trigger_action functions as trigger_change and trigger_notify. Piwigo 2.6 handles both versions but only the new ones will be kept for 2.7. No change for trigger handling with the add_event_handler function.

Templated CSS and JS files (details)

Now you can use Smarty functions in .css and .js files, just set template=true when using combine_script and combine_css.

Improve template methods to sort action buttons (details)

In 2.5 we added two methods to sort action buttons on index and photo page. As planned, the usage changed a bit for 2.6 : plugins must not declare their buttons with surrounding <span>, <div> or <li>, as this markup is now handled by the template.