WordPress-plugin

De officiële plugin DimensionKit voor WordPress verbindt je WordPress-website met je DimensionKit-account. Hiermee autoriseer je je domein met één klik, bekijk je een overzicht van je scorecards en sluit je ze in via een native blok of shortcode.

De plugin is beschikbaar in de WordPress.org Plugin Directory.

Belangrijkste functionaliteiten

• Eenmalig verbinden: Authenticatie bij DimensionKit via OAuth 2.1. Geen API-sleutels die handmatig moeten worden gekopieerd of beheerd.
• Autorisatie met één klik: DimensionKit staat insluiting alleen toe op goedgekeurde domeinen. De plugin voegt automatisch de URL van je website toe aan de allowlist van de scorecard.
• Gutenberg-blok & shortcode: Plaats assessments eenvoudig met de native blokeditor of via de shortcode [dimensionkit].
• Automatische responsieve hoogteaanpassing: De ingesloten iframe past zijn hoogte automatisch aan naarmate bezoekers vragen beantwoorden – zonder interne schuifbalken.
• Gebouwd op MCP: Onder de motorkap fungeert de plugin als een Model Context Protocol (MCP)-client die communiceert met https://app.dimensionkit.com/mcp.

Vereisten

• WordPress 6.3 of nieuwer
• PHP 7.4 of nieuwer
• Een actief DimensionKit-account
• Een website die via HTTPS wordt geserveerd (vereist voor de beveiliging van de OAuth-omleiding; http://localhost wordt ondersteund voor lokale ontwikkeling)

Installatie

1. Ga in je WordPress-beheerpaneel naar Plugins → Nieuwe plugin toevoegen.
2. Zoek naar DimensionKit.
3. Klik op Nu installeren en vervolgens op Activeren.

Je kunt de plugin ook downloaden van WordPress.org en het .zip-bestand uploaden via Plugins → Nieuwe plugin toevoegen → Plugin uploaden.

Je account verbinden

1. Open in het WordPress-menu DimensionKit.
2. Klik op Connect to DimensionKit.
3. Je wordt doorgestuurd naar DimensionKit. Log in indien nodig en keur de toegangstoestemming goed.
4. Je keert terug naar WordPress, waar je scorecards direct worden weergegeven.

Scorecards toestaan op deze website

DimensionKit beveiligt insluitingen met de header Content-Security-Policy: frame-ancestors. Een scorecard wordt pas op een domein weergegeven nadat deze aan de allowlist is toegevoegd.

Zo autoriseer je je website:

1. Zoek de desbetreffende scorecard op in de tabel onder DimensionKit.
2. Klik op Allow on this site.
3. De status wijzigt naar Allowed on this site.

Exacte domeinovereenkomst

https://example.com en https://www.example.com worden beschouwd als afzonderlijke origins. De plugin gebruikt automatisch het adres dat is geconfigureerd onder WordPress Instellingen → Algemeen (Siteadres (URL)). Als je website op beide adressen bereikbaar is, zorg er dan voor dat bezoekers het ingestelde adres gebruiken, of voeg de tweede origin handmatig toe in DimensionKit.

Een scorecard insluiten

Je kunt scorecards insluiten via de WordPress-blokeditor of via een shortcode.

Optie 1: Blokeditor (Gutenberg)

1. Open de editor van een bericht of pagina.
2. Voeg een nieuw blok toe en zoek naar DimensionKit Scorecard.
3. Selecteer je scorecard in het vervolgkeuzemenu in de blokwerkbalk.
4. In het zijpaneel met blokinstellingen aan de rechterkant kun je optioneel configureren:
   • Minimale hoogte: Initiële iframe-hoogte in pixels voorafgaand aan dynamische schaling (standaard: 400).
   • Titel: Toegankelijke iframe-titel voor schermlezers.

Optie 2: Shortcode

Gebruik de shortcode in de Classic Editor, tekstwidgets of pagebuilders (Elementor, Divi, Beaver Builder, enz.):

[dimensionkit slug="jouw-scorecard-slug"]

Parameter	Vereist	Beschrijving
slug	Ja	De slug van de scorecard (zichtbaar in de DimensionKit-instellingentabel).
min_height	Nee	Initiële hoogte in pixels vóór dynamische aanpassing. Standaard: 400.
title	Nee	Toegankelijke titel voor de iframe.

Je kunt meerdere scorecards op dezelfde pagina plaatsen.

Ervaring voor bezoekers

Wanneer een bezoeker de pagina opent, laadt de scorecard naadloos binnen je paginalay-out, waarbij het ingestelde thema behouden blijft en de hoogte vloeiend meeschaalt.

Scorecards aanmaken

Scorecards worden gemaakt en geconfigureerd in DimensionKit:

• Webinterface: Klik in de plugin-instellingen op Write a new scorecard om de DimensionKit-editor te openen.
• AI-assistent (MCP): Koppel Claude, ChatGPT of Cursor aan de MCP-server van DimensionKit met behulp van de connector-URL die in de instellingen wordt vermeld (https://app.dimensionkit.com/mcp). Vraag je assistent om dimensies, vragen en resultaatniveaus samen te stellen. Zie de handleiding Een MCP-client verbinden.

Klik na het publiceren van een nieuwe scorecard in DimensionKit in WordPress op Refresh list. De lijst wordt standaard vijf minuten gecached.

Probleemoplossing

Leeg gebied waar de scorecard hoort te staan

De origin van de website is nog niet geautoriseerd. Ga in WordPress naar DimensionKit en klik bij de scorecard op Allow on this site. Controleer ook of het protocol (https://) en domein overeenkomen met de adresinstellingen van WordPress.

Zichtbaar voor beheerders maar niet voor bezoekers

De scorecard staat waarschijnlijk nog als concept (draft). Concepten geven een 404-fout voor bezoekers. Publiceer de scorecard in DimensionKit.

Nieuwe scorecard verschijnt niet in de lijst

De lijst wordt vijf minuten gecached om API-aanroepen te beperken. Klik op Refresh list op het instellingenscherm om direct de nieuwste lijst op te halen.

Account ontkoppelen

Als je op Disconnect klikt, worden de opgeslagen OAuth-tokens uit WordPress verwijderd. Reeds ingesloten scorecards blijven werken zolang het websitedomein in DimensionKit geautoriseerd blijft.