Installation plugins Piwigo : Différence entre versions
m |
(Aucune différence)
|
Version actuelle en date du 14 août 2018 à 16:48
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.
Sommaire
Votre avis
Nobody voted on this yet
|
|
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.
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
.
Installation par téléchargement
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.
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.
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.
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.
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
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
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
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
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
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
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é.
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.
Voir aussi
Documentation officielle: http://fr.piwigo.org/doc/doku.php?id=utiliser:admin:menus:plugins