🌍
English
Differences
|
user_documentation:learn:customize [2013/11/29 13:01] flop25 |
user_documentation:learn:customize [2013/12/04 12:23] (current) flop25 [Explicative Introduction] |
||
|---|---|---|---|
| Line 11: | Line 11: | ||
| 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: | 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 ]** <wrap info>__Forwarding__ :</wrap> [[user_documentation:administration:menus:configuration:themes]] | + | * Themes are in the folder /themes. To manage them easily, go to **[ Administration >> Configuration >> Themes ]** \\ <wrap info>__Forwarding__ :</wrap> [[user_documentation:administration:menus:configuration:themes]] |
| - | * Templates are *.tpl files which are in the ./template folder of themes and in the /template-extension folder of Piwigo. <wrap info>__ Forwarding __ :</wrap> [[user_documentation:use:features:template]] & [[user_documentation:administration:menus:configuration:templates]] | + | * Templates are *.tpl files which are in the ./template folder of themes and in the /template-extension folder of Piwigo. \\ <wrap info>__ Forwarding __ :</wrap> [[user_documentation:use:features:template]] & [[user_documentation:administration:menus:configuration:templates]] |
| * .css files are loaded from themes, but can be overwritten in many ways (see below) | * .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. <wrap info>__ Forwarding __ :</wrap> [[user_documentation:use:features:conf_locale]] | + | * The local configuration is a set of variables /options of Piwigo which are not in the administration panel of Piwigo as a graphical interface. \\ <wrap info>__ Forwarding __ :</wrap> [[user_documentation:use:features:conf_locale]] |
| - | * Plugins are powerful in Piwigo: check them on piwigo.org/ext/ or inside your Piwigo in **[ Administration >> Plugins >> Manage ]** <wrap info>__ Forwarding __ :</wrap> [[user_documentation: administration:menus:plugins:manage]] | + | * Plugins are powerful in Piwigo: check them on piwigo.org/ext/ or inside your Piwigo in **[ Administration >> Plugins >> Manage ]** \\ <wrap info>__ Forwarding __ :</wrap> [[user_documentation: administration:menus:plugins: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: | 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”… | + | |
| + | |||
| + | * **You want to change the display of content, the aspect of a page like colors, borders, font etc** | ||
| + | * <wrap info>__Read__ :</wrap>[[user_documentation:faq:css_code]] | ||
| + | * if your changes need the modification of the HTML, or are too big, read the next paragraph then you might consider creating your own theme, since it’s easy and you will be more organized. \\ <wrap info>__Forwarding__ :</wrap> [[dev:extensions: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 | ||
| + | * you need to change the HTML of a page ? The HTML code is in *.tpl files called template, which are written in SMARTY ([[http://www.smarty.net/docsv2/|Read their Doc]]): Smarty will read those files, and interpret them according to the values given by Piwigo in order to render the final HTML page. \\ <wrap info>__Forwarding__ :</wrap> [[user_documentation:use:features:template]]. | ||
| + | |||
| + | * **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" etc** | ||
| * first take a look at all the administration pages of your Piwigo (you can also search in that Documentation using keywords) | * 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 <wrap info>__ Forwarding __ :</wrap> [[user_documentation:use:features:conf_locale]] . Many options of all kind are there! | + | * take a deep look at the Local Configuration \\ <wrap info>__ Forwarding __ :</wrap> [[user_documentation:use:features:conf_locale]] . 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 ]** <wrap info>__Forwarding__ :</wrap> [[user_documentation:administration:menus:configuration:themes]] | + | * 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 ]** \\ <wrap info>__Forwarding__ :</wrap> [[user_documentation:administration:menus:configuration:themes]] |
| * still nothing? Ask on our [[http://piwigo.org/forum/|forum]] if you’ve missed something or if someone has a small snippet of code to help you. | * still nothing? Ask on our [[http://piwigo.org/forum/|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]] ) | * 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… | ||
| - | * <wrap info>__Read__ :</wrap>[[user_documentation:faq:css_code]] | ||
| - | * 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. <wrap info>__Renvoi__ :</wrap> [[dev:extensions: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 ([[http://www.smarty.net/docsv2/fr/|Lien vers la Doc Fr]]) selon les 'ordres' de Piwigo.<wrap info>__Renvoi__ :</wrap> [[utiliser:utilisation:fonctionnalites: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. | ||
| - | <WRAP important>//**__ Mise en garde... __**// | + | <WRAP important>//**__ Warning __**// |
| - | Ne modifiez jamais manuellement des fichiers qui sont livrés lors de l'installation de votre galerie Piwigo.\\ | + | Never ever change the files provided in the Piwigo installation.\\ Your Piwigo could become unstable, buggy, and you will loose your changes after each update. |
| - | 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 [[plugins:installes:localfiles_editor]].\\ | + | A plugin has been specially designed to avoid that, and allows to change safely files and configurations : <wrap info>__Read carefully__ :</wrap> [[user_documentation:use:features:conf_locale]] |
| - | Rendez-vous dans **[ Administration >> Plugins >> LocalFiles Editor ]**((Il faut que le plugin soit activé.)) et visitez les onglets. | + | |
| </WRAP> | </WRAP> | ||
| - | + | ===== Example of Advanced Customization ===== | |
| - | [[user_documentation:faq:css_code|]]\\ | + | |
| - | [[dev:extensions:theme_creation|]]\\ | + | |
| - | [[dev:extensions:template_ext|]] | + | |
| {{indexmenu>:user_documentation:learn:customize|nocookie navbar de js#gnome.png nsort msort#order}} | {{indexmenu>:user_documentation:learn:customize|nocookie navbar de js#gnome.png nsort msort#order}} | ||