Coppermine Photo Gallery v1.5.x: Documentation and Manual

Table of Contents
Partial translation

Sprachen

Coppermine besitzt eine extra Sprach-Datei, die die Übersetzung des Programms wesentlich vereinfacht. Die Sprach-Dateien sind im Ordner lang zu finden. Die Dateien sind in Unicode codiert (utf-8). Diese Codierung wird automatisch mit Hilfe des iconv – Programms generiert, so dass es für Dich nicht notwendig ist eine Unicode-Version Deiner Übersetzung anzufertigen.

Wenn Du utf-8 als Standard-Codierung in Deiner Coppermine-Konfiguration auswählst, ist das Programm automatisch in der Lage, eine Sprachdatei auf Grundlage der Browser-Einstellung des Besuchers zu wählen.

Wenn Du Coppermine in eine Sprache übersetzt hast die noch nicht unterstützt wird, lies bitte die Richtlinie für Übersetzer und besuche die Coppermine Website. Folge den Anweisungen dort zum Einreichen Deiner Sprache.

Wie Coppermine mit Sprachen arbeitet

Hier findest Du die Reihenfolge nach der Coppermine die Sprache für einen Benutzer auswählt: Wenn Coppermine aufgerufen wird, prüft Coppermine ob ein Benutzer eine Sprache explizit als bevorzugte Sprache angegeben hat (das wird in einem Cookie in der Benutzeranwendung gespeichert). Wenn der Benutzer eine Sprache ausgewählt hat, dann wird Coppermine in dieser Sprache dargestellt.

Wenn vom Benutzer keine bevorzugte Sprache festgelegt wurde, stellt Coppermine die Sprache des Benutzers fest, die in seinem Browser eingestellt ist. Falls der Browser beispielsweise auf Englisch eingestellt ist, wird Coppermine dann in Englisch dargestellt.

Wenn die eingestellte Sprache des Browser zum Beispiel Hindi ist, und es gibt keine Coppermine-Sprachdatei die für diese Sprache zur Verfügung steht, wird Coppermine auf die Standard-Sprache zurückgreifen (Ausweichlösung) die Du in der Coppermine-Konfiguration voreingestellt hast.

Wie Du siehst wird die Feststellung der anzuzeigenden Sprache in drei Schritten abgearbeitet:

Dieser Dreischritt-Prozess ist sehr hilfreich: Du stellst eine Standardsprache in der Coppermine-Konfiguration ein (normalerweise ist das die Sprache, die der Großteil Deiner Besucher spricht) und das war’s: Wenn ein Besucher der eine andere Sprache spricht Deine Seite besucht, werden die Coppermine-Kontrollen (Menü, Buttons usw.) in seiner Sprache dargestellt. Normalerweise brauchst Du keine Sprachenauswahl auf Deiner Seite anbieten (es ist aber möglich, das in dem Coppermine-Theme zu aktivieren wenn Du das möchtest). Die Sprachauswahl fügt eigentlich nur einen Parameter an die URL hinzu der dann wiederum dazu führt dass ein Cookie beim Benutzer gesetzt (oder verändert) wird. Du (als Coppermine-Administrator) kannst das Selbe erreichen indem Du von Hand den Parameter an die URL in der Adresszeile Deines Browsers hinzufügst. Beobachte einfach wie sich die URL ändert, wenn Du die Sprachauswahl in Deinem Coppermine-Theme aktiviert hast, um zu sehen wie das funktioniert.

Beispiel:

Wenn Dein Browser auf "Deutsch" eingestellt ist und Du hast "Spanisch" als Standardsprache (Ausweichlösung) eingestellt hast, wird Deine Galerie für Dich auf Deutsch gezeigt. Füge den Parameter lang=english an die URL zu Deiner Galerie in Deiner Browser-Adresszeile hinzu. Die URL sieht dann etwa so aus: http://deineseite.endung/dein_coppermine_ordner/?lang=english. Wenn Du das getan hast, hast Du eine bevorzugte Sprache definiert, die in einem Cookie gespeichert ist und die Spracherkennung Deines Browsers übergeht. Um wieder zurück zur Ausgangssituation zu kommen, stelle das Cookie, in dem Deine bevorzugte Sprache gespeichert wurde, wieder zurück indem Du http://deineseite.endung/dein_coppermine_ordner/?lang=xxx, in die Adresszeile Deines Browsers eingibst. "xxx" ist einfach ein Sprachenkürzel das es nicht gibt (Du kannst einfach wörtlich xxx eingeben).

Eine bestimmte Sprache entfernen

Es gibt viele Sprachen mit denen Coppermine ausgerüstet ist, und die Anzahl der Sprachen steigt, weil neue Sprachdateien von der Coppermine-Gemeinschaft beigetragen werden. Daher kommt Coppermine bereits mit einer großen Anzahl von Sprachdateien die Du verwenden kannst. Viele Benutzer sind sich dessen nicht bewusst, da ihre Besucher nur aus einer bestimmten Region oder einem bestimmten Land kommen. Im Endeffekt brauchst Du diese vielen Sprachen dann nicht. Falls dies bei Dir der Fall ist, kannst Du mit einem FTP-Programm die nicht-gebrauchten Sprachen aus dem ‚lang‘-Ordner löschen (http://deineseite.endung/dein_coppermine_ordner/lang/). Wir empfehlen jedoch die englische Sprachdatei unbedingt zu behalten.

Sprachen-Ausweichlösung

Beginnend mit CPG 1.3.x gibt es eine Konfigurationseinstellung die "Fallback to English if translated phrase not found?" (Auf Englisch zurückgreifen, wenn Deutsche Übersetzung nicht verfügbar?) heißt. Sie ist nützlich wenn eine Sprachdatei für die aktuelle Coppermine-Version nicht verfügbar ist: Du kannst dann eine Sprachdatei aus einer älteren Coppermine-Version verwenden. Neue Zeichenfolgen (die in der neuen Coppermine-Version eingeführt wurden), die es in der alten Sprachdatei nicht gibt, werden dann auf Englisch dargestellt. Auf diese Weise kann der Benutzer Deine Galerie zumindest größtenteils in der von ihm bevorzugten Sprache sehen.

Die Sprachen-Ausweichlösung verbraucht zusätzliche Ressourcen auf dem Server und kann Coppermine spürbar verlangsamen. Verwende die Ausweichlösung also nur wenn Du wirklich Sprachdateien aus älteren Coppermine-Versionen (etwa von cpg 1.4.x) verwendest.

Bitte beachte, dass Du (als Coppermine-Administrator) die Sprachen-Ausweichlösung nicht für administrative Zwecke verwenden kannst. Einstellungen nur für Administratoren werden von dieser besonderen Funktion nicht übersetzt. Du musst daher eine vollständige cpg 1.5.x-Sprachdatei verwenden um Dein Coppermine zu administrieren. Wechsle für administrative Zwecke daher dann zeitweilig auf Englisch; wenn Du mit Deinen Admin-Einstellungen fertig bist, kannst Du wieder zurück auf Deine bevorzugte Sprache wechseln.

Umfang der Internationalisierung

Die Sprachdateien mit denen Coppermine ausgerüstet ist, haben nur vordefinierte Zeichenfolgen aus denen die Kontrollen für Deine Galerie zusammengestellt werden (Menüs, Buttons). Wenn Du Deine Galerie auf eine andere Sprache umstellst, wird das keinen Einfluss haben auf den individuellen Inhalt der sich in Deiner Datenbank befindet (etwa die Kategorie-Namen, die Du eingegeben hast oder die Bildbeschreibungen). Unter diesem Aspekt betrachtet ist Coppermine nicht wirklich mehrsprachig: Im Moment gibt es keine Möglichkeit den Inhalt von Coppermine in mehr als einer Sprache verfügbar zu halten.

The language manager

Starting with cpg1.5.x coppermine comes with a language manager that you can use to fine-tune your language preferences. What the language manager basically does is adding an interface to all the language files that reside in the lang folder. To access the language manager, go to coppermine's config screen, expand the section "Language & Charset settings" and click on the link named "Manage languages". Alternatively, you can manually enter the URL http://yoursite.tld/your_coppermine_folder/langmgr.php in to your browser's address bar.

Controls

Use the buttons "Show details" / "Hide details" at the top and the bottom of the page to toggle the display of the language manager between a condensed view (where only the important data is being displayed) and an advanced view (where additional information can be found).
Use the OK button at the bottom of the screen to save changes.

Columns

The language manager will display a table with several columns. Those columns have the following meaning: