Installation plugins Piwigo

De EjnTricks

Piwigo permet d'ajouter des plugins fournis par la communauté. Ceci permet d'enrichir l'application comme l'authentification LDAP des utilisateurs. Cet article présente les procédures d'installation de ces plugins, qui peut être réalisée manuellement ou depuis la console d'administration.

Pour cet article, le plugin Loupe 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 plugins est disponible dans l'instance déployée, soit à l'emplacement /var/opt/piwigo/installed/plugins dans le cadre de cette installation. Par défaut, quatre plugins sont mis à disposition.

#sudo ll /var/opt/piwigo/installed/plugins
total 28
drwx------  6 www-data www-data 4096 oct.  13 23:40 ./
drwx------ 15 www-data www-data 4096 oct.  13 23:40 ../
drwx------  5 www-data www-data 4096 oct.   3 23:56 AdminTools/
-rw-------  1 www-data www-data 1765 juil.  7 18:36 index.php
drwx------  3 www-data www-data 4096 juil.  7 18:36 language_switch/
drwx------  6 www-data www-data 4096 juil.  7 18:36 LocalFilesEditor/
drwx------  7 www-data www-data 4096 juil.  7 18:36 TakeATour/

L'installation d'un plugin 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 plugins 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 Plugins et cliquer sur le lien Gérer. L'interface d'administration est alors affichée.


Le premier onglet Liste des plugins présente les plugins installés en fonction de leur activation. Par défaut, une vue synthétique est affichée. Il est possible de basculer sur une vue avec les détails de ceux-ci en cliquant sur le lien montrer les détails.


Il est possible de rebasculer sur la vue synthétique avec le lien cacher les détails.


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 plugin depuis l'interface d'administration. Sur la page d'administration, il faut sélectionner l'onglet Autres plugins disponibles, qui présente la liste des plugins "officiels".


Une zone de saisie permet de filtrer la liste au fur et à mesure de la saisie. La recherche s'effectue sur le nom du plugin. De plus, une liste de choix permet de choisir le type de tri avec cinq options.

  • Date d'ajout;
  • Dernières révisions, pratique pour voir ceux qui sont actifs;
  • Nom;
  • Auteur;
  • Nombre de téléchargements, pratique pour voir les populaires.

Pour cet article, l'installation du plugin Loupe s'effectue en cliquant sur le lien Installer. A noter que le lien Télécharger entraîne le téléchargement du plugin depuis le navigateur. Cela ne le télécharge pas sur le serveur.

Icon-memory.png Déploiement

Une confirmation d'installation est demandée à l'utilisateur. Après validation, le plugin est téléchargé sur le serveur dans le répertoire plugins. En cas de succès, un message est affichée sur la page d'administration.

De plus, le plugin n'est plus disponible dans la liste de ceux disponibles.

Il est possible d'activer immédiatement le plugin en cliquant sur le lien L'activer maintenant. Le plugin sera alors disponible et l'utilisateur est redirigé ver la liste où celui-ci est présenté comme installé.


Attention, dans les copie d'écran le plugin Ldap login est présenté dans le bandeau de gauche, car celui-ci contient une interface de paramétrage. Ce n'est pas le cas pour le plugin Loupe et c'est pourquoi il ne figure pas dans cette partie de l'interface d'administration.


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 plugins 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.

  • apps-available, afin de stocker les paquets téléchargés et décompressés;
  • apps-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/apps-available
#sudo mkdir /var/opt/piwigo/common/apps-enabled
#sudo chown www-data:www-data /var/opt/piwigo/common/apps-available
#sudo chmod 700 /var/opt/piwigo/common/apps-available
#sudo chown www-data:www-data /var/opt/piwigo/common/apps-enabled
#sudo chmod 700 /var/opt/piwigo/common/apps-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 plugin

Pour le plugin, le répertoire Loupe est créé dans apps-available

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

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/Loupe/1.0.3.zip http://piwigo.org/ext/download.php?rid=5981&origin=piwigo_download

Unzip-icon.png Installation

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

#sudo unzip /var/opt/piwigo/common/themes-available/Loupe/1.0.3.zip -d /var/opt/piwigo/common/themes-available/Loupe/
#sudo mv /var/opt/piwigo/common/apps-available/Loupe/Loupe /var/opt/piwigo/common/apps-available/Loupe/1.0.3

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

#sudo rm /var/opt/piwigo/common/themes-available/Loupe/1.0.3.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/apps-available/Loupe/1.0.3

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/apps-available/Loupe/1.0.3

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 apps-enabled vers la version souhaitée, avec les commandes suivantes.

#sudo ln -s /var/opt/piwigo/common/apps-available/Loupe/1.0.3 /var/opt/piwigo/common/apps-enabled/Loupe
#sudo chown -h www-data:www-data /var/opt/piwigo/common/apps-enabled/Loupe

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

#sudo ln -s /var/opt/piwigo/common/apps-enabled/Loupe /var/opt/piwigo/installed/plugins/Loupe
#sudo chown -h www-data:www-data /var/opt/piwigo/installed/plugins/Loupe

Bug-icon.png Cependant, ce type 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/apps-available/Loupe/1.0.3 /var/opt/piwigo/installed/plugins/Loupe

Le plugin 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 table piwik_plugins avec le nom du plugin, son statut (active / inactive) 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: http://fr.piwigo.org/doc/doku.php?id=utiliser:admin:menus:plugins