🌍
English
This is an old revision of the document!
Customize Piwigo
A Message from the Team Know that the Piwigo team makes every effort to simplify at best the work of the webmasters for their gallery. Many options are accessible to ordinary users to customize their gallery. Whether these are simple checkboxes either still to add some lines in a file via the plugin LocalFiles Editor. In brief, Piwigo is really very flexible.
On the other hand, when the customization required has not been planed or can't be done with such Piwigo options, requests to personalize of a gallery is going to involve to have a minimum of notions in informatics language from you. The team takes care of the development and of supports of the software daily. Ours role consists in directing you so that you can realize yourself your own modifications. According to our free time to all (we are passionate volunteers) we give more or less complete, precise, sophisticated solutions but we always ask for a minimum of investment on behalf of the applicant. Otherwise it's the same as having a contractor and performers (the latter working cheap!). So you will understand while certain demands do not succeed.
Explicative Introduction
Piwigo is highly flexible to customize. Piwigo uses themes, templates and configurations variables but also allows the addition of CSS easily etc. Here is a quick overview of possibilities:
- Themes are in the folder /themes. To manage them easily, go to [ Administration » Configuration » Themes ] Forwarding : themes
- .css files are loaded from themes, but can be overwritten in many ways (see below)
- The local configuration is a set of variables /options of Piwigo which are not in the administration panel of Piwigo as a graphical interface. Forwarding : The Local Configuration (LocalFiles Editor)
- Plugins are powerful in Piwigo: check them on piwigo.org/ext/ or inside your Piwigo in [ Administration » Plugins » Manage ] Forwarding : manage
According to the magnitude of customization and the kind of customization you want, we’ve just seen that a lot of solutions exist. Here a guide to help you to find your way:
- You’re looking for new features or options like “Adding more information about author/picture” “Don’t display such text according to the user/album” “A faster Slideshow”…
- first take a look at all the administration pages of your Piwigo (you can also search in that Documentation using keywords)
- take a deep look at the Local Configuration Forwarding : The Local Configuration (LocalFiles Editor) . Many options of all kind are there!
- if you have enabled a theme and/or plugins, they might have a configuration page in [ Administration » Plugins » The name of the plugin ] or [ Administration » Configuration » Themes ] Forwarding : themes
- still nothing? Ask on our forum if you’ve missed something or if someone has a small snippet of code to help you.
- If you have skills in PHP and/or Smarty, you cloud develop your plugin using Localfiles Editor or building a whole complexe plugin ( dev )
- You want to change the display of content, the aspect of a page like colors, borders, font…
- if your changes need the modification of the HTML, or are too big, you should consider creating your own theme, since it’s easy and you will be more organized. Renvoi : theme_creation
- You want to change the display, the layout of a page (inverting/moving blocks, adding a logo somewhere else than the banner, etc)
- be sure it can’t be done by CSS. You would be surprised of can be done only by CSS
- Check out plugins like PWG Stuffs, Extended Description… which add blocks and rich content
- Si ce n'est pas possible par CSS, il faut modifier l'HTML. Ce code html est contenu dans les fichiers .tpl qui sont analysées par Smarty (Lien vers la Doc Fr) selon les 'ordres' de Piwigo.Renvoi : template. Pour utiliser une métaphore, c'est comme si vous vouliez vous approprié la charpente d'une maison pour la copier et ainsi mieux la modifier à votre goût.
Mise en garde…
Ne modifiez jamais manuellement des fichiers qui sont livrés lors de l'installation de votre galerie Piwigo.
Vous risquerez de de déstabiliser le programme, de rencontrer des problèmes par la suite et aussi de perdre vos modifications lors d'une mise à jour de Piwigo.
Un plugin est spécialement développé pour modifier certains fichiers de votre galerie. Il s'agit du plugin localfiles_editor.
Rendez-vous dans [ Administration » Plugins » LocalFiles Editor ]1) et visitez les onglets.
How To Customize Colors, Fonts and more (CSS coding)
theme_creation
template_ext
1)
Il faut que le plugin soit activé.