De nieuwe plug-in is compatibel met de volgende versies van jouw shop software:
- vanaf versie 6.4.14
Daarnaast moet je systeem aan de volgende eisen voldoen:
- Gedetailleerde informatie over Shopware's app-systeem vind je hier: Apps
- Je systeem moet een van de talen gebruiken die door de plugin worden ondersteund. Momenteel worden de talen met de volgende ISO-codes ondersteund: de_DE, en_EN, es_ES, fr_FR, it_IT, nl_NL, pl_PL, pt_PT.
- De APP_URL uit het .env-bestand moet bereikbaar zijn voor externe diensten.
- De APP_URL moet het domein van het eerste verkoopkanaal opgeven.
- De waarde van core.app.shopId in het system_config-tabel moet overeenkomen met de bijbehorende APP_URL.
Meer informatie over de APP_URL vind je hier: Notes to the APP_URL
Is jouw versie niet compatibel? In dat geval kan je voorlopig jouw huidige plug-in blijven gebruiken. Houd er echter rekening mee dat we de technische ondersteuning voor de tot nu toe gebruikte plugin op 30 maart 2023 hebben stopgezet. Na deze datum kunnen er technische problemen optreden.
We raden je daarom aan om je shop software zo snel mogelijk te updaten en daarna over te stappen op de nieuwe plug-in.
Voor Shopware 6 is vanaf november 2022 een nieuwe plug-in beschikbaar. Er zijn twee manieren om deze te installeren:
Methode 1: Je gebruikt al een Trusted Shops plug-in voor Shopware 6.
- Deïnstalleer eerst aan de hand van het hoofdstuk 'Deïnstalleren' de plug-in die je tot nu toe hebt gebruikt.
- Installeer vervolgens de huidige plug-in aan de hand van het hoofdstuk 'Installeren'.
Methode 2: Je hebt tot nu toe geen Trusted Shops plug-in voor Shopware 6 gebruikt.
- Sla het hoofdstuk 'Deïnstalleren'
- Installeer de huidige plug-in aan de hand van het hoofdstuk 'Installeren'.
Deïnstalleren
- Meld je aan bij de Shopware 6 backend.
- Klik in de hoofdnavigatie op 'Extensies' (
). Klik vervolgens op 'Mijn extensies' (
).
- Het overzicht 'Mijn extensies' verschijnt. Klik op de drie kleine puntjes (
) rechts naast 'Trusted Shops Integration' en klik vervolgens op 'Verwijderen' (
).
- Er verschijnt een pop-upvenster. Activeer de schakelaar naast 'Alle app-gegevens permanent verwijderen' (
) en klik vervolgens op 'Verwijderen' (
).
- Het overzicht 'Mijn extensies' verschijnt. Klik op de drie kleine puntjes (
) rechts naast 'Trusted Shops Integration' en vervolgens op 'Verwijderen' (
).
De plug-in die je tot nu toe hebt gebruikt is verwijderd. Installeer vervolgens de huidige plug-in aan de hand van het hoofdstuk 'Installeren'.
Installeren
De gratis Trusted Shops Extension for Shopware is hier beschikbaar. Hier vind je een gedetailleerde beschrijving voor het toevoegen van extensies met Shopware.
Daarna moet je de Trusted Shops plug-in installeren in je systeem. Selecteer hiervoor eerst het menu-item 'Extensies' () in de hoofdnavigatie en klik op het menu-item 'Mijn extensies' (
) in het vervolgkeuzemenu dat nu verschijnt.
Hier zie je een overzicht van je extensies. Klik in dit overzicht op de knop 'App installeren' naast de toegevoegde plug-in om de plug-in volledig te installeren.
Activeer vervolgens de plug-in door de knop over te schakelen van 'deactivated' naar 'activated'. Na een succesvolle installatie en activering van de plug-in kun je nu beginnen met de configuratie. Klik hiervoor op '...' naast de plug-in in het overzicht 'Mijn extensies' en selecteer 'Open extensie'.
Log-in
Om in te loggen op de plug-in heb je individuele toegangsgegevens nodig: de API Client Credentials. De API Client Credentials zijn niet identiek aan je inloggegevens voor het eTrusted Controlecentrum. Hieronder lees je hoe je deze API Client Credentials aanmaakt en ermee inlogt op de plug-in.
- Open de plug-in zodat het inlogscherm verschijnt.
- Klik op 'Aanvragen'.
- De eTrusted-inlogpagina verschijnt in een nieuw tabblad van je browser. Voer je gebruikersnaam (
) en wachtwoord (
) in en klik op 'Inloggen' (
).
- Het overzicht 'API Client Management' opent in een nieuw venster. Klik op het bovenste blauwe documentpictogram om je Client ID naar het klembord te kopiëren.
- Ga in de browser naar het tabblad met de inlogpagina van de plug-in. Hier kun je de tussentijds opgeslagen Client ID met een rechtermuisklik en 'Invoegen' aan het veld 'Client ID' toevoegen.
- Ga naar het pop-upvenster met het overzicht 'API Client Management'. Klik op het onderste blauwe documentpictogram om je Client Secret naar het klembord te kopiëren.
- Ga terug naar het tabblad met de inlogpagina van de plug-in, in de browser. Voeg de Client Secret van je klembord met de rechtermuisknop en 'Invoegen' aan het veld 'Client Secret' (
) toe. Klik op 'Koppelen' (
).
- Er verschijnt een pop-upvenster. Gebruik het dropdown-menu (
) om de verschillende domeinen die je bij Trusted Shops hebt geregistreerd aan het desbetreffende eTrusted-kanaal te koppelen. Klik vervolgens op 'Opslaan' (
).
Nu heb je je met succes aangemeld en de kanalen gekoppeld.
Configuratie
Hieronder laten we je zien hoe je de Trustbadge®-technologie kunt inzetten en deze vervolgens naar jouw individuele wensen kunt aanpassen:
- De Trustbadge weergeven, kopersbescherming integreren en beoordelingen verzamelen
- Verzamelde shop- en productbeoordelingen in je webshop tonen
- Beoordelingsverzoeken geoptimaliseerd verzenden
- Verdere mogelijkheden
De Trustbadge weergeven, kopersbescherming integreren en beoordelingen verzamelen
Met de unieke Trustbadge-technologie verzamel, beheer en toon je de verzamelde klantbeoordelingen moeiteloos in je shop. Bovendien kun je zo eenvoudig het keurmerk tonen en de kopersbescherming aan je klanten aanbieden.
- Open het tabblad 'Trustbadge' in de plug-in.
- Selecteer in het dropdown-menu 'Geselecteerd kanaal' (
) het verkoopkanaal waarvoor je de configuratie wilt uitvoeren.
- Controleer dat de schakelaar op 'actief' (
) staat ingesteld; deze instelling activeert de Trustbadge.
- Er zijn nu verschillende mogelijkheden om de Trustbadge te configureren:
-
'Standaard' (
) selecteren. Met deze instelling verschijnt de Trustbadge rechtsonder op je webshop op een desktopapparaat, en linksonder op mobiele apparaten. Mocht je deze plaatsing willen wijzigen dan zijn er hiervoor verschillende mogelijkheden:
- Klik op het dropdownmenu 'Plaatsing voor desktopgebruikers' (
) om te bepalen of je de Trustbadge in de desktopweergave rechts of links wilt zien.
- Klik op het dropdownmenu 'Plaatsing voor mobiele gebruikers' (
) om aan te geven of je de Trustbadge in de mobiele weergave rechts of links wilt zien.
- Voeg het gewenste aantal pixels aan het invoerveld 'Naar boven verschuiven om' (
) toe. Door het aantal pixels aan te passen, bepaal je de hoogte van de Trustbadge binnen de betreffende weergave.
- Klik op het dropdownmenu 'Plaatsing voor desktopgebruikers' (
-
'Integratiecode bewerken' (
) selecteren. Hier kun je de Trustbadge-code handmatig bewerken.
-
'Standaard' (
- Klik op 'Wijzigingen opslaan' (
).
Test nu de werking van de Trustbadge: dit doe je door een testbestelling in je webshop te maken. Wanneer aan het einde van de bestelling de zogenoemde Trustcard verschijnt, heb je de Trustbadge goed in je shop geïntegreerd. Ook bevestigt dit dat de kopersbescherming actief is en er beoordelingen verzameld worden.
Verzamelde shop- en productbeoordelingen in je shop weergeven
Om je verzamelde beoordelingen en de sterrenscore in je webshop te tonen, zijn er tal van widgets beschikbaar. Deze widgets kunnen individueel worden aangepast en de selectie wordt voortdurend uitgebreid.
Houd er rekening mee dat de widgets voor de weergave van productbeoordelingen alleen beschikbaar zijn als je productbeoordelingen hebt geboekt.
- Open het tabblad 'Widgets' in de plug-in.
- Klik op 'Maak een nieuwe widget'. Er verschijnt een pop-upvenster.
- Klik op 'Ga naar eTrusted' en log in bij het eTrusted Controlecentrum. De widgetbibliotheek van het eTrusted Controlecentrum opent.
- Selecteer een widget en klik op de bijbehorende knop 'Creëren' . Het configuratieoverzicht van de widget verschijnt.
- Nu kun je de widget volgens je individuele wensen configureren. Klik aansluitend op 'Widget-code creëren'.
- Ga terug naar de plug-in. Klik op 'Reload list'. De widget die je zojuist hebt aangemaakt wordt nu in het vak 'Huidige widgets' weergegeven.
- Aan de hand van het dropdownmenu 'Selecteer een positie' (
) bepaal je ook op welke pagina's en op welke positie de widget in je webshop moet verschijnen.
- Configureer je een widget voor productbeoordelingen? Gebruik dan het dropdownmenu 'Product ID' (
) om te bepalen met welke productidentificatie de widget de producten kan identificeren.
- Klik op 'Wijzigingen opslaan'.
Je hebt de widget nu met succes in je webshop geïntegreerd.
In het vak 'Current widgets' vind je veel informatie over je widgets. Hier leggen we uit hoe het vak is opgebouwd:
| Widget | Dit is de naam van de widget zoals deze ook in het eTrusted Controlecentrum wordt gebruikt. | |
| Product ID | Om productbeoordelingen te kunnen verzamelen en weergeven, moet eTrusted de aangeboden producten in jouw shop eenduidig kunnen identificeren. Hier bepaal je welke productaanduiding hiervoor gebruikt moet worden; deze instelling is dus alleen relevant als je productbeoordelingen in je shop wilt weergeven. | |
| Status |
Op dit punt in de opsomming zie je welke status de widget heeft. Er zijn twee mogelijkheden:
|
|
| Content | Dit veld toont welk type beoordeling wordt weergegeven. | |
| Locatie | Hier wordt de plaatsing van de widget in je shop bepaald, zoals bijvoorbeeld productpagina's, checkoutpagina, header of footer. |
Beoordelingsverzoeken geoptimaliseerd verzenden
Tijdstip van het verzenden van het beoordelingsverzoek aanpassen
Nadat je de Trustbadge hebt geactiveerd, worden beoordelingen automatisch verzameld. Met behulp van de plug-in kun je het tijdstip van de verzending van beoordelingsverzoeken aanpassen aan je behoeften. Koppel de verzendtijd aan een van de bestelstatussen in je winkelsysteem.
- Open het tabblad 'Beoordelingsverzoeken' (
) in de plug-in.
- Scrol naar het menupunt 'Stuur uitnodigingen voor beoordelingen op het juiste moment om mer en betere beoordelingen te verzamelen'.
- Gebruik de 'Servicebeoordelingen'-vervolgkeuzelijst (
) om de bestelstatus te selecteren waaraan je het tijdstip van verzending van je servicebeoordelingsverzoeken wilt koppelen.
- Gebruik de 'Productbeoordelingen'-vervolgkeuzelijst (
) om de bestelstatus te selecteren waaraan je het tijdstip van verzending van je productbeoordelingsverzoeken wilt koppelen.
- Klik op 'Opslaan' (
).
Je hebt de verzendtijd correct gekoppeld aan een bestelstatus.
Zodra de status van de bestelling is bereikt, wordt een verzendvertraging gestart. De duur van de verzendvertraging is gebaseerd op gegevens van Trusted Shops voor het optimale verzendtijdstip. Aan het einde van de verzendvertraging wordt het beoordelingsverzoek verzonden.
Wil je zelf bepalen hoeveel tijd er moet verstrijken tussen het bereiken van de bestelstatus en het verzenden van het beoordelingsverzoek? Maak vervolgens een beoordelingsverzoek aan in het eTrusted Controlecentrum. Dit artikel kan daarbij handig zijn: Hoe kan ik automatisch beoordelingsverzoeken versturen aan mijn klanten?
Handmatige beoordelingsverzoeken verzenden
Als je je beoordelingen niet automatisch wilt verzamelen of naast de automatische verzending van beoordelingsverzoeken ook handmatig klanten wilt uitnodigen om een beoordeling te geven, kun je de Review Collector gebruiken. Hiervoor heb je een CSV-bestand nodig met de gegevens van de klanten naar wie je beoordelingsverzoeken wilt sturen. Dit CSV-bestand maak je aan met behulp van de plug-in.
- Binnen de plug-in open je het tabblad 'Beoordelingsverzoeken'.
- Scroll naar het menupunt 'Verstuur beoordelingsverzoeken voor eerdere bestellingen'.
- Gebruik het keuzeveld 'Bestellingen exporteren' (
) om te bepalen voor welke periode de bestelgegevens moeten worden geëxporteerd.
- Wil je ook handmatig beoordelingen van producten verzamelen? Dan moet het CSV-bestand gegevens bevatten over de bestelde producten. Zet hiervoor de 'Include product data'-schakelaar (
) op groen
- Klik vervolgens op 'Exporteren' (
); het CSV-bestand wordt gedownload.
- Ga dan naar het eTrusted Controlecentrum.
- Gebruik de Review Collector met behulp van dit artikel: Wat is de Review Collector?
Verdere mogelijkheden
Verkoopkanalen koppelen aan eTrusted
- Open de plug-in het tabblad 'Instellingen'.
- Scroll vervolgens naar het menupunt 'Kanaalinstellingen'.
- Koppel vervolgens de verkoopkanalen (bijv. verschillende taalshops) via de dropdownmenu's (
) aan het betreffende eTrusted-kanaal.
- Klik op 'Wijzigingen opslaan'.
Koppeling met Trusted Shops opheffen
- Open de plug-in het tabblad 'Instellingen'.
- Scrol naar het menupunt 'Trusted Shops verbreken'.
- Klik op 'Koppeling verbreken'.
Problemen met de integratie?
In dit gedeelte vind je oplossingen voor mogelijke problemen bij het instellen van je plug-in.
Als je met je shop naar een nieuw domein verhuist, moet je de omgevingsvariabele APP_URL zo configureren dat de shop bereikbaar blijft voor externe plug-ins. Alleen zo kan onze plug-in gegevens met je shop blijven uitwisselen en blijven functioneren.
- Domeinverhuizing uitvoeren.
- Meld je aan bij de Shopware-backend.
- Shopware herkent automatisch dat het domein is veranderd. Het pop-upvenster "Domain change detected" verschijnt.
- Kies een van de beschikbare opties (
).
- Klik op "Confirm" (
).
Je hebt de APP_URL nu met succes geconfigureerd. De plug-in werkt ook verder naar wens.
Shopware slaat de actuele URL van je webshop op in de omgevingsvariabele APP_URL. Via deze variabele wisselt onze plug-in gegevens uit met Shopware, zodat je geboekte producten werken.
Als je met je shop naar een nieuw domein verhuist, toont Shopware in de backend de pop-up "Domain change detected".
Als je deze pop-up negeert of sluit, blijft de APP_URL ongewijzigd. De plug-in kan dan geen gegevens uitwisselen met het nieuwe domein. Daardoor wordt de Trustbadge niet weergegeven, kunnen je klanten geen kopersbescherming afsluiten en ontvangen ze geen beoordelingsverzoek.
APP_URL naderhand bijwerken
- Open je Shopware-backend.
-
Open de console en voer het volgende commando uit:
bin/console app:url-change:resolve - Er verschijnt een overzicht van de beschikbare opties. Kies een van de opties. Voer het betreffende commando in de console uit.
Je hebt de APP_URL nu met succes bijgewerkt. Je plug-in werkt weer naar wens.
Als in de plug-in alleen een laadscherm wordt weergegeven, kan dit verschillende oorzaken hebben. Voer de volgende stappen uit om het probleem te beperken.
Stap 1: Pagina opnieuw laden en foutmelding controleren
- Laad de pagina opnieuw als het laadscherm langer dan 30 seconden wordt weergegeven.
- Controleer of een van de volgende foutmeldingen wordt weergegeven. Klik in dat geval op de bijbehorende link:
- App registration for "TrustedShopsEasyIntegrationS6" failed: Already existing Shop ID. Please ensure each environment uses a unique Shop ID and reinstall the app afterwards.
- Something went wrong. The provided shop signature is not valid. One of the reasons could be that your APP_URL in the Shopware .env is wrong.
- Verschijnt er een andere foutmelding of wordt opnieuw het laadscherm weergegeven? Ga dan verder met stap 2.
Stap 2: Informatie beschikbaar stellen voor analyse
Om je probleem snel op te lossen, hebben we het volgende nodig:
- Administratie-URL van je Shopware-backend
- Screenshot van de browserconsole zodra het laadscherm of de foutmelding wordt weergegeven
- Waarde van APP_URL uit je .env- of .env.local-bestand
- Screenshot van de database-invoer van de URL in de kolom core.app.shopId in de database system_config
Voer de volgende stappen uit om de informatie te verstrekken:
- Kopieer de volledige URL uit de adresbalk van je browser om de administratie-URL van je Shopware-backend te krijgen.
- Klik op "F12" op je toetsenbord. Open vervolgens het tabblad "Console" om de browserconsole te openen. Maak een screenshot.
- Open via FTP of Hosting Manager de hoofdmap van je Shopware-installatie. Open het bestand .env of .env.local. Kopieer de waarde die achter APP_URL staat.
- Open je Shopware-database. Open de database "system_config". Open de database-invoer van de kolom "core.app.shopId". Maak een screenshot.
Hiermee heb je alle informatie verstrekt. Ga nu verder met stap 3.
Stap 3: Informatie doorgeven aan Trusted Shops
- Verzamel alle informatie die je in stap 2 hebt verstrekt in één e-mail.
- Stuur de e-mail naar members@trustedshops.com.
Hiermee heb je alle informatie met succes doorgegeven. Ons supportteam analyseert je probleem en neemt contact op met een passende oplossing.
Deze foutmelding geeft aan dat je shop dezelfde shop-ID gebruikt als een andere instantie.
Om je plug-in correct te kunnen installeren, heeft elke shop van jou een eigen shop-ID nodig. Voer de volgende stappen uit om het probleem op te lossen:
- Open je Shopware-database, bijv. met de plugin Adminer of de databasetool van je hosting.
- Open de database "system_config". Controleer aan de hand van de databasevermeldingen in de kolom "core.app.shopId" of meerdere instanties dezelfde shop-ID gebruiken.
- Zorg ervoor dat elke Shopware-instantie een eigen Shop-ID gebruikt. Gebruik hiervoor deze handleiding van Shopware: Handling the migration of shops
- De plug-in deïnstalleren.
- De plug-in opnieuw installeren.
Nu is de plug-in correct geïnstalleerd. Je moet de plug-in nu probleemloos kunnen configureren.
Deze foutmelding geeft aan dat je shop dezelfde shop-ID gebruikt als een andere instantie.
Om je plug-in correct te kunnen configureren, heeft elke shop van jou een eigen shop-ID nodig. Voer de volgende stappen uit om het probleem op te lossen:
- Open je Shopware-database, bijv. met de plugin Adminer of de databasetool van je hosting.
- Open de database "system_config". Controleer aan de hand van de databasevermeldingen in de kolom "core.app.shopId" of meerdere instanties dezelfde shop-ID gebruiken.
- Zorg ervoor dat elke Shopware-instantie een eigen Shop-ID gebruikt. Gebruik hiervoor deze handleiding van Shopware: Handling the migration of shops
- De plug-in deïnstalleren.
- De plug-in opnieuw installeren.
Nu is de plug-in correct geïnstalleerd. Je moet de plug-in nu probleemloos kunnen configureren.
Het Customer Success Team helpt je als je niet verder komt met de integratie. Hiervoor zijn twee stappen nodig:
Stap 1: Versienummer bepalen
Om je snel en doelgericht te kunnen helpen, heeft het Customer Success Team de volgende informatie nodig:
Zo vind je het versienummer van je shopsysteem
- Meld je aan bij de Shopware 6 backend.
- Het versienummer staat boven de hoofdnavigatie in de linkerbovenhoek.
Zo vind je het versienummer van de Trusted Shops plug-in
- Meld je aan bij de Shopware 6 backend.
- Klik in de hoofdnavigatie op "Extensions" (
). Klik daarna op "My extensions" (
).
- Het overzicht "My extensions" verschijnt. Het versienummer bevindt zich aan de rechterkant van de invoer "Trusted Shops Easy Integration for Shopware 6".
Stap 2: Contact opnemen met het Customer Success Team
Nadat je de versienummers hebt gevonden, kun je contact opnemen met het Customer Success Team. Vermeld de twee versienummers direct bij je aanvraag.
Zo bereik je het team:
- E-mail: members@trustedshops.com
- Telefoon: 020 709 1235 (optie 2)