Probleemoplossing & FAQ
Veelvoorkomende problemen en hun oplossingen
🚫 Widget verschijnt niet
Mogelijke oorzaken:
- Onjuiste of ontbrekende venue UUID
- Script niet geladen of onjuist geladen
- JavaScript fouten die widget
initialisatie voorkomen
- Netwerkconnectiviteit problemen
Oplossingen:
- Verifieer dat de venue UUID correct en
actief is
- Controleer dat de script tag op de
juiste locatie staat
- Open browser console (F12) en zoek
naar foutmeldingen
- Zorg ervoor dat jouw website externe
scripts toestaat
- Test op een ander netwerk/apparaat
📍 Widget verschijnt op verkeerde positie
Mogelijke oorzaken:
- CSS conflicten met bestaande fixed/sticky
elementen
- Viewport meta tag problemen op mobiel
- Z-index conflicten
- Onjuiste offset waarden
Oplossingen:
- Controleer op CSS
conflicten met
position: fixed elementen
- Verifieer dat offset waarden redelijk
zijn (-500 tot 500px)
- Test op verschillende schermformaten en
oriëntaties
- Zorg ervoor dat viewport meta tag
correct geconfigureerd is
- Probeer verschillende positie waarden om
te vinden wat het beste werkt
🎨 Styling problemen
Belangrijk om te weten:
- Widget gebruikt Shadow DOM - externe CSS
kan interne stijlen niet beïnvloeden
- Aanpassing moet gedaan worden via
widget attributen
- Merkkleur moet een geldige CSS
kleurwaarde zijn
Oplossingen:
- Gebruik onze testruimte om styling
wijzigingen te testen
- Verifieer dat kleurwaarden in correct
CSS formaat zijn
- Test kleurcontrast voor toegankelijkheid
- Gebruik onze testruimte om styling
wijzigingen te testen
📱 Responsiviteit problemen
Veelvoorkomende problemen:
- Widget overlapt met mobiele navigatie
- Aanraakdoelen te klein
- Modale dialoogvenster past niet goed op
scherm
Oplossingen:
- Test widget positie op echte mobiele
apparaten
- Pas offset waarden aan voor
mobiel-specifieke ruimte
- Overweeg verschillende posities voor
mobiel vs desktop
- Zorg ervoor dat viewport meta tag correct
geconfigureerd is
⚠️ JavaScript conflicten
Mogelijke oorzaken:
- Andere scripts interfereren met widget laden
- Content Security Policy blokkeert externe
scripts
- Verouderde browser ondersteunt geen Web
Components
Oplossingen:
- Laad widget script na andere kritieke
scripts
- Update CSP om widget domein toe te staan
- Controleer browser compatibiliteit (zie
hieronder)
- Test in incognito modus om extensies uit
te sluiten
Browser Ondersteuning
De Constell Widget vereist moderne browser functies en
ondersteunt:
✅ Chrome 61+
Volledige ondersteuning inclusief alle
functies
✅ Firefox 63+
Volledige ondersteuning inclusief alle
functies
✅ Edge 79+
Volledige ondersteuning inclusief alle functies
⚠️ Niet-ondersteunde Browsers
- Internet Explorer (alle versies)
- Chrome > 61
- Firefox > 63
- Edge Legacy > 79
Opmerking: De widget zal gracefully degraderen of niet verschijnen op
niet-ondersteunde browsers.
Debug Stappen
Volg deze stappen om widget problemen te diagnosticeren:
-
Open Browser Ontwikkelaarstools (F12)
- Controleer de Console tab voor foutmeldingen
- Zoek naar 404 fouten in de Network tab
- Verifieer dat het widget script succesvol
geladen is
-
Verifieer Widget Element
- Controleer Elements tab voor
<constell-widget> element
- Verifieer dat alle attributen correct ingesteld
zijn
- Zoek naar Shadow DOM inhoud
-
Test Isolatie
- Probeer de widget op een eenvoudige HTML pagina
- Test in incognito/privé browsing modus
- Schakel browser extensies tijdelijk uit
-
Controleer Netwerkconnectiviteit
- Verifieer CDN toegankelijkheid vanaf jouw
netwerk
- Controleer op bedrijfsfirewalls of ad blockers
- Test op verschillende netwerken indien mogelijk
Hulp Krijgen
Als je nog steeds problemen ondervindt:
📞 Neem contact op met Constell
Support via support@constell.com of 020-8932406
Bij het contact opnemen, vermeld alsjeblieft:
- De venue UUID
- Browser en versie
- Console foutmeldingen (indien van toepassing)
- Stappen om het probleem te reproduceren
- Screenshots of schermopnames indien behulpzaam
Prestatie Overwegingen
Tips voor optimale widget prestaties:
- Laad het widget script asynchroon wanneer mogelijk
- Overweeg lazy loading voor widgets onder de fold
- Gebruik specifieke versie URL's in productie voor
betrouwbaarheid
- Monitor Core Web Vitals impact als prestaties kritiek
zijn