Gebruikersdocumentatie

Zo werkt de Vertaalagent voor jullie Shopware 6-webshop

In deze documentatie leer je hoe je Reqser kunt gebruiken om je shop automatisch in meerdere talen te vertalen. Van automatische inhoudsherkenning en de vertaaleditor tot het woordenboek - je vindt hier alles wat je nodig hebt om aan de slag te gaan.

Waar je aan moet denken na je afstuderen

Wijzig inhoud in vreemde talen niet direct in Shopware - gebruik in plaats daarvan onze vertaaleditor zodat uw wijzigingen niet worden overschreven door de volgende crawl.

Test bestelling in elke vreemde taal - zo zorg je ervoor dat het hele bestel- en afrekenproces correct werkt in alle talen.

Controleer inhoud in vreemde talen en rapporteer fouten - bekijk je shop in de afzonderlijke talen en rapporteer afwijkingen direct aan ons of aan je agentschap.

1. overzicht

Gefeliciteerd - uw winkel is nu volledig geautomatiseerd! Reqser neemt nu de vertaling van de inhoud van je shop in alle geconfigureerde talen over. In deze documentatie kunt u in detail lezen hoe de belangrijkste functies werken en hoe u indien nodig kunt ingrijpen.

Altijd up-to-date

Reqser houdt je anderstalige content altijd up-to-date. Nieuwe producten, gewijzigde teksten en bijgewerkte categorieën worden automatisch herkend en vertaald.

Volledige controle

Je hebt op elk moment toegang tot de vertalingen via de vertaaleditor en het woordenboek - van individuele aanpassingen tot globale woordenboekregels.

Omleiding op basis van taal

Anderstalige bezoekers worden automatisch doorverwezen naar de juiste taalversie van je winkel op basis van de taal van hun browser.

2. automatische inhoudsherkenning

Automatische inhoudsherkenning vormt het hart van Reqser. De agent scant regelmatig uw winkel via de API en herkent alle vertaalbare inhoud - van productnamen en beschrijvingen tot categorieën, CMS-pagina's en informatie over fabrikanten.

Zodra de agent nieuwe of gewijzigde inhoud vindt, wordt deze automatisch gemarkeerd voor vertaling en verwerkt in de volgende stap.

De crawling-interval instellen in de website-instellingen

Kruipinterval

U kunt aangeven hoe vaak de agent in uw shop moet zoeken naar nieuwe inhoud. Onze aanbeveling: Dagelijks. Dit is de enige manier om ervoor te zorgen dat uw vertalingen altijd up-to-date zijn in alle talen - vooral als u regelmatig producten bijwerkt, nieuwe artikelen maakt of teksten wijzigt.

Als de frequentie lager is (wekelijks, maandelijks, enz.), kan het zijn dat nieuwe of gewijzigde inhoud pas met een vertraging in de vreemde talen verschijnt. Voor de meeste winkels is "Dagelijks" daarom de beste keuze.

Dagelijks (aanbevolen) - Zorgt ervoor dat alle taalversies altijd up-to-date zijn
Wekelijks / Maandelijks / Jaarlijks - Mogelijk, maar nieuwe en gewijzigde inhoud verschijnt met een vertraging in de vreemde talen
Nooit - Automatisch crawlen is uitgeschakeld. Nieuwe inhoud wordt niet automatisch herkend

Nu beginnen met crawlen

Je kunt op elk moment een crawl starten buiten het reguliere interval om – bijvoorbeeld als jullie net veel nieuwe producten hebben geïmporteerd en niet willen wachten tot de volgende automatische crawl.

In de verbindingsinstellingen vind je hiervoor de knop „Crawling nu starten”. Als er op dit moment al een crawling actief is, is de knop tijdelijk uitgeschakeld.

Uitsluitingen

Als bepaalde inhoud niet moet worden vertaald, kunt u specifiek uitsluiten dat deze wordt herkend. Dit is bijvoorbeeld handig voor technische tabellen of inhoud die in de oorspronkelijke taal moet blijven.

Je kunt de uitsluitingen gebruiken om afzonderlijke tabellen of items uit te sluiten van herkenning.

3. de vertaaleditor

In de vertaaleditor kunt u alle vertalingen van uw webwinkel in één oogopslag bekijken. Hier kunt u vertalingen zoeken, filteren, handmatig bewerken en bevestigen.

U krijgt toegang tot de editor via uw website-instellingen - er is een aparte editor-toegang voor elke vreemde taal.

Zoeken en filteren

Gebruik de zoekfunctie om bepaalde vertalingen snel te vinden. Je kunt filteren op tabel, veld, herkomst en vertaalstatus – bijvoorbeeld alleen bevestigde vermeldingen of teksten waarvoor nog geen vertaling beschikbaar is. Met ‘Laatst bijgewerkt’ sorteer je op de vertalingen die het laatst zijn gewijzigd.

Overschakelen naar HTML-weergave

Sommige vertalingen bevatten HTML-opmaak (bijvoorbeeld vetgedrukte tekst of links). Je kunt schakelen tussen de gewone tekstweergave en de gerenderde HTML-weergave om de inhoud te zien zoals die in de winkel verschijnt.

Vertalingen bewerken

Klik op „Bewerken” om een vertaling in het bewerkingsvenster te openen. Je kunt ook direct in het overzicht op „Opnieuw vertalen” klikken om een automatische hervertaling te starten.

In het bewerkingsvenster heb je twee mogelijkheden:

• Smart Edit – Selecteer afzonderlijke termen uit de brontekst en bepaal hoe ze vertaald moeten worden. De regels worden automatisch in het woordenboek opgenomen. Je kunt kiezen of alleen dit item of alle items met deze termen opnieuw vertaald moeten worden.
• Handmatige bewerking – Pas de vertaalde tekst rechtstreeks in het tekstveld aan. De wijziging geldt alleen voor dit ene item.

Na het opslaan wordt de wijziging automatisch in je webshop doorgevoerd.

Vertalingen bevestigen

Als je bijvoorbeeld een proeflezer gebruikt, kun je gecontroleerde vertalingen markeren als "bevestigd". Zo kun je bijhouden welke vertalingen al gecontroleerd zijn. Belangrijk: Als de brontekst in de basistaal verandert, wordt de vertaling toch automatisch opnieuw gemaakt.

Automatische hertaling bij wijzigingen

Als een tekst in de basistaal verandert, herkent de agent dit automatisch en worden alle bijbehorende vermeldingen in vreemde talen opnieuw vertaald. Je hoeft je er dus zelf geen zorgen over te maken - gewijzigde inhoud wordt automatisch bijgewerkt in alle talen na de volgende controlecyclus.

Oorsprong begrijpen

Bij elke vertaling wordt aangegeven waar deze vandaan komt. De belangrijkste bronnen zijn: „Overgenomen uit jullie winkel” (reeds aanwezig in de winkel), „Handmatig bewerkt” (aangepast in de editor), „Vertaald door Reqser” (automatisch vertaald) en „Woordenboektoepassing” (aangepast door een woordenboekregel). Via het info-pictogram naast de herkomst vind je een korte uitleg van alle waarden.

Bestaande teksten in vreemde talen overnemen

Als jullie al hoogwaardige vertalingen in jullie webshop hebben, kunnen jullie in de instellingen de optie „Bestaande teksten in vreemde talen overnemen” activeren. Reqser neemt dan jullie bestaande teksten in vreemde talen over, in plaats van ze opnieuw te vertalen – dat bespaart tekenkosten.

Het is belangrijk om te begrijpen wanneer deze optie van toepassing is:

• Alleen bij de eerste invoer: Een bestaande webshoptekst wordt alleen overgenomen als er in Reqser voor dit item nog geen vertaling in een vreemde taal bestaat. De optie is dus vooral bedoeld voor het aanvankelijk vullen van de winkel.
• Bij wijziging van de basistekst: Als de tekst in de basistaal later verandert, wordt de vreemde taal bewust opnieuw vertaald – ongeacht of deze optie actief is. Zo blijven jullie vertalingen inhoudelijk correct en wijken ze niet af van de basistaal.
• Je herkent deze overname in de editor aan de herkomst „Overgenomen uit jullie webshop".

Waarom je teksten in een vreemde taal niet rechtstreeks in Shopware moet bewerken

Reqser is de belangrijkste bron voor alle geregistreerde inhoud. Als je een tekst in een vreemde taal rechtstreeks in Shopware bewerkt, kan deze wijziging bij de volgende crawl weer worden overschreven – vooral als de basistekst verandert of er een nieuwe vertaling wordt gestart.

Breng aanpassingen daarom altijd aan in de vertaaleditor (handmatige bewerking of Smart Edit). Van daaruit worden ze correct overgenomen in je webshop en blijven ze behouden.

4. het woordenboek (glossarium)

Het woordenboek is een van de krachtigste tools in Reqser. Hier definieert u regels voor hoe bepaalde termen moeten worden vertaald - of dat ze helemaal niet moeten worden vertaald.

Woordenboekregels zorgen ervoor dat uw merk, productnamen en technische termen consistent en correct worden weergegeven in alle talen.

Overzicht van woordenboekregels met taal- en zoekfilters

Altijd vertalen als...

Specificeert dat een bepaalde term altijd op een bepaalde manier moet worden vertaald. Dit is ideaal voor merknamen, technische termen of industriespecifieke uitdrukkingen.

Voorbeeld: "Weidezaun" moet altijd in het Engels vertaald worden als "elektrisch hek".

Nooit vertalen

Geeft aan dat een term in de originele taal moet blijven en niet vertaald wordt. Nuttig voor eigennamen, handelsmerken of technische termen.

Voorbeeld: "Patura" is een merknaam en mag in geen enkele taal worden vertaald.

Regels toevoegen

Bij het maken van een nieuwe regel voert u de volgende informatie in:

- Bronwoord - De term in uw basistaal
- Doelwoord - De gewenste vertaling (alleen voor "Altijd vertalen als...")
- Talen - De vreemde talen waarvoor de regel moet gelden

Bij het opslaan kunt u ook aangeven of bestaande vertalingen direct met de nieuwe regel opnieuw moeten worden vertaald.

Formulier voor het toevoegen van een nieuwe woordenboekregel

Nieuwe vertaling voor regelwijzigingen

Als u een woordenboekregel wijzigt of verwijdert, hebt u de optie om alle getroffen vertalingen automatisch opnieuw te laten vertalen. Reqser toont u een schatting van de getroffen ingangen en de bijbehorende tekenkosten.

Dit zorgt ervoor dat uw vertalingen altijd voldoen aan de huidige woordenboekregels.

5. linkafhandeling

Linkafhandeling zorgt ervoor dat interne links in uw vertalingen correct verwijzen naar de desbetreffende taalversie van uw webwinkel. Zonder deze functie zou vertaalde inhoud naar de Duitstalige URL's verwijzen, waardoor uw bezoekers onverwacht van taal zouden veranderen wanneer ze klikken.

De linkafhandeling werkt volledig automatisch op de achtergrond en vereist geen handmatige configuratie.

Reqser herkent interne links in de inhoud van jullie webshop (bijvoorbeeld in productbeschrijvingen of in de frontend)
Voor elke vreemde taal worden de links automatisch herschreven naar de overeenkomstige taalspecifieke URL
De domeinen en paden worden correct toegewezen voor elke taal (bijv. /nl/category/ wordt /nl/category/)
Linkafhandeling wordt automatisch uitgevoerd na elke vertaling

Link regels

Als de automatische linkverwerking een link niet correct kan vertalen of als je een vaste toewijzing wilt, kun je linkregels aanmaken. Een regel bepaalt: „Als deze originele link in een bepaalde vreemde taal voorkomt, vervang deze dan altijd door deze vertaalde link.“

Linkregels vind je in de instellingen onder Linkverwerking. Daar zie je alle verwerkte links en kun je ze in het overzicht bewerken. Via Regel toevoegen kun je ook een regel aanmaken voor een link die nog niet in het overzicht staat.

Regels worden per taal gedefinieerd - dezelfde link kan anders worden vertaald in verschillende talen
De regels gelden in de betreffende taal overal waar de link voorkomt – in productbeschrijvingen, frontend-pagina’s of URL-velden
Zonder verdere opties geldt een regel alleen voor de exacte originele link, inclusief anker (#page=14) en parameters (?ts=…)
Met Voor alle varianten van dit pad geldt de regel voor elk voorkomen van hetzelfde pad. Ankers zoals #page=14 blijven bij het betreffende voorkomen staan, cacheparameters zoals ?ts=… worden verwijderd
Wanneer je een regel opslaat of wijzigt, worden de betreffende vertalingen in Reqser op de achtergrond bijgewerkt; je webshop ontvangt de gewijzigde teksten doorgaans bij de volgende crawl
Bij het verwijderen van een regel wordt alleen de regel verwijderd – bestaande vertaalteksten worden hierdoor niet automatisch gereset
Regels hebben voorrang op de automatische link-resolutie – als er een regel bestaat, wordt deze toegepast

Formulier voor het toevoegen van een nieuwe linkregel

Bestaande beeldvertalingen gebruiken

Als jullie jullie afbeeldingen al zelf in meerdere talen in de webshop beheren, herkent Reqser deze taalversies, koppelt ze aan de vermeldingen in de vreemde talen en maakt ze niet opnieuw aan. Bij elke doorloop wordt automatisch gecontroleerd op nieuwe en gewijzigde inhoud. Hiervoor moeten de afbeeldingen een vast naamgevingsschema volgen:

Basistaal: bestandsnaam zonder taalextensie of optioneel met basistaal-extensie, bijvoorbeeld SD-Feb-2026_Kuechen_1440x480 of SD-Feb-2026_Kuechen_1440x480_DE
Vreemde taal: dezelfde basisnaam plus _{taalcode}, bijvoorbeeld SD-Feb-2026_Kuechen_1440x480_FR voor het Frans
Als de basis-taalcode een taalsuffix bevat (bijv. _DE), wordt dit automatisch herkend en vervangen door het suffix van de vreemde taal
De map waarin de afbeeldingen in andere talen in Shopware staan, doet er niet toe – de toewijzing gebeurt op basis van de bestandsnaam
Het bestandstype doet er evenmin toe – de bron- en doelafbeelding kunnen verschillende bestandsformaten hebben

6. op taal gebaseerde omleidingen

Reqser stelt standaard op taal gebaseerde omleidingen in voor jullie webshop. Bezoekers van wie de browsertaal overeenkomt met een van jullie vreemde talen, komen terecht op het juiste taaldomein – zonder dat ze handmatig van taal hoeven te wisselen. Dit verbetert de gebruikerservaring en kan de conversie in jullie vreemde talen aanzienlijk verhogen.

De herkenning is gebaseerd op de browsertaal (Accept-Language), niet op de locatie van de bezoeker. Reqser stuurt dus niet door op basis van Geo-IP – een Duitstalige bezoeker in de VS krijgt precies dezelfde Duitse versie te zien als iemand in Zwitserland.

Op de startpagina van jullie domein in de basistaal controleert de Reqser-plugin de browsertaal van de bezoeker
Als de taal overeenkomt met een actieve vreemde taal, leidt Reqser je door naar het bijbehorende taaldomein van je verkoopkanaal
Als de taal niet overeenkomt met een vreemde taal, blijft de bezoeker in de basistaal
Als iemand rechtstreeks een subpagina opent (bijvoorbeeld een product-URL vanuit Google), vindt er geen automatische doorverwijzing plaats – de link leidt rechtstreeks naar de geopende pagina
Welke bezoekers later opnieuw worden omgeleid, hangt af van de gekozen omleidingsmodus (zie hieronder)

Voorwaarden

Om ervoor te zorgen dat de doorsturing tijdens de live-omgeving werkt, moet aan de volgende punten worden voldaan:

De Reqser-plugin is in Shopware geïnstalleerd en actief (minimaal versie 1.1.0)
De automatische omleiding is in Reqser ingeschakeld onder Redirect (standaard: aan)
Uw abonnement is actief – in de demomodus is de doorverwijzing uitgeschakeld
Voor elke vreemde taal is er een bijbehorend domein voor het verkoopkanaal, dat door Reqser wordt beheerd

Doorstuurmodi

Onder Redirect in de website-instellingen kun je instellen hoe vaak en hoe strikt Reqser bezoekers naar de juiste taal doorverwijst. De standaardmodus is vaak (aanbevolen). Geavanceerde opties (tolerantietijden, limieten, alternatieve taal) zijn beschikbaar vanaf plug-inversie ≥ 1.5.3.

vaak (aanbevolen)

Leidt op de startpagina door als de taal van de browser niet overeenkomt met het huidige domein. Na een handmatige taalwijziging in de webshop wordt de keuze van de bezoeker gerespecteerd – gedurende een uur vindt er geen automatische doorverwijzing meer plaats. Daarna kan op de startpagina weer naar de juiste taal worden doorgestuurd. Aanbevolen voor de meeste webshops.

soms

Doorverwijzing met sessielimieten: het aantal en de frequentie van de doorverwijzingen per bezoekerssessie zijn beperkt. Na een handmatige taalwisseling blijft de gekozen taal langer (tot 24 uur) behouden. Dit is handig als jullie minder agressieve doorverwijzingen willen.

zelden

Maximaal één doorverwijzing per sessie. Voor webwinkels die bezoekers zoveel mogelijk controle willen geven over de taalkeuze.

altijd (waarschuwing)

Leidt zeer strikt om – een handmatige taalwijziging kan onmiddellijk weer worden overschreven. Afhankelijk van de configuratie van de webshop kan dit tot eindeloze lussen leiden. Alleen aanbevolen voor testdoeleinden, niet voor live gebruik.

Handmatige taalwisseling

Als een bezoeker in de webshop zelf de taal wijzigt (Language Switcher), onthoudt Reqser deze keuze – afhankelijk van de modus voor een beperkte tijd of voor de gehele sessie. In de modus vaak geldt de handmatige keuze doorgaans een uur; daarna kan op de startpagina weer worden doorgestuurd op basis van de browsertaal.

In de modus vaak kan Reqser bezoekers ook permanent naar de laatst gekozen taal leiden, zolang de sessie actief is – ongeacht de browsertaal.

SEO en dieplinks

Omleidingen werken alleen op de startpagina. Zoekmachines en gedeelde links moeten daarom altijd rechtstreeks naar de juiste taal-URL verwijzen – niet via de startpagina van de basistaal met een daaropvolgende omleiding.

Geen Geo-IP-omleiding: De taal wordt bepaald door de taal van de browser, niet door het land van de bezoeker
Deep links blijven stabiel: Wie een product- of categorie-URL uit de zoekresultaten opent, komt precies op die URL terecht zonder eerst via de startpagina te gaan
Hreflang blijft belangrijk: Omleidingen zijn geen vervanging voor correcte hreflang-tags en taalversies – beide vullen elkaar aan

Instellingen aanpassen

Je vindt alle opties onder Website-instellingen → Redirect in Reqser. Daar kun je de omleiding in- en uitschakelen, de modus kiezen en – vanaf pluginversie ≥ 1.5.3 – geavanceerde parameters nauwkeurig afstemmen. Onder de instellingen zie je de omleidingstest met resultaten per taal.

De doorverwijzing is standaard ingeschakeld. Als je deze uitschakelt, blijven bezoekers op het domein dat ze bezoeken – zonder automatische taalkenning.

8 Veelgestelde vragen

Antwoorden op de meest gestelde vragen over Reqser, de verbinding, vertalingen en beeldbeschrijvingen zijn te vinden op onze FAQ pagina.

Naar de FAQ-pagina

Heb je nog vragen of ondersteuning nodig? Neem te allen tijde contact op met ons of je agentschap - we helpen je graag verder.