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 customization. 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/ : it's an essential file, and you can open it to see what the available additional options are, 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: “” : 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:
For example
$conf['top_number'] = 15;
$conf['comment_spam_reject'] = true;
$conf['newcat_default_status'] = 'public';

The workflow:

  • find the variable you need or on which you want explanations by displaying and searching (Ctrl+F) inside the reference file, “”.
  • 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;\\

  • 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
  • change the value according to explicative text (above each variable), like $conf['newcat_default_visible'] = false;
  • click Save File
  • it should display
  File written successfully.
  Backup file created (local/config/

You can revert you changes by restoring the backup file

Additional info

The plugin itself handle the php tags: <?php at the beginning and ?> at the end.
The file location is local/config/

Back to top
user_documentation/use/features/conf_locale.1361730093.txt.gz · Last modified: 2013/02/24 18:21 by tadjio
github twitter newsletter Donate © 2002-2023 · Contact