Coppermine Photo Gallery: Versionen, Themes, Upload und Sprachdateien der Web-Galerie
Am 23. Oktober 2026 erschien Version 1.6.31 von Coppermine Photo Gallery, eine kleine Wartungsversion. Fünf Tage zuvor hatten die Entwickler im GitHub-Repository des Projekts 1.6.30 veröffentlicht, ein kritisches Sicherheitsupdate, das eine Lücke im Update-Prozess schließt und auf der Projektseite als verpflichtend für alle 1.6.x-Installationen bezeichnet wird. Für ein Projekt, dessen Version 1.5.8 schon im Sommer 2010 als stabil erschien, ein lebendiger Herbst.
Coppermine ist ein in PHP geschriebenes Galerie-Skript für den eigenen Webspace, das Bilder in Kategorien und Alben ordnet und seine Daten in einer MySQL-Datenbank ablegt. Das Projekt steht unter der GNU General Public License; das Repository weist die GPL 3.0 aus. Zu Hause ist es inzwischen unter coppermine-gallery.com. Version 1.6.31 räumt die letzten Verweise auf die frühere .net-Adresse aus dem Code.
Drei Versionslinien: 1.4.x, 1.5.x und 1.6.x
1.4.x war die Linie mit der größten Auswahl an Themes aus der Community – die Entwickler selbst nannten die Vielfalt in ihrer Ankündigung von 1.5.8 „amazing“. Mit dieser Ankündigung vom 6. August 2010 begann der Abschied: Für 1.4.x gab es fortan nur noch Sicherheitskorrekturen.
1.5.x brachte laut derselben Ankündigung das neue Standard-Theme Curve, eine erweiterte Plugin-Schnittstelle, ein eingebautes Captcha und eine neue Upload-Oberfläche.
1.6.x ist die aktuelle Linie. Die Projektseite nennt für sie volle Unterstützung von PHP 7 und 8. Einige ältere Themes sind entfallen; im Paket stecken noch Curve, Eyeball, Hardwired, Rainy Day, Waterdrop und das Sample-Theme. Plugins für 1.4.x oder 1.5.x laufen laut Dokumentation in der Regel nicht mehr und müssen durch Fassungen für 1.6.x ersetzt werden.
Wie ein Theme aufgebaut ist
Jedes Theme bewohnt einen eigenen Unterordner im Verzeichnis themes. Drei Dateien bilden den Kern:
template.html– das HTML-Gerüst der Seitestyle.css– das zugehörige Stylesheettheme.php– PHP-Funktionen des Themes
Hinzu kommt meist ein Ordner images für Logo, Hintergründe und Symbole. Der entscheidende Mechanismus steckt in theme.php: Definiert ein Theme dort eine Funktion, hat sie Vorrang vor der gleichnamigen Kernfunktion. Fehlt sie, greift Coppermine auf den Kern zurück. Ein Theme enthält also nur, was es anders macht.
Ein eigenes Theme braucht einen eigenen Ordnernamen. Wer stattdessen Curve direkt bearbeitet, verliert seine Änderungen beim nächsten Upgrade, weil die mitgelieferten Themes dann überschrieben werden.
Themes zwischen den Versionen umziehen
Die Theme-Engine ändert sich mit jeder Hauptversion. Ein Theme für 1.4.x läuft deshalb nicht unverändert unter 1.5.x, und 1.6.x verlangt erneut Anpassungen. Die Anleitung zur Theme-Umstellung empfiehlt einen radikalen Weg: die eigene theme.php möglichst leeren und nur die Teile, die wirklich abweichen sollen, frisch aus dem Sample-Theme übernehmen. Für template.html nennt sie handwerkliche Korrekturen – Und-Zeichen in URLs als & schreiben, jedem Bild ein alt-Attribut geben, <br> und <hr> schließen. Geprüft wird jeweils als Gast, als angemeldeter Nutzer und im Admin-Modus.
Bilder hochladen: HTTP-Upload und Batch-Add
Der HTTP-Upload ist der Weg für normale Nutzer: Album wählen, Dateien per Browser schicken. Die Dokumentation beschreibt dafür ein einfaches HTML-Formular für einzelne Dateien und eine Flash-Oberfläche für mehrere Dateien auf einmal. Da Adobe den Flash Player seit dem 31. Dezember 2020 nicht mehr unterstützt, bleibt bei Schwierigkeiten das HTML-Formular die verlässliche Variante. Wie groß eine Datei sein darf, entscheidet nicht Coppermine, sondern die PHP-Konfiguration des Servers.
Batch-Add ist dem Administrator vorbehalten. Die Bilder wandern per FTP in einen selbst angelegten Unterordner von albums, danach liest die Batch-Add-Funktion sie in ein Album ein und erzeugt Vorschaubild, Zwischengröße und Datenbankeintrag. Drei Regeln ersparen Ärger:
- Nie per FTP in die Ordner
userpicsodereditladen, die Coppermine intern nutzt. - Ordnernamen ohne Punkte, Leerzeichen und Sonderzeichen wählen; Dateinamen nicht mit
thumb_,normal_oderoriginal_beginnen lassen. - Eingelesene Dateien später nicht per FTP umbenennen oder löschen, sonst zeigt die Datenbank ins Leere.
Sprachdateien
Die Übersetzungen liegen im Ordner lang, kodiert in UTF-8. Welche Sprache ein Besucher sieht, entscheidet Coppermine in dieser Reihenfolge: gespeicherte Auswahl im Cookie, Spracheinstellung des Browsers (sofern die automatische Erkennung aktiv ist), zuletzt die Standardsprache der Konfiguration. Die Sprachliste führt für Deutsch auch eine eigene informelle Variante, „Deutsch (Du)“. Die englische Datei sollte in jedem Fall im Ordner bleiben, denn fehlende Übersetzungen erscheinen ersatzweise auf Englisch.
Vor dem Upgrade einer alten Installation
Zuerst gehört geklärt, was der Server kann. Die Anforderungsseite für 1.6.x verlangt PHP 5.4 oder neuer mit MySQL- beziehungsweise MySQLi-Unterstützung und GD 2.x oder ImageMagick. Volle Unterstützung für PHP 7 und 8 nennt die Projektseite ausdrücklich für 1.6.x.
Dann die Sicherung: include/config.inc.php, die Datei anycontent.php und der komplette Ordner albums. Ein eigenes Upgrade-Paket existiert nicht: Das vollständige aktuelle Paket wird hochgeladen, ohne albums und anycontent.php zu überschreiben, danach ruft der Administrator update.php im Browser auf. Das Skript passt die Datenbank an und darf im Zweifel mehrfach laufen.
Von 1.4.x oder älter geht es nur in zwei Etappen, erst auf 1.5.x, dann auf 1.6.x. Alte Sprachdateien taugen danach nicht mehr als Hauptsprache; im Ordner lang sollten nur die Dateien des neuen Pakets liegen, sonst lässt sich die Galerie nicht administrieren. Übrig bleibt die Arbeit am eigenen Theme.
Häufige Fragen
Welche Coppermine-Version ist aktuell?
Im GitHub-Repository des Projekts ist Version 1.6.31 vom 23. Oktober 2026 als neueste Veröffentlichung markiert. Wenige Tage zuvor erschien 1.6.30, ein kritisches Sicherheitsupdate, das die Entwickler für alle 1.6.x-Installationen als Pflicht einstufen.
Lässt sich Coppermine 1.4 direkt auf 1.6 aktualisieren?
Nein. Laut Upgrade-Anleitung wurde der direkte Weg von 1.4.x und älteren Versionen gestrichen. Die Galerie wird zuerst auf 1.5.x und danach auf 1.6.x gebracht; nach jedem Schritt läuft das Skript update.php.
Funktionieren alte Themes nach einem Upgrade weiter?
Selbst gebaute Themes müssen bei jedem Sprung auf eine neue Hauptversion angepasst werden. Die mitgelieferten Themes ersetzt das Upgrade automatisch, und innerhalb einer Versionslinie, etwa von 1.6.30 auf 1.6.31, sind keine Änderungen am Theme nötig.
Aus welchen Dateien besteht ein Coppermine-Theme?
Ein Theme liegt in einem eigenen Unterordner von themes und besteht aus template.html für das HTML-Gerüst, style.css für das Stylesheet und theme.php für PHP-Funktionen, die Kernfunktionen überschreiben. Ein Ordner images für Grafiken ist optional.
Wie kommen viele Bilder auf einmal in die Galerie?
Per Batch-Add: Die Dateien werden per FTP in einen Unterordner von albums geladen, danach liest der Administrator sie über die Batch-Add-Funktion in ein Album ein. Coppermine erzeugt dabei Vorschaubilder und Datenbankeinträge, die Originale bleiben an ihrem Platz.