This is an old revision of the document!


The Local Configuration (LocalFiles Editor)

What's that?

Piwigo has a graphical interface for the administration panel, where many options can be easily changed in only a few clicks. But Piwigo allows much more customizations. In order to keep the essential options easily identifiable, all these additional options are not available in the graphical interface but in a file. The default config file, which should be never modified, is include/config_default.inc.php : it's an essential file, and you can open it to see what are the available additional options, but not to modify them!

How to change it?

The best way is to use the plugin LocalFiles Editor, available as a default plugin in any Piwigo installation :

  • Go to [ Administration » Plugins » Manage ] and activate LocalFiles Editor : if you don't find it, click on the tab [ Other Plugins available ], and install it
  • Go to [ Administration » Plugins » LocalFiles Editor ] : the Local Config page is directly displayed, because that's the first of the five tabs of this plugin.
  • There you can
    • check the default config file, by clicking on Display reference file: “config_default.inc.php” : it contains almost all the variables you can change
    • change these variables by typing inside the text field where you currently see something like “File does not exist and will be created by LocalFiles Editor”


The Local Config use a PHP syntax:
$conf['NAME OF THE VARIABLE'] = VALUE_OF_THE_VARIABLE;
For example
$conf['top_number'] = 15;
$conf['comment_spam_reject'] = true;
$conf['newcat_default_status'] = 'public';

The workflow:

  1. find the variable you need or on which you want explanations by displaying and searching (Ctrl+F) inside the reference file, “config_default.inc.php”.
  2. copy the reference variable or the one given on the forum/doc, like

newcat_default_visible : at creation, must a category be visible or not ?
Warning : if the parent category is invisible, the category is
automatically create invisible. (invisible = locked)
$conf['newcat_default_visible'] = true;

  1. past it inside the text field, where you currently see something like “File does not exist and will be created by LocalFiles Editor” if you never changed the local config
  2. change the value according to explicative text (above each variable), like
  3. the text field where you currently see something like $conf['newcat_default_visible'] = true;
  4. click Save File
  5. it should display
  File written successfully.
  Backup file created (local/config/config.inc.bak.php)
 
Back to top
user_documentation/use/features/conf_locale.1361286898.txt.gz · Last modified: 2013/02/19 15:14 by flop25
 
 
github twitter newsletter Donate Piwigo.org © 2002-2024 · Contact