La configuration locale consiste à modifier certains paramètres de votre galerie Piwigo, qui ne sont pas modifiables via une interface visuelle dans l’administration.
Ces paramètres sont stockés dans un fichier de configuration : config_default.inc.php
Ce fichier ne doit JAMAIS être modifié : en revanche, vous pouvez le surcharger en utilisant le plugin LocalFiles Editor.
<aside> 💡 On vous déconseille très fortement de modifier les fichiers de Piwigo directement via FTP. Utiliser le plugin LocalFiles Editor a de nombreux avantages comme vous allez le voir.
</aside>
La première étape pour modifier la configuration locale est donc d’activer le plugin LocalFiles Editor.
Une fois le plugin activé, cliquez sur “Configuration”.
Vous avez alors accès à l’écran ci-dessous :
Depuis cet écran, vous avez accès au fichier de configuration par défaut qui liste toutes les options de configuration disponibles dans ce fichier : pour cela cliquez sur le lien Afficher le fichier "config_default.inc.php" en haut à droite de l’écran.
Chaque ligne commençant par $conf représente une option.
Les options sont regroupées en sections cohérentes (urls, tags, related albums…).
Au dessus de chaque options, une section en commentaires (commençant par // ) explique le rôle de l’option.
Prenons un exemple avec l’option 'enable_formats': cette option permet d’activer ou pas la gestion des formats multiples sur votre galerie. Par défaut, elle est désactivée (false).
// enable_formats: should Piwigo search for multiple formats?
$conf['enable_formats'] = false;
Comme on l’a dit, il ne faut pas modifier le fichier de configuration livré avec votre Piwigo.
LocalFiles Editor va vous permettre de surcharger les paramètres de ce fichier, c’est à dire de spécifier quels paramètres doivent être modifiés par rapport au fichier de base.
Reprenons l’exemple précédent : imaginons que vous souhaitez activer la gestion des formats multiples.
Vous n’avez qu’à copier la section correspondant au paramètre 'enable_formats' et à la coller dans l’onglet Configuration Locale de LocalFiles Editor. Vous pouvez maintenant remplacer la valeur false par true comme dans l'exemple ci-dessous.
<aside>
⚠️ Attention ! Le fichier doit toujours commencer par <?php et finir par ?>
</aside>
Enregistrez le fichier : le paramètre est mis à jour et la gestion des formats multiples est activée.
<aside> 💡 On vous conseille de copier également l’explication en commentaires au dessus de la ligne contenant le paramètre de configuration. Ainsi, vous vous souviendrez plus facilement du rôle de chaque paramètre.
</aside>
Pour vous aider à comprendre le rôle de chaque paramètre, nous avons traduit les commentaires du fichier de configuration par défaut.
Sommaire de l’article