Postingan Debaty di situsmu sendiri
Sematkan satu postingan dengan satu snippet salin-tempel — tanpa cookie, tanpa pelacakan, jadi pengunjungmu tidak pernah perlu menutup banner cookie untuk itu.
Snippet-nya
Tempel ini di tempat postingan seharusnya muncul. blockquote adalah kontennya sendiri — bisa dibaca mesin pencari, pembaca RSS, dan pembaca layar, bahkan saat JavaScript mati. Skrip menggantinya dengan kartu hidup yang menyesuaikan ukuran sendiri.
<blockquote class="debaty-embed" data-debaty-post="<post-id>">
<p>De posttekst — leesbaar zonder JavaScript.</p>
<p>— Naam (@handle) · <a href="https://debaty.com/nl/bubbel/<post-id>">https://debaty.com/nl/bubbel/<post-id></a></p>
</blockquote>
<script async src="https://debaty.com/embed.js" charset="utf-8"></script>Kamu tidak pernah harus membuat ini secara manual: setiap postingan punya "Sematkan" di menu bagikannya, dan kodenya keluar siap pakai — termasuk teks postingan di dalam blockquote.
Menyematkan liveblog
Selain sebuah postingan, kamu juga bisa menyematkan seluruh liveblog: gunakan data-debaty-liveblog dengan id liveblog alih-alih data-debaty-post. Kartu ini menampilkan judul, orang yang menjalankannya, tiga pembaruan terbaru, dan tautan ke laporan lengkap, serta menyegarkan dirinya sendiri setiap tiga puluh detik selama liveblog masih terbuka — tanpa cookie dan tanpa permintaan ke pihak ketiga mana pun. Begitu liveblog ditutup, penyegaran berhenti dan kartu menampilkan ringkasan penutup.
<blockquote class="debaty-embed" data-debaty-liveblog="<liveblog-id>">
<p><strong>De titel van het liveblog</strong></p>
<p>De intro — leesbaar zonder JavaScript.</p>
<p>— Naam (@handle) · <a href="https://debaty.com/nl/liveblog/<liveblog-id>">https://debaty.com/nl/liveblog/<liveblog-id></a></p>
</blockquote>
<script async src="https://debaty.com/embed.js" charset="utf-8"></script>Cara kerjanya
embed.js (±2 kB, tanpa dependensi) mencari blockquote dengan data-debaty-post dan menggantinya dengan iframe yang mengarah ke halaman sematan postingan itu. iframe mengukur dirinya sendiri dan melaporkan tingginya lewat postMessage; embed.js hanya menerima pesan seperti itu dari origin kami dan hanya untuk iframe yang ia pasang sendiri. Tautan di kartu membuka Debaty di tab baru.
Tanpa cookie, tanpa pelacakan
Dokumen sematan tidak menyetel satu cookie pun, tidak membaca sesi, dan sama sekali tidak membuat permintaan pihak ketiga — font sistem, CSS-nya sendiri, gambar hanya dari origin kami sendiri. Jadi tidak ada yang perlu disetujui: kamu bisa memasang sematan tanpa kewajiban banner cookie, dan tetap berfungsi di peramban yang memblokir cookie pihak ketiga sepenuhnya (seperti Safari).
Membangun iframe sendiri alih-alih lewat embed.js? Kalau begitu beri atribut sandbox ini — kartu tidak butuh lebih dari itu:
<iframe src="https://debaty.com/embed/post/<post-id>"
sandbox="allow-scripts allow-same-origin allow-popups"></iframe>Tema dan bahasa
Secara bawaan, kartu mengikuti skema warna pengunjung (terang/gelap). Kunci dengan data-debaty-theme="light" atau "dark" pada blockquote; bahasa label kartu kamu pilih dengan data-debaty-lang="nl" atau "en".
oEmbed
Untuk CMS dan editor yang bicara oEmbed (WordPress, sejenis Mastodon, aplikasi catatan) ada endpoint sesuai oembed.com: type rich, dengan snippet di html. height bernilai null — tinggi baru diketahui setelah konten dirender; embed.js mengukurnya secara langsung. maxwidth dihormati sampai batas atas kami yaitu 600.
GET /api/oembed?url=https%3A%2F%2Fdebaty.com%2Fnl%2Fbubbel%2F<post-id>&format=json{
"version": "1.0",
"type": "rich",
"provider_name": "Debaty",
"author_name": "…",
"html": "<blockquote class=\"debaty-embed\" …>…</blockquote><script async src=\"…/embed.js\"></script>",
"width": 600,
"height": null
}Setiap halaman postingan publik membawa tautan discovery (<link rel="alternate" type="application/json+oembed">), jadi konsumen oEmbed cukup butuh permalink biasa saja.
Bagaimana dengan widget penerbit?
Ini dua produk yang berbeda. Embed postingan (halaman ini) menampilkan satu postingan Debaty yang sudah ada, bisa ditaruh di mana saja, tanpa registrasi. Widget penerbit adalah panel komentar di bawah artikelmu sendiri: komentar dari pembacamu, dengan antrean moderasi dan allowlist domain, dikelola lewat akun penerbitmu.
Ke widget penerbit →