## Help

Add photos, the pLoader way

pLoader for Windows or pLoader for Linux : description, download and details about new revisions.

1. Create a directory "upload" next to directory "galleries" in your Piwigo installation, with write access.
2. Install pLoader on your computer, start it and fill the connection settings : your gallery URL, your username and password.
3. Drag'n drop photos from your directory browser into pLoader photo selection.
4. Create a category and select it.
5. Select some photos.
6. Click on the green arrow to transfer photos in your gallery

Congratulations! You have successfuly created the first category of your photo gallery.
Add photos, the FTP way

### 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) :

      .
      |-- admin
      |-- doc
      |-- galleries
      |   |-- categorie-1
      |   |   |-- categorie-1.1
      |   |   |   |-- categorie-1.1.1
      |   |   |   |   |-- categorie-1.1.1.1
      |   |   |   |   |   |-- pwg_high
      |   |   |   |   |   |   +-- wedding.jpg
      |   |   |   |   |   |-- thumbnail
      |   |   |   |   |   |   +-- TN-wedding.jpg
      |   |   |   |   |   +-- wedding.jpg
      |   |   |   |   +-- categorie-1.1.1.2
      |   |   |   +-- categorie-1.1.2
      |   |   |-- categorie-1.2
      |   |   |   |-- pookie.jpg
      |   |   |   +-- thumbnail
      |   |   |       +-- TN-pookie.jpg
      |   |   +-- categorie-1.3
      |   +-- categorie-2
      |       |-- piglet.gif
      |       |-- pwg_representative
      |       |   +-- video.jpg
      |       |-- thumbnail
      |       |   +-- TN-piglet.jpg
      |       +-- video.avi
      |-- include
      |-- install
      |-- language
      |-- template
      +-- tool

- 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)

Permissions

- You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.
- U kunt een categorie aan private maken door het aanpassen van een enkele categorie(Administratie » Categorieën » Beheren » bewerken) of bij het aanpassen van de opties op de hele categorie map (Administratie » Categorieën » Eigenschappen » Publiek / Private).

- Als de categorie private is, dan kun je de rechten aanpassen voor de groepen en gebruikers via 3 schermen :

  - Administratie » Identificatie » Gebruikers » rechten aanpassen (een link per gebruiker)
  - Administratie » Identificatie » Groepen » rechten aanpassen (een link per groep)
  - Administratie » Categorieën » Beheren » bewerk categorie rechten aanpassen (one link per categorie)

Gebruikers en groepen

- Groups is a convenient way to set permissions for a list of users.
- Je kan groepen maken in Administratie » Identificatie » Groepen en voeg gebruikers toe aan de groep via Administratie, Identicatie, Gebruikers.
- Een gebruiker kan behoren tot verschillende groepen. De vergunning is sterker dan verbod : als gebruiker "jack" behoord tot de groep "familie" en "Vrienden", en alleen de groep "familie" kan de categorie "Christmas 2003" zien, "jack" zal de mogelijkheid hebben om de categorie "Christmas 2003" te zien.

Bestands upload door gebruikers

Users can upload their photos too.

1. Authorize upload on any physical categories (Administration » Categories » Manage » edit or Administration » Categories » Properties » Upload). Virtual categories can't receive any upload.
2. geef rechten op de mappen 777 (gebruiker, groepen, wereld)

Photos uploaded by users are not directly visible on the website. An administrator must validate uploaded photos in Administration » Pictures » Waiting.

Links tussen elementen en categorieën, virtuele categorieën

- Photos are displayed in the category corresponding to the file directory.
- You can also display a picture in several categories, without duplicating the file on your web server. Associate the photo to any category from the photo editing screen (that any administrator can reach from the photo page on the gallery side).
- Virtual categories are based on this concept: they have no corresponding directory. Create virtual categories from Administration » Categories » Manage.

Diverse informatie

- Als je je gallery-installatie hebt afgerond, verander dan het uiterlijk van de standaard weergave in Administratie paneel » Configuratie » Standaard. Elke nieuwe geregistreerde gebruiker zal dezelfde standaard vertoningseigenschappen hebben.
- If you have any question, Piwigo community will welcome you on its forum.