Installation thèmes Piwigo

De EjnTricks

Piwigo permet d'ajouter des thèmes fournis par la communauté. Ceci permet de modifier l'apparence de l'interface. Cet article présente les procédures d'installation de ces thèmes, qui peut être réalisée manuellement ou depuis la console d'administration.

Pour cet article, le thème Versa sera pris en exemple.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Study icon.png Etude

Un répertoire themes est disponible dans l'instance déployée, soit à l'emplacement /var/opt/piwigo/installed/themes dans le cadre de cette installation. Par défaut, six thèmes sont mis à disposition.

#sudo ll /var/opt/piwigo/installed/themes
total 36
drwx------  8 www-data www-data 4096 juil. 13 15:23 ./
drwx------ 15 www-data www-data 4096 juil. 13 15:24 ../
drwx------  2 www-data www-data 4096 juil. 13 15:23 clear/
drwx------  3 www-data www-data 4096 juil. 13 15:23 dark/
drwx------  8 www-data www-data 4096 juil. 13 15:23 default/
drwx------  5 www-data www-data 4096 juil. 13 15:23 elegant/
-rw-------  1 www-data www-data 1765 juil. 13 15:23 index.php
drwx------  7 www-data www-data 4096 juil. 13 15:23 smartpocket/
drwx------  4 www-data www-data 4096 juil. 13 15:23 Sylvia/

L'installation d'un thème s'effectue en plaçant le contenu dans ce répertoire, manuellement ou via le téléchargement depuis l'application. Cependant, il faut ensuite l'activer depuis l'interface d'administration.


Tool-box.png Administration

L'interface d'administration des thèmes est accessible depuis le lien Administration dans le bandeau de gauche.


La page d'administration est alors affichée.


Il faut déployer la section Configuration et cliquer sur le lien Thèmes. L'interface d'administration est alors affichée.


Le premier onglet Thèmes installés présente les thèmes installés en fonction de leur activation.


Download-icon.png Installation par téléchargement

Browser Icon.png Interface administration

La méthode la plus facile consiste à télécharger et activer le thème depuis l'interface d'administration. Sur la page d'administration, il faut sélectionner l'onglet Ajouter un thème, qui présente la liste des thèmes "officiels".


Pour cet article, l'installation du thème Versa s'effectue en cliquant sur le lien Installer sous la vignette de celui-ci.

Icon-memory.png Déploiement

Aucune confirmation n'est demandée lors de l'installation. Seul un message de succès est présenté en cas de succès et le thème n'est plus disponible dans la liste de ceux disponibles..


Run-icon.png Activation

Il faut retourner dans l'onglet Thèmes installés afin de cliquer sur le lien Activer sous la vignette du thème nouvellement installé.


Command-icon.png Installation manuelle

Comme pour les autres applications expliqués dans ce wiki, une structure est externalisée afin de faciliter les montées de versions. Il est possible de gérer facilement les versions des thèmes et de l'application en utilisant de simples liens.

Folder-icon.png Structure

La structure mise en place dans le répertoire /var/opt/piwigo/common consiste en deux répertoires.

  • themes-available, afin de stocker les paquets téléchargés et décompressés;
  • themes-enabled, afin de placer les liens sur les version activer.

La structure est donc créée avec les commandes suivantes.

#sudo mkdir /var/opt/piwigo/common/themes-available
#sudo mkdir /var/opt/piwigo/common/themes-enabled
#sudo chown www-data:www-data /var/opt/piwigo/common/themes-available
#sudo chmod 700 /var/opt/piwigo/common/themes-available
#sudo chown www-data:www-data /var/opt/piwigo/common/themes-enabled
#sudo chmod 700 /var/opt/piwigo/common/themes-enabled

A noter, le répertoire intermédiaire common a été créé lors de l'installation et de l'externalisation du fichier de configuration.

Add-file-icon.png Environnement thème

Pour le thème, le répertoire Versa est créé dans apps-available

#sudo mkdir /var/opt/piwigo/common/themes-available/Versa
#sudo chown www-data:www-data /var/opt/piwigo/common/themes-available/Versa
#sudo chmod 700 /var/opt/piwigo/common/themes-available/Versa

Download-icon.png Téléchargment

Puis la version est téléchargée dans le répertoire temporaire de la machine.

#sudo wget -O /var/opt/piwigo/common/themes-available/Versa/0.6.zip https://piwigo.org/ext/download.php?rid=6254

Unzip-icon.png Installation

Une fois téléchargée, il faut décompresser l'archive dans la structure personnalisée des applications disponibles. L'objectif est de l'installer en mentionnant le numéro de version.

#sudo unzip /var/opt/piwigo/common/themes-available/Versa/0.6.zip -d /var/opt/piwigo/common/themes-available/Versa/
#sudo mv /var/opt/piwigo/common/themes-available/Versa/Versa /var/opt/piwigo/common/themes-available/Versa/0.6

Le fichier téléchargé peut être supprimé.

#sudo rm /var/opt/piwigo/common/themes-available/Versa/0.6.zip

Icon File Owner.png Propriétaire fichiers

L'installation a été réalisée avec le compte root. Il est préférable de donner la propriété au compte de démarrage du serveur web, soit www-data dans le cadre de cette installation.

#sudo chown -R www-data:www-data /var/opt/piwigo/common/themes-available/Versa/0.6

Icon ACL.png Sécurisation

Après avoir modifié le propriétaire des fichiers, il est conseillé de positionner des droits restrictifs afin que seul le propriétaire puisse accéder à ceux-ci.

#sudo chmod -R go-rwx /var/opt/piwigo/common/themes-available/Versa/0.6

Run-icon.png Activation

La mise en place de la structure de répertoire doit permettre de placer un lien dans le sous répertoire themes-enabled vers la version souhaitée, avec les commandes suivantes.

#sudo ln -s /var/opt/piwigo/common/themes-available/Versa/0.6 /var/opt/piwigo/common/themes-enabled/Versa
#sudo chown -h www-data:www-data /var/opt/piwigo/common/themes-enabled/Versa

L'étape suivante serait de placer un lien vers /var/opt/piwigo/common/themes-enabled/Loupe dans le répertoire themes de l'instance.

#sudo ln -s /var/opt/piwigo/common/themes-enabled/Versa /var/opt/piwigo/installed/themes/Versa
#sudo chown -h www-data:www-data /var/opt/piwigo/installed/themes/Versa

Bug-icon.png Cependant, ce mode d'organisation ne fonctionne pas avec Piwigo. Le répertoire est donc copié, comme si l'installation avait été faite depuis l'interface d'administration.

#sudo cp -Rp /var/opt/piwigo/common/themes-available/Versa/0.6 /var/opt/piwigo/installed/themes/Versa

Le thème est alors disponible dans l'interface d'administration et près à être activé.


Icon-database-process.png Informations complémentaires

Lors de l'installation, par l'interface, une information est injectée dans la talbe piwik_themes avec l'identifiant du thème, son nom et le numéro de version. Dans le cas de l'installation manuelle, cette ligne est ajoutée lors de l'activation.


Viewer icon.png Voir aussi

Documentation officielle: https://fr.piwigo.org/doc/doku.php?id=utiliser:admin:menus:configuration:themes