## Help

### Snelle start

1. Maak een lokale map "test_categorie".
2. Kopieer de afbeeldingen maar "test_categorie".
3. Open an FTP verbinding naar de gallerie.
4. Upload lokale map "test_categorie" in de galleriemap de map heet "galleries". Stel de mapeigenschappen in op 777 on directory "galleries/test_categorie".
5. Login op de Piwigo als een beheerder.
6. Ga naar Beheer, Afbeeldingen, Thumbnails. Piwigo vind de afbeeldingen in de map "test_category" zonder thumbnails. Vraag om thumbnails te maken.
7. Ga naar Beheer, Categorieën, Synchronizeer. vink aan "mappen + bestanden" optie, vink uit "alleen een simulatie uitvoeren" en bevestig de synchronizatie.
8. Klus geklaard. Je hebt een categorie "test_categorie" in het begin van de gallerie gemaakt.

### Toeveoegen elementen

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

### Toegangs authorizatie

- U kunt toegang tot categorieën verbieden. De categorieën kunnen openbaar of private zijn. De toestemming (voor groepen en gebruikers) kunnen worden aangepast als de categorie private is.
- 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

- Piwigo heeft de mogelijkheid tot het beheren van gebruikers en groepen. Dit kan erg handig zijn als er gemeenschappelijk rechten zijn voor toegang tot private categorieën.
- 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

Piwigo geeft de mogelijkheid aan gebruikers om bestanden uploaden. Om het mogelijk te maken :

1. authorizeer upload op een categorie (Administratie, Categorieën, Beheren, bewerken of Administratie paneel, Categorieën, Eigenschappen, Upload)
2. geef rechten op de mappen 777 (gebruiker, groepen, wereld)

Bestanden geupload door gebruikers zijn niet direct zichtbaar op de website, ze moeten gevalideerd worden door een beheerder. Voor dat doel moet de beheerder gaan naar Administratie, Afbeeldingen, Wachten om de bestanden te bevestigen of te weigeren, dan worden voorgesteld om te synchroniseren met de database.

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

- Piwigo scheidt categorieën waar de elementen en categorieën worden opgeslagen waar zij worden getoond.
- Standaard, de elementen worden getoond slechts in hun echte categorieën: de die aan mappen op de webserver beantwoorden.
- Om een element met een categorie te koppelen, moet u enkel de vereniging op de pagina van elementenuitgave maken (verbinding met dit scherm picture.php ingelogt zijn als beheerder) of op informatie van alle elementen van een categorie.
- Gebruik dit principe, is het mogelijk om virtuele categorieën tot stand te brengen: geen folder corespondeerd aan deze categorie. U kunt virtuele categorieën maken in Administratie, Categorieë, Beheren.

### 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.
- Als je vragen hebt, twijfel niet en bezoek het forum om naar het antwoord te zoeken of stel zelf een vraag. Het forum (Berichtenbord) is beschikbaar op de website van Piwigo. Bekijk de officiele Piwigo documentatie voor meer informatie.