Snelle start

1. Create a directory on your computer.
2. Copy some photos inside this directory, resize them for web display. Warning: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.
3. With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.
4. Logon your gallery and go to Administration » Pictures » Thumbnails to create missing thumbnails.
5. Go to Administration and click on the big Synchronization button.

Congratulations! You have successfuly created the first category of your photo gallery.
Directories and files organization

- Categorie mappen zijn in de Piwigo map "galleries". Bekijk de mapstructuur van een kleine gallerie (maar met een hoop mogelijkheden) :

      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

- Eigenlijk, een categorie is gepresenteerd door een map op welke level in Piwigo map "galleries". Elke categorie kan zoveel submappen als jij wilt bevatten. In het voorbeeld hierboven, categorie-1.1.1.1 is op nivo 4 van de trap.
- Eigenlijk, een element is gepresenteerd door een bestand. Een bestand kan een Piwigo element zijn als de extenstie is `file_ext` configuration parameter mofenlijkheden (zie include/config_default.inc.php file). Een bestand kan een afbeelding zijn als de extensie gelijk is aan `picture_ext` configuration parameter possibilities.
- Afbeeldings elementen moeten een link naar een thumbnail hebben.(zie sectie hieronder over thumbnails)
- Afbeeldings elementen kunnen gekoppeld zijn aan hoge kwaliteit bestanden. Zoals in het voorbeeld wedding.jpg hierboven. Er is geen andere naamsaanpassing nodig voor de hoge kwaliteit afbeelding verplicht.
- Niet afbeeldings elementen (video, geluid, tekstbestanden, wat je wil...) worden standaard vertegenwoordigt door een ikoontje die overeenkomt met de bestandsextensie. Optioneel, je kan zelf een associatie met een thumbnail en een bestand opgeven (zie video.avi in het voorbeeld hierboven).
- Waarshuwing : de naam van de mappen en bestanden moeten bestaan uit de letters en koppeltekens "-", "_" of ".". Geen spaties en geen accenten op de karakters
- Advies : Een categorie kan elementen en sub-categorieën hebben op het zelfde moment. Desalnietemin, word je geadviseerd om te kiezen uit categorieën die elementen bevatten of categorieën die sub-categorieën bevatten.
- Als bestanden, thumbnails en representativev corrct zijn geplaatst in mappen ga dan naar: Administratie » Categorieën » Synchronizeren

Thumbnails

- Zoals eerde gemeld, elk element of afbeeldingstype moet geassociateerd worden met een thumbnail.
- Thumbnails worden opgeslagen in een sub-directory "thumbnail" of de categorie map. De thumbnail is een afbeelding (zelfde bestandsnaam extensies mogelijk als de afbeeldingbestanden) welke is prefixed met een geconfigureerde "Thumbnail prefix" (zie administratie paneel, Configuratie, Algemeen).
- Thumbnails hoeven niet de zelfde extensie te hebben als het geassocieerde afbeelding (een afbeelding met .jpg extensie kan een thumbnail hebben met .GIF extentie als voorbeeld).
- Advies: gebruik een ecterne module voor het maken van thumbnails.
- Je kunt ook de pagina thumbnail maken gebruiken (Administratie, Afbeeldingen, Thumbnails), maar dat word niet aangeraden. De thumbnail kwaliteit kan slecht zijn en het gebruikt een hoge CPU kracht welke een probleem kan zijn bij gratis webhost.
- Als je er voor kiest om de thumbnails te laten maken door de webhoster, dan dien je de rechten toe te wijzen op die mappen om de thumbnail te kunnen maken. De correcte rechten op de mappen en sub-mappen zijn gebruiker/goep/wereld (ook wel 777)