So funktioniert es
Der CSV-Export listet jeden Shop-Text für die gewählte Sprache auf, vom Kursplayer bis zur Danke-Seite im Checkout, zur Bestellstatusseite und zu Meine Kurse, mit seinem Standardwortlaut und Ihrem aktuellen Text. Sie füllen die Spalte your text aus und importieren die Datei in dieselbe Sprache. Leere Zellen ändern nichts, und ein Import löscht nie Text.
Die CSV-Spalten
Jeder Export hat dieselben vier Spalten in dieser Reihenfolge:
| Spalte | Inhalt | Beim Import |
|---|---|---|
locale |
Die Sprache: all für Alle Sprachen oder ein Code wie fr, de oder pt-BR. Jede Zeile hat denselben Wert. |
Muss zur im Editor gewählten Sprache passen. |
key |
Die ID des Textes, derselbe graue Code, der im Editor unter jedem Feld steht, etwa homePage.title. |
Muss ein Text sein, den der Editor auflistet. Nicht ändern. |
default text |
Der integrierte Wortlaut für diese Sprache oder Englisch bei Alle Sprachen. | Wird ignoriert. Er dient nur als Referenz. |
your text |
Ihr aktueller Wortlaut oder leer, wenn Sie diesen Text nicht geändert haben. | Leer behält den aktuellen Text. Alles andere ersetzt ihn. |
So übersetzen Sie Shop-Texte mit einer CSV
1. Die Sprache auswählen
Öffnen Sie den Editor für Shop-Texte und wählen Sie im Menü Sprache die Sprache, zum Beispiel Französisch. Export und Import verwenden beide die ausgewählte Sprache.
2. Die CSV exportieren
Klicken Sie auf Exportieren → Als CSV exportieren (Tabelle). Alva Courses lädt eine Datei herunter, die nach dem Sprachcode benannt ist, etwa storefront-text-fr.csv, oder storefront-text-all.csv für Alle Sprachen. Die Datei enthält nur Ihren gespeicherten Text, keine nicht gespeicherten Änderungen.
3. Die Spalte „your text“ ausfüllen
Öffnen Sie die Datei in einer Tabellen-App und tragen Sie jeden neuen Wortlaut in die Spalte your text ein. Lassen Sie die Zellen unter locale und key unverändert, behalten Sie Platzhalter wie {{count}} bei und lassen Sie eine Zelle leer, um den aktuellen Text zu behalten.
4. Als CSV speichern
Speichern Sie die Datei als CSV mit Kommas zwischen den Spalten. Wählen Sie CSV UTF-8, sofern Ihre App es anbietet, damit Umlaute und nichtlateinische Zeichen erhalten bleiben. Fügen Sie keine Spalten hinzu und entfernen oder benennen Sie die Spalten locale, key oder your text nicht um.
5. Importieren und die Vorschau prüfen
Klicken Sie im Editor bei gleicher ausgewählter Sprache auf Importieren und dann auf Datei auswählen. Alva Courses prüft die Datei und zeigt die Sprache, in die importiert wird, wie viele Texte geändert und unverändert sind und jede Änderung vom alten zum neuen Wortlaut.
6. Den Import bestätigen
Klicken Sie auf die Schaltfläche Importieren, die die Anzahl der Texte nennt, etwa 42 Texte importieren. Der Text wird sofort gespeichert, ohne Schritt in der Speicherleiste, und erscheint beim nächsten Laden einer Shop-Seite.
Importregeln
- Eine Sprache pro Datei. Weicht die Sprache der Datei von der ausgewählten ab, nennt Alva Courses beide und importiert nichts. Wählen Sie die Sprache der Datei aus und versuchen Sie es erneut.
- Ganz oder gar nicht. Hat eine Zeile ein Problem, wird nichts importiert, und jedes Problem wird mit seiner Zeilennummer aufgelistet. Die Kopfzeile ist Zeile 1, passend zu Ihrer Tabelle.
- Die Textregeln des Editors gelten. Jeder Text darf bis zu 500 Zeichen lang sein, darf weder
<noch>enthalten und nur die Platzhalter verwenden, die sein Standardtext nutzt. - Dateien bis 1 MB, im Format
.csvoder.json. - Der Import löscht nie. Um Text zu entfernen, nutzen Sie die Zurücksetzen-Schaltflächen im Editor und speichern Sie dann.
Bei Alle Sprachen listet die Vorschau gesondert jeden Text auf, den Sie unter „Anmeldung anpassen“ festgelegt haben und den die Datei ändern würde, weil dieser Text in jeder Sprache erscheint.
Tipps für die Tabelle
Text, der mit =, +, - oder @ beginnt, wird mit einem vorangestellten Apostroph exportiert, damit Tabellen ihn nicht als Formel lesen. Der Import entfernt diesen Apostroph wieder. Zeilen mit leerer Zelle unter your text werden übersprungen, sodass Sie einige Texte auf einmal übersetzen und so oft importieren können, wie Sie möchten.
Als JSON für eine Sicherung exportieren
Exportieren → Als JSON exportieren lädt nur den Text herunter, den Sie für die ausgewählte Sprache angepasst haben. Das ist eine schnelle Sicherung vor einem großen Zurücksetzen, und Importieren akzeptiert sie genauso wie eine CSV.
Häufige Fragen
Kann eine Datei mehrere Sprachen enthalten?
Nein. Jede Datei enthält eine Sprache, und jede Zeile muss dieselbe locale tragen. Exportieren und importieren Sie jede Sprache einzeln und wählen Sie sie vorher im Menü Sprache aus.
Wie entferne ich Text mit einem Import?
Gar nicht. Eine leere Zelle behält den aktuellen Text, und ein Import löscht nie etwas. Um zum Standard zurückzukehren, nutzen Sie im Editor Auf Standard zurücksetzen, Diese Gruppe zurücksetzen oder die Schaltfläche zum Zurücksetzen aller Texte und speichern Sie dann.
Warum wurde nichts importiert?
Importe gelten ganz oder gar nicht. Hat eine Zeile ein Problem, etwa einen unbekannten Schlüssel, eine andere Sprache, einen Text mit mehr als 500 Zeichen oder einen Platzhalter, den der Text nicht verwenden kann, listet Alva Courses jedes Problem mit seiner Zeilennummer auf und importiert nichts. Korrigieren Sie die Datei und importieren Sie sie erneut.
Enthält die CSV auch Texte für Checkout und Kundenkonto?
Ja. Der Export listet die Texte der Danke-Seite im Checkout, der Bestellstatusseite und von Meine Kurse nach den Texten des Kursplayers auf. Ihre Schlüssel beginnen mit ext., zum Beispiel ext.membersArea.page_title für den Seitentitel von Meine Kurse.
Weitere Artikel
War dies hilfreich?
Zuletzt aktualisiert 2026-10-08