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

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:

- Benutzer-Voreinstellung (Cookie)
- Browser-Einstellung
- Coppermine-Konfigurationseinstellung

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:

- #### Default

  Specify the default language for your gallery; this record is identical to the one you can pick on the config panel using the option "Default Language".
  You can only pick languages that are enabled in the first place. Those that are not enabled will be greyed out.
  The default language will be the one that is used if the visitor's prefered language could not be detected or if the visitor's prefered language doesn't exist as coppermine language file.

- #### Language name

  The column "Language name" consists of three sub-columns. Each of those columns contains a text field where you can change the default.

  - ##### English

    The language name in English. It's recommended not to change this record.

  - ##### Native

    The language name in the native language, i.e. the word "Français" that means "French" in French

  - ##### Custom

    If your language or the language of the majority of you visitors will be another language than English and you have a language selector in place, you can specify the language names in your language.
    Example
    This is a possible example if your gallery catters for a German audience, with the language names in German entered into the custom field:

    English | Native | Custom
    Bulgarian | Български | Bulgarisch
    Czech | Česky | Tschechisch
    English (US) | English (US) | Englisch
    Finnish | Suomea | Finnisch
    French | Français | Französisch
    German (informal) | Deutsch (Du) | Deutsch
    Greek | Ελληνικά | Griechisch
    Polish | Polski | Polnisch
    Russian | Русский | Russisch

    If text is entered into the "Custom"-column, it will take precedence over the pre-populated columns.

- #### Flag

  The flag column contains a dropdown field where you can specify another flag that you want to use to represent your language. The flag icon you pick will be only applicable if you enable a language selector in your custom theme (which is not not recommended and off by default). Usually, the flag can be left alone if there is a clear correlation between your country and your language.
  Take German as an example: the flag of Germany represents German by default, but of course German is spoken in other countries as well, e.g. in Austria and Switzerland. So, if you're from Austria and have a language selector on your page you might want to change the flag representing German from Germany to Austria as well.

- #### Language file

  There are two sub-columns inside the language file column:

  - ##### Available

    As most other coppermine settings, the language preferences are being stored inside the database as well.
    - If there is only a database record for a particular language, but the corresponding language file isn't there, there will be a stop-icon in this column.
    - If there is both a database record as well as a language file, the OK-icon will be displayed
    - If there is a language file, but so far there has been no database record for that file, a plus-icon will be displayed. Submit the form to create a record in the database as well.
    You can only enable a language if the corresponding language file exists.

  - ##### Complete

    The column "Complete" is a result of a detailed check of each file:
    - If the language file has been designed for your version of coppermine, an OK-icon will be displayed in this column.
    - Otherwise, if your language file has been designed for a pervious version of coppermine, a cancel icon will be displayed instead. This doesn't necessarily mean that you can't use a particular file - missing translations (if any) will shine through in English instead.

- #### Enabled

  This is the most important column of the entire screen: here you determine if a particular language will be taken into account, i.e. if the language can be used by visitors. This is independant of the existence of a language selector: if a particular language isn't enabled, it's as if the language file didn't exist in the first place.