Les T-E. de Piwigo étaient sensés permettre vos adaptations tout en autorisant les évolutions des templates standards. Donc de permettre d’identifier rapidement les différences. Afin que les évolutions puissent être également appliquées à vos adaptations.
Les T-E. sont ni plus ni moins que des templates qui sous certaines conditions remplacent les templates standards.

Pour identifier rapidement les différences, il aurait été nécessaire de proposer un outil de comparaison entre chaque T-E. et son template d’origine. Ceci afin que les évolutions soient rapidement prises en compte.
De l’absence de comparateur et pour la raison évoquée ci-après, nous assisterons à la fin programmée des T-E.
La logigue de thème parent a tendance à se généraliser dans bon nombre d’applications et surtout elle a pris le pas sur l’orientation template de Piwigo.
Il s’en suit des incohérences entre les templates fournis par les thèmes, incohérences devenant bloquantes parfois pour certains plugins.
Prenons un exemple récent : RV Maps and Earth (un fabuleux plugin de rvelices) ne fonctionne pas actuellement avec le thème Luciano.
Même si cela sera sans doute vite corrigé, ce type d’incohérences conduit :
- soit à multiplier les plugins afin de répondre aux problématiques créées par un thème (et parfois tous les thèmes enfants) et pour s’en convaincre il suffit de chercher un plugin de WordPress;
- soit à faire évoluer le thème et vous faire perdre vos adaptations.

Si les thèmes parents/enfants se généralisent, il semble évident que les T-E. n’auront plus lieu d’être. Cependant, ceux-ci permettaient de présenter vos pages sur la base de conditions totalement originales comme une catégorie spéciale ou un lien permanent (permalink).
C’est là qu’intervient la fonction getParam().
Exemples:
- getParam(‘most_recent’) permettra de sélectionner un template particulier aux images récentes peut-être,
- getParam(‘category/Paris’) permettra d’ajouter un script particulier,
etc.

Comment coder un tel template (évolutif) dans son thème ?
Dans mon_theme/template/ par exemple pour créer un header.tpl évolutif…

Explications du code ci-dessus:
- si l’url contient recent_pics, on génèrera une bannière spécifique.
- si l’url contient un lien permanent de catégorie vers « Paris » un script sera ajouté à la page… avant le </head> (Page de miniatures et page picture).

Cette astuce permet de traiter la grande majorité des cas de figure traités par les T-E actuels de Piwigo.

En attendant, la fin programmée des T-E. les points restants en leur faveur sont:
1 – La sécurité (les curieux ne pourront pas découvrir l’emplacement de votre T-E. et, du fait, son contenu avant inclusion dans la page).
2 – La modification globale (Ajout d’éléments communs à toutes les pages et quel que soit le thème).
3 – La réduction du besoin de plugin (pour tous ceux qui ne maîtrisent pas assez le php), la modification globale (sans critère) permet de s’éviter d’avoir à coder un plugin personnel (lequel serait plus complexe à maintenir).

Pour la grande majorité des débutants, espérons que les T-E. (templates-extensions) aient la vie dure, même si leur utilisation semble complexe au début.

En comparaison, une application comme WordPress sans template vous privera des évolutions de thème, ou les évolutions effaceront toutes vos adaptations. En général les applications, qui n’utilisent pas de templates, auront beaucoup de thèmes mais ceux-ci resteront sans évolution.

Assurément, il n’y aurait pas de solution idéale.
Nous allons voir pour Piwigo comment coder un template évolutif dans un thème personnel.
Ci-dessous vous trouverez un exemple d’un header.tpl évolutif…

Explications du code ci-dessus :

{include file=’hello.inc.tpl’ assign=BANNER}
Le code html contenu dans votre thème ./template/hello.inc.tpl sera affecté à la variable BANNER (Un logo par exemple).

{assign var=HOME_BANNER value=$PAGE_BANNER|cat:$BANNER}
La variable HOME_BANNER va recevoir la concaténation (cat) de la bannière standard ($PAGE_BANNER) avec celle produite par hello.inc.tpl

{include file=’topbar.inc.tpl’ assign=TOPBAR}
Là encore, du code html contenu dans votre thème ./template/topbar.inc.tpl sera affecté à la variable TOPBAR (Des liens du site vers votre forum, votre blog, etc).

{include file= »../../default/template/header.tpl » theSwiftHeader=$TOPBAR PAGE_BANNER=$HOME_BANNER}

C’est là l’essentiel, au lieu de copier le header standard, le thème va l’inclure et ainsi profiter de ses évolutions.
Mais également la variable theSwiftHeader va prendre la valeur de TOPBAR (nos liens)
et la variable PAGE_BANNER prendra la valeur de HOME_BANNER (notre bannière avec son logo).
En incluant le header standard, le thème continuera à bénéficier des évolutions du header standard, tout en pouvant être différent.

C’est assez simple, mais surtout cela fonctionne bien.

Une seule réserve: lors de l’include du template d’origine faites attention à décrire le chemin relatif à partir de themes/xxxx/template/

{html_head}
<style type= »text/css » src= »{$ROOT_URL}themes/{$themeconf.id}/css/extension.css »} »>
{/html_head}
Ajout d’un style complémentaire ou plus avant la balise </head> (Cf. Javascript interprété inutilement)

Remarque: Cette astuce n’est qu’une application des fonctionnalités de Smarty (le moteur de templates utilisé par Piwigo)

.

Avant tout, nous allons étudier où introduire cette fonction dans Piwigo. Cette fonction pourrait avoir sa place à plusieurs endroits, essentiellement dans :
- un plugin, et plus précisément plugins/PersonalPlugin/main.inc.php (également éditable en ligne par LocalFiles Editor), ou
- un thème, et plus précisément dans un themeconf.inc.php (mais ceux-ci ne sont pas éditables en ligne à ce jour).

Avec de bons arguments, je considère que sa place est dans le themeconf.inc.php, car l’appel de cette fonction concerne l’affichage final.
Si nous placions cette fonction dans un plugin, il ne faudrait jamais perdre de vue que le plugin devrait rester actif.
En le plaçant dans la configuration du thème, nous n’aurons qu’à créer des templates sur lesquels nous souhaitons agir différement.

Exemples dans un thème personnel.

dès lors dans themes/mon_theme/include/functions.inc.php

Ensuite il suffira de copier et de modifier les templates standards que l’on souhaite modifier venant de themes/default/template/ dans themes/mon_theme/template/
par exemple: thumbnails.tpl afin d’y remplacer

par

Ainsi le nombre de commentaires ne sera plus indiqué que sur les pages de catégories. Ce nombre ne figurera donc pas dans les résultats de recherches, les pages de miniatures découvertes par les tags, ou les pages des catégories spéciales.

Autre exemple, picture.tpl afin d’y remplacer

par

Et cette fois, il ne s’agira pas du nombre mais des commentaires eux-mêmes qui ne seront pas affichés sur la page picture dès lors que l’image n’est pas présentée au travers de sa catégorie.

Ces 2 exemples simples de l’utilisation de getParam() ne sont que des préludes à d’autres usages également très intéressants que nous découvrirons prochainement.

Avant de l’utiliser, je me propose une explication minimaliste.
Cette fonction PHP fait appel à un preg_replace et une expression rationnelle.
L’objectif est de conserver uniquement les caractères comme le point, la virgule, les 2 tirets (- et _), les lettres (minuscules ou majuscules, mais pas les lettres accentuées) et les chiffres.
Par exemple, supposons que nous ayons ceci :

alors nous devrions avoir en retour :

Quel 1er_paramtre   Un argument

L’intérêt sera de sécuriser votre site lors de l’appel à cette fonction.

Découvrir la mise en œuvre de cette fonction.

Avertissement au lecteur :
Les indications suivantes sont obtenues dynamiquement et ne sont pas enregistrées sur ce site mais pourraient être enregistrées par d’autres.
(Elles seront certainement différentes pour chacun de vous).

Votre accès :

Ville de connexion de votre FAI :
Votre région :
United States
Latitude : 38
Longitude : -97
Timezone :
Soit GMT : 0
Google Maps

Agrandir le plan

Quelques précisions devraient être utiles pour votre compréhension.
A partir de votre adresse IP, en utilisant les services gratuits de ipinfodb.com, en php on codera (version simplifiée) :

file_get_contents peut être restreint par votre hébergeur auquel cas il existe peut-être des solutions de remplacement (à base de fsockopen ou de curl) mais ce n’est pas le propos.

Il est recommandé d’être en php 5 au minimum (SimpleXML requiert PHP 5).
Cette extension, SimpleXML, est disponible via l’option de configuration de php –enable-libxml (ceci dit libxml est activée par défaut).
SimpleXMLElement va « parser » (transformer) le résultat de ipinfodb.com/ip_query.php en un objet php.
Il suffira ensuite d’utiliser chacun des éléments obtenus (propriétés de l’objet php).

Exemple de résultat de ip_query.php :

Gmtoffset représente le décalage en seconde par rapport à l’heure du méridien de Greenwhich (GMT Greenwhich Mean Time).
Isdst à 1 indique que la zone est en heure d’été.
Certains champs peuvent être non renseignés et dans ce cas vous n’aurez pas d’erreur mais un élément vide, exemple fréquent en France, le Code postal (<ZipPostalCode/>).

A tous les développeurs : à vos claviers, c’est à vous d’imaginer comment vous allez pouvoir mettre en œuvre ce service.
N’abusez pas de ce service, vous pourriez être temporisé, voire banni.

Attention, vous devez toujours savoir respecter la vie privée de vos visiteurs, donc ne conservez pas ces données au delà du nécessaire.

Chers visiteurs de passage n’oubliez pas que ce qu’internet permet est vraiment peu de chose comparé aux renseignements qui pourraient être collectés par les opérateurs téléphoniques.

Quelques uns des 229 drapeaux:

Si vous avez une utilisation originale comme dans le cadre d’une géolocalisation, n’hésitez pas à proposer votre un lien.

Bon usage à tous, et à votre retour de voyage n’oubliez pas d’émailler vos récits d’un grand nombre de détails afin de renforcer vos souvenirs.

Dans le cas présent, il s’agit d’un problème de plugins et nullement de Piwigo lui-même.

Le premier script, HDShadowbox, est présent dans toutes les pages picture.php, même si la page ne propose aucune image en haute définition, c’est pourtant sa seule raison d’agir.
paMOOramics est un contre exemple, il est présent uniquement dans les pages où il est réellement utile.
Le script grum_plugins_classes-2 (avec Piwigo 2.0) n’est pas utilisé dans les pages picture.php, son successeur pour Piwigo 2.1 ne génère plus ce script prouvant bien qu’il est possible de remédier au problème.
Je vous fais grâce de piclens ou de pwgCumulus qui n’ont en général rien à faire en page picture.php. Sachez qu’ils ne sont pas des exceptions et les plugins du même acabit sont nombreux.

Pourtant Piwigo présente l’incommensurable avantage de disposer de {known_script id=…} et de {html_head}.
Ces balises sont spécifiques à Piwigo, et Smarty devrait bien s’en inspirer. Elles simplifient radicalement la vie de tous les développeurs de plugins.
Il leur suffit d’incorporer directement ces balises avec les paramètres qui vont bien dans le template.
Dès lors si le template est mis en œuvre les scripts seront remontés dans le « head » de la page.

{html_head} … {/html_head} remonte le contenu avant la balise /head (également utile pour les styles).
{known_script id=…} évince les doubles inclusions d’un même script (exemple: un même framework par plusieurs plugins) et bien entendu remonte le script avant le /head.

Par exemple, pour pwgCumulus, actuellement nous avons dans pwgCumulusContent.class.php, ceci :

alors que dans le tags.tpl, il suffirait de coder:

Si le template est sollicité alors le module swfobject.js sera présent dans la page, dans tous les autres cas il n’apparaitra pas.
C’est super simple, c’est même plus lisible que les balises natives de Smarty.
Ainsi le script swfobject.js n’encombrera pas les navigateurs de vos visiteurs au moins pour la page en cours.

En principe, par leur présence dans une page web, les javascripts sont chargés par le navigateur, et analysés au niveau syntaxique.
Le fait d’éviter la présence d’un javascript inutile, multiplié par le nombre de visites (et donc de requêtes http), améliorera la disponibilité de votre bande passante et la vitesse d’affichage de vos pages.

La solution pour Piwigo doit pouvoir s’appliquer à tous les CMS, et autres systèmes basés sur l’usage de plugins et de frameworks.

WordPress: L’application propose une fonction assez proche de celle de Piwigo (fonction wp_enqueue_script), c’est seulement un peu plus compliqué. Cette fonction gère la dépendance au script parent et à la version. Pourtant la solution de Piwigo présente de nombreux aspects intéressants et avantages:
- Le premier plugin qui définit un script en fixe la version, il suffit aux auteurs de plugins de jouer sur les priorités des hooks (handlers, triggers), c’est plus simple.
- L’usage d’un moteur de template permet de remonter simplement les scripts en « head » lesquels n’ont vraiment rien à faire dans le « body » de la page.
- Les pages sont allégées des scripts inutiles, elles sont plus simples à relire, et plus faciles à déboguer pour ceux qui font du support.
- Vous obtenez une réduction du nombre de requête HTTP.
- Vous avez moins de scripts à analyser par les navigateurs et moins de risques de conflits entre les scripts.

Bonne interprétation.

Nouvelle page d’accueil, une version slideshow.KenBurns

Après les commentaires de tosca:

Nouvelle page d’accueil, après révision

Si vous souhaitez mettre vos photos en ligne rapidement, simplement, et sans peine, alors Piwigo.com répondra à vos attentes.

Pied de page côté Administration

Le Xème jour du Yème mois de l’année 1900 + Z, un bateau ayant U hélices, V cheminées et W hommes d’équipage est lancé.

Sachant que le produit UVWXYZ augmenté de la racine cubique de l’âge du capitaine (qui est grand-père) est égal à 4002331, trouver l’âge du capitaine ainsi que toutes les caractéristiques du bateau.

Ce n’est pas le lieu d’y apporter une réponse (Bien qu’avec l’aide de 2 précisions vous pouvez la trouver sur l’excellent site du zéro, un site très formateur. Comme quoi se détendre, s’amuser sur un forum, ne gâche rien).

Non, le capitaine (webmaster) dès qu’il entame la personnalisation de sa galerie Piwigo, inévitablement imagine les questions suivantes:

Ô Combien de miniatures, combien de lignes
devrais-je présenter dans la largeur ou la hauteur de chaque page?

Encore une énigme basée sur une opération élémentaire, mais celle-ci ne m’a jamais faire particulièrement sourire.

Mais dites-moi, avons-nous tous le même écran ?
Même si parfois nous pouvons en trouver deux identiques, rien ne prouve qu’ils soient réglés avec les mêmes résolutions, non ?
Devons-nous être limités en largeur quand on regarde votre site avec une résolution 1920 x 1080 sur un écran 27″ ou sur un écran TV de salon ?
Pensez-vous que votre site s’affichera comme vous l’imaginez sur un iPhone (résolution 640 x 960) ou sur un iPad (résolution 1024 x 768) avec leurs pages web formatées par l’iOS ?

Piwigo propose 2 paramètres:

• Le nombre de miniatures par ligne, et
• Le nombre de lignes par page

Les préférences permettent en théorie de faire votre choix :

Pourtant en résolution standard, nous obtenons :

ou dans une résolution particulièrement élevée, l’affichage nous avons un rendu différent mais toujours adapté :

En fait, Piwigo présente au travers de tous les thèmes un nombre de miniatures par page. Opération élémentaire :
Nombre de miniatures par ligne * Nombre de lignes par page = Nombre de miniatures par page

Seulement vous n’aurez pas le nombre de miniatures par ligne que vous espériez et ceci avec bon nombre des thèmes proposés.
Restent les thèmes de largeur fixe (par exemple: MontBlanc XL) seulement la dimension des miniatures peut très bien limiter le nombre de miniatures par ligne, et vous aurez beau demander peut-être 10 miniatures par lignes, en général vous n’obtiendrez pas l’âge du capitaine.

Pourquoi alors nous proposer d’indiquer le nombre de miniatures par ligne dans la configuration ?

Demain peut-être qu’un thème en tiendra compte.

Mais dans ce cas n’est-ce pas à ce thème de le gérer lui-même le paramètre ?

Nous sommes bien d’accord, vous avez compris l’objet de mon billet.
Mais surtout, vous ne vous poserez plus la question du nombre de miniatures par ligne.

PS: Ce sujet n’a rien avoir avec l’histoire de l’ami Victor:

Ô combien de marins, combien de capitaines
Qui sont partis joyeux pour des courses lointaines

PS2: Un billet dédié à la mémoire de Christine, partie hier, bien trop tôt. Mes pensées accompagnent son mari, et leurs deux fils qui devront mener leur barque sans elle maintenant.