Nouveau Depuis le 24 juillet 2023, la nouvelle documentation est disponible sur doc-fr.piwigo.org

LocalFiles Editor

Qu'est-ce que c'est ?

Le plugin LocalFiles Editor est un plugin à installer sur votre galerie, qui va permettre de modifier le contenu (et de créer le cas échéant) de certains fichiers de configuration. On parlera de “surcharger” la configuration de base car les modifications que vous allez pouvoir effectuer viendrons s'ajouter sur la configuration de base. Ainsi, l'intégrité de votre galerie est préservée et vos modifications ne seront pas perdues lors d'une mise à jour de Piwigo.

Dans quel but ?

Le but étant de ne pas passer par FTP et donc d'appliquer des changements “à chaud” sur sa galerie. L'effet sera immédiat 1)
Aidé par la coloration syntaxique, il devient facile de faire des modifications en sécurité. En sécurité oui car le plugin LocalFiles Editor est capable de repérer un certains nombre d'erreurs dans le fichier. En plus, le plugin sauvegarde automatiquement la dernière version du fichier que vous modifiez. De la sorte, vous pouvez revenir à la version antérieure si vos modifications ne sont pas concluantes.
Ainsi, apporter des modifications sur Piwigo devient d'une facilité déconcertante.

Installation

:!: Depuis Piwigo v2.0.0 le plugin LocalFiles Editor est livré avec Piwigo. Vous n'avez donc qu'à vous rendre dans votre administration pour installer et activer le plugin :!:

Utilisation

Rien de compliqué. Il faut commencer par se rendre sur la page d'administration du plugin via votre compte administrateur.
[ Administration » Spéciales » Plugins » LocalFiles Editor ]

Vous arrivez à une page qui doit ressembler à ça: 2)

  1. Cette page (la première) correspond au fichier de configuration config_local.inc.php
  2. Dans la partie supérieure se trouve les onglets dans lesquels se trouvent différents fichiers.
  3. Possibilité d'utiliser ou non l'éditeur avancé. Pratique pour la coloration syntaxique et quelques aides.
  4. Bouton d'enregistrement du fichier. Ce bouton peut être complété par un second pour la restauration de la version antérieure du fichier que vous êtes en train de modifier.
  5. Nom du fichier sur lequel vous êtes en train de travailler.
  6. [Pour utilisateurs avertis] D'autres options.

Onglet "Configuration générale"

Cette page correspond au fichier de configuration config_local.inc.php

Au centre se trouve donc le contenu de votre fichier.

Veillez bien 3) à écrire vos lignes entre les symboles <?php et ?>

Onglet "CSS"

  • Le fichier /template/xxxxxxx/local-layout.css ⇒ Effets uniquement sur le template xxxxxxx
  • Le fichier /template-common/local-layout.css ⇒ Effets sur tous les templates
  • Le fichier /template/xxxxxxx/theme/yyyyy/theme.css ⇒ Effets uniquement sur le thème yyyyy du template xxxxxxx

Onglet "Templates"

Renvoi : templates

Par convention, si on souhaite faire un template-extension de picture.tpl on appellera ce template-extension my-picture.tpl
Comme toutes conventions, vous être libre de ne pas la suivre et de faire selon vos besoins ;-)

Onglet "Langues"

Onglet "Plugin personnel"

Pour aller plus loin...

1) Il faudra parfois vider le cache de son navigateur pour que les modifications soient prises en compte.
2) Dans la cas d'une première utilisation
3) Dans le cadre du fichier config_local.inc.php
 
Haut de page
plugins/installes/localfiles_editor.txt · Dernière modification: 2011/01/23 22:33 (modification externe)
 
 
github twitter newsletter Faire un don Piwigo.org © 2002-2024 · Contact