Shopware 6
Welkom bij de handleiding van de Clonable integratie voor Shopware 6.
Downloads en ondersteunde Shopware versies.
| Shopware versie | Ondersteund | Download |
|---|---|---|
| Shopware <= 6.3 | ❌ | |
| Shopware 6.4 | ✅ | V4.0.0 |
| Shopware 6.5 | ✅ | V5.0.0 |
| Shopware 6.6 | ✅ | V6.0.0 |
| Shopware 6.7 | Op aanvraag |
Clonable is op dit moment nog bezig om de Shopware extensie in de officiële Shopware store te publiceren. Totdat dit proces voltooid is, is de extensie beschikbaar als ZIP bestand.
Installatie
Na het downloaden van het ZIP bestand, kun je (of je development partner) deze uploaden en installaren in Shopware door in de Shopware admin interface naar Extensions → My extensions te gaan. Klik vervolgens op Upload extensions en kies dan de plug-in die je hebt gedownload.
Setup
Na het installeren van de plug-in kun je deze configureren. Afhankelijk van de Shopware versie is deze knop zichtbaar of zit deze in het submenu van de plug-in.
Sales channels
Voor flexibiliteit raden wij altijd aan om per clone een eigen sales channel aan te maken. Omdat het aanmaken van sales channels kan verschillen per installatie, geven we hier geen stapsgewijze instructies voor, maar uw development partner kan hier ongetwijfeld bij helpen. De belangrijkste instellingen van de sales channel zijn:
- Taal: de taal van de sales channel moet gelijk zijn aan de taal van de clone.
- URL: de url van de sales channel moet ook gelijk zijn aan de URL van de clone (inclusief eventuele subfolder).
Instellingen
De instellingen van de plug-in werken per sales channel.
Talen zijn niet geïsoleerd per sales channel. Wanneer twee sales channels dezelfde taal gebruiken, gebruiken ze allebei dezelfde content. Houd hier rekening mee indien u de plug-in instelt voor een taal die u ook al in een andere sales channel gebruikt.
API sleutel en clone ID
Voordat de plug-in geactiveerd kan worden voor een sales channel moet je de API sleutel en het ID van de clone invullen.
- Selecteer de sales channel waarvoor u de plug-in wilt activeren. Dit is de sales channel die is aangemaakt voor de desbetreffende clone.
- Binnen clonable kun je API sleutels aanmaken bij de instellingen van je profiel. Klik hiervoor op je naam rechtsboven in de Clonable interface en vervolgens op profile.
- De clone ID vind je door binnen Clonable naar de Quick setup guide te gaan voor de clone. Kijk vervolgens in de URL, de Clone ID is daar de tweede reeks van willekeurige letters en getallen:
https://app.clonable.net/sites/[site-ID]/clones/[clone-ID]/settings/setup - Vul binnen Shopware de API sleutel en clone ID in en sla de instellingen op. Klik vervolgens op Retrieve Clone data. Er zou dan een melding moeten verschijnen die aangeeft dat het gelut is.
Overige instellingen
Na het koppelen van de plug-in via de API key, kun je middels de andere instellingen bepalen wat de plug-in doet. Hieronder staat per instelling de functionaliteit uitgelegd.
- Enable translation for current Sales Channel: dit is een soort master-switch. Als deze uit staat wordt alle functionaliteit uitgeschakeld voor de geselecteerde sales channel, ongeacht de andere instellingen.
- Enable automatic product title translations: schakel deze instelling in om automatisch producten te vertalen wanneer deze aangemaakt of bijgewerkt worden in de originele taal. Door de producttitels te vertalen binnen Shopware, verschijnen deze ook correct op bijvoorbeeld facturen en bestelling-emails.
- Divider(s) to split product name between main product name and variant: wanneer je veel producten hebt die de vorm
[product] - [kleur]opgebouwd zijn kun je hier-(of een ander scheidingsteken) toevoegen, zodatproductenkleurafzonderlijk vertaald worden. Dit zorgt voor betere consistentie in de vertalingen. - Translate product URLs (only enable if automatic title translations are disabled): met deze instelling activeer je de URL vertalingen. Dit is meestal niet nodig, omdat shopware meestal automatisch URLs genereert op basis van de producttitel.
- Copy product information: indien de standaardtaal van je website niet overeenkomt met de brontaal van je clone, kun je deze instelling gebruiken om de originele product content (beschrijving, meta title, meta description) gesynchroniseerd te houden. Indien de standaardtaal wel overeenkomt met de brontaal van je clone, is dit niet nodig omdat in dat geval de standaard Shopware inheritence hetzelfde doet.
- Translate category names: hetzelfde als Copy product information, maar dan voor categorie namen.
- Copy category information: hetzelfde als Copy product information, maar dan voor de beschrijving, meta title, meta description, en content blokken van categorieën.
- Copy landingpage contents: hetzelfde als Copy product information, maar dan voor content blokken van landingspagina's.
- Redirect links to correct language variant: deze instelling zorgt ervoor dat links die voor de verkeerde sales channel worden opgevraagd worden geredirect naar de vertaalde variant. Kan gebruikt worden om te zorgen dat gehardcode links geen 404 error geven.
CLI commando's
Om bij de initiële installatie de vertaling in bulk af te trappen, kun je (naast de bulkactie binnen de productcatalogus in Shopware) een aantal CLI commando's gebruiken.
Bulk categorie vertalingen
Om de categorie-vertalingen in bulk uit te voeren kun je onderstaand commando gebruiken om alle categorieën te vertalen. Het commando zal de instellingen de instellingen die op dat moment actief zijn toepassen op alle categorieën binnen die sales channel, ook sales channels die al eerder vertaald of handmatig aangepast zijn. Let op: het commando vraagt niet om bevestiging.
$ ./bin/console clonable:translate:categories {SALES_CHANNEL_ID}
Bulk landingspagina's vertalingen
Om de landingspagina content kopieeracties in bulk uit te voeren kun je onderstaand commando gebruiken. Het commando zal de instellingen de instellingen die op dat moment actief zijn toepassen op alle landingspagina's binnen die sales channel, ook sales channels die al eerder verwerkt of handmatig aangepast zijn. Let op: het commando vraagt niet om bevestiging.
$ ./bin/console clonable:translate:landing_pages {SALES_CHANNEL_ID}