Naar hoofdinhoud
— Handleiding

Winkelteksten importeren en exporteren als CSV

Alva Courses kan je winkelteksten exporteren als CSV-spreadsheet met elke tekst en de standaardformulering ervan. Vul een hele taal in met je spreadsheetapp, of geef het bestand aan een vertaler, en importeer het daarna terug. Een voorbeeld toont elke wijziging voordat er iets wordt opgeslagen.

Hoe het werkt

De CSV-export bevat elke winkeltekst voor de geselecteerde taal, van de cursusplayer tot de bedankpagina bij het afrekenen, de orderstatuspagina en Mijn cursussen, met de standaardformulering en je huidige tekst. Jij vult de kolom your text in en importeert het bestand in dezelfde taal. Lege cellen veranderen niets en een import verwijdert nooit tekst.

De CSV-kolommen

Elke export heeft dezelfde vier kolommen, in deze volgorde:

Kolom Wat erin staat Bij importeren
locale De taal: all voor Alle talen, of een code zoals fr, de of pt-BR. Elke rij heeft dezelfde waarde. Moet overeenkomen met de taal die in de editor is geselecteerd.
key De ID van de tekst, dezelfde grijze code die onder elk veld in de editor staat, zoals homePage.title. Moet een tekst zijn die de editor toont. Wijzig hem niet.
default text De ingebouwde formulering voor die taal, of Engels voor Alle talen. Wordt genegeerd. Hij staat er ter referentie.
your text Je huidige formulering, of leeg als je die tekst niet hebt gewijzigd. Leeg behoudt de huidige tekst. Al het andere vervangt hem.

Winkelteksten vertalen met een CSV

1. De taal selecteren

Open de editor voor winkelteksten en kies de taal in het menu Taal, bijvoorbeeld Frans. De export en de import gebruiken allebei de taal die is geselecteerd.

2. De CSV exporteren

Klik op Exporteren → Exporteren als CSV (spreadsheet). Alva Courses downloadt een bestand dat is vernoemd naar de taalcode, zoals storefront-text-fr.csv, of storefront-text-all.csv voor Alle talen. Het bestand bevat alleen je opgeslagen tekst, geen niet-opgeslagen wijzigingen.

3. De kolom your text invullen

Open het bestand in een spreadsheetapp en typ elke nieuwe formulering in de kolom your text. Laat de cellen locale en key zoals ze zijn, behoud variabelen zoals {{count}} en laat een cel leeg om de huidige tekst te behouden.

4. Opslaan als CSV

Sla het bestand op als CSV met komma's tussen de kolommen. Kies CSV UTF-8 als je app dat aanbiedt, zodat tekens met accenten en niet-Latijnse tekens behouden blijven. Voeg geen kolommen toe en verwijder of hernoem de kolommen locale, key of your text niet.

5. Importeren en het voorbeeld controleren

Klik in de editor, met dezelfde taal geselecteerd, op Importeren en daarna op Bestand kiezen. Alva Courses controleert het bestand en toont de taal waarin wordt geïmporteerd, hoeveel teksten zijn gewijzigd en ongewijzigd, en elke wijziging van de oude naar de nieuwe formulering.

6. De import bevestigen

Klik op de knop Importeren die het aantal teksten noemt, zoals 42 teksten importeren. De tekst wordt meteen opgeslagen, zonder stap in de opslagbalk, en verschijnt bij de volgende paginalading in de winkel.

Regels voor importeren

  • Eén taal per bestand. Als de taal van het bestand afwijkt van de geselecteerde taal, noemt Alva Courses beide en importeert het niets. Selecteer de taal van het bestand en probeer het opnieuw.
  • Alles of niets. Als een rij een probleem heeft, wordt er niets geïmporteerd en wordt elk probleem vermeld met het rijnummer. De koprij is rij 1, zoals in je spreadsheet.
  • De tekstregels van de editor gelden. Elke tekst mag maximaal 500 tekens bevatten, mag geen < of > bevatten en mag alleen de variabelen gebruiken die de standaardtekst gebruikt.
  • Bestanden tot 1 MB, in de indeling .csv of .json.
  • Importeren verwijdert nooit. Om tekst te verwijderen gebruik je de resetknoppen in de editor en sla je daarna op.

Bij Alle talen toont het voorbeeld apart de tekst die je onder Inloggen aanpassen hebt ingesteld en die het bestand zou wijzigen, omdat die tekst in elke taal verschijnt.

Tips voor spreadsheets

Tekst die begint met =, +, - of @ wordt geëxporteerd met een apostrof ervoor, zodat spreadsheets hem niet als formule lezen. De import verwijdert die apostrof weer. Rijen met een lege cel your text worden overgeslagen, dus je kunt een paar teksten tegelijk vertalen en zo vaak importeren als je wilt.

Exporteren als JSON voor een back-up

Exporteren → Exporteren als JSON downloadt alleen de tekst die je voor de geselecteerde taal hebt aangepast. Het is een snelle back-up vóór een grote reset en Importeren accepteert het op dezelfde manier als een CSV.

Veelgestelde vragen

Kan één bestand meerdere talen bevatten?

Nee. Elk bestand bevat één taal en elke rij moet dezelfde locale hebben. Exporteer en importeer elke taal apart en selecteer hem eerst in het menu Taal.

Hoe verwijder ik tekst met een import?

Dat kan niet. Een lege cel behoudt de huidige tekst en een import verwijdert nooit iets. Om terug te gaan naar de standaard gebruik je Standaard herstellen, Deze groep resetten of de knop om alles te resetten in de editor, en sla je daarna op.

Waarom is er niets geïmporteerd?

Importeren is alles of niets. Als een rij een probleem heeft, zoals een onbekende key, een andere taal, een tekst van meer dan 500 tekens of een variabele die de tekst niet kan gebruiken, vermeldt Alva Courses elk probleem met het rijnummer en importeert het niets. Herstel het bestand en importeer het opnieuw.

Bevat de CSV ook teksten voor afrekenen en klantaccounts?

Ja. De export toont de teksten van de bedankpagina bij het afrekenen, de orderstatuspagina en Mijn cursussen na de teksten van de cursusplayer. Hun keys beginnen met ext., zoals ext.membersArea.page_title voor de paginatitel van Mijn cursussen.

Zie ook

Was dit nuttig?

Nog steeds vastgelopen? Stuur ons een e-mail.

Laatst bijgewerkt 2026-10-08