piwigo_ynh/sources/language/en_UK/help/photos_add_ftp.html

<fieldset>
  <legend>Quick Start</legend>

<ol>
  <li>Create a directory on your computer.</li>  

  <li>Copy some photos inside this directory, resize them for web display. <em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, nor accentuated characters.</li>

  <li>With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.</li>

  <li>Logon your gallery and go to <span class="pwgScreen">Administration</span> and click on the big Synchronization button.</li>
</ol>

<p>Congratulations! You have successfully created the first album of your photo gallery.</p>
</fieldset>

<fieldset>
  <legend>Directories and files organization</legend>

<ul>

  <li>

    <p>Album directories are in the Piwigo directory
    "galleries". Here follows the directory tree of a very small gallery (but
    using many features):</p>

    <pre>
galleries
|-- wedding
|   |-- celebration
|   |   |-- arrival
|   |   |   |-- paul-alone.jpg
|   |   |   +-- sarah-alone.jpg
|   |   +-- departure
|   |       +-- paul-and-sarah.jpg
|   +-- party
|       |-- dancers001.jpg
|       |-- dancers002.jpg
|       +-- dancers003.jpg
+-- honeymoon
|   |-- hotel.png
|   |-- video-from-plane.avi
|   +-- pwg_representative
|       +-- video-from-plane.jpg
+-- photoshoot
    |-- img0001.jpg
    |-- img0002.jpg
    +-- pwg_format
        |-- img0001.cr2
        |-- img0001.cmyk.jpg
        |-- img0001.zip
        |-- img0002.cr2
        +-- img0002.cmyk.jpg
</pre>

  </li>

  <li>Except for "pwg_representative" and "pwg_format" (see explanations below), each directory under "galleries" produces a album. There is no limit on deepness.</li>

  <li>Basically, an element is represented by a file. A file can be a
  Piwigo element if its extension is among <code>file_ext</code>
  configuration parameter possibilities (see <span
  class="filename">include/config_default.inc.php</span> file). A file can
  be a picture if its extension is among <code>picture_ext</code>
  configuration parameter possibilities.</li>

  <li>Non photo elements (video, sounds, file texts, whatever you want...) are represented by default by an icon corresponding to the filename
  extension. Optionally, you can associate a thumbnail and a representative
  file (see video.avi in the example above).</li>

  <li>Multiple formats: a photo can be available in several formats. In this example, we have 3 additional formats for img0001.jpg. You can activate this feature with <code>$conf['enable_formats'] = true;</code> in your local configuration and define a list of formats, like <code>$conf['format_ext'] = array('cmyk.jpg', 'cr2', 'zip');</code></li>

  <li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, nor accentuated characters.</li>

  <li>Once photos are correctly placed in the
  directories, go to: <span class="pwgScreen">Administration &raquo; Tools &raquo;
  Synchronize</span></li>

</ul>
</fieldset>