dev:changes_in_2.6 [Piwigo Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Technical changes in Piwigo 2.6 ======

===== Jquery UI 1.9 =====
Jquery ui effects filename have changed. For example change
<file>footer|combine_script require='jquery.effects.blind'</file>
to
<file>footer|combine_script require='jquery.ui.effect-blind'</file>
We had backward naming compatibility for 2.5 but not for 2.6.

===== jGrowl CSS file =====
the file //admin/themes/default/uplodify.jgrowl.css// was moved to //themes/default/js/plugins/jquery.jgrowl.css//

use this line to include the file in your template :
<code>{combine_css path="themes/default/js/plugins/jquery.jgrowl.css"}</code>
no changes for the javascript file


===== Add action buttons =====
Following http://piwigo.org/doc/doku.php?id=dev:changes_in_2.5#add_action_buttons\\

Themes have to handle two new template vars : //$PLUGIN_INDEX_BUTTONS// and //$PLUGIN_PICTURE_BUTTONS//\\
Plugins creators SHOULD NOT add <li> or <div> or <span> around their buttons, it's now handled by the theme.

===== TokenInput CSS + config =====
TokenInput CSS was moved from //admin/themes/default/style.css// to //themes/default/js/plugins/jquery.tokeninput.css//. Needs to be explicitly imported with <code>{combine_css path="themes/default/js/plugins/jquery.tokeninput.css"}</code>
**allowCreation** parameter was renamed into **allowFreeTagging**

===== SwitchBox =====
SwitchBox are used for derivatives choices, sort options, LanguageSwitch, ThemeSwitch, etc.\\
Now the JS code is factorized in a function available in //themes/default/js/switchbox.js//\\
Usage :
<code>{combine_script id='core.switchbox' load='footer' require='jquery' path='themes/default/js/switchbox.js'}
{footer_script require='core.switchbox'}switchBox("#sortOrderLink", "#sortOrderBox");{/footer_script}</code>

The CSS is still provided by themes.

===== Smarty 3 =====

in template/menubar_categories.tpl, replace:

<code>{'</ul></li>'|@str_repeat:$ref_level-$cat.LEVEL}</code>
by
<code>{'</ul></li>'|@str_repeat:($ref_level-$cat.LEVEL)}</code>

===== Generic template for custom pages =====
Many plugins add a new public page to Piwigo. Lacking of a documented way to do it, everybody was using his own method, causing display issues with some themes.

In Piwigo 2.6 we introduced a simple way to do it. 

=== For plugins developpers ===
First define in **loc_end_section** trigger :
<code>$page['body_id'] = "whatever_you_want";
$page['is_external'] = true;</code>

Then when you want to display the content of your page :
<code>
$template->set_filename('your_page', realpath(path to your template));
$template->assign_var_from_handle('CONTENT', 'your_page');</code>

Check Skeleton plugin for complete example http://piwigo.org/svn/extensions/skeleton/trunk/include/public_events.inc.php

=== For themes developpers ===
A new template file was introduced : **common_page.tpl**. It has the same layout that **index.tpl** but with minimum content.

Check the default one http://piwigo.org/svn/trunk/themes/default/template/common_page.tpl
Back to top
dev/changes_in_2.6.1371727522.txt.gz · Last modified: 2013/06/20 11:25 by mistic100
Sitemap Recent changes
Show page
Old revisions