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

# Installatie en Setup

## Hoe het script installeren

- ### Minimum vereisten

  Verzeker u er van dat u voldoet aan de minimum vereisten om Coppermine te kunnen gebruiken op uw webserver.

- ### Ontzip het archief met behoud van de mappenstructuur

  Best geeft u de Coppermine hoofdmap een eigen naam, maar laat de namen van de submappen en bestanden zoals ze zijn.

  Details

  U heeft een toepassing nodig die het Copperminepakket kan ontzippen zoals 7-Zip indien uw OS geen ontzip ondersteuning ingebouwd of meegeleverd heeft, (Windows XP of hoger heeft dat ingebouwd; de meeste Desktop Linux distributies hebben gelijkaardige programma's zoals File Roller ter beschikking). In sommige Zip/Unzip toepassingen zoals WinZip is een instelmogelijkheid voor de eindgebruiker beschikbaar om de mappenstructuur van het Coppermine pakket te bewaren of om alle bestanden uit te pakken in een enkele map zonder submappen. Voor Coppermine is het belangrijk dat de volledige mappenstructuur behouden blijft.

  Een goede plaats om uw kopie van het Copperminepakket uit te pakken is het bureelblad of een andere tijdelijke map. In deze tekst veronderstellen wij dat u het pakket hebt uitgepakt op het bureelblad.

  Na het uitpakken zou u een map op uw bureelblad moeten hebben met de naam `cpg15x`. Bij deze vragen wij u om de naam van die map te veranderen in een meer bruikbare naam voor het gebruik op internet, let er echter wel op dat u een webveilige naam gebruikt: gebruik geen speciale tekens behalve het min-teken (`-`) en de underscore (`_`), gebruik geen spaties, gebruik geen accentletters of welk ander speciaal teken dan ook. Vermijd hoofdletters indien mogelijk. In feite dus alleen latijnse alphanumerieke tekens (`a` tot `z` en `0` tot `9`). Deze aanbevelingen gelden niet alleen voor de Coppermine map maar voor alle mappen of folders die geüpload worden naar een web-server.

  Hier een lijstje met voorbeelden van geschikte namen voor de map:
  - `gallery`
  - `pictures`
  - `images`
  - `multimedia`
  - `fotogalerij` (indien de meerderheid van de gebruikers Nederlands spreekt, het Nederlands woord voor gallery is Galerij met één `L en gestipte ij`)
  De mapnaam die u hier kiest zal later corresponderen met de URL van uw galerij, het is dus aan te raden om een naam te kiezen die gemakkelijk te onthouden is. U krijgt zelfs een kleine extra bonus in gebruiksvriendelijkheid van uw zoekrobot indien u een beschrijvende naam geeft zoals `galerij`. Maak u echter geen zorgen over de naam van de map waarin Coppermine zal geplaatst worden: u kunt de naam van de map later nog aanpassen.

- ### Upload alle bestanden naar uw webserver

  Het is strikt noodzakelijk om alle mappen en bestanden, die in het pakket van Coppermine zitten te uploaden naar de webserver.
  Details

  Gebruik uw FTP-client applicatie om de uitgepakte map, die u ontzipt hebt in de eerste stap, te uploaden naar uw webserver. Gebruik geen browser add-ons of enig ander flutprogramma om de bestanden te uploaden maar gebruik een echt FTP-programma. Vertrouw geen uploaders die nogal eens aangeboden worden als WYSIWYG-editors zoals MS-Frontpage of Dreamweaver, want deze ingebouwde uploaders hebben nogal eens de neiging om de tekstbestanden te "verfraaien" en daardoor fouten te veroorzaken. Dergelijke editors en de hulpjes die daar bij horen, zijn wel OK voor andere doeleinden maar geven vaak problemen met geprepareerde bestanden zoals die van Coppermine. Daarom dringt het Coppermine ontwikkelingsteam sterk aan om zulke WYSIWYG-editors niet te gebruiken. Indien u nog geen FTP-programma heeft, neem dan eens een kijkje in de lijst van hulpjes aanbevolen door de Coppermine ontwikkelaars. Gebruik geen rommel als WebFTP applicaties: deze applicaties zijn goed voor een gelegenheids-upload wanneer u van thuis weg bent en geen toegang hebt tot een computer waar je de volledige toegang toe hebt, WebFTP is niet OK om gebruikt te worden om een pakket als Coppermine te installeren vanwege de ingebouwde limieten in dergelijke applicaties.

  Om uw FTP-applicaties te gebruiken, moet je natuurlijk de FTP-details van uw webspace weten. Als u niet zeker bent van deze details, vraag dan uw webhost voor ondersteuning.

  Gebruik zeker de juiste FTP modus bij het opladen.

  Als u van plan bent om van Coppermine uw primaire applicatie te maken die getoond wordt op de startpagina van uw site, dan hoef je niet noodzakelijk de Coppermine bestanden in een afzonderlijke map te plaatsen: u kunt dan gerust de inhoud van het Coppermine pakket in de webroot van uw server kopiëren.

- ### Rechten toekennen op de "albums" en "include" mappen in uw Coppermine map

  Stel rechten in op bestandssysteem niveau voor het Coppermine script. Coppermine heeft schrijfrechten nodig voor sommige mappen binnen in de Coppermine folder. Rechten toekennen kan soms moeilijk zijn voor nieuwelingen, daarom is er een aparte sectie van de documentatie geschreven over de permissies in detail.
  Gewoonlijk moet u het CHMOD-commando gebruiken om de rechten op 755 (of 777, afhankelijk van uw serverconfiguratie) te plaatsen.
  Deze stap is zeer belangrijk en mag zeker niet overgelagen worden!

- ### Zorg ervoor dat u correcte informatie bezit over uw database

  U moet de databasenaam weten maar ook de details van een MySQL gebruikersaccount via welk Coppermine geconnecteerd moet worden met de database. De database en de gebruikersnaam moeten al bestaan, en de gebruiker moet toegang hebben tot de relevante databank. Coppermine zal de database zelf niet voor u aanmaken, maar zal wel de tabellen in de database aanmaken bij de installatie, u hoeft zelf geen tabellen toe te voegen.
  Details
  Indien er geen database beschikbaar is voor uw website, moet u er een creëren of een laten aanmaken door uw webhost. Uw webhost is bestgeplaatst om u te voorzien van de juiste instructies om een database aan te maken. Voor het installeren heeft u het pad nodig van de database-server welke u zult gebruiken en details van het MySQL gebruikersaccount waarmee Coppermine zal connecteren met de server. U moet hebben: het database serverpad (gewoonlijk 'localhost'), uw MySQL gebruikersnaam, MySQL paswoord, en MySQL databasenaam voordat Coppermine geïnstalleerd kan worden. De gebruiker die Coppermine installeert moet alle relevante toegangsrechten hebben tot deze database.
  Als u een nieuw aangemaakte database gebruikt, dan hoeft u geen enkele tabel toe te voegen. Coppermine zal de nodige tabellen aanmaken in de database gedurende het installatieproces.

- ### Run het installatie script op uw server

  Typ de volgende URL in de adresbalk van uw webbrowser: `http://uw_server/coppermine_dir/install.php` (uw_server = uw website, coppermine_dir = de map waarin u de Coppermine bestanden geüpload hebt.) Volg de online instructies op het installatiescherm voer de nodige informatie in zoals gevraagd wordt.
  Voorbeeld
  Als uw website `voorbeeld.com` is en de naam van uw Coppermine map was "`galerij`", dan is het adres dat u moet intypen `http://voorbeeld.com/galerij/install.php`

## Wat doet de installer

Na enkele basiscontroles, creëert de installer de nodige databasetabellen voor u en vult ze met standaardwaardes. Hij creëert het bestand \'include/config.inc.php\' in de coppermine map op uw server, hierin worden de databasedetails opgeslagen die u ingevoerd heeft tijdens de installatie. Als u later uw mysql databasedetails zou veranderen (bvb. als u het paswoord verandert of uw mysql gebruikersaccount of indien u uw galerij migreert naar een andere server), moet u de veranderingen manueel in dit bestand \'include/config.inc.php\' inbrengen. Het bestand \'include/config.inc.php\' verhindert ook dat het installatiescript tweemaal zou uitgevoerd worden: bij het runnen van de installer, wordt een controle uitgevoerd of het configbestand al bestaat - indien ja, zal de installer stoppen en de gebruiker terug naar de indexpagina brengen.

## Verbandhoudende informatie

Er zijn enkele extra informatiedelen die in verband staan met de installatie:

- Auto-Installers (zoals Fantastico)
  Ontdek wat daarmee mis is, waarom u ze niet zou gebruiken en wat u kunt doen indien u toch een auto-installer gebruikt hebt
- Installatie FAQ
  Frequently asked questions in verband met de installatie van coppermine. Lees eerst vooraleer vragen te stellen!
- Uninstall
  Alhoewel wij overtuigd zijn dat Coppermine geschikt is voor iedereen, zou het toch kunnen dat u er van af wilt geraken (om gelijk welke reden) - hier volgen de instructies hoe dat kan gebeuren.
- Starten (eerste stappen na de installatie)
  U heeft Coppermine met succes geïnstalleerd? Volgende stap - hier is een andere korte pagina die uw coppermine galerij in de kortste keren configureert en vult met inhoud.

## Server configuratie

Bij het installeren van Coppermine, zou u in problemen kunnen geraken die niet rechtstreeks verband houden met Coppermine, maar tot de webserver setup. Deze sectie van de docs kan alleen maar een beknopt overzicht geven over de problemen met de webserver setup. Wij kunnen alleen maar aanbevelingen geven, maar het valt buiten het bestek van Coppermine support om u exact te adviseren hoe een setup van een webserver uitgevoerd moet worden. Met andere woorden: indien u problemen heeft met de webserver setup, gelieve u dan te wenden tot de supportafdeling van uw webhost en niet die van Coppermine.

### register_globals

In oudere versies van PHP, is de standaard instelling voor register_globals "on", wat resulteert in veel PHP-coders die rommelige code leveren met betrekking tot veiligheid (eenvoudigweg omdat zij zich niet bewust zijn van de gevaren die zich in zulke rommelige code bevinden). Als resultaat zijn er veel scripts die er op vertrouwen dat de server variabele "register_globals" aan staat. Echter, doordat veel kwaadwillige aanvallen op scripts uitgevoerd worden met dat vertrouwen op het aanstaan van register_globals, is het aan te raden om deze functie uit te schakelen in de configuratie van uw webserver's PHP instellingen. In recente versies van PHP, is de default instelling "off". Het zou echter kunnen dat uw webhost de register_globals nog heeft "aan" staan om u toe te laten om oudere scripts te kunnen gebruiken.

Voor alle duidelijkheid: coppermine heeft register_globals=on niet nodig , maar zal werken in beide gevallen: "on" of "off". Het is alleen in functie van de veiligheid dat wij de gebruikers een waarschuwing geven wanneer de server deze variabele heeft "aan" staan. De installer zal een waarschuwing geven maar gewoon doorgaan met de installatie ongeacht de instelling.

Het Coppermine ontwikkelingsteam wil de instelling `register_globals` off op uw server dan ook sterk aanbevelen. Wij kunnen echter niet zeggen hoe dat moet gebeuren: het is een webserver-instelling en geen van Coppermine. Gewoonlijk (wanneer u een shared hosting heeft) kunt u vragen aan uw webhost om `register_globals` op "off" te zetten voor u. Een goede webhost doet dat voor u of kan u tenminste zeggen hoe dat in uw geval moet gebeuren (als zij u toestaan om uw server te configureren). Stel de vraag over `register_globals` a.u.b. niet op het Coppermine support board - dat valt buiten het bestek van dat support forum.

Er zal geen negatieve impact zijn voor uw Coppermine installatie als u de `register_globals` aan laat staan: niemand buiten u (de admin) zal de boodschappen van het script zien die waarschuwen voor de gevaren die schuilen in `register_globals`. Er zou misschien wel een impact kunnen zijn voor andere applicaties die nog op uw webruimte staan - wij kunnen u hierover geen zekerheid geven.