# Coppermine Photo Gallery v1.5.x: Documentatie en Handleiding

# Over Coppermine

Coppermine Photo Gallery is een geavanceerd, gebruiksvriendelijk, fotogalerij-script met ingebouwde ondersteuning voor andere multi-media/data bestanden. De galerij kan privaat zijn, alleen bereikbaar voor de geregistreerde gebruikers, en/of open voor alle bezoekers van uw site. Gebruikers, indien toegelaten, kunnen foto's uploaden met hun webbrowser (thumbnail and tussenformaatafbeeldingen worden en passant gemaakt), foto's beoordelen, commentaar toevoegen en zelfs e-kaarten sturen. De sitebeheerder bepaalt welke hierboven genoemde toepassingen beschikbaar zijn voor geregistreerde en ongeregistreerde gebruikers. De sitebeheerder kan ook galerijen besturen en grote hoeveelheden van foto's, die naar de server geüpload zijn via FTP, in batch bewerken.

Beeldbestanden worden opgeslagen in albums en albums kunnen gegroepeerd worden in categorieën, welke op hun beurt verder gegroepeerd kunnen worden onder hogerliggende categorieën. Het script ondersteunt meerdere gebruikers en voorziet de beheerder van de website met gereedschappen om te beslissen welke gebruikersgroepen al dan niet hun persoonlijke albums kunnen hebben, e-kaarten kunnen versturen of commentaar kunnen toevoegen. Gebruikers kunnen ook uploaden naar publieke albums indien de websitebeheerder het toelaat. Rechten om albums aan te maken, te uploaden en te wissen worden allemaal bepaald door de websitebeheerder.

Coppermine heeft een door gebruikers optioneel te selecteren themasysteem met een aantal verschillende thema's voorgeïnstalleerd. Het ondersteunt ook het gebruik van meerdere talen en bevat zijn eigen taalbibliotheek. Deze taalbestanden laten de gebruikers van uw galerij toe om de galerij te gebruiken in hun voorkeurtaal. Coppermine gebruikt PHP, een MySQL database, en ofwel de GD bibliotheek (versie 1.x or 2.x) ofwel ImageMagick als fotobibliotheek om een database te genereren van bestandsinformatie van alle thumbnails, tussenformaat en full-sized afbeeldingen. Coppermine genereert de nodige html-code om de verschillende categorieën, sub-categorieën, albums, tussenformaat- en full-sized-afbeeldingen dynamisch af te beelden. Dit vermindert drastisch het aantal bestanden en de gebruikte ruimte die uw galerij anders zou innemen bij gebruik van de standaard HTML. Het installatiescript (install.php) maakt het u snel en gemakkelijk om te starten.

Coppermine gebruikt de jquery JavaScript/Ajax-bibliotheek voor een rijke gebruikersbelevenis en gemakkelijke aanpassingen.

Coppermine is gratis, open source software en mag gebruikt worden voor zowel privé als professioneel gebruik. Het is uitgebracht onde de GNU GPL licentie, versie 3, welke goedgekeurd is door de OSI.

## Over de documentatie

Gebruik het menu boven-links van dit scherm om door de Coppermine documentatie te bladeren. Het menu is beschikbaar doorheen de ganse documentatie. Het menu is JavaScript-gestuurd - als u JavaScript hebt uitgeschakeld of niet kunt gebruiken voor eender welke reden, gebruik dan bovenaan de link, die zal u naar de inhoudstafel brengen en van daaruit naar de sectie van de documenten die u wilt lezen.

Het Coppermine ontwikkelingsteam kan u sterk aanbevelen om Javascript in te schakelen en een moderne browser te gebruiken (met CSS en JavaScript in overeenstemming tot de DOM standaard) om meer te genieten van de speciale opbouw van deze documentatie.

### Documentatie Conventies

#### Tekstkaders

In deze documentatie komen verschillende tekstkaders voor met een speciale betekenis:

Voorbeelden die bedoeld zijn om de gegeven instructies te illustreren, worden aangegeven zoals dit!

Extra informatie die zeker bekeken moet worden, wordt aangegeven zoals dit.

Hints die gewoonlijk leiden tot een beter inzicht in de algemene werking van Coppermine of u zullen helpen om bepaalde functies met succes te kunnen toepassen worden geaccentueerd zoals dit.

Waarschuwingen over dingen die gemakkelijk fout kunnen gaan als er een vergissing gebeurd is, worden op deze manier weergegeven. Het is aan te raden om extra aandacht te besteden aan de tekst in dit soort kaders.

Zaken die fout kunnen gaan afhankelijk van een actie of invoer door een gebruiker, worden op deze manier getoond.

Momentele fouten of toestanden die een grote impact kunnen hebben, worden zoals deze getoond. Dit is de meest ernstige soort van de tekstvakken - de inhoud is zeer belangrijk om te lezen.

Grotere delen van codevoorbeelden (kan PHP, HTML, CSS of JavaScript zijn) worden getoond met een typemachine vooraan in het tekstvak.

#### Linken

Alle "normale" linken (die geen speciaal icoon vertonen) zijn interne linken, zij verwijzen bvb. naar een sectie van deze documentatie en laten u toe om door dit document te navigeren. Uitzonderingen op deze regel zijn de volgende linken:

- ##### Uitklapbare / dichtgeklapte secties

  Dit zijn sommige secties die uitgeklapt of dichtgeklapt kunnen worden (als Javascript ingesteld is in uw browser) voor een overzichtelijker geheel. Gewoonlijk bevatten deze secties details over de tekst aangegeven in de alinea die er net voor staat. Uitklapbare secties worden voorafgegaan door een klein kadertje met een plusteken (), de uitgeklapte toestand wordt weergegeven met een min-teken (). Als JavaScript uitgeschakeld is in uw browser, dan worden alle uitklapbare delen weergegeven als uitgeklapt - klikken op de icoontjes heeft dan geen effect.

- ##### Externe linken

  Externe linken die naar een pagina verwijzen buiten deze documentatie, worden gevolgd door een klein icoontje dat een venster met daarin een pijl voorstelt: .

- ##### PHP documentatie

  Coppermine is een PHP-applicatie, er zijn een aantal verwijzingen in dit document die verband houden met technische termen uit de programmeertaal PHP. De linken met een PHP-icoon () verwijzen dan ook naar secties in de officiële PHP documentatie op php.net waar meer informatie te vinden is over definities of termen gebruikt in de Coppermine documentatie.

- ##### Ankers

  Op iedere pagina in de Coppermine documentatie zult u anker-iconen vinden () volgend op veel alineahoofdingen. Zij zijn aanklikbaar en verwijzen exact naar de genoemde alinea. Deze symbolen zijn hoofdzakelijk bedoeld om gemakkelijker ondersteuning te kunnen geven: indien een supportgever wil verwijzen naar een bepaalde sectie van de documenten vanuit zijn/haar bericht, kan hij/zij vanuit de officiële coppermine homepage op dat anker rechtsklikken, "snelkoppeling kopiëren" en die gekopieerde link dan plakken in de e-mail. Voor u als eindgebruiker kunnen de ankers helpen als u bladwijzers voor bepaalde secties wilt aanmaken.

## Functies

Coppermine omvat een groot aantal functies. Beneden vind u een onvolledige lijst. Nieuwe functies in cpg1.5.x (vergeleken met cpg1.4.x) zijn als dusdanig gemarkeerd.

Details

- Installatie
  - gemakkelijk installeren (installatiescript is voorzien)
  - verbeterd, wizard-achtige installatie (cpg1.5.x)
- Registratie & Login
  - termen, voorwaardenoptie (cpg1.5.x)
  - config settable globaal paswoord voor registratie functie (cpg1.5.x)
  - visuele confirmatie (captcha) voor registratie (cpg1.5.x)
  - e-mailadres verificatie (activation link)
  - resend activation link feature (cpg1.5.x)
  - goedkeuring registratie door admin
  - registratie notificatie voor admin
  - optional creatie van persoonlijke albums bij registratie (cpg1.5.x)
  - gebruiker kan eigen account wissen functie (cpg1.5.x)
  - login mogelijk met gebruikersnaam of e-mailadres (cpg1.5.x)
- Gebruikersbeheer
  - gebruikersbeheer (private galerijen, groepen)
    bezoekers kunnen hun eigen registreren (als de admin registraties toestaat). Alternatief, admin kan gebruikersaccount creëren.
  - Gebruikersbeheer gebaseerd op groepen
  - Rechten worden beheerd/toegewezen per groep
  - bridging: integratie van gebruikersbeheer met verschillende bbs (zoals phpBB, YaBB SE, SMF, Invisionboard, vbulletin)
  - bbs integratie instelbaar met een wizardachtige gebruikersinterface (bridge manager)
  - gebruikers lidmaatschap in meerdere groepen
  - meer admin-instelbaar gebruikersprofiel velden
- Beheer van categorieën en albums
  - indelen van foto\'s in categorieën, optioneel sub-categorieën en albums
  - gebruikers kunnen albums aanmaken in categorieën met admin toestemming (cpg1.5.x)
  - Nieuwe categorie hiërarchisch systeem (cpg1.5.x)
- Uploading
  - gebruikers kunnen foto\'s/bestanden uploaden met webinterface (en admin kan FTP-uploaden en batch-toevoegen aan database)
  - aanmaken van thumbnails en tussenmaat-foto\'s
  - bijschrift, titel, omschrijving en gebruiker gedefinieerde velden voor iedere foto (doorzoekbaar)
  - upload goedkeuringsnota voor admin
  - beeldverdraaiïng
  - multi-pic upload
  - optie te kiezen max hoogte of breedte voor thumbnails helpt bij het mooier uitlijnen van thumbnail rijen en kolommen
  - foto-afmetingen aanpassen tijdens het opladen
  - optioneel bekijk thumbnails tijdens batch-upladen (cpg1.5.x)
  - boodschap toegelaten bestandstypes getoond op uploadscherm (cpg1.5.x)
  - geanimeerde grafieken op het oplaadscherm om het vorderen van het opladen aan te geven (cpg1.5.x)
  - niet-latijnse karakters in bestandsnamen worden vervangen door transliteratie indien mogelijk en underscore indien er geen transliteratie voor webveilige bestandsnamen beschikbaar is, ongeacht de gebruikerskennis (cpg1.5.x)
- Tonen van afbeeldingen
  - Meta albums:
    admin kan specificeren welke virtuele extra albums gebruikt kunnen worden om alternatieve voorstellingen of methodes aan te bieden om door de galerij te bladeren:
    - laatst becommentarieerd
    - laatst toegevoegd
    - random foto
    - blader op datum meta-album (cpg1.5.x)
    - meest bekeken
    - top waardering
    - favorieten
  - diashow bekijken
  - optie om een klikbare filmstrip van thumbnails te tonen onder de beeldweergave
  - watermerk optie (cpg1.5.x)
  - thumb bijknippen en verscherpen (cpg1.5.x)
- Gebruikers interactie
  - gebruikers commentaar
  - commentaar goedkeuring optie (cpg1.5.x)
  - visuele confirmatie (captcha) voor commentaren (cpg1.5.x)
  - gebruik van Akismet voor commentaarfiltering (cpg1.5.x)
  - registratie promotie in de commentaarsectie (cpg1.5.x)
  - e-kaart functie
  - Flash support voor e-kaart (cpg1.5.x)
  - taalselectie optie in template
  - paswoord-beveiligde albums
  - Stemming/Waardering
  - optioneel weergave van de waardering op thumbnailscherm (cpg1.5.x)
  - stemmingsniveau aanpasbaar en ajax-driven (cpg1.5.x)
  - optioneel contactformulier met captcha (cpg1.5.x)
  - gebruikers kunnen misplaatste of ongewenste inhoud rapporteren aan admin
  - favorieten: bezoekers kunnen beelden toevoegen aan hun favorieten voor toekomstige bezoeken
- Statistieken
  - publiek tonen van aantal beelden, bekeken en laatste uploads
  - browser en os stats voor admin (cpg1.5.x)
  - algemene stats (cpg1.5.x)
  - album hits teller (cpg1.5.x)
  - publieke stats kunnen uitgeschakeld worden (cpg1.5.x)
- Zoeken
  - geavanceerd zoeken (boolean operators)
  - regular expressions in zoekopdracht (cpg1.5.x)
  - klikbare trefwoorden
  - tag wolk functie (cpg1.5.x)
- Administratie
  - Admin hulpjes
  - basis goedkeuring voor update script (cpg1.5.x)
  - reset naar standaard voor individuele configuratie opties (cpg1.5.x)
  - Opgeladen bestanden kunnen afgekeurd worden door de admin om ze tijdelijk te verbergen (cpg1.5.x)
  - Directe verbanningsoptie op commentaartoelatingsscherm (cpg1.5.x)
  - Gebruikersbeheerscherm met bijkomende criteria, toont de gebruikersinteractie (cpg1.5.x)
- Plugins
  - plugin-API om verbeteringen toe te laten die door gebruikers aangebracht worden
  - veel plugin bijdragen beschikbaar
  - plugin-manager
- Documentatie
  - online help functie voor de admin pagina\'s
  - bbcode help icoon op commentaren (cpg1.5.x)
  - complete admin documentatie beschikbaar
  - veeltalige documentatie
  - documentatie gesplitst in secties om leesbaarder te maken (cpg1.5.x)
- Allerlei
  - beeldinformatie opgeslagen in database
  - volledig multimedia support
  - meertalig
  - Engels als een backup taal voor (nog)niet-vertaalde delen in de taalbestanden
  - alle functies aanpasbaar via webinterface (admin section)
  - EXIF/IPTC support
  - URL parameters verwijzen naar absolute posities inplaats van relatieve om de zoekfunctie gebruiksvriendelijker te maken (cpg1.5.x)
  - API voor Coppermine om te gebruiken met applicaties zoals Koppermine en andere (cpg1.5.x)
  - nieuwssectie voor de admin om hem te verwittigen bij beschikbare updates (cpg1.5.x)
  - gebruik van Inspekt voor de gezondmaking van superglobals, een hulpprogramma om veilige PHP applicaties te maken (cpg1.5.x)
  - granulaire controle voor gast toegang: geen toegang, alleen thumbs, thumbs + middelmaat alleen, thumbs + middelmaat + full-size (cpg1.5.x)
  - Voorkomt dat zoekrobotten meta albums kunnen indexeren (cpg1.5.x)
- Uitzicht
  - template/thema systeem
  - scheiding van de breadcrumb blok zodat hij onafhankelijk van de categorie kan geplaatst worden in de template
  - optie om eerste niveau albums tonen van een categorie inplaats van alleen maar statistieken van de categorie
  - optie om de toon "Privaat" Icoon aan niet-ingelogde / niet-gemachtigde gebruiker aan of uit te zetten
  - option to send visitors directly from the thumbnail page to the full-size pop-up (cpg1.5.x)
  - optioneel film download link (cpg1.5.x)
  - afwisselende kleuren voor tabelrijen (cpg1.5.x)
  - optionele tag wolk (cpg1.5.x)
  - sidebar voor gemakkelijker navigatiebalk (cpg1.5.x)
  - ajax filmstrip (cpg1.5.x)

## Wat nu?

Er zijn een aantal pagina's in deze documentatie waar beginners best zouden mee beginnen:

- Quick-Start gids
- Minimum eisen
- Testen (alpha/beta versies!)
- Talen
- Credits
- Licentie & Copyright
- Gekende problemen