Základní implementace

Do hlavičky HTML stránky mezi tagy vložte kód:

<script type="text/javascript" src="https://d21-a.sdn.cz/d_21/sl/3/loader.js"></script>

Do místa na stránce, kde chcete embed vykreslit vložte HTML kód:

<div id="discussion"></div>

Pomocí kódu níže si načtěte kód diskuzního embedu:

window.SZN.DiscussionLoader.load(['embedded']).then(() => {
    const instance = SZN.Discussion.create(
        "service-name", // identifier of your service
        "#discussion",
        {
        // configuration
        }
    );
});

Řetězec service-name nahraďte za námi přidělený strojový název vaší služby.

Dostupné atributy konfigurace:

• linksInNewTab: [false] - Pokud bude true, odkazy se budou otevírat v novém okně
• allowScroll: [true] - Pokud je povoleno, embed může scrollovat hostující stránku

Nakonec vyrobíme instanci diskuzního embedu pomocí:

instance.loadDiscussion(
    "canonicalString",
    {   // meta data
        title: "discussion or page title”,
        url: "http://url-of-page-with-the-discussion'
    }
});

• canonicalString - Identifikátor konkrétní diskuze. Jedinečný řetězec vygenerovaný službou. Doporučujeme tento atribut nastavit na stejnou hodnotu jako canonical url nebo permalink článku, kterého se diskuze týká.
• metaData.title - Nepovinný nadpis Diskuze. Doporučujeme nastavit na stejný titulek jako titulek článku. Pomůže vám to diskuzi pak snadno najít v administraci.
• metaData.url - URL na které se nachází diskuzní embed

Úklid

Po dokončení práce diskuzního embedu zavolejte metodu unload. Tímto se odstraní události a instance samotná.

instance.unload();

Propojení diskuzí s Homepage Seznamu

Aby byla implementace na vašich stránkách kompletní, je potřeba zajistit propojení mezi diskuzní stránkou a Homepage Seznamu. Toho docílíte dvěma jednoduchými kroky. Do článku je nutné přidat hlavičku s metatagem szn:permalink:

<meta name="szn:permalink" content="canonicalString" />

A do strukturovaných dat (https://json-ld.org) článku přidat položku discussionUrl:

<script type="application/ld+json">
    {
        "@context": "http://schema.org",
        "@type": "NewsArticle",
        ...
        "discussionUrl": "https://mujweb.xyz/diskuze/123"
    }
</script>

Správné chování si můžete otestovat pomocí nástroje https://search.google.com/structured-data/testing-tool

Uzavření diskuze

Pokud nechcete zobrazovat bublinku vedoucí na diskuzi ze Seznam Homepage, je možné u článku poslat HTML hlavičku:

<meta name="szn:discussionDisabled" content="true" />

Tuto hlavičku se hodí posílat například u diskuzí, které byly zavřeny z důvodu porušování pravidel nebo které nemají být u článku vůbec vytvořeny.