Prilagođavanja i konfiguracija

Kontekst

Ovde ćete pronaći detaljnu dokumentaciju o svakoj funkciji i podešavanju koje widget za komentare podržava.

Ova dokumentacija će pokriti osnovne pojmove i detaljno obraditi svako područje funkcionalnosti, sa uputstvima i uobičajenim zamkama.

Biće prikazani primeri koda, sa istaknutim relevantnim linijama. Tamo gde je primenljivo biće prikazani snimci ekrana stranica za konfiguraciju.

Primeri koda će koristiti našu vanilla JavaScript biblioteku, međutim opcije konfiguracije koriste tačno ista imena za sve verzije widgeta za komentare (React, Vue, itd.).

Većina podešavanja i funkcija opisanih u ovom vodiču ne zahteva pisanje koda.

Identifikacija vašeg naloga

Možda ćete primetiti da se widget za komentare može koristiti sa Tenant ID-jem "demo", na primer:

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 namenjeno samo za isprobavanje i igranje sa widgetom za komentare. U produkciji biste prosledili svoj Tenant ID, na sledeći način:

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 već možete pronaći primenjen na widgetu za komentare isečak koda na vašem nalogu.

Takođe možete pronaći svoj Tenant ID i upravljati svojim API ključevima na stranici sa API akreditivima.

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

Kako su komentari povezani sa stranicama i člancima

Pri renderovanju niza komentara, ili ostavljanju komentara, FastComments mora da zna 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.

Podrazumevano, ako ne navedete urlId, on će postati URL stranice. Uzećemo trenutni URL stranice i očistiti ga da uklonimo sve uobičajene marketinške parametre ili identifikatore praćenja.

U slučaju integracija trećih strana, poput WordPress-a, naš plugin će obično koristiti identifikator koji predstavlja trenutne informacije koje se gledaju kao URL ID, na primer ID članka/stranice.

Definisanje 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 pozivati u ovom dokumentu je UI za prilagođavanje widgeta.

Ovaj UI se može koristiti za mnoge promene widgeta za komentare bez korišćenja koda.

Kada kreiramo pravilo prilagođavanja, često ćemo želeti da se primeni na sve stranice našeg sajta. Međutim, u nekim slučajevima želimo da prilagodimo widget za komentare na određenoj stranici, bilo da primenimo prilagođeni stil, ili možda učinimo komentare za tu stranicu anonimnim. Takođe, na primer, možete imati da se živi komentari odmah pojavljuju na nekim stranicama, dok su na drugima sakriveni iza dugmeta za obaveštenja.

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

Unos URL ID-a na stranici za prilagođavanje widgeta

Polje URL ID koje se koristi za ograničavanje pravila prilagođavanja na jednu stranicu, ili na šablon kao što je */blog/*

Vrednost u ovom polju treba da se podudara sa parametrom urlId koji se prosleđuje widgetu za komentare. Ako želite da vaše pravilo prilagođavanja bude neutralno prema urlId, ostavite ovo polje prazno ili unesite *.

Od 2023. godine polje URL ID u prilagođavanju widgeta sada takođe prihvata šablone! Na primer, možete imati */blog/* da dodate stil specifičan za vaš blog i */store/* da imate stil specifičan za vašu prodavnicu, sve dok koristite isti domen.

Zamke

Ako vaša stranica ima hash parametre (kao example.com#page-1) - to će podrazumevano postati deo URL ID-a.
Tokom migracija, na primer sa WordPress-a na Gatsby, možda ćete morati da migrirate vrednosti komentara URL ID-a nakon početne migracije. Za to nas kontaktirajte.

Prikazivanje istih komentara na različitim stranicama

Pošto parametar urlId omogućava da definišemo kojoj stranici, odnosno id-u, su komentari vezani, možemo jednostavno postaviti urlId na istu vrednost 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 stil

FastComments je dizajniran da bude prilagodljiv. Sam widget za komentarisanje radi unutar iframe-a iz sigurnosnih razloga, pa da primenite prilagođeni stil morate slediti jedan od dva pristupa.

Prvi, najjednostavniji pristup, i naš preferirani, je da koristite widget customization page.

Na stranici za prilagođavanje widgeta, pogledajte odeljak „Show Advanced Options“, ispod kojeg se nalazi oblast označena kao „Custom CSS“:

Oblast za unos prilagođenog CSS-a

Uređivač prilagođenog CSS-a ispod Show Advanced Options na stranici za prilagođavanje widgeta

Ovaj pristup ima neke prednosti:

Uneti CSS se minifikuje pre nego što se pošalje korisniku, a formatiranje se održava doslednim u UI za uređivanje.
Dobijate sve prednosti UI-ja za prilagođavanje widgeta, na primer lako prilagođavanje widgeta za komentarisanje različito za različite sajtove.
Kada napravimo promene na widgetu za komentarisanje, vaš prilagođeni stil će biti testiran kao deo našeg procesa izdavanja.

Drugi pristup je da navedete parametar customCSS u konfiguraciji widgeta, na sledeći način:

Prosleđ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 prilagođenog CSS-a može biti prosleđeno pre nego što naši serveri odbiju zahtev, zbog veličine zaglavlja.
Morate upravljati prilagođenim CSS-om u vašoj infrastrukturi i sistemu za izgradnju. Ovo može biti i prednost, a ne samo nedostatak.
Postoji dodatni trošak slanja prilagođenog CSS-a preko mreže dva puta u ovom slučaju, jer se mora poslati našim serverima, a zatim nazad u sadržaj iframe-a. Međutim, za većinu veličina opterećenja, to nije primetno.
Uobičajena optimizacija je minifikacija CSS-a kako bi se smanjila njegova veličina preko mreže, ali sa ovim pristupom vi ćete to morati da uradite.
Vaš prilagođeni CSS neće biti testiran kada mi napravimo promene.

Eksterni CSS fajlovi

Možete reći widgetu da preuzme eksterni fajl koristeći @import!

Preporučuje se da @import stavite u pravilo za prilagođavanje. Na ovaj način, ako ikada budemo morali da promenimo widget za komentarisanje, možemo koristiti našu automatizaciju da proverimo vaše podešavanje. Na primer, kreirali biste pravilo za prilagođavanje u UI-ju za prilagođavanje widgeta, kliknuli na Advanced i uneli u Custom CSS:

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

U kodu – nije preporučeno

Takođe možete učitati eksterni CSS fajl putem svojstva customCSS:

Eksterni CSS fajl

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 da bude testiran od strane nas ako to uradite.

Stilizovanje modalnog prozora korisničkog profila

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

Na primer:

CSS za korisnički profil

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 FastComments-u znamo da naši korisnici prilagođavaju widget za komentarisanje. To je po dizajnu – poslednja stvar koju želimo je da naš proizvod izazove nesklad u dizajnu vašeg proizvoda.

Pošto je ovo važan deo našeg proizvoda, imamo pipeline za izgradnju koji nam omogućava da pregledamo promene na widgetu za komentarisanje, po korisniku, pri svakom izdanju.

Ako pronađemo manje probleme, ažuriraćemo vaš nalog kako bismo osigurali da naše izdanje teče glatko. Ako uočimo velike promene koje prekidaju funkcionalnost, to nam omogućava da zaustavimo izdanje.

Prilagođeni fontovi

FastComments je dizajniran da bude prilagodljiv, i font koji koriste naši widgeti nije izuzetak.

Podrazumevano, FastComments koristi system font stack da izgleda što bolje na širokom spektru uređaja.

Da biste definisali sopstvene fontove, pogledajte Custom CSS dokumentaciju.

Tamo ćete pronaći način da definišete prilagođeni CSS, što će vam omogućiti da postavite željene fontove.

Kako definisati font

Da biste prebrisali font, preporučujemo da definišete svoj CSS koristeći selektore .fast-comments, textarea. Na primer:

Primer prilagođenog spoljnog 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

Za korisnike sa Pro ili Enterprise nalozima, white-labeling je dozvoljen. Jednostavno kontaktirajte nas i biće nam drago da pomognemo.

Ako želite samo da uklonite naš logo iz widgeta za komentare, ovo se automatski omogućava na Flex i Pro planovima.

Ovi planovi takođe obezbeđuju istu funkcionalnost za e-poruke poslate sa naše platforme.

Podrška za tamne pozadine (tamni režim)

Podrazumevano, FastComments widget za komentare će automatski detektovati tamni režim na većini sajtova.

Kada se otkrije tamni režim, FastComments će promeniti prikaz sa crnog teksta na belim pozadinama na beli tekst na crnoj pozadini. Slike će se takođe promeniti.

Prilikom učitavanja stranice, widget će pokušati da odredi koliko je tamna pozadina stranice iza widgeta za komentare. Ovo znači da stranica može imati belu pozadinu, ali ako postavite widget za komentare unutar kontejnera sa crnom pozadinom, tamni režim bi i dalje trebalo automatski da bude 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 režim kada to želite. Da biste ga prisilno omogućili, postavite zastavicu hasDarkBackground na true na sledeći način:

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>

Uključivanje/isključivanje tamnog režima

Za sajtove koji omogućavaju prebacivanje tamnog režima nakon početnog učitavanja stranice, ovo je malo složenije.

Prvo, sve aktuelne verzije biblioteke Comment widget (React, Vue) imaju primere prebacivanja tamnog režima u svojim odgovarajućim repozitorijumima.

Za VanillaJS widget, moraćemo da uradimo još nešto. Prvo, FastCommentsUI vraća objekat sa funkcijama "destroy" i "update".

Možemo jednostavno pozvati funkciju update svaki put kada želimo da ažuriramo konfiguraciju komentarskog widgeta, na sledeći način. Ovde je kompletan funkcioni primer prebacivanja tamnog režima sa VanillaJS widgetom.

Kompletan primer prebacivanja tamnog režima

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>

Zamena teksta

Sa FastComments, sav tekst u vidžetu za komentare je prilagodljiv.

Možete prepisati pojedinačni deo teksta, kao što je dugme za slanje, ili sav tekst u celom vidžetu za komentare.

Podrazumevano, tekst u vidžetu za komentare se prevodi prema lokalitetu korisnika. Međutim, možemo prepisati tekst, ako smo sigurni da naša baza korisnika koristi isti lokal/jezik, na primer:

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>

Sve prilagodljive prevode možete pronaći ovde pod karticom "napredne opcije" tab.

Međutim, postoji jednostavniji način, putem UI-ja za prilagođavanje vidžeta. Tamo možemo jednostavno pronaći tekst koji se prikazuje u vidžetu za komentarisanje u EN_US lokalitetu i navesti zamenu.

Prilagođeni tekst

Sva prepisivanja prevoda trenutno utiču na sve lokalitete.

Ovo pokriva tekst samog vidžeta. Da biste preveli komentare koje vaši posetioci pišu, pogledajte Prevod komentara.

Promena podrazumevanog avatara

Kada korisnik prvi put komentariše putem FastComments, pokušaćemo da preuzmemo njegov avatar sa https://gravatar.com/.

Međutim, ako ne pronađemo avatar, ili korisnik nikada ne postavi avatar na svom nalogu, prikazaćemo statičku podrazumevanu sliku avatara.

Da biste naveli svoju statičku sliku avatara, možete koristiti podešavanje defaultAvatarSrc.

Zamijeni podrazumevani 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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte sekciju "Default Avatar".

Prilagođavanje podrazumevanog avatara

Sekcija podrazumevanog avatara na stranici za prilagođavanje widgeta, gde postavljate URL rezervne slike avatara

Napomena: definisanje avatara za određenog korisnika, kao što je slučaj sa SSO, obrađeno je u posebnoj sekciji.

Onemogućavanje avatara

Avatari se mogu potpuno ukloniti iz vidžeta za komentare, čak i ako su korisnici definisali svoj sopstveni 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 prilagođavanje vidžeta:

Skrivanje avatara

Onemogućavanje svih podrazumevanih stilova

Za veće projekte prilagođenog stilizovanja, može biti poželjno započeti sa čistom tablom i uopšte ne koristiti podrazumevani stil.

Sav podrazumevani stil može se ukloniti postavljanjem parametra noStyles na true, na sledeć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 za prilagođavanje widgeta, pod naprednim opcijama:

Onemogućavanje svih podrazumevanih stilova

Povezivanje komentara sa stranicama

Kada se šalju obaveštenja putem e‑pošte, ili se komentari prikazuju u korisničkim interfejsima poput stranice za moderaciju, korisno je omogućiti povezivanje iz komentara na stranicu na kojoj se nalazi.

Ako URL ID nije uvek pravi ID, onda moramo URL sačuvati negde drugo. Za to služi svojstvo "url", definisano na sledeć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 sa identifikatorom, na primer člankom, i zatim povezivanje nazad na konkretnu stranicu, na primer:

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. Podrazumevano, šta god da je trenutni URL stranice, taj URL se čuva uz komentar.

Podrazumevano skupljanje odgovora

Podrazumevano, odgovori na komentare najvišeg nivoa se prikazuju.

Ovo se može konfigurisati tako da korisnik mora da klikne „Show Replies“ na komentarima najvišeg nivoa da bi video podkomentare.

Collapse Replies to 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",
    "collapseReplies": true
}];
</script>

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta:

Sakrij odgovore

Opcija za sakrivanje odgovora u UI za prilagođavanje widgeta, sakriva podkomentare iza linka Show Replies

Ovo podešavanje neće uticati na broj početno učitanih komentara najvišeg nivoa. Ako imate jedan komentar najvišeg nivoa i 29 podkomentara, uz ovo podešavanje ćete:

Videti komentar najvišeg nivoa.
Videti „Show Replies (29)“ ispod tog komentara.

Ako želite da prikažete sve komentare najvišeg nivoa u kombinaciji sa ovom opcijom, postavite početnu stranicu na -1.

Omogući WYSIWYG

Podrazumevano, funkcionalnosti formatiranja u FastComments se ostvaruju dodavanjem vidljivih anchor tagova poput <b></b> oko vašeg teksta. Klikom na alatnu traku ili korišćenjem prečica se to radi za vas. Međutim, neke zajednice mogu želeti da koriste formatiranje bez anchor tagova. Ovo se naziva omogućavanje WYSIWYG (what you see is what you get) uređivača. Ovaj uređivač izgleda identično podrazumevanom, osim što učitava dodatni kod koji omogućava korisnicima da podebljaju, podvlače, itd. svoj tekst bez vidljivih anchor tagova.

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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte opciju "Enable Advanced Formatting" opciju.

Omogući WYSIWYG

Stranica za prilagođavanje widgeta sa čekiranim poljem Omogući napredno formatiranje za uključivanje WYSIWYG uređivača

Po defaultu, FastComments prikazuje alatnu traku prilikom pisanja komentara kako bi obezbedio prečice za dekorisanje teksta i otpremanje slika.

Ova alatna traka može biti onemogućena u kodu ili putem UI‑a za prilagođavanje.

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte opciju „Disable The Reply Toolbar“.

Onemogućavanje alatne trake

Stranica za prilagođavanje widgeta sa čekiranim poljem Disable The Reply Toolbar da bi se uklonile prečice za formatiranje

Onemogućavanje blokiranja

Podrazumevano, FastComments omogućava korisnicima da blokiraju druge korisnike. Blokiranje korisnika će uzrokovati da se njihovi komentari maskiraju, sprečava obaveštenja između korisnika i slično.

Možda će biti poželjno onemogućiti ovu funkcionalnost. To se može uraditi na sledeć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đe može uraditi bez koda, što takođe omogućava pravilnu validaciju na serveru, putem UI‑a za prilagođavanje widgeta:

Onemogući blokiranje

Opcija za onemogućavanje blokiranja u UI‑u prilagođavanja widgeta, koja sprečava korisnike da blokiraju jedni druge

Određivanje koju stranicu prikazati

Prilikom preuzimanja i renderovanja komentara, widget za komentare mora znati od koje stranice da počne. Podrazumevano, počinje sa prvom stranicom i prikazuje samo tu stranicu.

Ako želite, tačnu stranicu koja će se renderovati možete proslediti widgetu za komentare kao podešavanje 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 gornji primer prikazuje drugu stranicu.

Promena niti komentara bez ponovnog učitavanja stranice

Objasnili smo kako je urlId identifikator stranice ili članka na koji su komentari vezani.

Takođe, da rezimiramo, ako nije definisan, urlId će podrazumevano biti URL trenutne stranice.

Šta je sa SPA-ima, odnosno Single-Page-Applications, gde se stranica ili sadržaj na koji su komentari vezani menja dinamički bez ponovnog učitavanja cele stranice?

Angular, React, Vue, i dr.

Sa našim bibliotekama kao što su Angular i React, jednostavno ažuriranje urlId svojstva prosleđenog widgetu prouzrokovaće osvežavanje widgeta za komentare. To možete videti u praksi za React aplikaciju, na primer, ovde.

VanillaJS

Ako koristite VanillaJS biblioteku, to je malo složenije jer nema framework-a poput Angular-a ili React-a koji bi rukovao vezivanjem podataka ili propagacijom stanja.

Kada instancirate VanillaJS widget, on vraća neke funkcije koje se mogu pozvati da ga ažuriraju.

Evo funkcionalnog primera gde menjamo hash stranice i ažuriramo widget za komentare:

Primer promene 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đe ažuriramo url, kako bi obaveštenja mogla da vode nazad na pravu stranicu
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Apsolutni datumi (onemogući čitljive vremenske oznake)

Podrazumevano se koriste lokalizovani relativni datumi. Na primer, pored nedavno ostavljenog komentara možete videti "11 minutes ago".

Mož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 za prilagođavanje widgeta, pod Naprednim opcijama:

Koristi Apsolutne Datume

Napredne opcije na stranici za prilagođavanje widgeta sa uključenim prekidačem apsolutnih datuma

Prikazivanje i apsolutnih i relativnih datuma

Podrazumevano se koriste lokalizovani relativni datumi. Na primer, pored nedavno ostavljenog komentara možete videti „pre 11 minuta“.

Može biti potrebno ili poželjno zadržati ovaj relativni format datuma, ali i prikazati puni datum pored njega, u kom slučaju postavljate 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 za prilagođavanje widgeta, pod naprednim opcijama. Prvo ćete morati da omogućite Apsolutne datume da biste videli ovu opciju u UI‑u.

Koristite i apsolutne i relativne datume

Napredne opcije na stranici za prilagođavanje widgeta sa i apsolutnim datumima i kombinovanom postavkom relativnog datuma omogućenom

Dodavanje teksta u zaglavlje

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

Ovo nazivamo zaglavljem i po podrazumevanju je skriveno.

Specifying Header HTML

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 za prilagođavanje widgeta, u odeljku Napredne opcije:

Definisanje HTML zaglavlja

Oblast naprednih opcija na stranici za prilagođavanje widgeta gde se unosi prilagođeni HTML zaglavlja

Prikazivanje linkova kao teksta

Podrazumevano, FastComments prikazuje linkove ovako: https://exmaple.com - gde URL linka postaje klikabilan HTML anchor tag.

Neki sajtovi možda žele da onemoguće ovo, na primer da obeshrabre prevarante. Ovo omogućavamo postavljanjem Comment HTML Rendering Option na Links as Text.

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje vidžeta, za ceo domen ili stranicu:

Prikaz linkova kao teksta

Comment HTML Rendering Option postavljeno na Links as Text pod Advanced Options u prilagođavanju vidžeta

Uključivanje/isključivanje komentara dugmetom

Po defaultu, FastComments će prikazati polje za unos komentara i nit komentara istovremeno. Da bi uštedeli vertikalni prostor, takođe će sakriti sve druge neophodne polja dok se widget ne interaguje.

Međutim, widget za komentare može biti sakriven iza dugmeta, na primer:

Klikni da prikažeš komentare

Widget za komentare skupljen iza dugmeta koje prikazuje broj komentara dok čitač ne klikne na njega

Dugme koristi različit prevedeni tekst u zavisnosti da li su komentari trenutno prikazani ili ne. Ako su komentari sakriveni, koristi translations.SHOW_COMMENTS_BUTTON_TEXT. Ako su komentari prikazani, koristi translations.HIDE_COMMENTS_BUTTON_TEXT. Prevođenja mogu sadržati tekst [count] koji će biti zamenjen lokalizovanim brojem.

Klikni da prikažeš ili sakriješ komentare

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 dizajnirano da zameni konfiguraciju hideCommentsUnderCountTextFormat.

Broj se ažurira u realnom vremenu zajedno sa nitom komentara. Dugme se ne prikazuje ako nema komentara.

Ovo se može omogućiti bez koda kreiranjem pravila prilagođavanja i omogućavanjem "Klikni da prikažeš komentare":

Omogući Klikni da prikažeš komentare

Polje za potvrdu Klikni da prikažeš komentare označeno u pravilu prilagođavanja na stranici za prilagođavanje widgeta

Prilagođavanje teksta broja komentara

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

Ovo se može zameniti bilo kojim stringom, a vrednost [count] će biti zamenjena vrednošću broja, lokalizovanom 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 prilagođavanje widgeta:

Prilagođavanje teksta broja komentara

Polje za tekst broja komentara na stranici za prilagođavanje widgeta, gde se [count] zamenjuje trenutnim ukupnim brojem

Onemogući preusmeravanje slike

Podrazumevano, FastComments dozvoljava korisnicima da otpremaju slike. Kada korisnik klikne tu sliku, FastComments će, podrazumevano, otvoriti novu karticu da prikaže tu sliku u punoj veličini. Podešavanje ove zastavice na true onemogućava 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 da uhvatite klik na sliku (pogledajte onImageClicked), preporučujemo da se ovo kombinuje sa nekim stilizovanjem kako biste uklonili utisak da je slika klikabilna.

Onemogući automatsko kreiranje hashtagova

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

U nekim slučajevima je poželjno onemogućiti ovu funkciju, ili kontrolisati koje hashtagove je moguće koristiti putem API‑ja.

Da biste to uradili, jednostavno omogućite Disable Automatic #hashtag Creation putem UI‑ja za prilagođavanje widgeta.

Onemogućavanje automatskog kreiranja HashTag‑a

Opcija onemogućavanja automatskog kreiranja #hashtag‑ova omogućena u UI‑ju za prilagođavanje widgeta

Onemogući zvono obaveštenja

Po defaultu, FastComments prikazuje zvono obaveštenja u gornjem desnom uglu oblasti za komentare.

Ovo zvono će postati crveno i prikazati broj obaveštenja koje korisnik ima. Neki primeri obaveštenja su:

Korisnik vam je odgovorio.
Korisnik je odgovorio u temi u kojoj ste komentarisali.
Korisnik je dao glas vašem komentaru.
Korisnik je odgovorio na stranicu na koju ste pretplaćeni.

Zvono obaveštenja takođe pruža mehanizam za pretplatu na celu stranicu.

Međutim, možemo potpuno onemogućiti zvono obaveštenja:

Disable Notification Bell

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 može uraditi i bez koda. Na stranici za prilagođavanje widgeta, pogledajte sekciju „Disable Notification Bell“.

Onemogući zvono obaveštenja

Stranica za prilagođavanje widgeta sa poljem "Disable Notification Bell" označenim

Onemogući profile

Podrazumevano, FastComments će prikazati profil korisnika kada kliknete na njegov avatar.

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

Disable Profiles

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>

To se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Disable Profiles".

Disable Profiles

Onemogući komentare na profilu

Podrazumevano, FastComments će prikazati karticu "Profile Comments" na korisničkim profilima, omogućavajući posetiocima da ostave komentare na nečijem profilu.

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

Disable Profile 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",
    "disableProfileComments": true
}];
</script>

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Disable Profile Comments".

Onemogući komentare na profilu

Onemogući direktne poruke na profilu

Podrazumevano, FastComments prikazuje karticu „Direktne poruke“ na korisničkim profilima, omogućavajući posetiocima da pošalju direktne poruke korisniku.

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

Onemogući direktne poruke na profilu

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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak „Onemogući direktne poruke“.

Onemogući direktne poruke na profilu

Stranica za prilagođavanje widgeta sa označenim poljem za onemogućavanje direktnih poruka kako bi se sakrila kartica poruka na profilu

Onemogući poruku o uspehu

Podrazumevano, FastComments prikazuje poruku o uspehu nakon komentarisanja. Ovo se može onemogućiti na sledeći način:

Onemogući poruku o uspehu

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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta:

Onemogući poruku o uspehu

Promeni ocenu sadržaja GIF-ova

Po defaultu, FastComments widget za komentare će postaviti gif rating na pg.

Raspoložive opcije su g, pg, pg-13 i r.

Ovo se može postaviti u kodu ili putem UI‑a. U kodu to možemo uraditi na sledeći način:

Postavi Gif Rejting

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 naći pod Gif Picker Rating sve dok Disable Image Uploads? nije označena.

Postavljanje Gif Rejtinga

Padajući meni Gif Picker Rating na stranici prilagođavanja widgeta koji nudi g, pg, pg-13 i r

Moderacija sadržaja slika

Podrazumevano, FastComments widget za komentare ima moderaciju sadržaja slika postavljenu na off.

Dostupne opcije su off, low, medium i high.

U UI‑u za prilagođavanje widgeta, ovo ćete naći pod Image Content Moderation Level sve dok opcija Disable Image Uploads? nije označena.

Podešavanje nivoa moderacije sadržaja slika

Padajući meni nivoa moderacije sadržaja slika na stranici za prilagođavanje widgeta postavljen na off, low, medium ili high

Promeni stil glasanja

Podrazumevano, FastComments će prikazati opcije glasanja kao strelice za gore i dole, omogućavajući korisnicima da glasaju gore ili dole za komentar.

Međutim, moguće je promeniti stil trake za glasanje. Trenutne opcije su podrazumevane dugmiće Up/Down, ili korišćenje mehanizma glasanja u obliku srca.

Koristimo zastavicu voteStyle na sledeći način:

Omogući dugme srca

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čujemo da ovo uradite bez koda, jer takođe omogućava server‑side validacije. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Vote Style".

Promeni stil glasanja

Podešavanje stila glasanja na stranici za prilagođavanje widgeta, nudi strelice za gore i dole ili glasanje srcem

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

Onemogući brisanje

Podrazumevano, FastComments će dozvoliti korisnicima da brišu svoje komentare.

Međutim, moguće je sprečiti to.

Na stranici za prilagođavanje widgeta, pogledajte opciju "Disable Deleting".

Onemogući brisanje komentara

Opcija Disable Deleting na stranici za prilagođavanje widgeta, sprečava komentatore da uklone svoje komentare

Ovo utiče samo na obične komentatore i ne na moderatore ili administratore, koji i dalje mogu da brišu.
Ovo će takođe uticati na API integracije kada se prosledi contextUserId.

Onemogući uređivanje

Podrazumevano, FastComments dozvoljava korisnicima da uređuju svoje komentare.

Međutim, moguće je sprečiti ovo.

Na stranici za prilagođavanje vidžeta, pogledajte opciju "Disable Editing".

Onemogući uređivanje komentara

Opcija Disable Editing na stranici za prilagođavanje vidžeta, koja sprečava komentatore da uređuju svoje komentare

Ovo utiče samo na obične komentatore, a ne na moderatore ili administratore, koji i dalje mogu da uređuju.
Ovo takođe utiče na API integracije kada se prosleđuje contextUserId.

Isticanje novih komentara

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

Prvo i najvažnije, podrazumevano komentari koji su pokrenuli in-app obaveštenje (odgovori, odgovori u istoj niti, ili komentari na stranici na koju ste pretplaćeni), biće automatski istaknuti sa avatarom korisnika koji blago svetli. Boja se može prilagoditi putem CSS-a koristeći is-unread klasu.

Komentari postavljeni u poslednja 24 sata imaju primenjenu 24hr klasu koja se može koristiti za stilizovanje.

Na kraju, svi novi komentari u realnom vremenu koji se pojave u korisničkoj sesiji biće istaknuti na nekoliko sekundi putem animacije. Ovo se radi putem is-live CSS klase i takođe se može prilagoditi.

Veličine stranice

Podrazumevano, veličina stranice FastComments-a je 30. Ovo 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: promena veličine stranice zahteva ponovno izračunavanje svih niti komentara u vašem nalogu. Ovo može potrajati nekoliko minuta.

Ovo ne može biti konfigurisano u widgetu na klijentskoj strani jer se stranice izračunavaju na serveru.

Primer konfiguracije je prikazan ispod:

Prilagođene veličine stranica

Selektor veličine stranice na stranici za prilagođavanje widgeta, gde se može izabrati vrednost od 10 do 200

Veličine stranica mogu biti prilagođene globalno, po domenu ili po stranici, kreiranjem različitih pravila prilagođavanja.

Ovo će uticati na sve klijente, integracije i okvire koje koristite za prikazivanje komentara putem naše platforme.

Šabloni e-pošte

Emailovi koje FastComments šalje vašim korisnicima mogu se prilagoditi. Šablon, logika, i prevodi se mogu menjati. Tekst se može prilagoditi po lokalima, a stil može biti promenjen čak i po domenu. Saznajte više o prilagođenim email šablonima ovde.

Formati korisničkih imena

Po defaultu, FastComments prikazuje ime korisnika onako kako je uneto, ili kako je prosleđeno putem SSO.

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

Ovo se može uraditi bez koda u UI‑u za prilagođavanje widgeta, pod podešavanjem pod nazivom Commenter Name Format:

Promeni format imena

Padajući meni Formata imena komentatora otvoren sa izborima kao što su Capitalize, Last Initial i All Initials

Dostupni formati su:

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

Efekat promene je trenutni. Korisnici će i dalje videti svoje puno korisničko ime na vrhu oblasti za komentar, za sebe, ali njihovi komentari će prikazivati izmenjeno korisničko ime.

Korisnička imena se maskiraju na serveru radi zaštite korisnika.

Onemogućavanje otpremanja slika

Po defaultu FastComments dozvoljava otpremanje slika. Ovo se može onemogućiti postavljanjem noImageUploads zastavice na true.

Onemogućavanje otpremanja 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 prilagođavanje widgeta:

Onemogućavanje otpremanja slika

Dozvoli ugrađivanje medija

Podrazumevano FastComments ne dozvoljava iframe‑ove u komentarima. Kada omogućite medijske embedove, komentatori mogu da nalepi kod za embed (the <iframe> snippet) od pouzdanih provajdera kao što su YouTube, Vimeo, SoundCloud i Spotify, i on će se prikazati inline u komentaru.

Iz sigurnosnih razloga, ovo nije konfiguraciona zastavica widgeta na klijentskoj strani. To je podešavanje na serverskoj strani, koje se validira prilikom čuvanja svakog komentara, pa se ne može uključiti sa stranice. Dozvoljeni su samo iframe‑ovi koji ukazuju na ugrađenu listu pouzdanih provajdera. Svaki drugi iframe se uklanja.

Ovo se radi bez koda, na stranici za prilagođavanje widgeta:

Dozvoli medijske embedove

Podešavanje medijskih embedova uključeno na stranici za prilagođavanje widgeta, omogućavajući komentatorima da nalepaju pouzdane iframe embedove

Dodavanje sopstvenih provajdera

Ako želite da dozvolite embedove od provajdera koji nije na ugrađenoj listi pouzdanih, dodajte njegov hostname u polje „Additional Embed Domains“ na istoj stranici. Ovi hostnames su dozvoljeni uz ugrađene provajdere. Poklapanje je tačno, pa uključite kompletan hostname (na primer, player.example.com). Sve što ne navedete ostaje blokirano.

I obična kutija za komentar i WYSIWYG editor podržavaju lepljenje embedova. U WYSIWYG editoru embed se ubacuje kao blok koji se može ukloniti.

Omogući polje za pretragu

Podrazumevano, u vidžetu za komentare se ne prikazuje polje za pretragu.

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

Omogućavanje pretrage

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đe može uraditi bez koda. Na stranici za prilagođavanje vidžeta, pogledajte opciju „Enable Search Box“.

Omogući polje za pretragu

Stranica za prilagođavanje vidžeta sa označenim poljem za potvrdu Enable Search Box kako bi se prikazalo polje za pretragu u vidžetu

Omogući spoiler-e

Možemo omogućiti podršku za spoiler postavljanjem enableSpoilers zastavice 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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte opciju "Enable Spoilers".

Enable Spoilers

Kada se tekst označi, a sada vidljivo dugme SPOILER se klikne, tekst će biti maskiran dok korisnik ne pređe mišem preko njega. Za tamni režim radimo isto, sa različitim bojama koje bolje odgovaraju tamnom režimu.

Ovo je takođe kompatibilno sa WYSIWYG editorom.

Omogući broj pregleda komentara

Podrazumevano, FastComments ne prati ko je pogledao svaki komentar niti pruža bilo kakve statistike u vezi s tim.

Međutim, možemo omogućiti ovu funkciju, i tada će sistem početi da prati kako svaki korisnik skroluje do komentara.

Kada se to desi, broj pored ikone oka prikazane na svakom komentaru će se povećati. Broj se ažurira u realnom vremenu i skraćuje prema lokalnom podešavanju korisnika.

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

Enabling Comment View Counts

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 prilagođavanje widgeta:

Omogućavanje broja pregleda komentara

Stranica za prilagođavanje widgeta sa označenim poljem za prikaz broja pregleda, tako da svaki komentar prikazuje ikonu oka i broj

Pratimo ID korisnika* koji je pogledao komentar tokom jedne nedelje, tako da ako ponovo pogledate komentar u tom periodu, broj se ne povećava. Ako pogledate komentar ponovo nakon što nedelja prođe, broj će se ponovo povećati.

*Napomena: ili anonimni ID sesije, ili IP korisnika kao heširana vrednost.

Prikaži live komentare odmah

Podrazumevano je omogućeno live komentarisanje. To znači da, ako se bilo koji komentar doda, obriše, izmeni ili zakači, promene bi trebalo da se pojave svim korisnicima koji gledaju nit komentara u isto vreme.

Međutim, podrazumevano ti novi komentari će se pojaviti ispod dinamički prikazanog dugmeta sa tekstom sličnim “Show 2 New Comments”.

Ako su novi komentari odgovori direktno na stranicu, dugme će se prikazati na vrhu niti komentara. Ako su odgovori na određeni komentar, dugme će se prikazati ispod tog komentara.

Ovo je da se spreči stalna promena veličine stranice kod korisnika, što može izazvati frustraciju prilikom pokušaja hvatanja klizača.

Za neke slučajeve upotrebe, poput live licitiranja ili online događaja, ovo nije željeno ponašanje – možda želite da vidžet za komentarisanje bude više poput “chat” kutije gde se novi komentari “prikazuju odmah”.

Stoga, ime zastavice koja omogućava tu funkciju: showLiveRightAway.

Možemo je uključiti na sledeći način:

Show Live Comments Right Away

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 prilagođavanje vidžeta:

Prikaži live komentare odmah

Postavka za sakrivanje live komentara je prebačena tako da se novi komentari pojavljuju odmah umesto iza dugmeta

Onemogućavanje live komentarisanja

Podrazumevano, FastComments će imati omogućeno live komentarisanje.

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

Na primer, ako se doda komentar, taj komentar treba da se prikaže. Ako se komentar izmeni ili ukloni, tada će ti komentari biti izmenjeni ili uklonjeni za sve posmatrače niti. Isto važi i za glasove i sve akcije moderacije.

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

Onemogući live komentarisanje

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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak „Onemogući live komentarisanje“.

Onemogući live komentarisanje

Novi live komentari na dno

Podrazumevano, novi komentari uživo pojavljuju se na vrhu liste komentara kako se objavljuju u realnom vremenu.

Kada je ova opcija omogućena, novi komentari uživo će umesto toga biti dodati na dno liste. Ovo utiče na način na koji se komentari pojavljuju kada se objavljuju uživo dok korisnici gledaju 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 pojaviće se na dnu liste komentara
Korisnici će videti kako se novi komentari pojavljuju ispod postojećih komentara u realnom vremenu
Ovo utiče samo na ažuriranja komentara uživo - ne na početno učitavanje stranice
Ovo može pomoći u održavanju toka čitanja kada korisnici prate diskusiju

Imajte na umu da ova postavka utiče samo na mesto gde se novi komentari uživo postavljaju kada stignu u realnom vremenu. Ne utiče na početni redosled sortiranja kada se stranica učitava.

Omogući beskonačno skrolovanje

Po podrazumevanoj vrednosti, FastComments widget će se vertikalno prilagoditi tako da stane sve vidljive komentare. Paginacija se postiže putem dugmeta "Prikaži sledeće" na kraju trenutne stranice, jer smo utvrdili da je to interakcija koja najviše odgovara većini korisnika.

Međutim, postoje slučajevi kada se preferira beskonačno skrolovanje. Na primer, ovu funkciju koristimo u našem proizvodu Stream Chat.

Možemo sakriti dugmad "Prikaži sledeće" i preći na beskonačno skrolovanje podešavanjem 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>

Ovo takođe zahteva dodavanje prilagođenog CSS-a. Dodajte prilagođeni CSS za selektor .comments da omogućite skrolovanje, na primer:

Omogućavanje beskonačnog skrolovanja

Copy

Run

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

Kompletan radni primer bi bio:

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 primeru koristimo svojstvo customCSS, međutim preporučuje se da se umesto toga koristi Widget Configuration UI iz razloga performansi. Pogledajte dokumentaciju o prilagođenom CSS-u.

Promena podrazumevanog pravca sortiranja

Podrazumevano, FastComments sortira komentare po smeru sortiranja „Najrelevantnije“.

Sortiranje po najrelevantnijem uzima u obzir vreme kada je komentar ostavljen i broj glasova za sortiranje.

Korisnik zatim može da promeni smer sortiranja na „Najstarije prvo“ ili „Najnovije prvo“ u UI‑u vidžeta za komentare.

Međutim, podrazumevani smer možemo promeniti na bilo koji od tri. Na primer, ako želite da prikažete najstarije komentare prvo:

Promena podrazumevanog 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>

Postavljamo vrednost defaultSortDirection na „OF“ da bismo postavili smer na „OF“.

Za smer sortiranja „Najnovije prvo“, uradićemo sledeće:

Promena podrazumevanog 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>

Validne vrednosti za defaultSortDirection su:

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

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje vidžeta, pogledajte odeljak „Podrazumevani smer sortiranja“.

Promena podrazumevanog pravca sortiranja

Selektor podrazumevanog pravca sortiranja koji nudi Najrelevantnije, Najnovije prvo i Najstarije prvo

Napomena: komentari na svakoj stranici za svaki smer sortiranja su unapred izračunati, tako da svi smerovi sortiranja imaju istu performansu.

Prikazivanje 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 ispod komentara

Podrazumevano je oblast za unos komentara pre niza komentara. Međutim, postavljanjem ovog parametra konfiguracije na true možemo je pomeriti posle.

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 prilagođavanje widgeta:

Pomicanje polja za odgovor na dno

Opcija na stranici za prilagođavanje widgeta koja postavlja oblast za unos komentara posle niza komentara umesto pre njega

Ograničavanje dužine komentara

Maksimalni broj znakova koji se mogu uneti u polje za unos komentara može biti ograničen parametrima maxCommentCharacterLength.

Podrazumevana vrednost je 2000.

Stvari poput URL‑ova slika nisu uključene u određivanje dužine.

Ograničenje dužine 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 prilagođavanje widgeta:

Ograničenje dužine komentara

Polje za maksimalnu veličinu komentara na stranici za prilagođavanje widgeta, koje se koristi da ograniči koliko znakova komentar može da sadrži

Onemogući višelinijski komentar

Podrazumevano, FastComments omogućava korisniku da unese komentar sa koliko god linija želi, do podrazumevanog ograničenja znakova.

Međutim, može biti poželjno ograničiti korisnika da unese samo jednu liniju teksta. Neki primeri upotrebe uključuju online licitacije ili live chat, za koje se FastComments može koristiti.

Omogućavamo zastavicu useSingleLineCommentInput na sledeć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đe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak „Enable Single-Line Comment Input“.

Omogući unos jedne linije komentara

Polje za unos jedne linije komentara je uključeno na stranici za prilagođavanje widgeta, ograničavajući unos na jednu liniju

Napomena: komentari na svakoj stranici za svaki smer sortiranja su unapred izračunati, tako da svi smerovi sortiranja imaju istu performansu.

Ograniči broj komentara po korisniku

Podrazumevano, svaki korisnik može poslati do 5 comments u istoj minuti.

Ovo se prati po ID‑u korisnika, anonimnom ID‑u korisnika i IP adresi (hashovana).

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta:

Ograničavanje broja komentara po korisniku

Polje maksimalnog broja komentara po minuti na stranici za prilagođavanje widgeta, podrazumevano postavljeno na 5

Napomena: ako koristite API za kreiranje komentara, možda ćete želeti da prosledite originalnu ip adresu korisnika u zahtevu našem backendu kako bi se ograničavanje brzine primenilo po korisniku, a ne globalno na vaš nalog.

Spreči nove komentare na najvišem nivou

Postavljanje noNewRootComments na true će uzrokovati da widget sakrije polje za odgovore na najvišem nivou, ali i dalje dozvoljava korisnicima da odgovaraju na podkomentare. Na primer, možete ovo uslovno postaviti prilikom učitavanja stranice kako biste dozvolili samo nekim korisnicima da ostavljaju komentare najvišeg nivoa.

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

Podrazumevano, FastComments dozvoljava neograničeno ugnježđavanje odgovora, stvarajući strukturu teme gde korisnici mogu beskonačno odgovarati na odgovore.

Opcija maxReplyDepth vam omogućava da ograničite koliko duboko mogu ići nitovi odgovora. Kada se dostigne maksimalna dubina, korisnici više neće videti dugme za odgovor na komentarima na tom nivou.

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>

Kada je maxReplyDepth postavljen na 2:

Korisnici mogu komentarisati na najvišem nivou (dubina 0)
Korisnici mogu odgovarati na komentare na najvišem nivou (dubina 1)
Korisnici mogu odgovarati na te odgovore (dubina 2)
Dalji odgovori nisu dozvoljeni iznad dubine 2

Podešavanje na 1 bi dozvolilo samo odgovore na komentare sa najvišeg nivoa, stvarajući pliću strukturu diskusije.

Postavljanje maxReplyDepth na 0 bi onemogućilo sve odgovore, dozvoljavajući samo komentare na najvišem nivou. Ako nije navedeno, odgovori se mogu ugnježđavati bez ograničenja.

Zahtevaj prihvatanje uslova korišćenja

FastComments vam omogućava da zahtevate od prvi put komentatora da prihvate vaše Uslove korišćenja pre slanja komentara.

Kada je omogućeno:

Anonimni korisnici će videti polje za potvrdu Uslova korišćenja svaki put kada komentarišu
Prijavljeni korisnici će videti polje za potvrdu samo na svom prvom komentaru, ili kada ažurirate svoje Uslove korišćenja

Konfiguracija

Idite na stranicu za prilagođavanje vidžeta i uključite polje za potvrdu "Require Terms of Service acceptance". Kada je omogućeno, videćete sledeće opcije:

Opcije Uslova korišćenja

Panel Uslova korišćenja koji prikazuje izbor režima teksta TOS-a i polje za datum poslednje izmene

TOS Text Mode: Podrazumevano, polje za potvrdu prikazuje "I agree to the Terms of Service and Privacy Policy" sa linkovima ka oba dokumenta. Izaberite "Customize text per locale" da biste obezbedili svoj tekst za svaki jezik.
TOS Last Updated Date: Kada ažurirate svoje Uslove korišćenja, postavite ovaj datum. Korisnici koji su prihvatili pre ovog datuma biće dužni da ponovo prihvate.

Kako funkcioniše

Vremenska oznaka prihvatanja Uslova korišćenja čuva se po korisniku i po komentaru
Kada korisnik prihvati Uslove korišćenja, datum se beleži na njegovom korisničkom profilu (po zakupcu)
Ako postavite datum "Last Updated" koji je nakon datuma prihvatanja korisnika, oni će morati ponovo da prihvate
Za anonimne korisnike koji se ne mogu pratiti, polje za potvrdu se pojavljuje pri svakom slanju komentara

Upozori pre napuštanja sa neslanim komentarom

Podrazumevano, ako korisnik napiše komentar, a zatim osveži stranicu, zatvori tab ili ode negde drugde pre slanja, skica se tiho gubi.

Postavljanje warnOnUnsavedComment na true čini da pregledač pita korisnika da potvrdi pre napuštanja stranice dok bilo koje polje za komentar ili uređivanje u toku još uvek sadrži tekst. Kada se komentar pošalje, tekst se briše, pa se ne prikazuje nijedan prompt.

Warn On Unsaved Comment

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",
    "warnOnUnsavedComment": true
}];
</script>

Prompt koristi sopstveni dijalog pregledača. Moderni pregledači prikazuju sopstveni tekst i ignorišu prilagođeni tekst, tako da se poruka ne može prilagoditi.

Ova opcija učitava mali dodatak po potrebi, tako da ne dodaje ništa widgetu za sajtove koji je ne omoguće.

Omogući ankete

Ankete omogućavaju komentatorima da prikače pitanje sa 2 do 10 opcija uz komentar. Svi na stranici glasaju na mestu i vide kako se rezultati ažuriraju u realnom vremenu.

Ankete su podrazumevano isključene. Označite Enable Polls u podešavanjima prilagođavanja widgeta da biste dodali dugme za anketu u alatnoj traci komentara. Zatim se pojavljuju još dve postavke:

Ko može kreirati ankete: Samo administratori/moderatori (podrazumevano), ili svi.
Dozvoli anonimne glasove u anketi: kada nije označeno (podrazumevano), samo prijavljeni korisnici mogu glasati.

Enable Polls

Stranica prilagođavanja widgeta sa opcijom Omogući ankete označenom

Pogledajte Vodič za ankete za informacije o kreiranju, glasanju, privatnosti i funkcionisanju obaveštenja o anketama.

Pregled Single Sign On (SSO)

SSO, ili single-sign-on, je skup konvencija koje vam ili vašim korisnicima omogućavaju da koristite FastComments bez potrebe za kreiranjem novog naloga.

Pod pretpostavkom da ne dozvoljavate anonimno komentiranje, nalog je potreban za komentiranje putem FastComments. Proces registracije činimo vrlo jednostavnim - korisnik samo ostavlja svoj email prilikom komentiranja. Ipak, razumemo da i to predstavlja dodatnu prepreku koju neke sajtove žele da izbegnu.

Tu prepreku možemo smanjiti tako da postoji samo jedan tok prijave za ceo vaš sajt.

Kako da ga dobijem?

Svi tipovi naloga trenutno imaju pristup SSO-u. Međutim, maksimalan broj SSO korisnika varira u zavisnosti od vašeg paketa. Kao i kod drugih funkcionalnosti, Pro planovi i viši pružaju direktnu razvojnu podršku.

Uporedimo opcije, a zatim uđimo u detalje svake od njih.

Migracija korisnika i komentara

Prilikom migracije sa platforme koja koristi SSO, poput Disqus-a, već ćete imati korisnike i njihove komentare.

Komentari se uvoze kao deo vaše migracije, bilo putem API-ja, našeg Import UI-ja, ili korisničke podrške. Import UI je preferiran ako podržava platformu sa koje se migrirate, jer uključuje rukovanje greškama, ekstrakciju i otpremanje avatara i medija, kao i sistem za praćenje batch poslova.

Sam korisnici se dodaju automatski prilikom prvog pregledanja niti komentara. Alternativno, mogu se unapred dodati putem API-ja, ali taj posao nema mnogo prednosti.

Ako se komentari uvezu, a SSO korisnici nisu ručno dodati putem API-ja, komentari će automatski biti migrirani na nalog korisnika prilikom njegovog prvog kreiranja kada pregleda bilo koju nit komentara. Tada će moći da upravljaju, uređuju i brišu komentare koje su prvobitno napisali.

Automatska migracija se vrši putem email-a ili korisničkog imena. Neke platforme ne pružaju email adrese pri eksportu, poput Disqus-a, pa u tom slučaju koristimo korisničko ime.

Sve dok prosledite odgovarajuće korisničko ime, i email u SSO payload-u, dodaćemo email pojedinačnim objektima komentara kako bi notifikacije i pominjanja radili.

Ako želite da uvezete komentare i korisnike odjednom, sarađujte sa podrškom da se komentari migriraju na odgovarajuće naloge korisnika nakon što se korisnici uvezu putem API-ja.

Dakle, da rezimiramo najlakši put za migraciju:

Uvezite komentare.
1. Avatari i ostali mediji se migriraju automatski ako koristite Import UI u Manage Data -> Imports.
Podesite Secure ili Simple SSO.
Dozvolite da migracija obavi automatski po korisniku kada se prvi put prijavi.
1. Ovo obično dodaje manje od sekunde vremenu učitavanja stranice ako korisnik ima manje od 50k komentara.

WordPress korisnici

Ako koristite naš WordPress plugin, ne morate pisati kod! Jednostavno idite na Admin stranicu plugina, kliknite SSO Settings, a zatim Enable.

Ovo će vas odvesti na čarobnjak sa jednim klikom dugmetom koji će kreirati vaš API ključ, poslati ga na vašu WordPress instalaciju i uključiti SSO. Ovo smo konsolidovali u jedan klik dugmeta za vas.

Imajte na umu da ako instalirate plugin prvi put, moraćete da završite proces podešavanja pre nego što vidite admin stranicu sa dugmetom SSO Settings.

WordPress SSO - Moderatori

Imajte na umu da trenutno, kako bi se "Moderator" bedž prikazao pored vaših moderatora kada komentiraju putem FastComments WordPress plugina, oni takođe moraju biti dodati kao Moderator u FastComments kontrolnoj tabli, i imati verifikovan email.

Prilagođene integracije

Za prilagođene integracije, postoje dve opcije.

Opcija jedan - Secure SSO

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

Sve dok kreirate validan payload, korisnik će uvek imati besprekorno iskustvo komentiranja.

Sa Secure SSO-om, SSO payload se kreira server-side koristeći HMAC autentikaciju, a zatim se prosleđuje vidžetu na klijentu.

Sa Secure SSO-om, nalog korisnika je potpuno odvojen od ostatka FastComments korisničke baze. To znači da ako imamo dva partnera, Kompanija A i Kompanija B, svaka može imati SSO korisnika sa korisničkim imenom "Bob".

Zahtevi

Osnovno znanje o backend razvoju.
Osnovno znanje o radu sa tajnim API ključevima.
Osnovno znanje o API razvoju ili server-side renderovanju.

Prednosti

Bezbedno.
Besprekorno iskustvo komentiranja.

Nedostaci

Zahteva backend razvoj.

Ažuriranje podataka korisnika

Sa Secure SSO-om, svaki put kada prosledite sso user payload, ažuriraćemo njihovog korisnika sa najnovijim informacijama. Na primer, ako korisnik ima korisničko ime X, a vi prosledite Y u SSO payload-u, njihovo korisničko ime će postati Y.

Ako želite da uklonite vrednosti ovim pristupom, postavite ih na null (ne undefined).

Secure SSO API

Takođe pružamo API za interakciju sa SSO korisnicima. Pogledajte dokumentaciju.

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

Opcija dva - Simple SSO

Alternativa Secure SSO-u je jednostavno prosleđivanje informacija o korisniku vidžetu za komentiranje.

Prosleđivanje email-a sa Simple SSO-om nije obavezno, međutim bez toga njihovi komentari će se prikazivati kao "Unverified".

^Napomena! Od početka 2022. korisnička imena sa Simple SSO-om ne moraju biti jedinstvena na celom FastComments.com.

Idealno, Simple SSO bi trebalo birati samo prilikom razvoja na platformi koja ne pruža backend pristup.

Zahtevi

Osnovno znanje o client-side razvoju.
Potrebno je znati barem email korisnika.

Prednosti

Jednostavno.
Sva aktivnost se i dalje verifikuje.
Korisnik nikada ne unosi svoje korisničko ime ili email.

Nedostaci

Manje bezbedno od Secure SSO-a jer client-side payload može biti falsifikovan da postane bilo koji korisnik.

Simple SSO API

Korisnici automatski kreirani putem Simple SSO toka čuvaju se kao SSOUser objekti. Mogu se pristupiti i upravljati njima putem SSOUser API-ja. Pogledajte dokumentaciju.

Prilagođene integracije – siguran Single Sign On (SSO)

FastComments Secure SSO koristi HMAC-SHA256 enkripciju kao mehanizam za implementaciju SSO. Prvo ćemo proći kroz ukupnu arhitekturu, dati primere i detaljne korake.

Postoji i dokumentacija koja se tiče migracije sa drugih provajdera sa sličnim SSO mehanizmima, i razlika.

Tok izgleda ovako:

Secure SSO tok

Pošto Secure SSO uključuje full-stack razvoj, kompletni radni primeri u Java/Spring, NodeJS/Express, i vanilla PHP su trenutno na GitHub-u.

Iako koristimo ExpressJS u NodeJS primeru i Spring u Java primeru, nema potrebe za dodatnim framework-ovima/bibliotekama u ovim runtime-ovima da bi se implementirao FastComments SSO - dovoljni su nativni crypto paketi.

Ne morate pisati nikakve nove API endpoint-e sa FastComments SSO. Jednostavno enkriptujte informacije o korisniku koristeći vaš tajni ključ i prosledite payload comment widgetu.

Preuzmite svoj API tajni ključ

Vaš API tajni ključ možete preuzeti sa ove stranice. Takođe ovu stranicu možete pronaći tako što ćete otići na Moj nalog, kliknuti na API/SSO pločicu, a zatim kliknuti "Preuzmi API tajni ključ".

Parametri widgeta za komentare

Visoko-nivo dokumentacije API-ja za widget za komentare može se naći ovde.

Hajde da detaljnije objasnimo šta ovi parametri znače.

Widget za komentare prihvata objekat konfiguracije - već prosleđujete ovo ako koristite FastComments da pošaljete vaš customer id (nazvan tenantId).

Da biste omogućili SSO, prosledite novi "sso" objekat, koji mora imati sledeće parametre. Vrednosti bi trebalo da budu generisane na serverskoj strani.

userDataJSONBase64: Podaci o korisniku u JSON formatu, koji se zatim Base64 enkodiraju.
verificationHash: HMAC-SHA256 hash kreiran od UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch timestamp u milisekundama. Ne sme biti u budućnosti, niti stariji od dva dana.
loginURL: URL koji widget za komentare može prikazati da bi se korisnik prijavio.
logoutURL: URL koji widget za komentare može prikazati da bi se korisnik odjavio.
loginCallback: Kada je obezbeđen umesto login URL-a, funkcija koju će widget za komentare pozvati pri kliku na dugme za prijavu.
logoutCallback: Kada je obezbeđen umesto logout URL-a, funkcija koju će widget za komentare pozvati pri kliku na dugme za odjavu.

Secure SSO Client Code

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": 1794130022559.0,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "loginCallback": null,
        "logoutCallback": null
    }
}];
</script>

Objekat korisnika

Copy

interface SSOUser {
    /** Obavezno. Maks. 1k karaktera. **/
    id: string;
    /** Obavezno. Maks. 1k karaktera. Napomena: Mora biti jedinstven. **/
    email: string;
    /** Obavezno. Maks. 1k karaktera. Napomena: Korisničko ime ne može biti email. Ne mora biti jedinstveno. **/
    username: string;
    /** Opcionalno. Maks. 3k karaktera za URL-ove. Podrazumevano iz gravatar-a na osnovu email-a. Podržava 64 enkodirane slike, u kom slučaju je limit 50k karaktera. **/ 
    avatar?: string;
    /** Opcionalno. Podrazumevano false. **/
    optedInNotifications?: boolean;
    /** Opcionalno. Podrazumevano false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Opcionalno. Maks. 100 karaktera. Ova etiketa će se prikazati pored njihovog imena. Podrazumevano je Administrator/Moderator kada je primenljivo. **/
    displayLabel?: string;
    /** Opcionalno. Maks. 500 karaktera. Ovo će biti prikazano umesto korisničkog imena. **/
    displayName?: string;
    /** Opcionalno. Maks. 2k karaktera. Ime korisnika će linkovati na ovo. **/
    websiteUrl?: string;
    /** Opcionalno. Do 100 grupa po korisniku. ID grupe ne sme biti duži od 50 karaktera. **/
    groupIds?: string[];
    /** Opcionalno. Označava korisnika kao administratora. **/
    isAdmin?: boolean;
    /** Opcionalno. Označava korisnika kao moderatora. **/
    isModerator?: boolean;
    /** Opcionalno, podrazumevano true. Postavite na false da omogućite karticu "aktivnosti" u profilu korisnika. **/
    isProfileActivityPrivate?: boolean;
    /** Opcionalno, podrazumevano false. Postavite na true da onemogućite komentare u profilu. **/
    isProfileCommentsPrivate?: boolean;
    /** Opcionalno, podrazumevano false. Postavite na true da onemogućite direktne poruke tom korisniku. **/
    isProfileDMDisabled?: boolean;
    /** Opcionalna konfiguracija za bedževe korisnika. **/
    badgeConfig?: {
        /** Niz globalnih ID-eva bedževa za dodelu. Ograničeno na 30 bedževa. Redosled se poštuje. **/
        badgeIds: string[];
        /** Niz ID-eva bedževa specifičnih za trenutnu stranicu (urlId). Prikazuju se samo na dodeljenoj stranici. **/
        pageBadgeIds?: string[];
        /** Ako je true, zamenjuje postojeće prikazane bedževe. Globalni i za stranicu se nezavisno prepisuju. **/
        override?: boolean;
        /** Ako je true, ažurira prikazna svojstva bedževa iz tenant konfiguracije. **/
        update?: boolean;
    };
}

Moderatori i administratori

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

Obaveštenja

Da biste omogućili ili onemogućili obaveštenja, postavite vrednost optedInNotifications na true ili false respektivno. Prvi put kada korisnik učita stranicu sa ovom vrednošću u SSO payload-u, njegova podešavanja obaveštenja će biti ažurirana.

Dodatno, ako želite da korisnici primaju email obaveštenja za aktivnosti na stranicama na koje su se pretplatili (za razliku od samo in-app obaveštenja), postavite optedInSubscriptionNotifications na true.

VIP korisnici i specijalne oznake

Možete prikazati specijalnu oznaku pored imena korisnika koristeći opciono polje "displayLabel".

Neautentifikovani korisnici

Da biste predstavili neautentifikovanog korisnika, jednostavno ne popunjavajte userDataJSONBase64, verificationHash ili timestamp. Obezbedite loginURL.

Ovi korisnici neće moći da komentarišu, već će im se prikazati poruka za prijavu (poruka, link ili dugme, u zavisnosti od konfiguracije).

Direktni primeri za serializaciju i heširanje podataka korisnika

Više detalja i primeri možete naći ovde (js), ovde (java) i ovde (php).

Razumemo da svaka integracija može biti komplikovan i bolan proces. Ne oklevajte da se obratite svom predstavniku ili koristite stranicu za podršku.

Prilagođene integracije – jednostavan Single Sign On (SSO)

Sa Simple SSO, možemo pružiti widgetu za komentarisanje informacije o korisniku tako da ne mora da unese svoje korisničko ime ili e‑mail da bi komentarisao.

Simple SSO možemo konfigurisati na sledeći način:

Simple 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 kreiraće SSO korisnika u pozadini. Korisniku će biti postavljeno createdFromSimpleSSO na true ako je preuzet iz API‑ja.

Napomene:

E‑mail je jedinstveni identifikator za Simple SSO.
Navođenje e‑maila uz Simple SSO nije obavezno, međutim po defaultu će njihovi komentari biti prikazani kao “Unverified”. Ako e‑mail nije naveden, korisnik ne može biti potpuno autentifikovan.
NOVO Od januara 2022: Korisnička imena ne moraju biti jedinstvena na celom fastcomments.com
Simple SSO može automatski kreirati i ažurirati SSO korisnike, ako je e‑mail naveden i korisnik nije prvobitno kreiran putem Secure SSO. Ako Simple SSO payload navodi korisnika kreiranog putem Secure SSO ili API‑ja, taj korisnik ostaje neizmenjen, a posetilac dobija zasebnog korisnika.
Možete navesti značke (badges) za korisnika pomoću svojstva badgeConfig. Niz badgeIds sadrži ID‑ove globalnih znački koje se povezuju sa korisnikom. Niz pageBadgeIds sadrži ID‑ove znački ograničenih na trenutnu stranicu (urlId) — ove značke se prikazuju samo na stranici na kojoj su dodeljene. Ako je override postavljen na true, zamenjuje postojeće prikazane značke (globalne i po‑stranici se nezavisno prepisuju); ako je false, dodaje se postojećim znacima.

Podešavanja Simple SSO

Simple SSO je uvek dostupan. Dva podešavanja kontrolišu koliko FastComments mu veruje. Možete ih pronaći pretragom za SSO u pravilu prilagođavanja. Obe su isključene po defaultu i primenjuju se bez obzira da li je “Require SSO To View Comments” uključen.

Nalozi koji su već koristili Simple SSO kada su ova podešavanja dodata imaju oba uključena, tako da se za njih ništa nije promenilo.

Samo pravilo prilagođavanja koje najbolje odgovara stranici se primenjuje, pa ako imate više pravila, postavite ova podešavanja na svako od njih. Novo pravilo počinje sa njima uključenim ako bilo koje od vaših drugih pravila ima ova podešavanja uključena.

Automatska verifikacija komentara putem Simple SSO

Kada je ovo uključeno, komentari od Simple SSO korisnika se odmah verifikuju.

Kada je ovo isključeno, komentari od Simple SSO korisnika se prikazuju kao “Unverified” dok korisnik ne klikne na link koji im pošaljemo e‑mailom na adresu iz Simple SSO payload‑a. Ako automatski odobravate samo verifikovane komentare, i oni čekaju na taj link. Ako u payload‑u nema e‑maila, komentar ostaje neverifikovan.

Ovo podešavanje utiče samo na komentare. Glasovi od Simple SSO korisnika se uvek odmah računaju.

Dozvoli Simple SSO administratore

Kada je ovo uključeno, Simple SSO korisnik može biti admin ili moderator vašeg naloga:

Simple SSO korisnik koji ima admin ili moderator dozvole zadržava ih.
Simple SSO korisnik sa istim e‑mailom kao jedan od vaših administratora ili moderatora preuzima njihove dozvole.

Kada je ovo isključeno, Simple SSO ne dodeljuje ove dozvole. Simple SSO payload koji navodi korisnika koji ih ima dobija zasebnog korisnika bez dozvola, a originalni korisnik ostaje neizmenjen.

Simple SSO payload‑i nisu potpisani, pa kada je ovo uključeno, bilo ko ko zna e‑mail ili ID administratora može se predstavljati kao on. Ako je to važno za vaš sajt, ostavite ovo isključeno i koristite Secure SSO za vaše administratore.

Korisnike kreirane putem Secure SSO ili API‑ja Simple SSO ne može dostići, bez obzira da li je ovo uključeno.

Prilagođene integracije – migracija sa 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 sa Disqus laka - promenite algoritam heširanja sa SHA1 na SHA256 i ažurirajte nazive svojstava koji se prosleđuju UI.

Prilagođene integracije – migracija sa Commento SSO

Commento koristi drastično drugačiji SSO pristup - oni zahtevaju da imate endpoint koji oni pozivaju da bi autentifikovali korisnika. FastComments je suprotno - jednostavno enkodirajte i hešujte informacije o korisniku koristeći vaš tajni ključ i prosledite ih.

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

FastComments SSO (detalji ovde) pruža vašim korisnicima način da komentarišu bez potrebe da se prijave na drugu platformu.

Međutim, ovo samo po sebi ne štiti vaše niti komentara, jer su podaci o komentarima po defaultu javno dostupni – svako ko može da vidi stranicu može da vidi i komentare.

Promenom jedne postavke možemo ograničiti preuzimanje komentara osim ako to ne uradi administrator ili validni SSO korisnik.

Podešavanje bez koda

Možemo sprečiti pregled i interakciju sa našim nitima komentara, kada je SSO postavljen, kreiranjem pravila prilagođavanja.

Prilikom toga, potražite SSO i naći ćete ovu opciju:

Zahtevaj SSO za pregled komentara

Omogućite je i sačuvajte pravilo prilagođavanja.

Zaštiti samo određeni domen ili stranicu

Da biste zaštitili samo određeni domen ili stranicu, jednostavno ćemo podesiti pravilo prilagođavanja da to uradi.

Na vrhu UI-ja za prilagođavanje naći ćete dva polja, Domen i URL ID.

Da biste zaštitili samo određeni domen, unesite taj domen u polje "domain".

Da biste zaštitili određenu stranicu, unesite URL stranice u polje "URL ID". Ako imate prilagođenu integraciju sa FastComments, ovde možete uneti tip ID-a umesto URL-a.

Nivoi sigurnosti

Kada zahtevate SSO, treba da odlučite da li zahtevate Simple SSO ili Secure SSO. Ako zahtevate Simple SSO, oba su dozvoljena, ali ako zahtevate Secure SSO, sadržaj mora biti preuzet sa Secure SSO payload-om hash-ovanim vašim API ključem da bi se mogao pregledati.

Opcija nivoa sigurnosti će se pojaviti kada izaberete "Zahtevaj SSO za pregled komentara", i primenjuje se samo dok je ta opcija uključena.

Automatska verifikacija komentara putem Simple SSO i dozvola Simple SSO administratorima postavke su odvojene i primenjuju se bez obzira da li je ova opcija uključena.

Zaštita izvan čitanja

Omogućavanje ove opcije zaštitiće stranicu ili domen od komentarisanja osim ako korisnik nije prijavljen putem SSO.

Zamke

Korisnici koji su kreirali komentare pre vaše SSO integracije neće moći da ih vide, osim ako se ne prijave putem vaše SSO integracije.

Dozvoli anonimno komentarisanje

Podrazumevano, FastComments zahteva imejl za komentaranje. Ne mora biti validan imejl, međutim dok korisnik ne klikne na link koji mu je poslat, njegov komentar će prikazivati oznaku "Neverifikovani komentar".

Međutim, možemo ukloniti zahtev za imejlom. Polje za unos imejla će i dalje biti prikazano, ali više neće biti obavezno.

Ovo se može konfigurisati putem UI-ja za prilagođavanje vidžeta:

Omogućavanje anonimnih komentara

Opcija anonimnih komentara u UI-ju za prilagođavanje vidžeta, koja čini polje za imejl opcionim

Korisničko ime je i dalje obavezno. Da biste uklonili i taj korak, možete podesiti podrazumevano korisničko ime koje dele svi, ili pustiti da FastComments generiše jedinstveno korisničko ime za svakog posetioca.

Sprečavanje isteka anonimnih komentara

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

Podrazumevano, ne.

Ovo se može konfigurisati ili onemogućiti putem stranice Podešavanja moderacije.

Podešavanja moderacije

Forma za podešavanje moderacije gde postavljate koliko dana se neprovereni komentari čuvaju pre uklanjanja

Onemogući unos e-pošte

Kada korisnici komentarišu i nisu prijavljeni, biće zatraženo da unesu svoju email adresu.

Ovo će za tog korisnika kreirati „neverifikovanu sesiju“, i zatražićemo od njih da verifikuju tu sesiju putem emaila.

Za neke sajtove ili aplikacije poželjno je da se korisniku ne traži email prilikom komentarisanja ili glasanja.

Omogućavanje anonimnog komentarisanja čini polje za unos emaila opcionim. Međutim, možemo ga potpuno onemogućiti. Prvo omogućite anonimno komentarisanje, a zatim će se pojaviti opcija za onemogućavanje polja za unos emaila.

Onemogući unos emaila

Opcija za potpuno sakrivanje polja za email, prikazana nakon što je anonimno komentarisanje omogućeno u UI‑u prilagođavanja

Kada je ovo uključeno, polja za email se neće uopšte prikazivati u svim našim proizvodima za komentarisanje.

Napomena: uz ovu konfiguraciju, svi komentari će biti neverifikovani osim ako korisnik ne kreira nalog i ne prijavi se na https://fastcomments.com.

Možda ćete želeti da razmotrite onemogućavanje oznake neverifikovanog.

Onemogući oznaku neproverenog

Podrazumevano, FastComments će prikazati oznaku "Unverified Comment" za komentare koje je ostavio korisnik čija sesija pregledača nije verifikovana. Pročitajte više o komentisanju bez verifikacije ovde.

Onemogući neverifikovanu oznaku

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, ova funkcija se može koristiti, bez pisanja koda, u korisničkom interfejsu za prilagođavanje:

Onemogući neverifikovanu oznaku

Stranica za prilagođavanje vidžeta sa čekiranim poljem Disable Unverified Comment Label

Dozvoli anonimno glasanje

Kada korisnici pokušaju da glasaju za komentar, a nisu prijavljeni, biće zatraženo da unesu svoje korisničko ime i email.

Možemo ukloniti ovaj zahtev, omogućavajući bilo kome da glasuje za komentar bez ostavljanja ikakvih informacija.

Dozvoli anonimno glasanje

Stranica za prilagođavanje widgeta sa omogućenom opcijom anonimnog glasanja tako da glasanje ne zahteva ime ili email

Postavljanje podrazumevanog korisničkog imena

Kada korisnici komentarišu ili glasaju, a nisu prijavljeni, biće zatraženo da unesu svoju e‑mail adresu i korisničko ime.

U slučaju anonimnog komentarisanja, ponekad je poželjno definisati podrazumevano korisničko ime kako bi se smanjila prepreka pri komentarisanju. Ovo se može uraditi iz UI‑a za prilagođavanje. Anonimno komentarisanje mora biti prvo omogućeno.

Postavljanje podrazumevanog korisničkog imena

Polje podrazumevanog korisničkog imena koje se pojavljuje u UI‑u za prilagođavanje kada je anonimno komentarisanje omogućeno

Deljenje podrazumevanog korisničkog imena

Podrazumevano korisničko ime je zajedničko ime za prikaz, a ne identitet. Posetilac koji zadrži podrazumevano ime i unese svoj e‑mail dobija sopstveni nalog, pri čemu je podrazumevano ime prikazano kao njegovo javno ime. Neograničen broj posetilaca može zadržati isto podrazumevano ime, tako da se „Anonymous“ nikada ne prikazuje kao zauzeto.

Korisnička imena koja posetilac sam unese i dalje moraju biti jedinstvena.

Ako radije želite da svaki posetilac dobije jedinstveno ime bez potrebe da ga sam smišlja, pogledajte Automatsko generisanje korisničkih imena.

Automatsko generisanje korisničkih imena

Kada korisnici komentarišu ili glasaju, a nisu prijavljeni, biće zatraženo da unesu svoj email i korisničko ime.

Za neke sajtove, traženje od posetioca da smišlja jedinstveno korisničko ime predstavlja prepreku, posebno na mobilnim uređajima. FastComments može generisati neutralno korisničko ime za svakog novog posetioca i unapred popuniti polje za korisničko ime, kao BraveOtter4172.

Posetilac može ostaviti ime kako je, ili ga zameniti imenom po svom izboru.

Ovo se može omogućiti iz UI prilagođavanja, pod podešavanjem pod nazivom Generate Usernames Automatically:

Generiši korisnička imena automatski

Kako se ponaša

Svako generisano ime je jedinstveno. Proverava se protiv postojećih naloga i rezerviše za sesiju pregledača tog posetioca, tako da dva posetioca ne dobiju isto ime.
Ime se generiše samo za posetioce koji još nemaju ime. Prijavljeni korisnici, SSO korisnici i posetioci koji su već komentarisali zadržavaju svoje postojeće ime.
Radi sa ili bez anonymous commenting. Kada je anonimno komentarisanje isključeno, posetilac i dalje unosi svoj email, ali više ne mora da razmišlja o korisničkom imenu.
Povratni posetilac koji unese email koji je ranije koristio biće povezan sa svojim postojećim nalogom i zadržaće ime na tom nalogu.
Ako je takođe postavljen Default Username, generisano ime ima prednost.

Povratni pozivi

Sve biblioteke za komentarski widget (trenutno Angular, React, Vue) podržavaju povratne pozive.

Povratni pozivi se navode u konfiguracionom objektu, sa istim potpisom za svaku biblioteku.

Podržani callback-ovi su:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

Tačne potpise možete pronaći u TypeScript definicijama.

Evo primera sa svim callback-ovima:

Primeri 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 spreči podrazumevano ponašanje (otvaranje fastcomments.com korisničkog profila).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // emulira asinhrono ponašanje (pozivanje API-ja itd).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // comments je sortirana prema podrazumevanom sortiranju 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 definisanje lokalizacije korisnika

Podrazumevano, FastComments će prikazati vidžet za komentare u lokalizaciji koju određuje sistem i pregledač korisnika.

Kada korisnik komentariše ili se prijavi, ažuriramo njegovu poslednju korišćenu lokalizaciju i koristimo je i za slanje e‑mailova.

Ovo utiče na to kako je vidžet za komentarisanje preveden za korisnika. Lokalizacija se sastoji od jezika i regiona korisnika, tako da podešavanje lokalizacije obično menja jezik koji se koristi za prikaz teksta korisniku.

Putem UI-ja

Ovo se može definisati pomoću UI-ja za prilagođavanje vidžeta. Pogledajte opciju „Locale / Language“:

Promena lokalizacije / jezika

Padajući meni Locale / Language na stranici za prilagođavanje vidžeta koji se koristi za prepisivanje otkrivene lokalizacije posetioca

Putem koda

Ovo se može prepisati željenom lokalizacijom.

Ručno definisanje 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 kompletnu listu podržanih jezika i odgovarajućih kodova lokalizacije ovde.

Napomena o SSO

Ako koristite SSO, možda ćete želeti da prosledite korisnikovu lokalizaciju u objektu korisnika, kako bi e‑mailovi i druge stvari bile pravilno lokalizovane za njih.

Ograničavanje dozvoljenih jezika

Podrazumevano, FastComments ne ograničava jezike koji se koriste za komentarisanje.

Možda je poželjno ograničiti jezike koje zajednica koristi.

Ovo se može konfigurisati bez koda, na stranici za prilagođavanje widgeta:

Dozvoljeni jezici

Selektor dozvoljenih jezika na stranici za prilagođavanje widgeta za ograničavanje koje jezike komentari mogu koristiti

Sistem će analizirati njihov komentar i odrediti njegov jezik, a zatim ga uporediti sa listom dozvoljenih.

Ako je komentar napisan na jeziku koji nije dozvoljen, prikazaće se lokalizovana poruka o grešci.

Prevod komentara

Podrazumevano, FastComments prevodi sopstveni interfejs vidžeta (dugmad, oznake, poruke o greškama) na jezik posetioca, ali se komentari prikazuju tačno onako kako su napisani.

Comment Translation dodaje prevod samih komentara, tako da zajednica koja piše na više jezika može da pročita svaki komentar na svom jeziku.

Postoje dva režima:

Automatski: komentari napisani na jeziku koji se razlikuje od jezika vidžeta prikazuju se prevedeni. Ispod komentara se pojavljuje red „Prevedeno sa španskog" sa linkom Prikaži original koji prebacuje između prevoda i neprevedenog teksta.
Ručni: svaki komentar dobija link Prevedi. Klikom na njega se taj komentar prevodi na jezik posetioca, sa istim prekidačem Prikaži original nakon toga. Komentari koji su već na jeziku posetioca umesto toga to i navode.

Ciljni jezik je jezik vidžeta: podešavanje Locale / Language na istom pravilu prilagođavanja, ako je postavljeno, inače jezik pregledača posetioca. Od posetioca se ništa ne traži — nalog, ekstenzija ili dodatni softver nisu potrebni, i radi isto u ugrađenom vidžetu i na samostalnim stranicama za komentare.

Ovo se uključuje po pravilu prilagođavanja, tako da se može primeniti na ceo sajt, jedan domen ili jednu stranicu. Podrazumevano je isključeno.

Comment Translation

Prevod je podešavanje na serverskoj strani. Prosleđivanje commentTranslation u JavaScript konfiguraciji vidžeta ga ne uključuje; to čini pravilo.

Svaki komentar se prevodi najviše jednom po ciljnom jeziku i rezultat se čuva uz komentar, tako da se komentar koji pročita hiljadu španskih govornika prevodi samo jednom. Ako autor ili moderator izmeni komentar, sačuvani prevod se odbacuje i komentar se ponovo prevodi pri sledećem pregledu. Prevedeni tekst prolazi kroz ista pravila sanitizacije i linkova kao originalni komentar. Komentari koji su predugi ili čiji se jezik ne može otkriti prikazuju se neprevedeni.

Potrošnja se naplaćuje kao LLM tokeni po istoj ceni kao AI Agents i pojavljuje se na istom mestu u detaljima vašeg naplatnog naloga.

Naslovi stranica

Trenutni naslov stranice je povezan sa navedenim urlId i sačuvan za upotrebu u alatima za moderaciju.

Podrazumevano se preuzima iz document.title.

Ako želite, možete navesti sopstveni naslov stranice na sledeć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>

Spreči nove odgovore i onemogući glasanje

Komentarisanje se može zaključati tako da se ne mogu ostavljati novi komentari ili glasovi postavljanjem flag-a readonly na true.

Komentari takođe neće moći da se uređuju ili brišu.

Making The Comment Thread Readonly

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 prilagođavanje widgeta, za ceo domen ili stranicu:

Zaključavanje niti komentara

Postavka za sprečavanje novih odgovora na stranici za prilagođavanje widgeta, koja zaključava nit za domen ili stranicu

Ažuriranje!

Od novembra 2022, niti se mogu zaključati ili otključati uživo od strane administratora i moderatora putem menija sa tri tačke iznad oblasti za odgovor.

Ovo će sprečiti nove komentare, dok i dalje omogućava glasanje i omogućava korisnicima da izbrišu svoje komentare ako to žele, dok readonly ne dozvoljava ove stvari.

Ovo odgovara polju isClosed u Page API-ju.

Ograničavanje domena linkova

Podrazumevano, FastComments dozvoljava povezivanje na bilo koji eksterni sajt.

Ovo može biti ograničeno na željenu listu sajtova ili domena. Pokušaj objavljivanja linka na sajt ili domen koji nije na definisanoj listi izazvaće prikaz greške korisniku.

Ova validacija važi samo za Comment Widget i API. Importi nisu pogođeni.

Ovo se podešava bez koda, na stranici za prilagođavanje vidžeta:

Ograniči domene eksternih linkova

Podešavanja eksternih linkova sa listom ograničenih domena gde se unose dozvoljeni sajtovi

Broj komentara i brojanje svih ugnježdenih odgovora

Broj komentara koji se prikazuje na vrhu komentarskog vidžeta može da prikazuje ili sve "top-level" komentare, što znači odgovore koji su direktno odgovori na stranicu ili članak, ili može biti broj svih ugnježdenih komentara.

Po defaultu, ovo je true - to je broj potonjeg - svi komentari. U starijim verzijama komentarskog vidžeta podrazumevana vrednost je false.

Možemo promeniti ponašanje, tako da bude broj svih ugnježdenih 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 broj odražava samo komentare najvišeg nivoa, 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>

Ovo trenutno ne može da se prilagodi bez izmena koda.

Omogući linkove komentatora

Podrazumevano, FastComments će tražiti od korisnika samo njihov komentar, korisničko ime i email.

Međutim, u nekim situacijama možda ćete želeti da korisnik ostavi link ka svom blogu ili veb sajtu.

Možemo omogućiti prikaz dodatnog polja za unos URL-a veb sajta korisnika tako što ćemo postaviti zastavicu enableCommenterLinks na true:

Enabling Commenter Links

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, nalog korisnika će biti ažuriran i sve njihove korisničke nazive na svim prošlim i budućim komentarima će biti povezani na ovaj URL.

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta:

Omogućavanje linkova komentatora

Stranica za prilagođavanje widgeta sa čekiranim poljem za linkove komentatora kako bi se dodalo polje za URL veb sajta u formu za komentar

Grupe za moderaciju

Lista id-eva generisanih sa stranice Grupe za moderaciju.

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

Ako Moderator ima jednu ili više definisanih Grupe za moderaciju, oni će videti samo komentare na stranici Moderate Comments koji su povezani sa njihovom grupom/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>

Pominjanje ID-ova grupa

Lista ID-jeva koja se koristi za automatsko dopunjavanje @mentions. Korisno kada želite sprečiti označavanje korisnika koji nemaju zajedničke grupe.

Kada je naveden, u automatskom dopunjavanju će, nakon kucanja karaktera @, biti prikazani samo korisnici iz drugih grupa.

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 zavisi od toga da su kolačići treće strane omogućeni u vašem pregledaču. Bez njih, korisnici će uvek morati da ostave svoj email da bi komentarisali (osim ako je polje za unos email-a sakriveno), i njihovi komentari će uvek biti prikazani kao neverifikovani (podrazumevano).

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

Kada je ovo podešavanje omogućeno, pojaviće se mali popup koji prikazuje poruku da se korisnik prijavljuje. Ovaj popup se prikazuje kad god korisnik interaguje sa widgetom za komentare; na primer, ako ostavi komentar.

Možemo to uraditi 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đe možemo podesiti putem UI-ja za prilagođavanje widgeta, pod Enable Third-Party Cookie Popup:

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

Brisanje komentara sa odgovorima

Podrazumevano, korisnici mogu da brišu svoje komentare. Takođe, brisanje njihovog komentara automatski briše sve podkomentare i privremene komentare u niti. Ovo ponašanje je takođe aktivno.

Možete da ograničite ovo na sledeće načine:

Umesto toga, anonimizujte obrisani komentar (postavite ime i tekst na [deleted] ili na prilagođenu vrednost).
Nemojte dozvoliti brisanje komentara kada postoje odgovori. Prikazuje se prilagodljiva poruka o grešci.
Ograničite brisanje kada komentar ima odgovore samo na administratore i moderatore.

Ovo se može konfigurisati putem sekcije Comment Thread Deletion u UI prilagođavanja widgeta.

Prilagodite ponašanje brisanja za odgovore

Opcije za brisanje niti komentara u UI prilagođavanja widgeta za anonimizaciju ili ograničavanje brisanja sa odgovorima

Prikaži značke u gornjoj traci

Podrazumevano, FastComments će prikazivati korisničke značke samo na njihovim komentarima unutar niti komentara.

Međutim, možemo prikazati korisničke značke pored njihovog imena iznad forme za komentar omogućavanjem ove funkcije na stranici za prilagođavanje widgeta:

Opcija Prikaza Značaka u Gornjoj Traci

Polje za prikaz znački u gornjoj traci na stranici za prilagođavanje widgeta, postavljanje znački pored imena iznad forme za komentar

Ovo će prikazati korisničke značke pored njihovog imena u području gornje trake, čineći njihove postignuće i status vidljivijim dok pišu komentar.

Napomena da ova funkcija mora biti omogućena u UI‑u za prilagođavanje widgeta da bi radila. Opcionalno možete postaviti showBadgesInTopBar zastavicu na false u vašoj konfiguraciji koda da je selektivno onemogućite čak i kada je uključena na nivou servera:

Onemogući Prikaz Značaka 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 listu online korisnika

Podrazumevano, FastComments ne prikazuje listu korisnika na stranici.

Možete prikazati listu ljudi koji trenutno gledaju stranicu, uz widget za komentare. Lista se ažurira u realnom vremenu kako se korisnici pridružuju i napuštaju, i prikazuje njihovo ime, avatar i indikator online statusa.

Postoje tri opcije rasporeda:

1 - Top: horizontalni red preklapajućih avatara prikazan iznad komentara.
2 - Left: bočna traka sa imenima i online tačkama prikazana levo od widgeta.
3 - Right: ista bočna traka prikazana desno od widgeta.

Postavite usersListLocation zastavicu da omogućite ovu funkciju:

Prikaži listu korisnika desno

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>

Podrazumevano lista prikazuje samo korisnike koji su trenutno online. Da biste takođe uključili ljude koji su u prošlosti komentarisali stranicu (ali je trenutno ne gledaju), postavite usersListIncludeOffline na true:

Uključi prethodne 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>

Prethodni komentatori se prikazuju bez zelene online tačke, kako bi bilo jasno ko je trenutno prisutan.

Korisnici sa privatnim profilima se prikazuju sa generičkim avatarom i oznakom „Privatan profil“ kako bi broj ostao tačan bez otkrivanja identiteta.

Ovo se takođe može konfigurisati bez koda. Na stranici za prilagođavanje widgeta, pogledajte opciju „Lokacija liste korisnika“. Kada je lokacija postavljena na bilo šta osim Off, pojavljuje se polje za potvrdu „Uključi prethodne komentatore“ ispod nje.

Podešavanja liste korisnika

Lokacija liste korisnika postavljena na desno, sa poljem za uključivanje prethodnih komentatora prikazanim ispod

Za poslednjih 500 aktivnih korisnika, lista može biti zastarela do 30 sekundi.

Prethodni vodič Sledeći vodič

Jezik 🇷🇸 Srpski (Latinica)

Osnove

Izgled i osećaj

Live komentarisanje

Paginacija i sortiranje

Polje za odgovor

SSO

Anonimno komentarisanje

Razno

Prilagođavanja i konfiguracija