<h2>Configuration</h2>

<p>This screen let the administrator do basic configuration. Indeed, this
screen only shows simple configuration parameters that should be enough for
the vast majority of administrators. If you want to see other numerous (and
advanced) configuration parameters, read file <span
class="filename">include/config_default.inc.php</span>.</p>

<p>This screen is divided in several sections, regrouping configuration
parameters by theme.</p>


<h3>Main</h3>
<ul>
  <li><strong>Gallery title</strong>: used in RSS feed and notifications by
email.</li>

  <li><strong>Page banner</strong>: displayed on top of each public
page.</li>

  <li><strong>Gallery URL</strong>: used for the RSS feed.</li>

  <li><strong>Lock gallery</strong>: Lock the entire gallery for
  maintenance. Only administrator users will be able to reach the
  gallery.</li>

  <li><strong>Rating</strong>: Picture rating feature is enabled.</li>

  <li><strong>Rating by guests</strong>: Even unregistered users can rate images.</li>

  <li><strong>Allow user registration</strong>: Anybody can register.</li>

  <li><strong>Mail address is mandatory for all users</strong>: mail address will be checked on registration or profile update, except if the action is done by an administrator.</li>

  <li><strong>Email admins when a new user registers</strong>: administrators will be notified by mail for each registration.</li>

</ul>

<h3>History</h3>

  <p>Visits on pages <span
  class="pwgScreen">category.php</span> and <span
  class="pwgScreen">picture.php</span> will be saved in the
  <code>history</code> table.</p>
  
  <p>Visits will be shown in <span
  class="pwgScreen">Administration, Specials, History</span>.</p>

<ul>
  <li><strong>Save page visits by guests</strong>: page visits by guests will be recorded.</li>

  <li><strong>Save page visits by users</strong>: visits by registrered users will be recorded.</li>

  <li><strong>Save page visits by administrators</strong>: page visits by administrators will be recorded.</li>

</ul>

<h3>Comments</h3>
<ul>

  <li><strong>Comments for all</strong>: Even unregistered guest can post
  comments.</li>

  <li><strong>Number of comments per page</strong>.</li>

  <li><strong>Validation</strong>: an administrator must validate users comments before they become visible on the site. User comments validation
  takes place in screen <span class="pwgScreen">Administration, Pictures,
  Comments</span>.</li>

  <li><strong>Email admins when a valid comment is entered</strong>:
Sends an email to the administrators when a user enters a comment and this comment is validated.</li>

  <li><strong>Email admins when a comment requires validation</strong>:
Sends an email to the administrators when a user enters a comment that requires validation by the admin.
User comments validation takes place in the screen <span class="pwgScreen">Administration, Pictures, Comments</span>.</li>

</ul>

<!--TODO --><h3>Upload</h3>
<ul>
<!--TODO -->  <li><strong>Show upload link every time</strong>: If uploadable categories exist, an upload link will be shown for each category.</li>
<!--TODO -->  <li><strong>User access level for uploading</strong>: Restricts upload to some categories of users</li>
  <li><strong>Email admins when a picture is uploaded</strong>: Administrators will be notified by mail each time a picture is uploaded by a user.</li>
</ul>

<h3>Default display</h3>

<p>Here you can change display options used by guest, the default user that is not
connected. Once connected, these options are overridden by the user own options
(modifiable in <span class="pwgScreen">profile</span>).</p>

<p>It is possible to change the display options for all existing users, on the <span class="pwgScreen">Administration,
Identification, Users</span> screen, where you can select a list of
users.</p>

<ul>

  <li><strong>Language</strong>: apply to Piwigo
  labels only. Category names, picture names and all descriptions fields are not
  localized.</li>

  <li><strong>Number of images per row</strong></li>

  <li><strong>Number of rows per page</strong></li>

  <li><strong>Interface theme</strong></li>

  <li><strong>Recent period</strong>: By days. Period during which a picture is
  shown as new. Must be greater than 1 day.</li>

  <li><strong>Expand all albums</strong>: Expand all albums by
  default in the menu <em>Warning</em>: this option is resources consuming
  and may generate a huge menu if your category tree contains many
  categories.</li>

  <li><strong>Show number of comments</strong>: show the number of comments
  for each picture on the thumbnails page. Resources consuming.</li>

  <li><strong>Show hits count</strong>: display hits observed on picture
  just under its thumbnail on the thumbnails page. 
  Only when advanced configuration parameter is: <br>
  $conf['show_nb_hits'] = true; <br>
  Notice: false by default.</li>

  <li><strong>Maximum width of the pictures</strong>: maximum displayed
  width. Pictures larger than this setting will be resized on
  display. Rather than choosing this option, you might consider
  modifying the width of your pictures; that would be a better practice.</li>

  <li><strong>Maximum height of the pictures</strong>: same remarks as for
 the maximum width setting.</li>

</ul>