This is an old revision of the document!

Technical changes in Piwigo 2.5

Albums pagination for theme creators.

On index.tpl, add

{if !empty($cats_navbar)}
  {assign var=navbar value=$cats_navbar}
  {include file='navigation_bar.tpl'|@get_extent:'navbar'}

right after {$CATEGORIES}

And modify existing photos navbar by

{if !empty($thumb_navbar)}
  {assign var=navbar value=$thumb_navbar}
  {include file='navigation_bar.tpl'|@get_extent:'navbar'}

Add action buttons for plugin creators.

Introduction of two template methods to add buttons to index and picture toolbars, allowing you to place buttons relative to each other :

$template->add_picture_button($content, $rank);
$template->add_index_button($content, $rank);

No changes for themes.

Info./Error messages moved

On index.tpl, {include file='infos_errors.tpl'} was moved away from the main #content block. See

Jquery UI 1.9

Jquery ui effects filename has changed. For example change

footer|combine_script require='jquery.effects.blind'


footer|combine_script require='jquery.ui.effect-blind'

We'll have backward naming compatibility for 2.5 version only!

Password hash

Until version 2.4 we had a configuration parameter $conf['pass_convert'], which by default was:

$conf['pass_convert'] = create_function('$s', 'return md5($s);');

Now we have 2 configuration settings :

// password_hash: function hash the clear user password to store it in the
// database. The function takes only one parameter: the clear password.
$conf['password_hash'] = 'pwg_password_hash';
// password_verify: function that checks the password against its hash. The
// function takes 2 mandatory parameter : clear password, hashed password +
// an optional parameter user_id. The user_id is used to update the password
// with the new hash introduced in Piwigo 2.5. See function
// pwg_password_verify in include/
$conf['password_verify'] = 'pwg_password_verify';

They are used this way:

if ($conf['password_verify']($clear_password, $row['password'], $row['id']))


    array($conf['user_fields']['password'] => $conf['password_hash']($_POST['use_new_pwd'])),
    array($conf['user_fields']['id'] => $user_id)

Website and email on comment form

On comment_list.tpl we display the website and the email of the author :

<span class="commentAuthor">{if $comment.WEBSITE_URL}<a href="{$comment.WEBSITE_URL}" class="external" target="_blank">{$comment.AUTHOR}</a>{else}{$comment.AUTHOR}{/if}</span>
{if $comment.EMAIL}- <a href="mailto:{$comment.EMAIL}">{$comment.EMAIL}</a>{/if}

On picture.tpl we display website url and email inputs :

{if $comment_add.SHOW_EMAIL}
    <p><label for="email">{'Email'|@translate}{if $comment_add.EMAIL_MANDATORY} ({'mandatory'|@translate}){/if} :</label></p>
    <p><input type="text" name="email" id="email" value="{$comment_add.EMAIL}"></p>
<p><label for="website_url">{'Website'|@translate} :</label></p>
<p><input type="text" name="website_url" id="website_url" value="{$comment_add.WEBSITE_URL}"></p>
Back to top
dev/changes_in_2.5.1352373044.txt.gz · Last modified: 2012/11/08 12:10 by mistic100
github twitter facebook google+ newsletter Donate © 2002-2019 · Contact