Coppermine Photo Gallery v1.5.4: Documentatie en Handleiding

Thema's

Coppermine heeft een krachtig mechanisme dat u toestaat om uw eigen thema te ontwerpen, zo kunt u uw galerij een uniek uitzicht geven dat past bij de rest van uw volledige website. Andere applicaties noemen dit "skins" of "templates", wij noemen het "thema's".

Er is een (constant groeiend) aantal van thema's door gebruikers ontworpen die bekeken en gedownload kunnen worden van de Coppermine web site.

Thema's meegeleverd met Coppermine

Het Coppermine pakket heeft sommige meegeleverde thema's:

• Curve
  
  Een thema met een lichte achtergrond en een horizontaal cascade-menu dat volledig aangestuurd wordt via CSS. Het is het nieuwe standaardthema voor cpg1.5.x en is geïnspireerd door het nieuwe thema van het forum SMF 2.0.

  Dit thema gebruikt momenteel nog wat patches om een correcte weergave te krijgen met Internet Explorer 6 and 7.
  Om de ondersteuning voor IE6 te verwijderen,
  - wis <!-- Begin IE6 support --> ... <!-- Einde IE6 support --> uit template.html
  - wis het bestand csshover3.htc uit de themamap.
  Om de ondersteuning voor IE7 te verwijderen,
  - wis <!-- Begin IE7 support --> ... <!-- Einde IE7 support --> uit template.html
  - verwijder alle lijnen met /* IE7 */ uit style.css,
  - haal het commentaar weg uit de lijn /* min-height: 95px; */ in style.css.

• Eyeball
  
  Een thema met een donkere achtergrond en een horizontaal menu dat uitklapt met functies voor gebruikersinteractie
• Hardwired
  
  Een thema met een donkere achtergrond en kleiner lettertype dat goed werkt in smalle ruimte en kleinere resoluties. Het heeft twee horizontale menu's
• Rainy Day
  
  Een thema met donkere achtergrond en afgeronde hoeken.
• Voorbeeld
  Het voorbeeldthema ziet er exact hetzelfde uit als het "waterdrop" thema. Het wordt niet getoond in de themakiezer - het dient alleen als een template om van te kopiëren wanneer u zelf een thema wilt aanmaken of aanpassen.
• Waterdrop
  
  Een thema met een lichte achtergrond en een "conventioneel" horizontaal menu

De thema's "Classic", "Fruity", "Igames", "Mac OX X" en "Project VII" die meegeleverd waren in cpg1.4.x zijn verwijderd uit het cpg1.5.x pakket. Ze zijn nog beschikbaar als aparte downloads - ga naar de sectie thema's ontworpen door gebruikers voor details.

Upgrading van uw aangepast thema

Om een bestaand aangepast thema te upgraden van cpg1.4.x naar versie 1.5.x, lees de thema upgrade documentatie.

Als u wilt upgraden van cpg1.3.x naar cpg1.5.x, dan zult u de upgrade in twee stappen moeten doen: eerst moet u uw thema upgraden van cpg1.3.x naar cpg1.4.x en daarna van cpg1.4.x naar cpg1.5.x

U moet alleen uw aangepast thema upgraden wanneer u een upgrade uitvoert tussen hoofdversies (bv. van cpg1.3.x naar cpg1.4.x of van cpg1.4.x naar cpg1.5.x), omdat het themaopbouwmechanisme verandert bij een upgrade van een hoofdversie naar een andere. Wanneer u alleen upgrade van een subversie naar een andere subversie (bv. van cpg1.5.x naar cpg1.5.y), dan hoeft het thema niet upgedatet te worden.

The standaard thema's die meegeleverd worden met het Coppermine pakket hoeven niet geüpdatet te worden, zij worden tijdens het upgraden van het pakket uitgevoerd en dat bevat alle nodige wijzigingen. Echter: wanneer u uw aangepast thema gebaseerd heeft op één van de standaardthema's uit het Copperminepakket (bv. het curve thema), let dan op voor mogelijke veranderingen. Zoals hieronder voorgesteld, is het aan te bevelen om uw aangepast thema een andere naam te geven zodat het niet per ongeluk wordt overschreven tijdens het upgraden.

Themainhoud

Coppermine thema's zijn opgeslagen in de "thema" map, ieder thema bestaat uit 3 primaire bestanden:

• "template.html" de hoofdtemplate in zuiver HTML.
• "style.css" de stylesheet geassocieerd met de template
• "theme.php" het PHP themabestand

Daarenboven is er gewoonlijk ook nog een map genaamd "images" die zich in de themamap bevindt (themes/thema_naam/images/) hierin bevinden zich alle afbeeldingen die in uw thema voorkomen (logos, bullets, achtergronden en andere grafische onderdelen).

Hoe werkt het thema-systeem

Wanneer een Coppermine pagina geparset wordt, zal de standaardcode themafuncties aanroepen. Als deze functies bestaan in uw aangepast of zelfontworpen thema, zullen zij gebruikt worden. Indien een bepaalde functie niet bestaat in uw thema, zal de functie uit het standaardthema gebruikt worden. De standaardfunctie (andersgezegd: het standaard themagedrag) bevindt zich in includes/themes.inc.php.

Daarom moogt u includes/themes.inc.php, onder geen beding editeren, anders zullen al uw wijzigingen aan uw eigen thema verloren gaan bij een volgende upgrade. Alles wat mogelijkerwijs zou aangepast kunnen worden door het editeren van include/themes.inc.php, kan ook verwezenlijkt worden door het editeren van themes/uw_thema/theme.php - alles wat in uw aangepast thema gedefinieerd is, heeft voorrang op de functies in het standaardthema.

Wat is de volgende stap?

Er worden stap-voor-stap instructies voorzien in de sectie "Ontwerp uw eigen thema" dat u zeker zou moeten lezen voor de details. Geef ook aandacht aan de gedeelten over "copyright-disclaimer in de voettekst" en de sectie "Dynamische (PHP-gestuurde) inhoud".