Die Oberflächen der twingle Widgets und Spendenformulare können, neben den Standardsprachen Deutsch, Englisch, Französisch und Spanisch, auch manuell in weitere Sprachen übersetzt werden. Dies kann für beliebige Sprachen erfolgen, die von links nach rechts gelesen werden und deren Schriftsatz von den twingle Standardschriften unterstützt wird.
Die nötigen Übersetzungen musst du dabei selbst vornehmen und in den Projekteinstellungen hochladen. Eine syntaktische Prüfung der Daten findet beim Upload statt. Die vier oben genannten Standardsprachen können dabei nicht überschrieben werden.
Hinweise:
- Die Texte der vier Standardsprachen kannst du ohne Übersetzungsdatei direkt im twingleMANAGER anpassen: Logge dich ein, öffne Projekteinstellungen / Inhalte und schalte beim jeweiligen Textfeld über die Sprachumschaltung (DE / EN / FR / ES) auf die gewünschte Sprache um. Eine Übersetzungsdatei für die Standardsprachen kannst du nicht hochladen.
Übersetzungsdatei anlegen
So gehst du vor, um eine neue Sprachdatei anzulegen und eine Übersetzung durchzuführen:
- Öffne im twingleMANAGER die Projekteinstellungen des Projekts, das du übersetzen willst.
- Klicke auf den Reiter Inhalte und im Abschnitt Eigene Sprachen auf Neue Sprache hochladen.
- Dort kannst du dir eine Vorlage zur Übersetzung auf Deutsch oder Englisch herunterladen.
Die Datei ist im CSV-Format, wobei hier das Semikolon als Trennzeichen verwendet wird. Verändere dieses Format NICHT. Trage in der Spalte translation deine Übersetzungen ein. Beachte bei der Übersetzung folgende Hinweise:
- Verändere nicht die Reihenfolge der Spalten oder die Beschriftung der Spalten.
- Verändere keine Werte in der Spalte textkey.
- Du kannst komplette Zeilen löschen, achte aber darauf, dass die Datei am Ende keine leeren Zeilen enthält.
- Leere Inhalte in der Spalte translation führen zu leeren Texten in der Oberfläche. Wenn du einen Text nicht übersetzen willst, lösche die gesamte Zeile.
- Einige Texte enthalten Platzhalter für Werte, die später ersetzt werden. Diese sind erkennbar an doppelten geschweiften Klammern. Beispiel: {{amount}}. Übersetze diese Platzhalter auf keinen Fall und nimm auch an den Klammern keine Veränderung vor. Texte vor und nach den Platzhaltern können natürlich übersetzt werden, Platzhalter können auch bezüglich der Position innerhalb eines Textes verschoben werden.
In einigen Fällen benötigst du keine vollständige Übersetzung der Oberflächen, weil du nicht alle Funktionen von twingle nutzt. Einige Funktionen sind dabei anhand der Spalte textkey gekapselt und können ggf. bei der Übersetzung ignoriert werden:
- Zeilen, deren textkey mit "selfservice." beginnen, müssen nur bei aktiviertem Spender-Selfservice übersetzt werden.
- Zeilen, deren textkey mit "certificate." oder "email.donationreceiptmail." beginnen, müssen nur bei mehrsprachigen Zuwendungsbescheinigungen übersetzt werden.
Übersetzungsdatei hochladen
Nachdem du eine Übersetzungsdatei erzeugt hast, wird diese in den Projekteinstellungen unter Inhalte im Abschnitt Eigene Sprachen hochgeladen. Beachte dabei das Format der Datei:
- Es muss sich um eine Text-Datei im CSV-Format handeln.
- Als Trennzeichen wird ein Semikolon verwendet, Texte können in Anführungszeichen eingegrenzt sein, besonders wenn sie Zeilenumbrüche enthalten.
- Die Datei muss im Zeichensatz UTF-8 gespeichert sein.
- Die Datei muss drei Spalten (textkey, text, translation) enthalten, in genau dieser Reihenfolge.
- Die erste Zeile enthält die Spaltenköpfe mit den oben genannten Bezeichnungen.
- Die Spalte textkey darf in keiner Zeile leer sein.
Beim Upload werden neben der Datei noch zwei weitere Angaben benötigt:
- Das Kürzel der Sprache, die du hier übersetzt. Es handelt sich dabei um den zweistelligen ISO-Code der Sprache. Dieser muss korrekt sein, entsprechend der verlinkten Liste.
- Ein sprechender Name der Sprache. Dieser ist nur für dich im twingleMANAGER sichtbar und kann beliebig lang sein.
Beim Upload können verschiedene Fehler auftreten. Auskunft darüber gibt dir die Fehlermeldung, die ggf. nach dem Upload angezeigt wird. Einige mögliche Fehler sind hier aufgelistet:
- Der Kopf der Datei mit den Spaltennamen entspricht nicht der Vorlage.
- Die Spalte textkey wurde verändert oder ein einzelner Wert verändert.
- Die Platzhalter oder deren Klammern wurden verändert.
Hinweise:
- Eigene Sprachen gelten pro Projekt: Du lädst die Übersetzungsdatei in jedem Projekt, in dem du die Sprache anbieten möchtest, einzeln hoch. Wenn du ein Projekt kopierst, werden die eigenen Sprachen mit übernommen. Eine projektübergreifende Auswahl eigener Sprachen oder ein gemeinsamer Export und Import der Texte aller Projekte gibt es nicht.
- Die Spendenzwecke eines Projekts (Projekteinstellungen / Betrag & Zahlung) lassen sich nicht pro Sprache übersetzen, sie werden in allen Sprachen mit demselben Namen angezeigt. Wenn du Spendenzwecke je Sprache benötigst, lege pro Sprache ein eigenes Projekt an (Projekt kopieren und im Projekt unter Inhalte / Aktivierte Sprachen nur die gewünschte Sprache aktivieren).