Ga naar hoofdinhoud

Embed Code Generator

Voeg in enkele minuten een Society Speaks voting widget aan uw artikel toe. Ontwikkelaars krijgen een schone iframe en aanpassingsopties. Redacteuren krijgen gestructureerd inzicht, geen reactie-rommel.

API Reference Contact

Embeds zijn beschikbaar voor Society Speaks native discussies.

Implementatiechecklist

  • Bevestig dat uw domein op de allowlist staat
  • Genereer de iframe hieronder
  • Voeg auto-resize toe voor een naadloze gebruikerservaring

Gebruik de Partner Portal voor productie-onboarding

Maak uw testsleutels aan, verifieer domeinen en activeer live sleutels vanuit de <a href="/for-publishers/portal/signup" class="underline">Partnerportaal</a>. Voor schaal gebruikt u de API om discussies te maken en slaat u de geretourneerde discussion ID op in uw CMS. Zie de <a href="/for-publishers/api" class="underline">API Reference</a> voor de programmatische workflow.

Voor ontwikkelaars

Een lichte iframe, voorspelbare parameters en postMessage resize hooks.

Voor redacteuren

Gestructureerde deelname, duidelijke consensussignalen en controleerbare methodologie.

Voor publiek

Stem in enkele seconden, zie waar het publiek aansluit en verken diepere analyses.

Workflow op schaal

1) Opzoeken op artikel-URL, 2) maken indien ontbrekend, 3) discussion ID opslaan.

Wat is een discussion ID?

Een unieke identificatie geretourneerd door de API wanneer een discussie wordt aangemaakt of gevonden.

Nog geen discussie?

Roep POST /api/partner/discussions aan om er een te maken, en embed vervolgens direct.

1. Vind uw discussie

of

Geretourneerd door de API wanneer een discussie wordt aangemaakt of gevonden.

2. Kies een thema

Of pas kleuren aan:

3. Voeg uw referentie toe (Optioneel)

Gebruikt voor analytics. Kleine letters, geen spaties.

Voorbeeld

Voer een discussie-ID in of zoek een artikel-URL op om een voorbeeld te zien

Embed-code

<!-- Voer een discussie-ID in om embed-code te genereren -->

Auto-resize snippet

<script>
window.addEventListener('message', (event) => {
  if (event.data && event.data.type === 'societyspeaks:embed:resize') {
    const iframe = document.getElementById('societyspeaks-embed');
    if (iframe) iframe.style.height = event.data.height + 'px';
  }
});
</script>

Performance-tips

<link rel="preconnect" href="https://societyspeaks.io">
<link rel="dns-prefetch" href="https://societyspeaks.io">

Tips

  • Stel iframe-breedte in op 100% voor responsieve embeds
  • Standaardhoogte is 600px; pas aan op basis van aantal stellingen
  • Voeg ref toe om deelname van uw site bij te houden
  • De embed stuurt zijn hoogte via postMessage voor dynamische sizing
  • Voeg het auto-resize snippet toe om scrollbalken te voorkomen
  • Gebruik preconnect-hints om de eerste paint sneller te maken