Prilagodbe i konfiguracija

Kontekst

Ovdje ćete pronaći detaljnu dokumentaciju o svakoj značajci i postavci koju widget za komentare podržava.

Ova dokumentacija će pokriti osnovne koncepte i detaljno obraditi svako područje funkcionalnosti, s uputama korak po korak i uobičajenim zamkama.

Bit će prikazani primjeri koda, s istaknutim odgovarajućim linijama. Snimke zaslona stranica za konfiguraciju bit će pružene gdje je primjenjivo.

Primjeri koda koristit će našu vanilla JavaScript knjižnicu, no opcije konfiguracije koriste točno iste nazive za sve verzije widgeta za komentare (React, Vue itd.).

Većina konfiguracija i značajki opisanih u ovom vodiču ne zahtijeva pisanje koda.

Identifikacija vašeg računa

Možda ćete primijetiti da se komentarski widget može koristiti s Tenant ID-jem "demo", na primjer:

Demo Tenant ID

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo"
}];
</script>

Ovo je namijenjeno samo za isprobavanje i igranje s komentarskim widgetom. U produkciji biste proslijedili svoj Tenant ID, ovako:

Defining Your Tenant ID

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "aKa2Z4Q="
}];
</script>

Vaš Tenant ID možete pronaći već primijenjen na isječku koda komentarskog widgeta u vašem računu.

Također možete pronaći svoj Tenant ID i upravljati svojim API ključevima na stranici s API vjerodajnicama.

Od ovog trenutka, ako ste prijavljeni u FastComments, primjeri koda će koristiti vaš stvarni Tenant ID (ako ste prijavljeni na https://fastcomments.com).

Kako su komentari povezani s stranicama i člancima

Pri prikazivanju niza komentara ili ostavljanju komentara, FastComments mora znati kojoj stranici, članku ili proizvodu ti komentari pripadaju.

Za to koristimo nešto što nazivamo "URL ID". To je ili identifikator, poput stringa ili broja, ili URL.

Prema zadanim postavkama, ako ne navedete urlId, on će postati URL stranice. Uzeti ćemo trenutni URL stranice i očistiti ga kako bismo uklonili sve uobičajene marketinške parametre ili identifikatore praćenja.

U slučaju integracija trećih strana, poput WordPressa, naš dodatak će obično koristiti identifikator koji predstavlja trenutno prikazane informacije kao URL ID, na primjer ID članka/stranice.

Definiranje prilagođenog URL ID-a

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/page"
}];
</script>

Jedna stvar na koju ćemo često upućivati u ovom dokumentu je Korisničko sučelje za prilagodbu widgeta.

Ovo sučelje može se koristiti za mnoge promjene widgeta za komentare bez korištenja koda.

Kada stvaramo pravilo prilagodbe, često ćemo željeti da se primijeni na sve stranice naše web stranice. Međutim, u nekim slučajevima želimo prilagoditi widget za komentare na određenoj stranici, bilo da primijenimo prilagođeni stil ili da učinimo komentare za tu stranicu anonimnim. Također, na primjer, možete imati da se živi komentari odmah prikazuju na nekim stranicama, dok se na drugima skrivaju ispod tipki za obavijesti.

Sve je to moguće putem polja za unos URL ID-a na ovoj stranici, koje izgleda ovako:

Unos URL ID-a na stranici za prilagodbu widgeta

Polje URL ID-a koje se koristi za ograničavanje pravila prilagodbe na jednu stranicu ili na uzorak poput */blog/*

Vrijednost u ovom polju treba odgovarati parametru urlId koji se prosljeđuje widgetu za komentare. Ako želite da vaše pravilo prilagodbe bude neovisno o urlId, ostavite ovo polje prazno ili unesite *.

Od 2023. godine polje URL ID u prilagodbi widgeta sada također prihvaća uzorke! Na primjer, možete imati */blog/* za dodavanje stilova specifičnih za vaš blog i */store/* za stilove specifične za vašu trgovinu, sve dok koristite istu domenu.

Zamke

Ako vaša stranica ima hash parametre (kao example.com#page-1) - to će po zadanim postavkama postati dio URL ID-a.
Tijekom migracija, na primjer s WordPressa na Gatsby, možda ćete morati migrirati vrijednosti URL ID-a komentara nakon početne migracije. Za to nas kontaktirajte.

Prikaz istih komentara na različitim stranicama

Budući da parametar urlId omogućuje da definiramo kojoj stranici, odnosno id‑u, su komentari pridruženi, možemo jednostavno postaviti urlId na istu vrijednost na tim stranicama.

The Same Comments on Multiple Pages

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/source-page"
}];
</script>

Prilagođeni stilovi

FastComments je dizajniran da bude prilagodljiv. Sam widget za komentiranje radi unutar iframea iz sigurnosnih razloga, pa za primjenu prilagođenog stiliziranja morate slijediti jedan od dva pristupa.

Prvi, najjednostavniji pristup, i naš preferirani, je korištenje stranice za prilagodbu widgeta.

Na stranici za prilagodbu widgeta, pogledajte odjeljak „Show Advanced Options“, ispod kojeg se nalazi područje označeno kao „Custom CSS“:

Područje unosa prilagođenog CSS-a

Uređivač prilagođenog CSS-a ispod Opcije naprednog prikaza na stranici prilagodbe widgeta

Pristup ima neke prednosti:

Uneseni CSS se minificira prije nego što se pošalje korisniku, a formatiranje ostaje dosljedno u sučelju za uređivanje.
Dobivate sve prednosti UI-a za prilagodbu widgeta, na primjer lako prilagođavanje widgeta za komentiranje različitim stranicama.
Kada napravimo promjene na widgetu za komentiranje, vaše prilagođeno stiliziranje bit će testirano kao dio našeg procesa izdanja.

Drugi pristup je specificirati parametar customCSS u konfiguraciji widgeta, na sljedeći način:

Prosljeđivanje prilagođenog CSS-a

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "button { background: red; }"
}];
</script>

Međutim, ovo ima ograničenja:

Postoji ograničenje koliko se prilagođenog CSS-a može proslijediti prije nego što naši serveri odbiju zahtjev, zbog veličine zaglavlja.
Morate upravljati prilagođenim CSS-om u svojoj infrastrukturi i sustavu izgradnje. To može biti i prednost, a ne samo nedostatak.
Postoji dodatni trošak slanja prilagođenog CSS-a preko mreže dvaput u ovom slučaju, jer se mora poslati našim serverima, a zatim vraćeno u sadržaj iframea. Međutim, za većinu veličina opterećenja to nije primjetno.
Uobičajena optimizacija je minificiranje CSS-a kako bi se smanjila njegova veličina preko mreže, ali s ovim pristupom to ćete morati sami upravljati.
Vaš prilagođeni CSS neće biti testiran kada napravimo promjene.

Vanjske CSS datoteke

Možete reći widgetu da preuzme vanjsku datoteku koristeći @import!

Preporučuje se staviti @import u pravilo prilagodbe. Na taj način, ako ikada trebamo napraviti promjenu na widgetu za komentiranje, možemo koristiti našu automatizaciju za provjeru vaše postavke. Na primjer, kreirali biste pravilo prilagodbe u UI-ju za prilagodbu widgeta, kliknuli Advanced i unijeli u Custom CSS:

@import url(https://example.com/styles.css);

U kodu – nije preporučeno

Također možete učitati vanjsku CSS datoteku putem svojstva customCSS:

Vanjska CSS datoteka

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "@import url(https://example.com/styles.css);"
}];
</script>

Međutim, imajte na umu da vaš CSS neće moći biti testiran od strane nas ako to učinite.

Stiliziranje modalnog prozora korisničkog profila

Modalni prozori korisničkog profila također se mogu stilizirati prilagođenim CSS-om. Međutim, kako bi se osiguralo da se prilagođeni stil primijeni na korisničke profile, svi CSS selektori moraju imati prefiks .user-profile. Bez ovog prefiksa, prilagođeni stil će biti zanemaren za modalne prozore korisničkog profila.

Na primjer:

CSS korisničkog profila

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": ".user-profile .profile-name { color: blue; }"
}];
</script>

Unazadna kompatibilnost

U FastCommentsu znamo da naši korisnici prilagođavaju widget za komentiranje. To je namjerno – posljednja stvar koju želimo je da naš proizvod uzrokuje nesklad u dizajnu vašeg proizvoda.

Budući da je to važan dio našeg proizvoda, imamo CI/CD pipeline koji nam omogućuje pregled promjena widgeta za komentiranje po korisniku, pri svakom izdanju.

Ako pronađemo manje probleme, ažurirat ćemo vaš račun kako bismo osigurali glatko izdanje. Ako uočimo veće promjene koje prekidaju funkcionalnost, to nam omogućuje zaustaviti izdanje.

Prilagođeni fontovi

FastComments je dizajniran da se prilagodi, a font koji koriste naši widgeti nije iznimka.

Prema zadanim postavkama, FastComments koristi system font stack kako bi izgledao što bolje na širokom rasponu uređaja.

Za definiranje vlastitih fontova, pogledajte Dokumentacija o prilagođenom CSS-u.

Tamo ćete pronaći način za definiranje prilagođenog CSS-a, što će vam omogućiti definiranje željenih fontova.

Kako definirati font

Da biste nadjačali font, preporučujemo da svoj CSS definirate koristeći selektore .fast-comments, textarea. Na primjer:

Primjer prilagođenog vanjskog fonta

Copy

Run

@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@300&display=swap');
.fast-comments, textarea {
    font-family: 'Roboto', sans-serif;
}

Uklanjanje brendiranja

Kupcima s Pro ili Enterprise računima dopušteno je uklanjanje brendiranja. Jednostavno kontaktirajte nas i rado ćemo vam pomoći.

Ako samo želite ukloniti naš logo iz widgeta za komentare, to je automatski omogućeno na Flex i Pro planovima.

Ti planovi također pružaju istu funkcionalnost za e-poruke poslane s naše platforme.

Podrška tamnim pozadinama (tamni način)

Po zadanim postavkama, FastComments widget za komentare automatski će otkriti tamni način rada na većini stranica.

Kad se otkrije tamni način rada, FastComments će prebaciti crni tekst na bijelim pozadinama u bijeli tekst na crnoj pozadini. Slike će se također promijeniti.

Prilikom učitavanja stranice, widget će pokušati odrediti koliko je pozadina stranice tamna iza widgeta za komentare. To znači da stranica može imati bijelu pozadinu, ali ako postavite widget za komentare unutar spremnika s crnom pozadinom, tamni način rada bi trebao i dalje biti automatski omogućen kako bi komentari bili čitljivi.

Međutim, mehanizam detekcije, koji se oslanja na određivanje "luminancije", možda neće omogućiti tamni način rada kada želite. Da biste ga prisilno omogućili, postavite hasDarkBackground flag na true kako slijedi:

Force Dark Background Mode

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hasDarkBackground": true
}];
</script>

Prebacivanje tamnog načina

Za web-lokacije koje omogućuju prebacivanje tamnog načina nakon početnog učitavanja stranice, ovo je malo složenije.

Prvo, sve trenutne verzije biblioteke Comment widget (React, Vue) imaju primjere za prebacivanje tamnog načina u svojim odgovarajućim spremištima.

Za VanillaJS widget morat ćemo napraviti još posla. Prvo, FastCommentsUI vraća objekt s funkcijama "destroy" i "update".

Možemo jednostavno pozvati funkciju update svaki put kad želimo ažurirati konfiguraciju widgeta komentara, kako slijedi. Evo potpunog funkcionalnog primjera prebacivanja tamnog načina s VanillaJS widgetom.

Potpuni primjer prebacivanja tamnog načina

Copy

Run

<script src="https://fastcomments.com/js/embed-v2.min.js"></script>
<button id="toggle-dark-mode">Toggle Dark Mode</button>
<div id="fastcomments-widget"></div>
<script>
    (function() {
        const button = document.getElementById('toggle-dark-mode');
        const config = {
            tenantId: 'demo',
            hasDarkBackground: false
        };
        const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        button.addEventListener('click', function() {
            config.hasDarkBackground = !config.hasDarkBackground;
            if (config.hasDarkBackground) {
                document.body.classList.add('dark');
            } else {
                document.body.classList.remove('dark');
            }
            instance.update(config);
        });
    })();
</script>
<style>
    body.dark {
        background: #000;
        color: #fff;
    }
</style>

Nadjačavanje teksta

S FastComments, sav tekst u widgetu za komentare je prilagodljiv.

Možete zamijeniti pojedinačni dio teksta, poput gumba za slanje, ili sav tekst u cijelom widgetu za komentare.

Prema zadanim postavkama, tekst u widgetu za komentare prevodi se prema lokalizaciji korisnika. Međutim, možemo zamijeniti tekst ako smo sigurni da naša baza korisnika koristi istu lokalizaciju/jezik, na primjer:

Prilagođeni tekst

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "translations": {
        "SUBMIT_REPLY": "Reply"
    }
}];
</script>

All customizable translations can be found ovdje under the "advanced options" tab.

Međutim, postoji jednostavniji način, putem UI-ja za prilagodbu widgeta. Tamo možemo jednostavno pronaći tekst koji se prikazuje u widgetu za komentiranje u EN_US lokalizaciji i navesti zamjenu.

Prilagođeni tekst

Panel prilagođenog teksta s odabranom stringom widgeta iz padajućeg izbornika i poljem za zamjenski tekst

Sva prepisivanja prijevoda trenutno utječu na sve lokalizacije.

Promjena zadane slike profila

Kada korisnik prvi put komentira putem FastComments, pokušat ćemo dohvatiti njegov avatar s https://gravatar.com/.

Međutim, ako ne pronađemo avatar ili korisnik nikada ne postavi avatar u svom računu, prikazat ćemo statičku zadanu sliku avatara.

Za određivanje vlastite statičke slike avatara možete koristiti postavku defaultAvatarSrc.

Zamijeni zadani avatar

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultAvatarSrc": "https://example.com/some-image.png"
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak "Default Avatar".

Prilagođavanje zadane slike avatara

Napomena: definiranje avatara za određenog korisnika, npr. putem SSO, obrađeno je u vlastitom odjeljku.

Onemogućavanje avatara

Avatari se mogu potpuno ukloniti iz widgeta za komentare, čak i ako su korisnici definirali vlastiti avatar.

Hiding Avatars

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hideAvatars": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Skrivanje avatara

Opcija Sakrij Avatare na stranici prilagodbe widgeta, koja uklanja sve avatare iz widgeta za komentare

Onemogućavanje svih zadanih stilova

Za veće projekte prilagođenog stiliziranja, možda je poželjno započeti s čistim početkom i uopće ne koristiti zadano stiliziranje.

Svo zadano stiliziranje može se ukloniti postavljanjem parametra noStyles na true, na sljedeći način:

Disabling All Default Styles

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noStyles": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici prilagodbe widgeta, pod Naprednim opcijama:

Onemogućavanje svih zadnjih stilova

Povezivanje komentara sa stranicama

Prilikom slanja obavijesnih e‑poruka ili prikazivanja komentara u korisničkim sučeljima kao što je stranica za moderaciju, korisno je moći povezati komentar sa stranicom na kojoj se nalazi.

Ako URL ID nije uvijek stvarni ID, moramo URL pohraniti negdje drugdje. Za to služi svojstvo "url", definirano na sljedeći način.

Defining a Custom URL

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5"
}];
</script>

Uobičajen slučaj upotrebe je povezivanje niza komentara s identifikatorom, npr. člankom, a zatim povezivanje natrag na određenu stranicu, na primjer:

Defining Custom URL and URL IDs together

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5",
    "urlId": "article-5"
}];
</script>

URL se ne čisti od uobičajenih marketinških parametara. Prema zadanim postavkama, koji god je trenutni URL stranice, taj se URL pohranjuje uz komentar.

Sažimanje odgovora po zadanom

Prema zadanim postavkama, odgovori na komentare najviše razine se prikazuju.

Ovo se može konfigurirati tako da korisnik mora kliknuti „Show Replies” na komentarima najviše razine da bi vidio podkomentare.

Sažmi odgovore na komentare najviše razine

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "collapseReplies": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Sažmi odgovore

Opcija za sažimanje odgovora u sučelju prilagodbe widgeta, skriva podkomentare iza veze Prikaži odgovore

Ova postavka neće utjecati na broj početno učitanih komentara najviše razine. Ako imate jedan komentar najviše razine i 29 podkomentara, uz ovu postavku ćete:

Vidjeti komentar najviše razine.
Vidjeti „Show Replies” (29) ispod tog komentara.

Ako želite prikazati sve komentare najviše razine u kombinaciji s ovom opcijom, postavite početnu stranicu na -1.

Omogućivanje WYSIWYG-a

Prema zadanim postavkama, funkcionalnosti formatiranja u FastComments se ostvaruju dodavanjem vidljivih oznaka sidra poput <b></b> oko vašeg teksta. Klikanje na alatnu traku ili korištenje prečaca to radi za vas. Međutim, neke zajednice mogu željeti koristiti formatiranje bez oznaka sidra. To se naziva omogućavanje WYSIWYG (what you see is what you get) uređivača. Ovaj uređivač izgleda točno isto kao zadani, osim što učitava dodatni kod koji korisnicima omogućuje podebljanje, podcrtavanje, itd. njihovog teksta bez vidljivih oznaka sidra.

Omogućavanje WYSIWYG uređivanja

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableWYSIWYG": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte opciju "Enable Advanced Formatting" opciju.

Omogući WYSIWYG

Stranica za prilagodbu widgeta s označenim potvrdnim okvirom Enable Advanced Formatting za uključivanje WYSIWYG uređivača

Prema zadanim postavkama, FastComments će prikazati alatnu traku prilikom pisanja komentara kako bi pružio prečace za uređivanje teksta i učitavanje slika.

Ovu alatnu traku možete onemogućiti u kodu ili putem sučelja za prilagodbu.

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte opciju "Disable The Reply Toolbar".

Onemogućavanje alatne trake

Stranica za prilagodbu widgeta s označenim potvrdnim okvirom Disable The Reply Toolbar za uklanjanje prečaca za formatiranje

Onemogućavanje blokiranja

Prema zadanim postavkama, FastComments omogućuje korisnicima da blokiraju druge korisnike. Blokiranje korisnika će uzrokovati da se njihovi komentari maskiraju, sprječava obavijesti između korisnika i slično.

Možda će biti poželjno onemogućiti ovu funkcionalnost. To se može učiniti na sljedeći način:

Onemogući blokiranje

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableBlocking": true
}];
</script>

Ovo se također može učiniti bez koda, što također omogućuje pravilnu provjeru na strani poslužitelja, putem UI‑a za prilagodbu widgeta:

Onemogući blokiranje

Opcija za onemogućavanje blokiranja u UI prilagodbe widgeta, koja sprječava korisnike da blokiraju jedni druge

Određivanje koju stranicu prikazati

Prilikom dohvaćanja i prikazivanja komentara, widget za komentare treba znati s koje stranice početi. Po zadanim postavkama počinje s prvom stranicom, prikazujući samo tu stranicu.

Ako želite, točnu stranicu koja će se prikazati možete proslijediti widgetu za komentare putem postavke startingPage.

Specifying The Page to Render

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": 1
}];
</script>

Imajte na umu da brojevi stranica počinju od nule, pa prethodni primjer prikazuje drugu stranicu.

Prebacivanje niti komentara bez ponovnog učitavanja stranice

Obradili smo kako je urlId ID stranice ili članka uz koji su komentari vezani.

Također, za podsjetnik, ako nije definirano, urlId će se zadano postaviti na URL trenutne stranice.

A što je s SPA-ovima, odnosno Single-Page Applicationima, gdje se stranica ili sadržaj kojem su komentari vezani mijenja dinamički bez ponovnog učitavanja stranice?

Angular, React, Vue, itd

S našim bibliotekama poput Angulara i Reacta, jednostavnim ažuriranjem svojstva urlId koje se prosljeđuje widgetu, widget za komentare će se osvježiti. Ovo možete vidjeti u praksi za React aplikaciju, na primjer, ovdje.

VanillaJS

Ako koristite VanillaJS biblioteku, stvar je nešto složenija jer ne postoji okvir poput Angulara ili Reacta koji bi rukovao vezivanjem podataka ili propagacijom stanja.

Kada instancirate VanillaJS widget, on vraća neke funkcije koje se mogu pozvati za njegovo ažuriranje.

Evo funkcionalnog primjera u kojem mijenjamo hash stranice i ažuriramo widget za komentare:

Primjer promjene hash-a stranice

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<button id="change-page"></button>
<div id="fastcomments-widget"></div>
<script>
    (function fastCommentsMain() {
        let config = {
            tenantId: 'demo'
        };
        let instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        let page = '#page-1';
        function getNextPage() {
            if (page === '#page-1') {
                return '#page-2';
            } else {
                return '#page-1';
            }
        }
        let button = document.getElementById('change-page');
        function nextPage() {
            page = getNextPage();
            button.innerText = 'Go to ' + getNextPage();
            window.location.hash = page;
            let locationString = window.location.toString();
            config.url = locationString; // Također ažuriramo url, kako bi obavijesti mogle voditi natrag na pravu stranicu
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Apsolutni datumi (onemogući čitljive vremenske oznake)

Prema zadanim postavkama, koriste se lokalizirani relativni datumi. Na primjer, uz nedavno ostavljen komentar možete vidjeti "11 minuta prije".

Možda će biti potrebno ili poželjno koristiti apsolutne datume, u tom slučaju postavite ovaj parametar na true.

Koristi apsolutne datume

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteDates": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici prilagodbe widgeta, pod naprednim opcijama:

Koristi apsolutne datume

Napredne opcije na stranici prilagodbe widgeta s uključenim prekidačem apsolutnih datuma

Prikazivanje i apsolutnih i relativnih datuma

Prema zadanim postavkama, koriste se lokalizirani relativni datumi. Na primjer, uz nedavno ostavljen komentar možete vidjeti "11 minuta prije".

Možda je potrebno ili poželjno zadržati ovaj format relativnog datuma, ali također prikazati puni datum uz njega, u kojem slučaju postavite ovaj parametar na true.

Koristite i apsolutne i relativne datume

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteAndRelativeDates": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici prilagodbe widgeta, pod Naprednim opcijama. Prvo ćete morati omogućiti Apsolutne datume da biste vidjeli ovu opciju u korisničkom sučelju.

Koristite i apsolutne i relativne datume

Napredne opcije na stranici prilagodbe widgeta s oba apsolutna datuma i omogućenom kombiniranom postavkom relativnog datuma

Dodavanje teksta zaglavlja

Neki tekst, poput zaglavlja ili poruke, može se prikazati ispod broja komentara, ali iznad teksta statusa prijave.

Ovo nazivamo zaglavljem, a prema zadanim postavkama je skriveno.

Navođenje HTML zaglavlja

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "headerHTML": "<h1>Leave a Comment!</h1>"
}];
</script>

Ovo se može prilagoditi bez koda, na stranici prilagodbe widgeta, pod Naprednim opcijama:

Navođenje HTML zaglavlja

Područje Naprednih opcija na stranici prilagodbe widgeta gdje se unosi prilagođeni HTML zaglavlja

Prikazivanje poveznica kao tekst

By default, FastComments will render links like this: https://exmaple.com - where the link URL becomes a clickable HTML anchor tag.

Some sites may want to disable this, for example to discourage scammers. We provide this by setting the Comment HTML Rendering Option to Links as Text.

This can be customized without code, on the widget customization page, for an entire domain, or page:

Prikazivanje veza kao tekst

Opcija prikaza HTML komentara postavljena na Veze kao tekst pod Naprednim opcijama u prilagodbi widgeta

Prebacivanje komentara pomoću gumba

Prema zadanim postavkama, FastComments će prikazati okvir za unos komentara i nit komentara istovremeno. Kako bi uštedio malo vertikalnog prostora, također će sakriti sve druge potrebne polja dok se widget ne aktivira.

Međutim, widget za komentare može biti sakriven iza gumba, na primjer:

Click to Show Comments

Widget za komentare skupljen iza gumba koji prikazuje broj komentara dok čitatelj ne klikne na njega

Gumb koristi različiti prevedeni tekst ovisno o tome jesu li komentari trenutno prikazani ili ne. Ako su komentari skriveni, koristi translations.SHOW_COMMENTS_BUTTON_TEXT. Ako su komentari prikazani, koristi translations.HIDE_COMMENTS_BUTTON_TEXT. Prijevodi mogu sadržavati tekst [count] koji će biti zamijenjen lokaliziranim brojem.

Click to Show or Hide Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useShowCommentsToggle": true
}];
</script>

Ovo je osmišljeno da zamijeni konfiguraciju hideCommentsUnderCountTextFormat.

Broj se ažurira u stvarnom vremenu zajedno s nitom komentara. Gumb se ne prikazuje ako nema komentara.

Ovo se može omogućiti bez koda stvaranjem pravila prilagodbe i omogućavanjem "Click to Show Comments":

Enable Click to Show Comments

Potvrdni okvir "Click to show comments" označen u pravilu prilagodbe na stranici za prilagodbu widgeta

Prilagodba teksta za broj komentara

Broj komentara prikazan na vrhu widgeta za komentare može se prilagoditi.

Ovo se može zamijeniti bilo kojim nizom, a vrijednost [count] bit će zamijenjena s vrijednošću broja, lokaliziranom za korisnika.

Prilagođavanje teksta broja komentara

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "commentCountFormat": "There are [count] comments."
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Prilagođavanje teksta broja komentara

Polje teksta broja komentara na stranici za prilagodbu widgeta, gdje se [count] zamjenjuje s trenutnim ukupnim brojem

Onemogućavanje preusmjeravanja slika

Po zadanim postavkama FastComments dopušta korisnicima da učitavaju slike. Kad korisnik klikne tu sliku, FastComments će, po zadanim postavkama, otvoriti novu karticu kako bi prikazao sliku u punoj veličini. Postavljanje ove zastavice na true onemogućuje ovo ponašanje:

Disable Image Redirect

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableImageRedirect": true
}];
</script>

Ako ne planirate sami uhvatiti klik na sliku (vidi onImageClicked), preporučujemo da se ovo kombinira s nekim stilovima kako bi se uklonio dojam da se slika može kliknuti.

Onemogućavanje automatskog stvaranja hashtagova

Kada korisnici unesu hashtagove, u obliku #someexampletag, FastComments će automatski stvoriti taj HashTag i istaknuti ga u njihovom komentaru.

U nekim slučajevima poželjno je onemogućiti ovu značajku ili kontrolirati koje se hashtagove može koristiti putem API-ja.

Da biste to učinili, jednostavno omogućite Disable Automatic #hashtag Creation putem UI-ja za prilagodbu widgeta.

Onemogućavanje automatskog stvaranja HashTagova

Opcija onemogućavanja automatskog stvaranja #hashtagova omogućena u UI-ju za prilagodbu widgeta

---

Onemogućavanje zvona za obavijesti

Po zadanom, FastComments će prikazati zvono obavijesti u gornjem desnom kutu područja za komentare.

Ovo zvono će postati crveno i prikazati broj obavijesti koje korisnik ima. Neki primjeri obavijesti su:

Korisnik vam je odgovorio.
Korisnik je odgovorio u temi u kojoj ste komentirali.
Korisnik je glasao za vaš komentar.
Korisnik je odgovorio na stranicu na koju ste pretplaćeni.

Zvono obavijesti također pruža mehanizam za pretplatu na cijelu stranicu.

Međutim, možemo potpuno onemogućiti zvono obavijesti:

Onemogući zvono obavijesti

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableNotificationBell": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak „Onemogući zvono obavijesti“.

Onemogući zvono obavijesti

Onemogućavanje profila

By default, FastComments will show the user's profile when you click on their avatar.

However, we can disable this functionality:

Onemogući profile

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfiles": true
}];
</script>

This can also be done without code. In the widget customization page, see the "Disable Profiles" section.

Onemogući profile

Onemogućavanje komentara na profilima

Prema zadanim postavkama, FastComments će prikazati karticu „Komentari profila“ na korisničkim profilima, omogućujući posjetiteljima da ostave komentare na nečijem profilu.

Međutim, možemo onemogućiti ovu karticu:

Onemogući komentare profila

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfileComments": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak „Onemogući komentare profila“.

Onemogući komentare profila

Onemogućavanje izravnih poruka na profilima

Prema zadanim postavkama, FastComments će prikazati karticu „Izravne poruke“ na korisničkim profilima, omogućujući posjetiteljima slanje izravnih poruka korisniku.

Međutim, možemo onemogućiti ovu karticu:

Disable Profile Direct Messages

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfileDirectMessages": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak „Onemogući izravne poruke“.

Onemogući izravne poruke profila

Stranica za prilagodbu widgeta s označenim potvrdnim okvirom „Onemogući izravne poruke“ za skrivanje kartice poruka na profilu

Onemogućavanje poruke o uspjehu

Prema zadanim postavkama, FastComments će prikazati poruku o uspjehu nakon komentiranja. To se može onemogućiti na sljedeći način:

Disable Success Message

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableSuccessMessage": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta:

Onemogući poruku o uspjehu

Promjena ocjene sadržaja GIF-ova

Prema zadanim postavkama, FastComments widget za komentare postavit će gif rating na pg.

Dostupne opcije su g, pg, pg-13 i r.

Ovo se može postaviti u kodu ili putem UI-a. U kodu to možemo učiniti na sljedeći način:

Set Gif Rating

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "gifRating": "pg-13"
}];
</script>

U UI-u ćete ovo pronaći pod Gif Picker Rating sve dok opcija Disable Image Uploads? nije označena.

Setting The Gif Rating

Padajući izbornik Gif Picker Rating na stranici prilagodbe widgeta koji nudi g, pg, pg-13 i r

Moderiranje sadržaja slika

Prema zadanim postavkama, FastComments widget za komentare ima moderaciju sadržaja slika postavljenu na off.

Dostupne opcije su off, low, medium i high.

U sučelju za prilagodbu widgeta, ovo ćete naći pod Image Content Moderation Level sve dok nije označeno Disable Image Uploads?.

Postavljanje razine moderacije sadržaja slika

Padajući izbornik razine moderacije sadržaja slika na stranici za prilagodbu widgeta postavljen na off, low, medium ili high

Promjena stila glasanja

Prema zadanim postavkama, FastComments će prikazati opcije glasanja kao strelice za gore i dolje, omogućujući korisnicima da glasaju gore ili dolje za komentar.

Međutim, moguće je promijeniti stil alatne trake za glasanje. Trenutne opcije su zadane tipke Gore/Dolje ili korištenje mehanizma glasanja u obliku srca.

Koristimo zastavicu voteStyle na sljedeći način:

Enable Heart Button

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "voteStyle": 1
}];
</script>

Preporučamo da to učinite bez koda jer to također omogućuje provjere na strani poslužitelja. Na stranici za prilagodbu widgeta, pogledajte odjeljak "Vote Style".

Promijeni stil glasanja

Postavka stila glasanja na stranici za prilagodbu widgeta, nudi strelice za gore i dolje ili glasanje srcem

Glasanje se također može onemogućiti, pogledajte Disable Voting iznad opcija stila.

Onemogućavanje brisanja

By default, FastComments will allow users to delete their comments.

However, it is possible to prevent this.

In the widget customization page, see the "Disable Deleting" option.

Onemogući brisanje komentara

Opcija Onemogući brisanje na stranici prilagodbe widgeta, sprječavajući komentatore da uklone svoje komentare

This only impacts regular Commenters and not moderators or admins, who will still be able to delete.
This will also impact API integrations for when contextUserId is passed.

Onemogućavanje uređivanja

By default, FastComments will allow users to edit their comments.

However, it is possible to prevent this.

In the widget customization page, see the "Disable Editing" option.

Onemogući uređivanje komentara

Opcija Onemogući uređivanje na stranici prilagodbe widgeta, sprječavajući komentatore da uređuju svoje komentare

This only impacts regular Commenters and not moderators or admins, who will still be able to edit.
This will also impact API integrations for when contextUserId is passed.

Isticanje novih komentara

FastComments pruža nekoliko načina za isticanje novih komentara.

Prije svega, prema zadanim postavkama komentari koji su pokrenuli obavijest unutar aplikacije (odgovori, odgovori u istoj niti, ili komentari na stranici na koju ste pretplaćeni), automatski će biti istaknuti tako da avatar korisnika blago svijetli. Boju je moguće prilagoditi putem CSS-a koristeći klasu is-unread.

Komentari objavljeni u posljednja 24 sata imaju primijenjenu klasu 24hr koja se može koristiti za stiliziranje.

Na kraju, svi novi komentari uživo koji se pojave u korisničkoj sesiji bit će istaknuti nekoliko sekundi putem animacije. To se radi pomoću CSS klase is-live i također se može prilagoditi.

Veličine stranica

Prema zadanim postavkama, veličina stranice FastCommentsa je 30. To uključuje odgovore u nitima.

Veličinu stranice možete prilagoditi u Widget Configuration UI u različitim veličinama od 10 do 200.

Napomena: promjena veličine stranice zahtijeva ponovno izračunavanje svih niti komentara u vašem računu. To može potrajati nekoliko minuta.

Ovo se ne može konfigurirati u widgetu na klijentskoj strani jer se stranice izračunavaju na poslužitelju.

Primjer konfiguracije prikazan je u nastavku:

Prilagođene veličine stranica

Selektor veličine stranice na stranici za prilagodbu widgeta, gdje se može odabrati vrijednost od 10 do 200

Veličine stranica mogu se prilagoditi globalno, po domeni ili po stranici, stvaranjem različitih pravila prilagodbe.

Ovo će utjecati na sve klijente, integracije i okvire koje možda koristite za prikazivanje komentara putem naše platforme.

Predlošci e-pošte

E-poruke koje FastComments šalje vašim kupcima mogu se prilagoditi. Predložak, logika i prijevodi svi se mogu promijeniti. Tekst se može prilagoditi po lokalizaciji, a stil se čak može mijenjati po domeni. Saznajte više o prilagođenim predlošcima e-pošte ovdje.

Formati korisničkih imena

Prema zadanim postavkama, FastComments će prikazati ime korisnika onako kako ga je unio, ili kako je proslijeđeno putem SSO-a.

Međutim, možda je poželjno maskirati ili prikazati ime korisnika na drugačiji način. Na primjer, ako je ime korisnika Allen Rex, možda želite prikazati samo "Allen R.".

Ovo se može učiniti bez koda u sučelju za prilagodbu widgeta, pod postavkom pod nazivom Commenter Name Format:

Promijeni format imena

Padajući izbornik Formata imena komentatora otvoren s izborima poput Capitalize, Last Initial i All Initials

Dostupni formati su:

Capitalize (prikazuje primjer korisnika kao Example User)
Last Initial (prikazuje Example User kao Example U.)
All Initials (prikazuje Example User kao E. U.)
Show "Anonymous"

Učinak promjene je trenutni. Korisnici će i dalje vidjeti svoje puno korisničko ime na vrhu područja za komentar, za sebe, ali njihovi komentari će prikazivati modificirano korisničko ime.

Korisnička imena maskiraju se na poslužitelju radi zaštite korisnika.

Onemogućavanje učitavanja slika

Prema zadanim postavkama FastComments dopušta učitavanje slika. To se može onemogućiti postavljanjem zastavice noImageUploads na true.

Onemogućavanje učitavanja slika

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noImageUploads": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Onemogućavanje učitavanja slika

Dozvoli ugrađivanje medija

Prema zadanim postavkama FastComments ne dopušta iframeove u komentarima. Kada omogućite medijska embedovanja, komentatori mogu zalijepiti kod za embed ( <iframe> isječak) od pouzdanih pružatelja poput YouTubea, Vimeo‑a, SoundClouda i Spotifyja, i on će se prikazati unutar komentara.

Iz sigurnosnih razloga, ovo nije konfiguracijska zastavica widgeta na klijentskoj strani. To je postavka na strani poslužitelja, provjerena prilikom spremanja svakog komentara, pa se ne može uključiti s stranice. Dopušteni su samo iframeovi koji upućuju na ugrađeni popis pouzdanih pružatelja. Svi ostali iframeovi se uklanjaju.

Ovo se radi bez koda, na stranici za prilagodbu widgeta:

Dozvoli medijske embedove

Postavka medijskih ugrađivanja uključena na stranici prilagodbe widgeta, omogućuje komentatorima lijepljenje pouzdanih iframe ugrađivanja

Dodavanje vlastitih pružatelja

Ako želite dopustiti embedove od pružatelja koji nije na ugrađenom popisu pouzdanih, dodajte njegov naziv hosta u polje "Dodatne domene za embed" na istoj stranici. Ovi nazivi hosta su dopušteni uz ugrađene pružatelje. Podudaranje je točno, pa uključite puni naziv hosta (na primjer, player.example.com). Sve što ne navedete ostaje blokirano.

I obični okvir za komentar i WYSIWYG uređivač podržavaju lijepljenje embedova. U WYSIWYG uređivaču embed se umeće kao uklonjivi blok.

Omogući okvir za pretraživanje

Prema zadanim postavkama, u widgetu za komentare se ne prikazuje polje za pretraživanje.

Međutim, možemo ga uključiti postavljanjem zastavice enableSearch na true:

Omogućavanje pretraživanja

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSearch": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte opciju "Enable Search Box".

Omogući polje za pretraživanje

Stranica za prilagodbu widgeta s označenim potvrdnim okvirom Enable Search Box kako bi se prikazalo polje za pretraživanje u widgetu

Omogući spoilere

Možemo omogućiti podršku za spoiler postavljanjem zastavice enableSpoilers na true:

Omogućavanje Spoilera

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSpoilers": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte opciju "Enable Spoilers" opciju.

Omogući Spoilere

Stranica za prilagodbu widgeta s označenim potvrdnim okvirom Enable Spoilers kako bi se dodalo SPOILER dugme u editor

Kada je tekst označen, a sada vidljivo dugme SPOILER kliknuto, tekst će biti maskiran dok korisnik ne prijeđe mišem preko njega. Za tamni način rada radimo isto, s različitim bojama koje bolje odgovaraju tamnom načinu rada.

Ovo je također kompatibilno s WYSIWYG editorom.

Omogući prikaz broja pregleda komentara

Prema zadanim postavkama, FastComments ne prati tko je pregledao svaki komentar niti pruža bilo kakve statistike o tome.

Međutim, možemo omogućiti ovu značajku, a sustav će početi pratiti kako svaki korisnik pomiče do komentara.

Kada se to dogodi, broj pored ikone oka prikazane na svakom komentaru će se povećati. Broj se ažurira u stvarnom vremenu i skraćuje prema lokalizaciji korisnika.

Možemo to omogućiti postavljanjem enableViewCounts zastavice na true:

Omogućavanje broja pregleda komentara

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableViewCounts": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Omogućavanje broja pregleda komentara

Stranica za prilagodbu widgeta s označenim potvrdnim okvirom za prikaz broja pregleda, tako da svaki komentar prikazuje ikonu oka i broj

Bilježimo ID korisnika* koji je pregledao komentar, tako da ako ponovno pregledate komentar, broj se ne povećava. Ako pregledate komentar ponovno nakon dvije godine, broj će se povećati više.

*Napomena: ili anonimni ID sesije, ili IP korisnika kao hashirana vrijednost.

Prikaži komentare uživo odmah

Prema zadanim postavkama, uživo komentiranje je omogućeno. To znači da ako se bilo koji komentar doda, izbriše, uredi ili zakači, promjene bi se trebale pojaviti svim korisnicima koji pregledavaju nit komentara u isto vrijeme.

Međutim, prema zadanim postavkama ti novi komentari će se pojaviti ispod dinamički prikazanog gumba s tekstom sličnim "Show 2 New Comments".

Ako su novi komentari odgovori izravno na stranicu, gumb će se prikazati na vrhu nite komentara. Ako su odgovori na određeni komentar, gumb će se prikazati ispod tog komentara.

Ovo je kako bi se spriječilo stalno mijenjanje veličine stranice za korisnika, što bi moglo izazvati frustraciju prilikom pokušaja hvatanja klizača.

Za neke slučajeve upotrebe, poput uživo licitiranja ili online događaja, ovo nije željeno ponašanje - možda želite da widget za komentiranje bude više poput "chat" okvira gdje se novi komentari "prikazuju odmah".

Stoga, naziv zastavice koja omogućuje tu značajku: showLiveRightAway.

Možemo ga uključiti na sljedeći način:

Prikaži komentare uživo odmah

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showLiveRightAway": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Prikaži komentare uživo odmah

Postavka za skrivanje uživo komentara prebačena tako da se novi komentari pojavljuju odmah umjesto iza gumba

Onemogućavanje komentiranja uživo

Prema zadanim postavkama, FastComments će imati omogućeno komentiranje u stvarnom vremenu.

Ovo znači da svaki preglednik niti komentara vidi isti sadržaj.

Na primjer, ako se doda komentar, taj komentar bi se trebao prikazati. Ako se komentar uredi ili ukloni, tada će se ti komentari urediti ili ukloniti za sve preglednike niti. Isto vrijedi za glasove i sve radnje moderacije.

Međutim, možemo to onemogućiti:

Onemogući komentiranje uživo

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableLiveCommenting": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici prilagodbe widgeta, pogledajte odjeljak "Onemogući komentiranje uživo".

Onemogući komentiranje uživo

Novi komentari uživo na dnu

Po zadanim postavkama, novi komentari uživo pojavljuju se na vrhu popisa komentara kako se objavljuju u stvarnom vremenu.

Kada je ova opcija omogućena, novi komentari uživo bit će umjesto toga dodavani na dno liste. Ovo utječe na način na koji se komentari prikazuju kada se objavljuju uživo dok korisnici pregledavaju nit komentara.

New Live Comments to Bottom

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "newCommentsToBottom": true
}];
</script>

Kada je ova postavka omogućena:

Novi komentari uživo koje objave drugi korisnici pojavit će se na dnu liste komentara
Korisnici će u stvarnom vremenu vidjeti nove komentare koji se pojavljuju ispod postojećih komentara
Ovo utječe samo na ažuriranja komentara uživo - ne i na inicijalno učitavanje stranice
To može pomoći u održavanju toka čitanja kada korisnici prate raspravu

Imajte na umu da ova postavka utječe samo na mjesto na koje se novi komentari uživo smještaju kada stignu u stvarnom vremenu. Ne utječe na početni redoslijed sortiranja pri učitavanju stranice.

Omogućavanje beskonačnog pomicanja

Po defaultu, FastComments widget će se vertikalno promijeniti veličinu kako bi odgovarao svim vidljivim komentarima. Paginacija se ostvaruje putem gumba "View Next" na kraju trenutne stranice, budući da smo ustanovili da je to interakcija koja većini korisnika najviše odgovara.

Međutim, postoje slučajevi u kojima je poželjno beskonačno pomicanje. Na primjer, ovu značajku koristimo u našem Stream Chat proizvodu.

Možemo sakriti gumbe "View Next" i prebaciti se na beskonačno pomicanje postavljanjem zastavice enableInfiniteScrolling na true:

Enabling Infinite Scrolling

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true
}];
</script>

To također zahtijeva dodavanje prilagođenog CSS-a. Dodajte prilagođeni CSS za selektor .comments kako biste omogućili pomicanje, na primjer:

Omogućavanje beskonačnog pomicanja

Copy

Run

.comments {
    max-height: 500px;
    overflow-y: auto;
}

Potpuni radni primjer bio bi:

Enabling Infinite Scrolling

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true,
    "customCSS": ".comments { max-height: 500px;  overflow-y: auto; }"
}];
</script>

U gornjem primjeru koristimo svojstvo customCSS, međutim preporučuje se korištenje Widget Configuration UI umjesto toga iz razloga izvedbe. Pogledajte dokumentaciju o prilagođenom CSS-u.

Promjena zadanog smjera sortiranja

Prema zadanim postavkama, FastComments će sortirati komentare prema smjeru sortiranja "Najrelevantnije".

Sortiranje Najrelevantnije uzima u obzir vrijeme kada je komentar ostavljen i broj glasova za sortiranje.

Korisnik tada može promijeniti smjer sortiranja na Najstarije ili Najnovije prvo u korisničkom sučelju widgeta za komentare.

Međutim, zadanu vrijednost možemo promijeniti na bilo koju od tri. Na primjer, ako želite prikazati najstarije komentare prvi:

Promjena zadane vrste sortiranja na najstarije prvo

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "OF"
}];
</script>

Postavili smo vrijednost defaultSortDirection na "OF" kako bismo postavili smjer na "OF".

Za smjer sortiranja najnovije prvo, učinili bismo sljedeće:

Promjena zadane vrste sortiranja na najnovije prvo

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "NF"
}];
</script>

Valjane vrijednosti za defaultSortDirection su:

MR: "Najnovije"
NF: "Najnovije prvo"
OF: "Najstarije prvo"

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak "Default Sort Direction".

Promjena zadane vrste sortiranja

Odabir Default Sort Direction koji nudi Najrelevantnije, Najnovije prvo i Najstarije prvo

Napomena: komentari na svakoj stranici za svaki smjer sortiranja su unaprijed izračunati, pa svi smjerovi sortiranja imaju istu izvedbu.

Prikaz svih komentara odjednom - onemogući paginaciju

Da biste onemogućili paginaciju i prikazali sve komentare odjednom, postavite startingPage na -1.

Render All Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": -1
}];
</script>

Premještanje polja za odgovor nakon komentara

Prema zadanim postavkama, područje za unos komentara je prije niti komentara. Međutim, postavljanjem ovog parametra konfiguracije na true možemo ga premjestiti nakon.

Moving The Reply Box to The Bottom

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "inputAfterComments": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Premještanje okvira za odgovor na dno

Opcija na stranici za prilagodbu widgeta koja postavlja područje za unos komentara nakon niti komentara umjesto prije

Ograničavanje duljine komentara

Maksimalni broj znakova koji se smiju unijeti u polje za unos komentara može se ograničiti parametrom maxCommentCharacterLength.

Zadana vrijednost je 2000.

Stvari poput URL-ova slika nisu uključene u određivanje duljine.

Ograničenje duljine komentara

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxCommentCharacterLength": 500
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Ograničenje duljine komentara

Polje za maksimalnu veličinu komentara na stranici za prilagodbu widgeta, koje se koristi za ograničavanje broja znakova koje komentar može sadržavati

Onemogućavanje višerednog komentiranja

Prema zadanim postavkama, FastComments će dopustiti korisniku da unese komentar s onoliko redaka koliko želi, do zadnog ograničenja znakova.

Međutim, možda je poželjno ograničiti korisnika da unese samo jedan redak teksta. Neki primjeri upotrebe uključuju online licitiranje ili live chat, za koje se FastComments može koristiti.

Omogućavamo zastavicu useSingleLineCommentInput na sljedeći način:

Enable Single-Line Comment Input

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useSingleLineCommentInput": true
}];
</script>

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak "Enable Single-Line Comment Input" sekciju.

Omogući unos jednorednog komentara

Potvrdni okvir za unos jednorednog komentara uključen na stranici za prilagodbu widgeta, ograničavajući unos na jedan redak

Napomena: komentari na svakoj stranici za svaki smjer sortiranja su unaprijed izračunati, pa svi smjerovi sortiranja imaju istu izvedbu.

Ograničavanje broja komentara po korisniku

Prema zadanim postavkama, svaki korisnik može poslati najviše 5 komentara u istoj minuti.

Ovo se prati prema ID-u korisnika, anonimnom ID-u korisnika i IP adresi (hashirana).

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Ograničavanje volumena komentara po korisniku

Polje maksimalnog broja komentara po minuti na stranici za prilagodbu widgeta, zadano na 5.

Napomena da ako koristite API za stvaranje komentara, možda ćete htjeti proslijediti originalnu ip adresu korisnika u zahtjevu našem backendu kako bi se ograničavanje brzine primijenilo po korisniku i ne globalno na vaš račun.

Spriječi nove komentare na najvišoj razini

Postavljanje noNewRootComments na true uzrokovat će da widget sakrije područje za odgovaranje na najvišoj razini, ali će i dalje dopustiti korisnicima da odgovaraju na podkomentare. Možete, na primjer, postaviti ovo uvjetno pri učitavanju stranice kako biste samo nekim korisnicima omogućili ostavljanje komentara na najvišoj razini.

Prevent New Root Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noNewRootComments": true
}];
</script>

Maksimalna dubina odgovora

Prema zadanim postavkama, FastComments dopušta neograničeno ugnježđivanje odgovora, stvarajući strukturu niti u kojoj korisnici mogu neograničeno odgovarati jedni na druge.

Opcija maxReplyDepth omogućuje vam ograničavanje koliko duboko niti odgovora mogu ići. Kada se postigne maksimalna dubina, korisnici više neće vidjeti gumb za odgovor na komentarima na toj razini.

Limiting Reply Depth to 2 Levels

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxReplyDepth": 2
}];
</script>

With maxReplyDepth set to 2:

Korisnici mogu komentirati na najvišoj razini (dubina 0)
Korisnici mogu odgovarati na komentare na najvišoj razini (dubina 1)
Korisnici mogu odgovarati na te odgovore (dubina 2)
Nisu dopušteni daljnji odgovori iznad dubine 2

Postavljanje na 1 dopuštalo bi samo odgovore na komentare na najvišoj razini, stvarajući plitkiju strukturu rasprave.

Postavljanje maxReplyDepth na 0 onemogućilo bi sve odgovore, dopuštajući samo komentare na najvišoj razini. Ako nije navedeno, odgovori se mogu ugnježđivati bez ograničenja.

Zahtijevaj prihvaćanje uvjeta korištenja

FastComments omogućuje da od prvog komentatora zahtijevate prihvaćanje vaših Terms of Service prije slanja komentara.

When enabled:

Anonymous users će vidjeti TOS potvrdni okvir svaki put kad komentiraju
Authenticated users će vidjeti potvrdni okvir samo na svom prvom komentaru, ili kada ažurirate svoje Terms of Service

Configuration

Idite na stranicu prilagodbe widgeta i omogućite potvrdni okvir "Require Terms of Service acceptance". Nakon što je omogućeno, vidjet ćete sljedeće opcije:

Opcije Uvjeta pružanja usluge

Panel Uvjeta pružanja usluge koji prikazuje odabir načina teksta TOS-a i polje datuma posljednjeg ažuriranja

TOS Text Mode: Po zadanom, potvrdni okvir prikazuje "I agree to the Terms of Service and Privacy Policy" s poveznicama na oba dokumenta. Odaberite "Customize text per locale" kako biste pružili vlastiti tekst za svaki jezik.
TOS Last Updated Date: Kada ažurirate svoje Terms of Service, postavite ovaj datum. Korisnici koji su prihvatili prije tog datuma morat će ponovno prihvatiti.

How It Works

Vremenska oznaka prihvaćanja TOS-a pohranjuje se po korisniku i po komentaru
Kada korisnik prihvati TOS, datum se bilježi u njegovom korisničkom profilu (per-tenant)
Ako postavite datum "Last Updated" koji je nakon datuma prihvaćanja korisnika, morat će ponovno prihvatiti
Za anonimne korisnike koji se ne mogu pratiti, potvrdni okvir se pojavljuje pri svakom slanju komentara

Pregled Single Sign-On (SSO)

SSO, odnosno prijava jednom (single-sign-on), je skup konvencija koje omogućuju vama ili vašim korisnicima korištenje FastComments bez potrebe za stvaranjem dodatnog računa.

Pod pretpostavkom da ne dopuštate anonimno komentiranje, račun je potreban za komentiranje putem FastComments. Pojednostavljujemo proces prijave — korisnik jednostavno ostavi svoj email kad komentira. Međutim, razumijemo da i to može predstavljati dodatnu prepreku koju neki sajtovi žele izbjeći.

Tu trenutačno možemo smanjiti tu zapreku tako da postoji samo jedan tok prijave za cijeli vaš sajt.

Kako dobijem pristup?

Sve vrste računa trenutno dobivaju pristup SSO-u. Međutim, maksimalan broj SSO korisnika razlikovat će se ovisno o vašem paketu. Kao i kod drugih značajki, Pro planovi i viši nude izravnu razvojnu podršku.

Usporedimo opcije, a zatim ćemo ući u detalje svake od njih.

Migracije korisnika i komentara

Prilikom migracije s platforme koja koristi SSO, kao što je Disqus, već ćete imati korisnike i njihove komentare.

Komentari se uvoze kao dio vaše migracije, bilo putem API-ja, našeg Import UI-a ili korisničke podrške. Import UI je poželjan ako podržava platformu s koje migrirate, jer uključuje obradu pogrešaka, izdvajanje i učitavanje avatara i medija te sustav za praćenje batch poslova.

Korisnici se dodaju automatski pri prvom otvaranju niti komentara. Alternativno, mogu se prethodno dodati putem API-ja, ali taj postupak nema mnogo prednosti.

Ako su komentari uvezeni, a SSO korisnici nisu ručno dodani putem API-ja, komentari će se automatski premjestiti na račun korisnika prvi put kada se on kreira pri pregledavanju bilo koje niti komentara. Tada će moći uređivati i brisati komentare koje su izvorno napisali.

Automatska migracija vrši se putem emaila ili username-a. Neke platforme ne daju emailove pri eksportu, poput Disqus-a, pa u tom slučaju koristimo username.

Sve dok pošaljete odgovarajući username i email u SSO payloadu, mi ćemo dodati email na pojedinačne objekte komentara kako bi obavijesti i spominjanja radili.

Ako želite uvesti komentare i korisnike odjednom, surađujte s podrškom kako bi komentari bili migrirani na odgovarajuće korisničke račune nakon što su korisnici uvezeni putem API-ja.

Dakle, za sažetak, najlakši put za migraciju je:

Uvezite komentare.
1. Avatari i drugi mediji se migriraju automatski ako koristite Import UI u Manage Data -> Imports.
Postavite Secure ili Simple SSO.
Dopustite da migracija nastupi po korisniku automatski kad se prvi put prijave.
1. To obično dodaje manje od sekunde na vrijeme učitavanja stranice ako korisnik ima manje od 50k komentara.

Korisnici WordPress-a

Ako koristite naš WordPress dodatak, nema potrebe pisati kod! Jednostavno idite na administratorsku stranicu dodatka, kliknite SSO Settings, a zatim Enable.

To će vas odvesti na čarobnjak s jednom tipkom koji će kreirati vaš API ključ, poslati ga na vašu WordPress instalaciju i uključiti SSO. Ovo smo objedili u jedan klik za vas.

Imajte na umu da ako instalirate dodatak prvi put, morat ćete dovršiti proces postavljanja prije nego što vidite administratorsku stranicu s gumbom SSO Settings.

WordPress SSO - Moderatori

Imajte na umu da se trenutno za prikaz značke "Moderator" pored vaših moderatora kada komentiraju putem FastComments WordPress dodatka, moraju također dodati kao Moderator u FastComments nadzornoj ploči i imati verificiran email.

Prilagođene integracije

Za prilagođene integracije postoje dvije opcije.

Opcija jedna - Secure SSO

Sa Secure SSO-om, FastComments zna da je korisnik koji komentira, glasa i čita komentare stvarni korisnik na vašem sajtu.

Sve dok kreirate valjan payload, korisnik će uvijek imati besprijekorno iskustvo komentiranja.

Sa Secure SSO-om, SSO payload se kreira server-side koristeći HMAC authentication i zatim se prosljeđuje widgetu na client strani.

Sa Secure SSO-om, korisnički račun je potpuno odvojen od ostatka FastComments baze korisnika. To znači da ako imamo dva partnera Company A i Company B, svaki može imati SSO korisnika s username-om "Bob".

Zahtjevi

Osnovno znanje o backend razvoju.
Osnovno znanje o radu s tajnim API ključevima.
Osnovno znanje o razvoju API-ja ili server-side renderiranju.

Prednosti

Sigurno.
Besprijekorno iskustvo komentiranja.

Nedostaci

Zahtijeva razvoj na backend-u.

Ažuriranje podataka korisnika

Sa Secure SSO-om, svaki put kada pošaljete sso user payload, mi ćemo ažurirati njihov korisnički račun s najnovijim informacijama. Na primjer, ako korisnik ima username X, i vi pošaljete Y u SSO payloadu, njihov username će postati Y.

Ako želite ukloniti vrijednosti koristeći ovaj pristup, postavite ih na null (ne undefined).

Secure SSO API

Također pružamo API za interakciju sa SSO korisnicima. Pogledajte the docs.

Imajte na umu da se pri korištenju Secure SSO-a korisnici automatski kreiraju u pozadini pri učitavanju stranice. Ne morate masovno uvoziti svoje korisnike.

Opcija dva - Simple SSO

Alternativa Secure SSO-u je jednostavno proslijediti korisničke informacije widgetu za komentiranje.

Nije obavezno proslijediti email s Simple SSO-om, međutim bez njega njihovi komentari će se prikazivati kao "Unverified".

^Note! Od početka 2022. username-i kod Simple SSO-a ne moraju biti jedinstveni preko cijelog FastComments.com.

Idealno, Simple SSO bi se trebao odabrati samo pri razvoju na platformi koja ne omogućuje pristup backend-u.

Zahtjevi

Osnovno znanje o razvoju na strani klijenta.
Morate poznavati barem email korisnika.

Prednosti

Jednostavno.
Sva aktivnost se i dalje verificira.
Korisnik nikad ne unosi svoj username ili email.

Nedostaci

Manje sigurno od Secure SSO-a jer payload na strani klijenta može biti konstruiran da postane bilo koji korisnik.

Simple SSO API

Korisnici automatski kreirani putem Simple SSO toka pohranjuju se kao SSOUser objekti. Do njih se može pristupiti i upravljati putem SSOUser API-ja. Pogledajte the docs.

Prilagođene integracije - Siguran Single Sign-On (SSO)

FastComments Secure SSO koristi HMAC‑SHA256 enkripciju kao mehanizam za implementaciju SSO. Prvo ćemo pregledati cjelokupnu arhitekturu, pružiti primjere i detaljne korake.

Postoji i dokumentacija o migraciji s drugih pružatelja koji imaju slične SSO mehanizme, te o razlikama.

Tok izgleda ovako:

Siguran SSO tok

Budući da Secure SSO uključuje full‑stack razvoj, potpuni radni primjeri koda u Java/Spring, NodeJS/Express i vanilla PHP trenutno su na GitHubu.

Iako koristimo ExpressJS u NodeJS primjeru i Spring u Java primjeru, nema potreba za frameworkovima/bibliotekama u tim runtime‑ovima za implementaciju FastComments SSO – rade nativni crypto paketi.

Ne morate pisati nove API endpointove s FastComments SSO. Jednostavno šifrirajte informacije korisnika koristeći svoj tajni ključ i proslijedite payload widgetu za komentare.

Preuzmite svoj API tajni ključ

Vaš API tajni ključ možete preuzeti s ove stranice. Također ovu stranicu možete pronaći odlaskom na Moj račun, klikom na pločicu API/SSO, a zatim klikom na „Preuzmi API tajni ključ“.

Parametri widgeta za komentare

Visokorazinska API dokumentacija za widget za komentare može se naći ovdje.

Idemo detaljnije u značenje ovih parametara.

Widget za komentare prima objekt konfiguracije – već ga prosljeđujete ako koristite FastComments za prosljeđivanje ID‑a vašeg kupca (zvanog tenantId).

Za omogućavanje SSO, proslijedite novi „sso“ objekt, koji mora sadržavati sljedeće parametre. Vrijednosti bi trebale biti generirane na serveru.

userDataJSONBase64: Podaci korisnika u JSON formatu, koji se zatim kodiraju u Base64.
verificationHash: HMAC‑SHA256 hash kreiran iz UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch vremenski žig, u milisekundama. Ne smije biti u budućnosti, niti stariji od dva dana.
loginURL: URL koji widget za komentare može prikazati za prijavu korisnika.
logoutURL: URL koji widget za komentare može prikazati za odjavu korisnika.
loginCallback: Kada se navede umjesto login URL‑a, funkcija koju će widget za komentare pozvati pri kliku na gumb za prijavu.
logoutCallback: Kada se navede umjesto logout URL‑a, funkcija koju će widget za komentare pozvati pri kliku na gumb za odjavu.

Siguran SSO klijentski kod

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "sso": {
        "userDataJSONBase64": "...",
        "verificationHash": "...",
        "timestamp": 1787115342859.0,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "loginCallback": null,
        "logoutCallback": null
    }
}];
</script>

Objekt korisnika

Copy

interface SSOUser {
    /** Obavezno. Najviše 1k znakova. **/
    id: string;
    /** Obavezno. Najviše 1k znakova. Napomena: Mora biti jedinstveno. **/
    email: string;
    /** Obavezno. Najviše 1k znakova. Napomena: Korisničko ime ne smije biti email. Ne mora biti jedinstveno. **/
    username: string;
    /** Opcionalno. Najviše 3k znakova za URL-ove. Zadano je iz gravatara na temelju emaila. Podržava 64‑kodirane slike, u tom slučaju limit je 50k znakova. **/ 
    avatar?: string;
    /** Opcionalno. Zadano false. **/
    optedInNotifications?: boolean;
    /** Opcionalno. Zadano false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Opcionalno. Najviše 100 znakova. Ova oznaka će se prikazati uz njihovo ime. Zadano je Administrator/Moderator kada je primjenjivo. **/
    displayLabel?: string;
    /** Opcionalno. Najviše 500 znakova. Ovo će se prikazati umjesto korisničkog imena. **/
    displayName?: string;
    /** Opcionalno. Najviše 2k znakova. Ime korisnika će biti poveznica na ovo. **/
    websiteUrl?: string;
    /** Opcionalno. Do 100 grupa po korisniku. ID grupe ne smije biti duži od 50 znakova. **/
    groupIds?: string[];
    /** Opcionalno. Označava korisnika kao administratora. **/
    isAdmin?: boolean;
    /** Opcionalno. Označava korisnika kao moderatora. **/
    isModerator?: boolean;
    /** Opcionalno, zadano true. Postavite na false da omogućite karticu "aktivnost" u korisničkom profilu. **/
    isProfileActivityPrivate?: boolean;
    /** Opcionalno, zadano false. Postavite na true da onemogućite komentare u profilu. **/
    isProfileCommentsPrivate?: boolean;
    /** Opcionalno, zadano false. Postavite na true da onemogućite izravno slanje poruka ovom korisniku. **/
    isProfileDMDisabled?: boolean;
    /** Opcionalna konfiguracija za značke korisnika. **/
    badgeConfig?: {
        /** Niz globalnih ID‑ova znački za dodjelu. Ograničeno na 30 znački. Redoslijed se poštuje. **/
        badgeIds: string[];
        /** Niz ID‑ova znački ograničenih na trenutnu stranicu (urlId). Prikazuje se samo na dodijeljenoj stranici. **/
        pageBadgeIds?: string[];
        /** Ako je true, zamjenjuje postojeće prikazane značke. Globalne i na stranici ograničene značke zamjenjuju se neovisno. **/
        override?: boolean;
        /** Ako je true, ažurira svojstva prikaza znački iz konfiguracije najmodavca. **/
        update?: boolean;
    };
}

Moderatori i administratori

Za administratore i moderatore, proslijedite odgovarajuće isAdmin ili isModerator zastavice u objektu SSOUser.

Obavijesti

Za omogućavanje ili onemogućavanje obavijesti, postavite vrijednost optedInNotifications na true ili false prema potrebi. Prvi put kada korisnik učita stranicu s ovom vrijednošću u SSO payloadu, njegove postavke obavijesti bit će ažurirane.

Dodatno, ako želite da korisnici primaju email obavijesti o aktivnostima na stranicama na koje su pretplaćeni (umjesto samo obavijesti u aplikaciji), postavite optedInSubscriptionNotifications na true.

VIP korisnici i posebne oznake

Možete prikazati posebnu oznaku uz ime korisnika koristeći opcionalno polje "displayLabel".

Neprijavljeni korisnici

Za predstavljanje neautentificiranog korisnika, jednostavno ne popunite userDataJSONBase64, verificationHash ili timestamp. Dostavite loginURL.

Ti korisnici neće moći komentirati, već će im se prikazati poruka za prijavu (poruka, poveznica ili gumb, ovisno o konfiguraciji).

Izravni primjeri za serijalizaciju i hashiranje podataka korisnika

Više detalja i primjeri ovdje (js), ovdje (java) i ovdje (php).

Razumijemo da svaka integracija može biti kompliciran i naporan proces. Ne oklijevajte kontaktirati svog predstavnika ili koristiti stranicu za podršku.

Prilagođene integracije - Jednostavan Single Sign-On (SSO)

Uz Simple SSO možemo pružiti widgetu za komentiranje informacije o korisniku kako ne bi morali unositi svoje korisničko ime ili e‑mail za komentiranje.

Simple SSO možemo konfigurirati na sljedeći način:

Jednostavni SSO

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "simpleSSO": {
        "username": "Bob",
        "email": "bob@example.com",
        "avatar": "https://example.com/bob.png",
        "websiteUrl": "https://example.com/profiles/bob",
        "displayName": "Bob's Name",
        "displayLabel": "VIP User",
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "badgeConfig": {
            "badgeIds": [
                "badge-id-1",
                "badge-id-2"
            ],
            "pageBadgeIds": [
                "badge-id-3"
            ],
            "override": false
        }
    }
}];
</script>

Korisnik će biti prijavljen i u pozadini će se stvoriti SSO korisnik. Korisnik će imati createdFromSimpleSSO postavljeno na true ako je dohvaćen putem API‑ja.

Napomene:

E‑mail je jedinstveni identifikator za Simple SSO.
Navođenje e‑maila uz Simple SSO nije obavezno, međutim prema zadanim postavkama njihovi će komentari biti prikazani kao "Unverified". Ako nije naveden e‑mail, korisnik se ne može potpuno autentificirati.
NOVO Od siječnja 2022.: Korisnička imena ne moraju biti jedinstvena na cijelom fastcomments.com
Simple SSO može automatski stvoriti i ažurirati SSO korisnike, ako je e‑mail naveden i korisnik nije izvorno stvoren putem Secure SSO.
Možete odrediti značke za korisnika pomoću svojstva badgeConfig. Polje badgeIds sadrži ID‑ove globalnih znački koje se povezuju s korisnikom. Polje pageBadgeIds sadrži ID‑ove znački ograničenih na trenutnu stranicu (urlId) — ove značke se prikazuju samo na stranici na kojoj su dodijeljene. Ako je override postavljeno na true, zamijenit će postojeće prikazane značke (globalne i na stranici ograničene značke zamjenjuju se neovisno); ako je false, dodati će se uz postojeće značke.

Prilagođene integracije - Migracija s Disqus SSO

Najveće razlike između Disqus i FastComments Secure SSO su u tome što Disqus koristi SHA1 za enkripciju, dok mi koristimo SHA256. To znači da je migracija s Disqus-a jednostavna - promijenite algoritam hashiranja s SHA1 na SHA256 i ažurirajte nazive svojstava koji se prosljeđuju UI-u.

Prilagođene integracije - Migracija s Commento SSO

Commento koristi drastično drugačiji pristup SSO-u - zahtijevaju da imate endpoint koji oni pozivaju kako bi autentificirali korisnika.

FastComments je obrnuto - jednostavno kodirajte i hashirajte informacije o korisniku koristeći vaš tajni ključ i proslijedite ih dalje.

Zaštita niti komentara pomoću Single Sign-On

FastComments SSO (detalji ovdje) pruža vašim korisnicima način za komentiranje bez potrebe da se prijave na drugu platformu.

Međutim, to samo po sebi ne osigurava vaše niti komentara, budući da su podaci o komentarima po zadanim postavkama javno dostupni – bilo tko tko može vidjeti stranicu može vidjeti i komentare.

Promjenom postavke možemo ograničiti dohvaćanje komentara osim ako to ne učini administrator ili valjani SSO korisnik.

No-Code Setup

Možemo spriječiti pregledavanje i interakciju s našim nitima komentara, kada je SSO postavljen, stvaranjem pravila prilagodbe.

Pri tome, potražite SSO i naći ćete ovu opciju:

Zahtjev za SSO za prikaz komentara

Omogućite ga i spremite pravilo prilagodbe.

Only Protect a Certain Domain or Page

Zaštiti samo određenu domenu ili stranicu

Da biste zaštitili samo određenu domenu ili stranicu, jednostavno ćemo konfigurirati pravilo prilagodbe da to učini.

Na vrhu sučelja za prilagodbu naći ćete dva polja, Domain i URL ID.

Da biste zaštitili određenu domenu, unesite tu domenu u polje "domain".

Da biste zaštitili određenu stranicu, unesite URL stranice u polje "URL ID". Ako imate prilagođenu integraciju s FastComments, ovdje možete unijeti vrstu ID-a umjesto URL-a.

Security Levels

Razine sigurnosti

Kada zahtijevate SSO, trebate odlučiti želite li Simple SSO ili Secure SSO. Ako odaberete Simple SSO, oba su dopuštena, ali ako odaberete Secure SSO, sadržaj se mora dohvatiti uz Secure SSO payload hashiran vašim API ključem kako bi se mogao pregledati.

Opcija razine sigurnosti pojavit će se kada odaberete "Require SSO To View Comments".

Protection Beyond Reading

Zaštita izvan čitanja

Omogućavanje ove opcije zaštitit će stranicu ili domenu od komentiranja, osim ako korisnik nije prijavljen putem SSO.

Gotchas

Zamke

Korisnici koji su kreirali komentare prije vaše SSO integracije neće moći vidjeti te komentare, osim ako se ne prijave putem vaše SSO integracije.

Dozvoli anonimno komentiranje

Prema zadanim postavkama, FastComments će zahtijevati e‑mail za komentiranje. Ne mora biti valjani e‑mail, ali dok korisnik ne klikne na link koji mu je poslan, njegov komentar će prikazati oznaku „Neprovjeren komentar“.

Međutim, možemo ukloniti zahtjev za e‑mailom. Polje za unos e‑maila i dalje će biti prikazano, ali više neće biti obavezno.

Ovo se može konfigurirati putem UI‑ja za prilagodbu widgeta:

Omogućavanje anonimnih komentara

Opcija anonimnih komentara u UI prilagodbe widgeta, koja čini polje e‑maila opcionalnim

---

Sprječavanje isteka anonimnih komentara

FastComments se može konfigurirati da uklanja neprovjerene komentare nakon željenog broja dana. Ovo pomaže u borbi protiv spama.

Prema zadanim postavkama, ne čini to.

Ovo se može konfigurirati ili onemogućiti putem Postavke moderacije stranice.

Postavke moderacije

Onemogućavanje unosa e-pošte

Kada korisnici komentiraju i nisu prijavljeni, bit će zatraženo da unesu svoju e‑mail adresu.

Ovo će za tog korisnika stvoriti „nepotvrđenu sesiju“, a mi ćemo ih zamoliti da potvrde tu sesiju putem e‑maila.

Za neke web‑stranice ili aplikacije poželjno je da se korisniku ne traži e‑mail adresa prilikom komentiranja ili glasanja.

Omogućavanje anonimnog komentiranja čini polje za unos e‑maila opcionalnim. Međutim, možemo ga potpuno onemogućiti. Prvo omogućite anonimno komentiranje, a zatim će se pojaviti opcija za onemogućavanje polja za unos e‑maila.

Onemogući unos e‑maila

Opcija za potpuno skrivanje polja za e‑mail, prikazana nakon što je anonimno komentiranje omogućeno u sučelju prilagodbe

S ovim postavkama, polja za e‑mail se neće uopće prikazivati u svim našim proizvodima za komentiranje.

Imajte na umu da će, uz ovu konfiguraciju, svi komentari biti nepotvrđeni, osim ako korisnik ne kreira račun i ne prijavi se na https://fastcomments.com.

Možda ćete željeti razmotriti onemogućavanje oznake nepotvrđenog.

Onemogućavanje oznake 'Nepotvrđeno'

Prema zadanim postavkama, FastComments će prikazati oznaku „Neprovjeren komentar” za komentare koji su ostavljeni za korisnika s neprovjerenom sesijom preglednika. Pročitajte više o neprovjerenom komentiranju ovdje.

Onemogući oznaku neprovjerenog komentara

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableUnverifiedLabel": true
}];
</script>

Dodatno, ovu značajku možete koristiti, bez pisanja koda, u sučelju za prilagodbu:

Onemogući oznaku neprovjerenog komentara

Dozvoli anonimno glasanje

Kada korisnici pokušaju glasati o komentaru, a nisu prijavljeni, bit će zatraženo da unesu svoje korisničko ime i e‑mail.

Možemo ukloniti ovaj zahtjev, omogućujući svima da glasaju o komentaru bez ostavljanja ikakvih podataka.

Allow Anonymous Votes

Stranica prilagodbe widgeta s omogućenom opcijom anonimnog glasanja tako da glasanje ne zahtijeva ime ili e‑mail

Postavljanje zadanog korisničkog imena

Kada korisnici komentiraju ili glasaju, a nisu prijavljeni, bit će zatraženo da unesu svoj e‑mail i korisničko ime.

U slučaju anonimnog komentiranja, ponekad je poželjno definirati zadano korisničko ime kako bi se smanjila prepreka prilikom komentiranja. To se može učiniti putem UI‑ja za prilagodbu. Anonimno komentiranje mora biti najprije omogućeno.

Postavljanje zadalog korisničkog imena

Polje zadano korisničko ime koje se pojavljuje u UI‑ju za prilagodbu kada je anonimno komentiranje omogućeno

Povratni pozivi

Sve biblioteke za widget komentara (trenutno Angular, React, Vue) podržavaju callbacks.

Callbacks se navode u objektu konfiguracije, sa istim potpisom za svaku biblioteku.

Podržani callbacks su:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

Točni potpisi mogu se pronaći u TypeScript definicijama.

Evo primjera koji koristi sve povratne pozive:

Primjeri povratnih poziva

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.fcConfigs = [{
        target: '#fastcomments-widget',
        tenantId: 'demo',
        onInit: function () {
            console.log('Library started to fetch comments!');
        },
        onAuthenticationChange: function (eventName, userObj) {
            console.log('User authenticated!', eventName, userObj);
        },
        onRender: function () {
            console.log('Render event happened!');
        },
        commentCountUpdated: function (newCount) {
            console.log('New comment count:', newCount);
        },
        onReplySuccess: function (comment) {
            console.log('New comment saved!', comment);
        },
        onVoteSuccess: function (comment, voteId, direction, status) {
            console.log('New vote saved!', comment, voteId, direction, status);
        },
        onImageClicked: function (src) {
            console.log('Image clicked!', src);
        },
        onOpenProfile: function (userId) {
            console.log('User tried to open profile', userId);
            // return true; // vrati true da spriječi zadano ponašanje (otvaranje fastcomments.com korisničkog profila).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // oponašanje asinhronog ponašanja (pozivanje API-ja itd).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // comments je sortirano prema zadanoj razvrstavanju na stranici koje može biti Najrelevantnije (npr. najviše glasova itd.) ili Najnovije prvo
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    }];
</script>

Ručno definiranje lokaliteta korisnika

Prema zadanim postavkama, FastComments će prikazati widget za komentare u lokalizaciji određenu sustavom i preglednikom korisnika.

Kad korisnik komentira ili se prijavi, ažuriramo njegovu posljednju korištenu lokalizaciju i koristimo je i za slanje e‑mailova.

Ovo utječe na način na koji je widget za komentare preveden za korisnika. Lokalizacija se sastoji od jezika i regije korisnika, pa će podešavanje lokalizacije obično promijeniti jezik koji se koristi za prikaz teksta korisniku.

Putem UI-ja

Ovo se može definirati putem UI-ja za prilagodbu widgeta. Pogledajte opciju "Locale / Language":

Promjena Locale / Language

Padajući izbornik Locale / Language na stranici za prilagodbu widgeta koji se koristi za nadjačavanje otkrivene lokalizacije posjetitelja

Putem koda

Ovo se može nadjačati željenom lokalizacijom.

Ručno definiranje korisnikove lokalizacije

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "locale": "ru_ru"
}];
</script>

Podržani jezici i kodovi lokalizacije

Možete pronaći potpuni popis podržanih jezika i odgovarajućih kodova lokalizacije ovdje.

Napomena o SSO

Ako koristite SSO, možda ćete htjeti proslijediti korisnikovu lokalizaciju u objektu korisnika, kako bi e‑mailovi i ostale stvari bile pravilno lokalizirane za njih.

Ograničavanje dopuštenih jezika

By default, FastComments does not limit languages used to comment.

It may be desirable to limit the languages a community uses.

This can be configured without code, on the widget customization page:

Dopušteni jezici

Selektor dopuštenih jezika na stranici prilagodbe widgeta za ograničavanje koje jezike komentari mogu koristiti

The system will parse their comment and determine its language, and then match it with the allowed list.

If the comment is written in a language that is not allowed, then a localized error message is shown.

Naslovi stranica

Trenutni naslov stranice povezan je s navedenim urlId i spremljen za upotrebu u alatima za moderaciju.

Po zadanom, ovo se dohvaća iz document.title.

Ako želite, svoj naslov stranice možete navesti na sljedeći način:

Specifying The Page Title

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "pageTitle": "Article 42"
}];
</script>

Spriječi nove odgovore i onemogući glasove

Komentiranje se može zaključati tako da se postavljanjem zastavice readonly na true onemogućuje ostavljanje novih komentara ili glasova.

Komentari također neće moći biti uređivani ili izbrisani.

Postavljanje niti komentara na samo čitanje

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "readonly": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta, za cijelu domenu ili stranicu:

Postavljanje niti komentara na samo čitanje

Postavka za sprječavanje novih odgovora na stranici za prilagodbu widgeta, koja zaključava nit za domenu ili stranicu

Ažuriranje!

Od studenog 2022., niti se mogu zaključati ili otključati uživo od strane administratora i moderatora putem izbornika s tri točke iznad područja za odgovor.

Ovo će spriječiti nove komentare, dok će i dalje omogućiti glasanje i omogućiti korisnicima da izbrišu svoje komentare po želji, dok readonly ne dopušta te stvari.

Ovo odgovara polju isClosed u Page API-ju.

Ograničavanje domena poveznica

Prema zadanim postavkama, FastComments omogućuje povezivanje na bilo koju vanjsku stranicu.

Ovo se može ograničiti na željeni popis stranica ili domena. Pokušaj objave veze na stranicu ili domen koji nije u definiranom popisu uzrokovat će prikaz greške korisniku.

Ova validacija vrijedi samo za widget za komentare i API. Uvozi nisu pogođeni.

Ovo se radi bez koda, na stranici za prilagodbu widgeta:

Ograniči domene vanjskih veza

Postavke vanjskih veza s popisom ograničenih domena veza gdje se unose dopuštene stranice

---

Broj komentara i brojanje svih ugniježđenih odgovora

Broj komentara prikazan na vrhu widgeta za komentare može prikazivati ili sve "komentare najviše razine", što znači one odgovore koji su odgovori izravno na stranicu ili članak, ili može biti brojanje svih ugniježđenih komentara.

Po zadanom je ovo true - to je brojanje potonjeg - svih komentara. U starijim verzijama widgeta za komentare zadana vrijednost je false.

Možemo promijeniti ponašanje, tako da bude brojanje svih ugniježđenih komentara postavljanjem zastavice countAll na true.

Counting All Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": true
}];
</script>

Ako želimo da brojanje odražava samo komentare najviše razine, postavimo zastavicu na false.

Counting Top Level Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": false
}];
</script>

Trenutno se ovo ne može prilagoditi bez promjena u kodu.

Omogućavanje poveznica komentatora

Prema zadanim postavkama, FastComments će tražiti od korisnika samo njihov komentar, korisničko ime i e‑mail adresu.

Međutim, u nekim situacijama možda ćete željeti da korisnik ostavi poveznicu na svoj blog ili web stranicu.

Možemo omogućiti prikaz dodatnog polja za unos URL‑a web stranice korisnika postavljanjem zastavice enableCommenterLinks na true:

Omogućavanje veza komentatora

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableCommenterLinks": true
}];
</script>

Kada se navedeni URL unese, korisnički račun će se ažurirati i sve njihove korisničko ime na svim prošlim i budućim komentarima će biti povezano s tim URL‑om.

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta:

Omogućavanje veza komentatora

Stranica prilagodbe widgeta s označenim potvrdnim okvirom za veze komentatora kako bi se dodalo polje za URL web stranice u obrazac za komentar

Grupe za moderiranje

Popis ID-jeva generiranih sa stranice Grupe za moderiranje.

Kada je navedeno, komentari ostavljeni koristeći navedenu konfiguraciju sadržavat će isti skup moderationGroupIds.

Ako Moderator ima jednu ili više Grupe za moderiranje definirane, oni će vidjeti samo komentare na stranici Moderate Comments povezane s njihovim grupama.

Specify Moderation Groups

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "moderationGroupIds": [
        "mxZAhjzdb",
        "FT19nXbqA"
    ]
}];
</script>

ID-ovi grupa za spominjanje

Popis id-ova za korištenje u automatskom dovršavanju @mentions. Korisno kada želite spriječiti označavanje korisnika koji nemaju zajedničke grupe.

Kada je navedeno, u automatskom dovršavanju će biti ponuđeni samo korisnici iz drugih grupa nakon upisivanja znaka @.

Limit Groups for Mentions

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "mentionGroupIds": [
        "yxZAhjzda",
        "QT19nXbqB"
    ]
}];
</script>

Za autentifikaciju, FastComments ovisi o tome da su kolačići treće strane omogućeni u vašem pregledniku. Bez njih, korisnici će uvijek morati ostaviti svoju e‑mail adresu za komentar (osim ako je polje za unos e‑maila skriveno), i njihovi će komentari uvijek biti prikazani kao neprovjereni (prema zadanim postavkama).

Da biste to zaobišli, možete omogućiti zaobilaženje kolačića treće strane.

Kada je ova postavka omogućena, pojavit će se mali skočni prozor koji prikazuje poruku da se korisnik prijavljuje. Ovaj skočni prozor prikazuje se kad god korisnik komunicira s widgetom za komentare; na primjer, ako ostavi komentar.

Ovo možemo učiniti u kodu postavljanjem zastavice enableThirdPartyCookieBypass na true:

Omogućavanje zaobilaženja kolačića treće strane

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableThirdPartyCookieBypass": true
}];
</script>

Ovo također možete postaviti putem sučelja za prilagodbu widgeta, pod Enable Third-Party Cookie Popup:

Omogućavanje zaobilaženja kolačića treće strane

Stranica prilagodbe widgeta s označenim potvrdnim okvirom Omogući skočni prozor kolačića treće strane

Brisanje komentara s odgovorima

By default, users can delete their own comments. Also, deleting their comment automatically deletes all child and transient comments in the thread. This behavior is also live.

You can restrict this in the following ways:

Instead, anonymize the deleted comment (set name and text to [deleted] or a custom value).
Don't allow deleting comments when there are replies. A customizable error message is shown.
Restrict deleting when a comment has replies to only administrators and moderators.

This can be configured via the Comment Thread Deletion section in the Widget Customization UI.

Prilagodite ponašanje brisanja za odgovore

Opcije brisanja niti komentara u UI prilagodbe widgeta za anonimiziranje ili ograničavanje brisanja s odgovorima

Prikaži značke u gornjoj traci

Prema zadanim postavkama, FastComments će prikazivati značke korisnika samo na njihovim komentarima unutar niti komentara.

Međutim, možemo prikazati značke korisnika pored njihovog imena iznad obrasca za komentar omogućavanjem ove značajke na stranici prilagodbe widgeta:

Opcija prikaza znački u gornjoj traci

Potvrdni okvir za prikaz znački u gornjoj traci na stranici prilagodbe widgeta, postavljanje znački pored imena iznad obrasca za komentar

Ovo će prikazati značke korisnika uz njihovo ime u području gornje trake, čineći njihove postignuće i status vidljivijim dok pišu komentar.

Napomena da ova značajka mora biti omogućena u sučelju za prilagodbu widgeta da bi radila. Opcionalno možete postaviti zastavicu showBadgesInTopBar na false u konfiguraciji koda kako biste je selektivno onemogućili čak i kada je uključena na razini poslužitelja:

Onemogući prikaz znački u gornjoj traci

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showBadgesInTopBar": false
}];
</script>

Prikaži popis online korisnika

Prema zadanim postavkama, FastComments ne prikazuje popis korisnika na stranici.

Možete prikazati popis ljudi koji trenutno pregledavaju stranicu, uz widget za komentare. Popis se ažurira u stvarnom vremenu kako se korisnici pridružuju i napuštaju stranicu, te prikazuje njihovo ime, avatar i indikator online statusa.

Postoje tri opcije rasporeda:

1 - Vrh: vodoravni red preklapajućih avatara prikazan iznad komentara.
2 - Lijevo: bočna traka s imenima i online točkicama prikazana s lijeve strane widgeta.
3 - Desno: ista bočna traka prikazana s desne strane widgeta.

Postavite zastavicu usersListLocation da omogućite ovu značajku:

Prikaži popis korisnika s desne strane

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "usersListLocation": 3
}];
</script>

Prema zadanim postavkama popis prikazuje samo korisnike koji su trenutno online. Da biste također uključili osobe koje su u prošlosti komentirale stranicu (ali je trenutno ne pregledavaju), postavite usersListIncludeOffline na true:

Uključi prošle komentatore

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "usersListLocation": 3,
    "usersListIncludeOffline": true
}];
</script>

Prošli komentatori se prikazuju bez zelenog online kruga kako bi bilo jasno tko je trenutno prisutan.

Korisnici s privatnim profilima prikazani su generičkim avatarom i oznakom "Privatni profil" kako bi broj ostao točan, a identiteti ostali neotkriveni.

Ovo se također može konfigurirati bez koda. Na stranici za prilagodbu widgeta, pogledajte opciju "Users List Location". Kada je lokacija postavljena na bilo koju vrijednost osim Off, pojavljuje se potvrdni okvir "Include past commenters" ispod nje.

Postavke popisa korisnika

Lokacija popisa korisnika postavljena na desno, s potvrdnim okvirom 'Uključi prošle komentatore' prikazanim ispod

Nakon 500 aktivnih korisnika, popis može biti za najviše 30 sekundi zastario.

Prethodni vodič Sljedeći vodič

Jezik 🇭🇷 Hrvatski

Osnove

Izgled i dojam

Komentiranje uživo

Paginacija i sortiranje

Polje za odgovor

SSO

Anonimno komentiranje

Ostalo

Prilagodbe i konfiguracija