# Coppermine Photo Gallery v1.5.4: Documentatie en Handleiding

# Inleiding

Vooreerst een lijstje met belangrijke punten waar beginners nog al eens problemen mee hebben. Lees deze punten dan ook aandachtig:

- Gebruik de "Album Manager" ("Albums" link in het beheerders menu) om uw albums aan te maken en te ordenen. U moet minstens één album beschikbaar hebben waar u bestanden kunt in plaatsen.
- Gebruik de anoniem/gast groep om te bepalen wat niet-geregistreerde gebruikers (m.a.w. gasten) mogen en niet mogen (in het groepen paneel).
- Gebruik de eigenschappen van een album om de beschrijving en rechten aan te passen. De albumeigenschappendialoog is toegankelijk door te klikken op de "Eigenschappen"-knop naast de thumbnail (= verkleinde afbeelding) die een album vertegenwoordigt.
- Opdat een gebruiker toelating zou hebben om een bestand naar een album te versturen, moet aan twee voorwaarden voldaan zijn:
  - De gebruiker moet deel uitmaken van een groep die bestanden mag uploaden.
  - Er moet minstens één album zijn waar het bestand volgens de toegekende rechten mag ingeladen worden. Dit is het geval indien:
    - er tenminste één album is in een publieke categorie (dat mag ook de rootcategorie zijn) als "Bezoekers bestanden kunnen plaatsen" ingesteld is op "Ja",
      OF
    - de gebruiker een album heeft aangemaakt in de 'gebruikersgalerij', als hij daartoe gerechtigd is.
- Hetzelfde geldt voor de fotowaardering en het commentariëren: de groep waarin de gebruiker zit moet de nodige rechten hebben om te beoordelen / te commentariëren en er moet minstens één album zijn waar de corresponderende albumrechten op ja zijn ingesteld. Albumrechten kunnen ingesteld worden door het dialoogvenster van de albumeigenschappen te gebruiken.
- Als u het galerijscript met succes geïnstalleerd heeft maar problemen hebt om het goed aan het werk te krijgen, kunt u de "debug modus" instellen op de Configuratie pagina. In deze modus geeft het script meestal waarschuwingen/foutboodschappen die door PHP geproduceerd worden in aanvulling op wat debug-informatie. Deze kunnen waardevolle informatie bevatten om te begrijpen wat er fout gaat.
- Doorheen de documentaties zal het woord "bezoeker" gebruikt worden voor gelijk welke persoon die een pagina opent (al dan niet ingelogd). "Bezoeker" is niet gelijk aan "gast". Gasten zowel als geregistreerde gebruikers zijn bezoekers.

## Basisconcepten

Natuurlijk bent u onder de indruk van Coppermine en wilt u zo snel mogelijk starten. Er zijn echter enkele basisoverwegingen te maken vooraleer te beginnen. Sommige instellingen zijn nog moeilijk te wijzigen als de galerij eenmaal gegevens bevat.

Dit gedeelte is bedoeld als een gids, eenmaal de installatie van Coppermine voltooid is. Ga stap voor stap door deze procedure om latere problemen te vermijden.

- Initiële configuratie
  Instellingen die best dadelijk na de installatie uitgevoerd zouden worden
- Categorie/album/bestandsstructuur
  De manier waarop Coppermine de navigatie en de opslag van individuele bestanden organiseert
- Aangepaste afmetingen van afbeeldingen
  Verkleinde versies van uw ingestuurde originelen worden aangemaakt volgens de configuratie-instellingen
- Uw beheerdersaccount
  Vul zorgvuldig alle beheerders details in
- Uploadrechten
  U kunt uw gebruikers toelaten of verbieden om iets te uploaden
- Controleer uploads
  Zorg ervoor dat de upload werkt zoals verwacht voordat u bezoekers toelaat
- Overweeg bridging
  Bridging (= koppeling met forum of website) wordt moeilijk als er al gebruikers actief zijn
- Welke rechten hebben uw bezoekers?
  Welk niveau van gebruikers interactie gaat u toestaan?
- Verander het design van uw coppermine
  Zorg dat het uitzicht van uw galerij past in het geheel van uw site-layout
- Typische setups
  Het niveau van de bezoekersinteractie dat u wil toelaten

## Initiële configuratie

Er zijn sommige instellingen in de configuratie van Coppermine die u best kunt aanpassen, dadelijk na het voltooien van de installatie.

Log in met de admin gebruikersnaam die u ingesteld heeft tijdens de installatie, klik op "Mijn galerij" en controleer of de link "Beheerdersfuncties uit" zichtbaar is, als de link "Beheerdersfuncties aan" zichtbaar is, klik dan op deze link om de beheerdersfuncties zichtbaar te maken. Ga naar de Configuratie pagina en begin uw galerij te configureren. Merk op dat u, zelfs indien u lid bent van de administrators groep, nog de "Beheerdersfuncties aan" moet ingesteld hebben. In vorige versies, werd dit de "admin modus" genoemd, maar is hernoemd geworden omdat sommige mensen dachten dat het switchen van de adminmodus naar de gebruikersmodus voldoende was om hun te tonen wat de gewone gebruikers kunnen zien (wat niet het geval is).

- Galerij administrator e-mail
- URL van uw coppermine galerij-map

Sommige instellingen in de configuratie kunnen later niet meer veranderd worden (als er reeds bestanden in de database zijn) - let er op dat u die in de eerste plaats juist zet. Alhoewel dat u coppermine dadelijk wilt gaan gebruiken is het aan te raden om de instellingen, gemarkeerd met een asterisk "*") juist in te stellen vooraleer te beginnen.

Sommige instellingen hebben een ernstige performantie impact en zouden degelijk overwogen moeten worden, vooral wanneer u op goedkope shared- of gratis hostings werkt.

## Categorie, albums en bestandsstructuur

De Coppermine Foto Galerij werkt als volgt:

- Bestanden worden opgeslagen in albums
- Albums worden ondergebracht in categorieën
- Categorieën kunnen genest worden (in subcategorieën)

Indien u niet van plan bent om veel albums te hebben, heeft u waarschijnlijk geen categorieën nodig. Als dit voor u van toepassing is, maak dan geen categorieën aan en al uw albums zullen automatisch op de hoofdpagina van de galerij getoond worden.

Er is echter een speciale categorie, genaamd "Gebruikers galerijen". Deze categorie kan niet gewist worden. Indien de gebruiker behoort tot de groep "mag een eigen galerij hebben" en dit is op JA gezet, dan heeft hij het recht om zijn eigen albums aan te maken en zijn galerij zal dan een subcategorie zijn van "Gebruikers galerijen". Deze link is echter niet zichtbaar voor bezoekers van uw site, als u geen rechten toekent aan gebruikers om hun eigen albums te hebben en hun eigen foto's te uploaden.

De administrator kan albums aanmaken in gelijk welke categorie. Niet-administratieve gebruikers kunnen alleen albums aanmaken in de "Gebruikers galerijen/Hun_gebruikersnaam".

U kan echter de "Gebruikers galerijen" hernoemen. Om de "Gebruikers Galerijen" te hernoemen, categorie en omschrijving, gaat u naar uw categorie controle paneel en wijzigt daar de naam (bvb. door de woorden "User galleries" te vertalen in uw taal).

## Herschaalde afbeeldingen

Een van de hoofdvoordelen van Coppermine is het feit dat er thumbnails en middelgrote foto's van de originele opgeladen afbeeldingen gemaakt worden. Dit gebeurt eenmaal per afbeelding (tijdens de upload), het proces van aanmaken van herschaalde afbeeldingen kan opnieuw gestart worden door de beheerdersinstrumenten te gebruiken. De herschaalde kopieën van uw originelen worden opgeslagen in dezelfde map als uw originelen - ze krijgen alleen een aparte prefiks.

De volgende herschaalde bestanden worden gegenereerd bij het opladen van een afbeelding:

- ### Thumbnails

  De thumbnail wordt gemaakt afhankelijk van de overeenkomstige opties "Thumbnail instellingen" in de configuratie wanneer het opgeladen bestand groter is, wat afmetingen betreft, dan de toegelaten afmetingen voor een thumbnail. De thumbnails worden meestal gebruikt op de actuele album thumbnailpagina, maar het kan ook op sommige andere plaatsen (bv. op de profielpagina of als thumbnail representatie van albums en categorieën). De aanmaak van thumbnails verbetert merkelijk de oplaadtijd van uw galerij - als Coppermine de thumbnail niet zou aanmaken en in plaats daarvan de originelen zou tonen (gebruikmakend van de HTML attributen om ze in een kleinere afmeting te tonen), dan zou de thumbnailpagina zeer traag inladen.
  U moet een goed compromis zien te vinden voor de afmetingen van uw thumbnails: thumbnails met kleinere afmetingen resulteren in kleinere bestanden en daardoor laden de thumbnailpagina's zeer snel. De nadelen van te kleine afmetingen liggen voor de hand: als u te kleine afmetingen neemt, kunnen uw bezoekers niet zien wat er getoond zal worden en zijn ze niet geïnteresseerd om er op te klikken en de volle afmeting te zien. Er bestaat geen ideale afmeting voor de thumbnail, het hangt voor een groot deel af van het onderwerp van uw galerij. Als vuistregel zou u de afmetingen kunnen instellen tussen de 50 en 250 pixels.
  Als u een bestand upload dat kleiner is, wat breedte en hoogte betreft, dan de breedte/hoogte voor thumbnails bij de configuratie van Coppermine, dan wordt het aanmaken van een thumbnail overgeslagen en wordt het origineel als thumbnail gebruikt.

- ### Tussenmaat

  De tussenmaatafbeelding wordt aangemaakt tenzij u de optie "Maak foto's met een tussenmaat" heeft uitgeschakeld of indien de opgeladen afbeelding kleiner of evengroot is in afmetingen dan de breedte/hoogte die u heeft ingesteld als Max breedte of hoogte van een middelmaat foto. De tussenmaat foto wordt hoofdzakelijk gebruikt om op de middelmaat pagina (displayimage.php) getoond te worden als foto die de gebruiker ziet wanneer hij klikt op een thumbnail. De tussenmaat fotopagina kan alle types van extra informatie over de foto bevatten (zoals o.a.: uploader naam, titel, beschrijving, metadata, enz.) en heeft navigatie controles om de bezoeker toe te laten rechtstreeks naar de vorige/volgende afbeelding in een album te springen zonder eerst terug te moeten gaan naar de thumbnailpagina. Daarenboven bevat de tussenmaatpagina controles voor gebruikersinteractie (zoals stemmen en commentariëren als u deze interactie toelaat).
  Het grootste voordeel van een tussenmaatse afbeelding is dat het ontworpen is om op het scherm van alle gebruikers te passen, gelijk welke resolutie zij hebben. Dit zal resulteren in een naadloze bladerervaring voor uw gebruikers. Het is aan te raden om een "veilige" waarde voor Max breedte of hoogte van een middelmaat foto te kiezen, zodat u er van verzekerd kan zijn dat hij op het scherm zal passen (ook samen met alle extra controles op die pagina). Als de ruimte die de controles nodig hebben afhangen van het thema dat u gebruikt, en u kunt er niet zeker van zijn welke schermresoluties uw bezoekers gebruiken, dan is het aan te raden om afmetingen voor de middelmaat in te stellen tussen 400 en 800 pixels.
  De aanmaak van tussenmaatse afbeeldingen zal ook bijdragen tot een hogere snelheid om de pagina te laden, vooral voor gebruikers met langzame verbindingen, daarentegen gebruiken de tussenmaatse afbeeldingen natuurlijk wel extra ruimte op uw server. Zet de aanmaak van tussenmaatse afbeeldingen alleen uit indien u gebrek heeft aan webruimte. De tussenmaatse afbeelding wordt opgeslagen in dezelfde map waar de originele afbeelding is ogeslagen en krijgt een prefix: "normal_".
  Laat ons zeggen dat u de max. afmetingen voor tussenmaatse afbeeldingen hebt ingesteld op 400 pixels. U (of een van uw gebruikers als u hen toestaat om te uploaden) doen dan een upload van een afbeelding: "mypic.jpg" die 800 pixels breed en 600 pixels hoog is. Een tussenmaatse afbeelding: "normal_mypic.jpg" zal dan aangemaakt worden tijdens het opladen met resoluties van 400 x 300. Een andere foto wordt dan geüpload: "foobar.jpg" en die is 1024 x 768 pixels: er zal dan weer een tussenmaatse foto aangemaakt worden als "normal_foobar.jpg" en die zal weer 400 x 300 pixels zijn. Een derde foto wordt geüpload: "hugepic.jpg" met als afmetingen 1280 x 800 pixels. De resulterende tussenmaatse afbeelding "normal_hugepic.jpg" zal dan 400 x 250 pixels zijn. Merk op dat de afmetingen van de derde afbeelding afwijkt van de andere twee. De reden hiervoor is dat de aanmaak de verhoudingen van de originele foto respecteert. Uw gebruikers zullen echter bij het doorbladeren van het album altijd een foto zien die 400 pixels breed is, op die manier blijven alle besturingselementen op de pagina zichtbaar zonder te moeten scrollen.

- ### Originelen

  De originele foto zal afgebeeld worden in een pop-up wanneer de gebruiker klikt op de middelmaatafbeelding als het origineel groter, in afmeting, is dan de middelmaat foto.
  Laten we zeggen dat u een middelmaat afmeting ingesteld hebt op 400 pixels en dat u toelaat om grotere bestanden te uploaden. Dan worden twee bestanden geüpload: bestand "first_pic.jpg" is 800 x 600 pixels, bestand "second_pic.jpg" is 400 x 300 pixels. Als een bezoeker dan kijkt naar de middelmaat afbeelding van het bestand "first_pic.jpg", dan kan hij/zij klikken op de middelmaat afbeelding en de originele grootte wordt in een pop-up getoond. Als hij of zij kijkt naar "second_pic.jpg" in de middelmaat fotopagina, heeft het klikken op deze afbeelding geen effect omdat het tonen van de originele afbeelding in een pop-up nu geen zin heeft: de foto wordt immers al getoond in de grootste beschikbare afmeting.
  U kan Coppermine opdragen om nooit het formaat van een originele foto die opgeladen wordt aan te passen en daardoor (tenminste in theorie) de originelen te bewaren in hun oorspronkelijke vorm, dit heeft echter ernstige gevolgen: met moderne digitale camera's is het mogelijk om foto's met veel grotere afmetingen te maken dan op het scherm van de bezoeker passen waardoor ze verplicht worden van veel te scrollen. Daarenboven zullen grote foto's een grote hoeveelheid webruimte innemen en resulteren in traag opkomende schermen, vooral voor gebruikers met trage internetaansluitingen.
  Daarom heeft Coppermine de optie om de originele afbeeldingen tijdens het inladen te verkleinen tot een zekere maximum resolutie - het is sterk aan te bevelen om deze optie te gebruiken in beide gevallen: voor admin uploads zowel als voor gewone gebruikersupload. De option bevindt zich in Coppermine's configuratie onder de naam Automatisch verkleinen van afbeeldingen die groter zijn dan de max. breedte of hoogte. Aanbevolen waarden liggen tussen 800 en 1200 pixels. In deze documentatie, zullen we verwijzen naar die afbeeldingen als "originelen" zelfs indien coppermine ze tijdens de upload verkleind heeft. Technisch gesproken zijn zij niet langer de "originelen" maar de aangepaste kopieën, maar aangezien deze optie pas lang na de eerste versie van Coppermine toegevoegd is, wordt in de documentatie verwezen naar deze bestanden als originelen. De originelen worden opgeslagen zonder prefix, gebruikmakend van de originele benaming gebruikt door de inzender. De bestandsnaam wordt alleen aangepast indien er verboden, web-onveilige, tekens in voorkomen zoals aangegeven in de configuratieoptie van Copermine Verboden karakters in bestandsnamen.

Coppermine gebruikt beeldbibliotheken (GD of ImageMagick) die reeds op de webserver moeten bestaan om de afbeeldingen met aangepaste afmetingen te kunnen maken (zie "minimum vereisten"). Deze bibliotheken zijn niet in staat om videoformaten aan te passen en zullen ook geen metadata zoals EXIF of IPTC bewaren. Dat is de reden waarom thumbnails en tussenmaten alleen kunnen aangemaakt worden voor het soort afbeeldingen die ondersteund worden door de afbeeldingsbibliotheek die u gebruikt.

Er kunnen problemen zijn met het verkleinen van grote foto's, als het verkleinen teveel resources gebruikt van uw webserver. Bekijk de sectie "Uploadproblemen oplossen" van de documententatie als u problemen krijgt met grotere bestanden (of in de eerste plaats met uploads zichtbaar te krijgen).

### Aanbevolen resizing instellingen

U moet begrijpen dat het aanpassen van de resizing-instellingen alleen invloed heeft op de afbeeldingen die vanaf dat tijdstip toegevoegd worden. Afbeeldingen die reeds bestaan bij de wijziging van de instellingen in de configuratie zullen niet automatisch aangepast worden - daarvoor moet u een proces starten door de corresponderende optie, "Update thumbnails en/of herschaalde foto's" te gebruiken van uit de beheerdersinstrumenten en alle albums doorlopen met de nieuwe instellingen.

#### Geen full-size pop-ups

Als u geen full-size pop-ups wilt gebruiken, bvb. als de afbeeldingen altijd getoond moeten worden in uw Coppermine scherm, dan kunt u coppermine instellen om webruimte te sparen met instellingen zoals deze.

U moet wel begrijpen dat u rekening moet houden met de bezoekers met de laagste resolutie. Als u verwacht dat uw bezoekers een resolutie hebben van 1024 x 768 pixels of beter, dan kunt u de breedte van de afbeeldingen instellen op 800, er moet altijd nog wat witruimte overblijven en wat plaats voor de besturingsknoppen.

Veronderstel dat bijvoorbeeld de max. afmeting die uw bezoeker te zien krijgt, 800 pixels is.

Ga naar coppermine's configuratie en plaats:

- "Maak tussenmaatafbeeldingen" op "nee"
  Op deze manier zal de full-size afbeelding eveneens getoond worden op het toonafbeeldingsscherm
- "Max breedte of hoogte van een tussenmaat afbeelding/video" op "800"
  Dit zorgt voor de resolutie die u zult zien op het toonafbeeldingsscherm
- "Max breedte of hoogte voor de uploaded afbeeldingen/videos" op "800"
  Dit zal een foutboodschap opleveren als uw gebruikers probeerden om foto's te uploaden met een grotere resolutie dan de ingestelde als u de volgende optie uitgeschakeld heeft "Automatisch verkleinen van afbeeldingen die groter zijn dan de max breedte of hoogte" op "Nee". Indien u echter de instelling plaatst op "Automatisch verkleinen van afbeeldingen die groter zijn dan de max breedte of hoogte" op "Ja", dan zullen alle uploads aangepast worden tot de maten die u ingesteld heeft in "Max breedte of hoogte voor uploaded afbeeldingen/videos (pixels)"
- "Automatisch verkleinen van afbeeldingen die groter zijn dan de max. breedte of hoogte" op "Ja:Iedereen"
  Als hierboven voorgesteld moet je deze instelling op "JA" zetten om te beletten dat de gebruikers een foutmelding krijgen bij het uploaden van grotere afbeeldingen dan verwacht. Coppermine zal dan de afbeeldingen op de server verkleinen indien nodig

Hierboven vermelde instellingen zijn het meest efficiënt als u beslist heeft om geen full-size pop-ups toe te laten, omdat hierdoor zoveel mogelijk webspace gespaard wordt en het de bezoekers onmogelijk maakt om grotere afbeeldingen te uploaden.

#### Full-size pop-ups met maximum ruimtebesparing

"Maak middelgrote afbeeldingen" op "nee" in de configuratie zal niet leiden tot een galerij waar u helemaal geen middelgrote afbeeldingen zult hebben die ingebed zijn in getoonde schermen; in plaats daarvan zullen de full-size foto's getoond worden maar gereduceerd in afmetingen door HTML-mechanismen. Deze optie is aanbevolen als de meerderheid van uw foto's zowiezo in de full-size resolutie getoond worden: op deze manier zal de browser de foto's al in cache hebben en zullen ze zeer snel getoond kunnen worden.

Geen middelgrote foto's aanmaken zal natuurlijk een impact hebben op de gespaarde webruimte. Indien u echer bezorgd bent over de gebruikte webruimte, kunt u beter overwegen om de "Max breedte of hoogte voor de opgestuurde afbeeldingen/video's" te beperken en de resizing van de afbeeldingen tot deze afmetingen in te schakelen (optie "Automatisch verkleinen van afbeeldingen die groter zijn dan max breedte of hoogte") - moderne digitale camera's maken foto's met enorme afmetingen en gebuiken daardoor grote webruimte. Het verkleinen van deze beelden naar zinvolle maten is goed voor praktische alle galerij-toepassingen.

Voorbeeld setup:

- Config instelling "Maak middelgrote foto's" → "neen"
- Config instelling "Max breedte of hoogte van een middelgrote foto/video" → "600"
- Config instelling "Max breedte of hoogte van opgestuurde foto's/video's" → "1280"
- Config instelling "Automatisch verkleinen van beelden die groter zijn dan max breedte of hoogte" → "Ja:Iedereen"

#### "Normale" setup met matig gebruik van bestandsruimte

Als u genoeg webruimte en bandbreedte heeft en uw bezoekers hebben een degelijke bandbreedte, dan is het aan te bevelen om het aanmaken van middelgrote bestanden in te stellen en de full-size pop-ups toe te laten voor de gebruikers die de details willen zien.

Voorbeeld setup:

- Config instelling "Maak middelgrote foto's" → "ja"
- Config instelling "Max breedte of hoogte van een middelgrote foto/video" → "800"
- Config instelling "Max breedte of hoogte voor opgestuurde foto's/video's" → "1600"
- Config instelling "Automatisch verkleinen van beelden die groter zijn dan max breedte of hoogte" → "Ja:Iedereen"

## Uw beheerdersaccount

Het is verplicht om uw adminaccount juist gedefinieerd te hebben en de gegevens ervan goed te onthouden. Coppermine voorziet u van een optie om een verloren paswoord terug te vinden maar hiervoor moet u een e-mailadres toekennen aan ieder account. Als users inloggen moeten zij een e-mailadres opgeven, dat zal dus geen probleem geven. Het administratoraccount, dat u aanmaakte tijdens de setup, heeft echter nog geen e-mailadres. Als u ingelogd bent als admin, ga dan naar uw profiel en vul daar een geldig e-mailadres in - op deze manier kunt u later een nieuw paswoord aanvragen als u het uwe vergeten bent.

Voor alle duidelijkheid: er zijn in Coppermine minstens twee plaatsen waar u een e-mailadres moet ingeven:

- de eerste plaats is de configuratie optie "Galerij administrator e-mail". Coppermine zal dit adres gebruiken als "van"-adres bij het zenden van e-mails (bv. tijdens registratie). Het is verplicht om dit e-mailadres correct in te vullen. Indien u uw eigen domein heeft, is het een goed idee om een e-mailadres te nemen dat verwijst naar uw domeinnaam.
  Als uw domeinnaam "voorbeeld.com" is, dan zou u een e-mailadres kunnen maken als galerij@voorbeeld.com en dat adres gebruiken in de configuratie van Coppermine. Coppermine maakt geen e-mailadres voor u!
- de tweede plaats is het profiel van uw gebruikersaccount: het is aangewezen om hiervoor ook een e-mailadres op te geven. Dat mag een andere adres zijn dat naar uzelf verwijst.

Het geeft geen probleem wanneer deze twee adressen gelijk zouden zijn. Het maakt niet uit als er maar een e-mailadres op beide plaatsen is opgegeven.

## Uploadrechten

In Coppermine wordt het recht van upload bepaald op groepsniveau waar de bezoeker toe behoort, u kunt dit recht dan ook toekennen in het paneel groepen (onder gebruikers). In 't algemeen zijn er de volgende mogelijke setups (per groep):

- ### Geen upload mogelijk

  - Schakel alle mogelijke uploads uit in het groep controle paneel voor de betrokken groep
    - Groepen → Rij die correspondeert met de groep → Persoonlijke galerij → Toegestaan = nee
    - Groepen → Rij die correspondeert met de groep → Publieke albums upload → Toegestaan = nee

- ### Gebruiker kan uploaden in bepaalde albums alleen in categorieën door de admin aangemaakt, maar kan geen albums aanmaken

  - Schakel de publieke album upload in in het groep controle paneel voor de betrokken groep
    - Groepen → Rij die correspondeert met de groep → Persoonlijke galerij → Toegestaan = nee
    - Groepen → Rij die correspondeert met de groep → Publieke albums upload → Toegestaan = ja
  - U moet uploads toestaan voor minstens één album. Ga naar de album eigenschappen van het album in een publieke categorie waar de gebruiker mag naar uploaden.
    - Album eigenschappen → Bezoeker mag bestanden uploaden = Ja
    Herhaal dit indien u uploads wilt toestaan in verschillende albums.

- ### Gebruiker kan in bepaalde albums uploaden in categorieën door de admin aangemaakt en kan in bepaalde categorieën albums aanmaken

  - Schakel publieke album upload in via het groepscontrole paneel voor de betrokken groep
    - Groepen → Rij die correspondeert met de groep → Persoonlijke galerij → Toegestaan = nee
    - Groepen → Rij die correspondeert met de groep → Publieke albums upload → Toegestaan = ja
  - Ga naar het categorie controlepaneel en bepaal de categorie(ën) waarin de gebruiker verondersteld wordt albums aan te maken
    - Categorieën → Edit icoon in de rij die correspondeert met de categorie waarin u albums wilt laten aanmaken → Groep(en) toegelaten om albums aan te maken in deze categorie → Selecteer de groepen (om meerdere groepen te selecteren, druk en houd de [Ctrl]-toets)
    Standaard is het de niet-admins niet toegelaten om albums aan te maken in publieke categorieën, u moet dus de gewenste groepen specifiek de toelating geven om in een bepaalde categorieën albums te mogen maken.

- ### Gebruiker kan persoonlijke albums maken in zijn gebruikers galerij en kan daarin uploaden

  Wanneer het de gebruiker is toegelaten om te uploaden in persoonlijke galerijen, moeten de volgende instellingen gebeuren.
  - Groepen → Rij die correspondeert met de groep → Persoonlijke galerij upload → Toegestaan = ja
  - Groepen → Rij die correspondeert met de groep → Publieke albums upload → Toegestaan = nee
  De gebruiker zal dan een extra menu item hebben, gelabeld "Maak / schik mijn albums" waar hij eerst een album moet aanmaken voordat hij kan uploaden (tenzij de de configuratie optie Configuratie → Registratie → Aanmaken gebruikersalbum in persoonlijke galerij tijdens registreren is ingesteld).

- ### Gebruiker kan uploaden naar publieke EN persoonlijke albums

  Een combinatie van beide is ook mogelijk: u kunt bepalen dat een gebruiker zowel kan uploaden naar albums in publieke categorieën als in persoonlijke albums in zijn gebruikersgalerij. Hiervoor moeten in het groepscontrolepaneel de volgende opties worden ingesteld:
  - Groepen → Rij die correspondeert met de groep → Persoonlijke galerij upload → Toegestaan = ja
  - Groepen → Rij die correspondeert met de groep → Publieke albums upload → Toegestaan = ja
  De hierboven voorgestelde methodes om upload toe te laten in bepaalde albums door gebruik te maken van het albumeigenschappen dialoogvenster als ook de besproken instellingen in het categorie controlepaneel moeten natuurlijk toegepast worden als hierboven voorgesteld.

## Controleer uploads

Vooraleer uw Coppermine galerij publiekelijk aan te kondigen, moet u er zeker van zijn dat de uploads normaal werken, dit zijn namelijk de meest voorkomende problemen die gebruikers hebben, ze worden veroorzaakt door een enorm aantal factoren waarmee rekening gehouden moet worden. Bekijk de sectie: upload probleemoplossing als u problemen heeft. Neem het niet als zeker aan dat uploads correct zullen werken - test het zorgvuldig, vooral indien u gebruikers toestaat om te uploaden.

## Overweeg bridging

Coppermine was ontworpen om als een standalone applicatie gebruikt te worden. Veel mensen wilden het echter integreren in een andere app, daarom werd vanaf de versie cpg1.1.x gestart met een systeem dat gebruikers toeliet om Coppermine te koppelen (= bridgen) met een andere toepassing op gebied van gebruikersbeheer. Het grootste voordeel hiervan is dat uw gebruikers slechts éénmaal moeten inloggen voor uw ganse site (bv. uw galerij EN uw forum), op die manier hebben ze ook maar één gebruikersnaam en één paswoord te onthouden.

Bridging integreert Coppermine niet visueel in uw homepage (u moet zelf een aangepast thema creëren om dit te verwezenlijken). Al wat bridging doet is Coppermine integreren voor zover het het gebruikersbeheer en de inlogprocedure betreft.

U kunt de bridging gelijk wanneer in- of uitschakelen, maar u kunt best de beslissing voor bridging nemen bij de eerste installatie van Coppermine, er zijn sommige problemen waar rekening moet mee gehouden worden: als er reeds gebruikers actief zijn in de coppermine database bij het inschakelen van de bridging, dan gaat de correlatie tussen de gebruikers die reeds in Coppermine actief waren en de nieuwe gebruikers van de bridgepartner verloren. Dat heeft als gevolg dat er geen verband meer bestaat tussen hetgeen de "oude" gebruikers deden (uploading foto's, comentaar posten enz...) en de nieuwe gebruikers van de gekoppelde toepassing.

Om deze toekomstige problemen te omzeilen, zou u een beslissing moeten nemen bij de installatie van Coppermine: bent u van plan om gebruikersinteractie toe te staan? Bent u van plan om (later) een forum aan te bieden of een ander programma dat een gebruikersbestand kan beheren? Als uw antwoord hierop "ja" is, of "misschien", dan is het aan te raden om de bridging in te stellen vooraleer u uw site voor het publiek openstelt en gebruikers laat inloggen.

Lees de details hierover in de bridging sectie van de doumentatie.

## Wat mogen uw gebruikers doen?

Coppermine kan gebruikt worden voor allerlei doeleinden: sommigen gebruiken het om hun persoonlijke bestanden te tonen aan iedereen op het Internet, anderen willen slechts een beperkt aantal gebruikers de mogelijkheid geven om alleen maar het aangeboden materiaal te bekijken en geen enkele actie kunnen ondernemen. Een groot aantal webmasters willen een site open stellen voor een bepaalde groep (familie, club) waar de gebruikers actief kunnen deelnemen door hun eigen werken te uploaden en anderen hun werken kunnen beoordelen door punten toe te kennen of commentaren te schrijven.

U kunt Coppermine op al deze manieren gebruiken (of een mix ervan), maar u zou eerst de mogelijkheden en limieten moeten bekijken:

Gebruikers "erven" hun rechten van de groep waartoe ze behoren. Daarom worden de meeste rechten toegekend aan groepen. Op deze manier kunt u verschillende niveau's van rechten instellen. De instelling van de rechten kan gebeuren via het groepscontrole paneel

## Verander het uiterlijk van uw Coppermine galerij

U kunt sommige layout- en design-aspecten aanpassen (bv. tonen van random thumbnails op de indexpagina) in de overeenkomstige configuratie sectie. Coppermine heeft een thema mechanisme dat u toelaat om het uiterlijk van uw galerij aan te passen. Om uw site een uniek uitzicht te geven of te laten passen in uw eigen huisstijl, kun u kiezen tussen de meegeleverde thema's, een door gebruikers ontworpen thema downloaden via de downloadsectie van de Coppermine homepage of u kunt er zelf een samenstellen door een van de beschikbare thema's aan te passen naar eigen smaak.

## Typische setups

Er zijn veel configuratieopties ingebouwd in Coppermine - gebruik ze met verstand. Veel gebruikers vragen naar een typische setup (alhoewel er niet echt zoiets bestaat als de typische setup die past voor iedereen), ziehier enkele mogelijkheden:

### Enige uploader zonder gebruikersinteractie (Monolithische galerij

Alleen de uploader (u, de admin) en weinig of geen gebruikersinteractie
Als u de enige uploader gaat zijn en weinig of geen acties toelaat aan uw gebruikers, verbied dan de bezoekers van uw site alles wat u niet wilt dat ze zouden kunnen doen. Dit is meestal het geval wanneer u een kunstenaar bent of een fotograaf: er is geen gemeenschapsopbouw - u wilt alleen uw werken tonen aan een groot publiek.

- Schakel nieuwe gebruikersregistratie uit in Coppermine's configuratie (Configuratie → Registratie → Laat nieuwe gebruikersregistratie toe). Als u dit uitvinkt zal de "Registreer" knop in de menubalk niet meer aanwezig zijn. Gebruikers die manueel naar de registratiepagina gaan zullen een boodschap krijgen dat deze operatie niet toegestaan is.
- Schakel het aanmaken van nieuwe albums uit voor gebruikers (Groepen → Rij "Geregistreerd" → Persoonlijke galerij → Toegestaan = nee) in geval u de registratie niet uitgeschakeld heeft van in het begin en er zijn nog enkele gebruikers geregistreerd.
- Verbiedt bezoekers om te uploaden door naar het groepscontrolepaneel te gaan en "Publieke albums uploaden" niet toe te staan: Groepen → Rij "Gasten" → Publieke albums upload → Toegestaan = nee. Als de groep gasten (of een andere groep) geweigerd wordt om persoonlijke galerijen te hebben en te uploaden naar publieke albums, zal de "upload bestand"-link niet meer getoond worden in het menu.
- Als u geen interactie wilt van uw bezoekers om een rating toe te kennen, zet dan de rating uit in het groepscontrolepaneel voor de gasten/anonymous groep: Groepen → Rij "Gasten" → Rechten → Rating = nee. Als rating uitgeschakeld is, zullen de gebruikers geen ratingsterren zien waar ze normaal zouden kunnen stemmen.
- Als u niet wilt dat uw bezoekers commentaar posten, schakel dan commentaar uit voor gasten: Groepen → Rij "Gasten" → Rechten → Commentaren = nee.
- Als u niet wilt dat uw bezoekers e-kaarten sturen, schakel dan het sturen van e-kaarten uit in het groepscontrolepaneel zoals hierboven voorgesteld: Groepen → Rij "Gasten" → Rechten → E-kaarten = nee

### Enige uploader met gebruikersinteractie

Als u de enige uploader bent maar u wilt een gemeenschap opbouwen rond uw site, met bezoekersregistratie, commentaren posten, enz..., schakel dan alleen de uploads uit voor uw gebruikers maar zet alle andere functies open die u wilt toelaten:

- Schakel alle soorten uploads uit voor gasten en geregistreerde gebruikers:
  - Groepen → Rij "Gasten" → Persoonlijke galerij → Toegestaan = nee
  - Groepen → Rij "Geregistreerden" → Persoonlijke galerij → Toegestaan = nee
  - Groepen → Rij "Gasten" → Publieke albums → Toegestaan = nee
  - Groepen → Rij "Geregistreerden" → Publieke albums → Toegestaan = nee
- Om spam te voorkomen kunt u best commentariëren weigeren aan gasten maar wel toestaan aan geregistreerde gebruikers:
  - Groepen → Rij "Gasten" → Rechten → Commentaren = nee
  - Groepen → Rij "Geregistreerden" → Rechten → Commentaren = ja
  - Om commentaarspam tegen te gaan kunt u de commentaargoedkeuring en/of de captcha instellen voor commentaren.
    Om commentaargoedkeuring in te stellen, ga naar het Coppermine configuratiescherm en verander de corresponderende instelling: Configuratie → Commentaar instelling → Commentaar vereist goedkeuring.
    Als extra (of alternatief), kunt u bij het commentariëren de captcha instellen (een soort van afbeelding die dooreengehusselde willekeurige letters toont aan de bezoeker en die deze dan moet aftypen in een invoerveld om te bewijzen dat een mens deze gegevens heeft ingevuld en niet een of andere robot): Configuratie → Commentaarinstelling → Display Captcha (Visuele Confirmatie) voor het toevoegen van commentaren
- Sta bezoekers toe om uw foto's te beoordelen: u stelt dit in op groepsniveau. Ga daarvoor naar het groepscontrolepaneel en stel de mogelijkheid tot beoordelen in voor alle mogelijke groepen:
  - Groepen → Rij "Gasten" → Rechten → Rating = ja
  - Groepen → Rij "Geregistreerd" → Rechten → Rating = ja
  Dit is echter niet alles: bekijk deze groepsinstelling als een algemene aan-/uit-schakelaar. U kunt een fijninstelling doen per individueel album: u kunt rating toestaan in één album en weigeren in een ander album. Ga naar de album eigenschappen van een individueel album om ratings toe te staan of te weigeren voor dit bepaald album.

### Meerdere uploaders zonder nieuwe registraties (gesloten groep)

Normaal wordt deze instelling gebruikt wanneer u kiest voor een verhoudingsgewijs laag aantal gebruikers die kunnen uploaden maar een groter aantal mensen die de inhoud van uw galerij kunnen bekijken. Dit is vaak het geval voor clubs, verenigingen of bedrijven waar alleen de leden bestanden mogen uploaden en de bezoekers alleen de inhoud mogen bekijken zonder iet toe te voegen. Er is weinig verschil in vergelijking met de vorige setup "Enkele uploader met gebruikersinteractie" behalve voor het volgende:

- Configuratie → Registratie → Sta nieuwe gebruikerregistraties toe = nee verhindert dat nieuwe gebruikers kunnen registreren. Alleen de admin zorgt voor de nodige gebruikersaccounts.
- De admin moet natuurlijk wel de uploadrechten instellen voor de geregistreerde gebruiker