Customizations & Configuration

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

Kada se prikazuje nit komentara, ili se ostavlja komentar, FastComments mora znati kojoj stranici, članku ili proizvodu ti komentari pripadaju.

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

Po defaultu, ako ne navedete urlId, on će postati URL stranice. Uzeće trenutni URL stranice i očistiti ga kako bi uklonio bilo koje uobičajene marketinške parametre ili identifikatore za praćenje.

U slučaju integracija trećih strana, kao što je WordPress, naš plugin će obično koristiti identifikator koji predstavlja informacije koje se trenutno pregledaju kao URL ID, na primer id članka/stranice.

Defining a Custom URL 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",
    "urlId": "https://example.com/page"
}];
</script>

Jedna stvar na koju ćemo često pozivati u ovom dokumentu je Widget Customization UI.

Ovaj UI se može koristiti za izvođenje mnogih promena na widgetu za komentare bez korišćenja koda.

Kada kreirate pravilo za prilagođavanje, često ćemo želeti da se ono primeni na sve stranice na našem sajtu. 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 napravimo komentare za tu stranicu anonimnim. Takođe, na primer, možete imati uživo komentare koji se odmah pojavljuju na nekim stranicama, dok su na drugim skriveni iza dugmadi za obaveštavanje.

Sve je to moguće preko URL ID polja za unos na ovoj stranici, koje izgleda kao što sledi:

URL ID Input in The Widget Customization Page

Vrednost u ovom polju treba da odgovara urlId parametru koji se prosleđuje u comment widget. Ako želite da vaše pravilo za prilagođavanje bude agnostično prema urlId, ostavite ovo polje prazno ili unesite *.

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

Napomene

Ako vaša stranica ima hash parametre (kao example.com#page-1) - to će postati deo URL ID-a, po defaultu.
Tokom migracija, na primer iz WordPress-a u Gatsby, možda ćete morati da migrirate vrednosti komentara URL ID nakon početne migracije. U tom slučaju, obratite nam se.

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 stilovi

FastComments je dizajniran da bude prilagodljiv. Sam widget za komentare se izvršava unutar iframe-a iz bezbednosnih razloga, pa da biste primenili prilagođeni stil morate slediti jedan od dva pristupa.

Prvi, najlakši pristup, i onaj koji mi preferiramo, je da koristite widget customization page.

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

Custom CSS Input Area

Ovaj pristup ima neke prednosti:

Uneseni CSS se minifikuje pre nego što se pošalje korisniku, a formatiranje se održava konzistentnim u UI za uređivanje.
Dobijate sve prednosti UI za prilagođavanje widgeta, na primer jednostavno prilagođavanje widgeta za komentare različitim sajtovima.
Kada napravimo promene u widgetu za komentare, vaš prilagođeni stil biće testiran kao deo našeg procesa objavljivanja.

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

Passing Custom CSS

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 poslato pre nego što naši serveri odbace zahtev, zbog veličine zaglavlja.
Morate upravljati prilagođenim CSS-om u svojoj infrastrukturi i build sistemu. Ovo može biti i prednost umesto mane.
Postoji dodatni overhead slanja prilagođenog CSS-a preko mreže dvaput u ovom slučaju, jer se mora poslati našim serverima, a zatim vratiti u sadržaju iframe-a. Međutim, za većinu veličina payload-a ovo nije primetno.
Uobičajena optimizacija je minifikacija CSS-a da bi se smanjila veličina prenosa, međutim sa ovim pristupom ćete to morati sami da rešite.
Vaš prilagođeni CSS neće biti testiran kada napravimo promene.

External CSS Files

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

Preporučuje se da stavite @import u pravilo za prilagođavanje. Na taj način, ako ikada budemo morali da napravimo promenu u widgetu za komentare, možemo koristiti naše automatizovane alate da verifikujemo vašu konfiguraciju. Dakle, na primer, kreirali biste pravilo za prilagođavanje u Widget Customization UI, kliknuli Advanced, i uneli u Custom CSS:

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

In Code - Not Recommended

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

External CSS File

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, zapamtite da vaš CSS neće moći biti testiran od strane nas ako ovo uradite.

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

Na primer:

User Profile CSS

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>

Backwards Compatibility

U FastComments-u znamo da naši korisnici prilagođavaju widget za komentare. To je namerno - poslednje što želimo je da naš proizvod izazove dizajnerske neusaglašenosti u vašem proizvodu.

Pošto je ovo važan deo našeg proizvoda, imamo build pipeline koji nam omogućava da pregledamo promene u widgetu za komentare po korisniku, za svako objavljivanje.

Ako pronađemo manje probleme, ažuriraćemo vaš nalog kako bismo osigurali da objavljivanje prođe glatko. Ako uočimo ozbiljne prekidajuće promene, ovo nam omogućava da zaustavimo objavljivanje.

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 brenda

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>

Prebacivanje 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>

Prepisivanje teksta

U FastCommentsu, sav tekst u widgetu za komentare je prilagodljiv.

Možete zameniti jednu stavku teksta, kao što je dugme za slanje, ili ceo tekst u celom widgetu za komentare.

Podrazumevano, tekst u widgetu za komentare se prevodi u skladu sa lokalom korisnika. Međutim, možemo prepisati tekst, ako smo sigurni da naša korisnička baza koristi isti lokal/jezik, na primer:

Custom Text

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".

Međutim, postoji lakši način, preko UI-a za prilagođavanje widgeta. Tamo možemo jednostavno pronaći tekst koji se prikazuje u komentarskom widgetu u EN_US lokalu, i odrediti zamenu.

Custom Text

Sve izmene prevoda trenutno utiču na sve lokale.

Promena podrazumevanog avatara

Kada korisnik prvi put komentariše koristeći FastComments, pokušaćemo da dohvatimo njegov avatar sa http://gravatar.com/.

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

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

Override The Default 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 može uraditi i bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Podrazumevani avatar".

Customizing The Default Avatar

Imajte na umu da je definisanje avatara za određenog korisnika, na primer pomoću SSO, objašnjeno u posebnom odeljku.

Onemogućavanje avatara

Avatare je moguće potpuno ukloniti iz widgeta za komentare, čak i ako su korisnici postavili 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 widgeta:

Hiding Avatars

Onemogućavanje svih podrazumevanih stilova

Za veće projekte prilagođavanja stilova može biti poželjno početi potpuno iz početka i uopšte ne koristiti podrazumevane stilove.

Svi podrazumevani stilovi mogu biti uklonjeni 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, u okviru Naprednih opcija:

Disabling All Default Styles

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.

Automatsko sklapanje odgovora

Po podrazumevanju se prikazuju odgovori na komentare najvišeg nivoa.

Ovo se može podesiti tako da korisnik mora da klikne "Show Replies" na komentarima najvišeg nivoa da bi video njihove 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:

Collapse Replies

Ovo podešavanje neće uticati na broj komentara najvišeg nivoa koji se inicijalno učitavaju. Ako imate jedan komentar najvišeg nivoa, i 29 njegovih odgovora, sa ovom opcijom uključenom vi ćete:

Videćete komentar najvišeg nivoa.
Videćete Prikaži odgovore (29) ispod ovog komentara.

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

Omogućavanje WYSIWYG uređivača

Po podrazumevanoj postavci, funkcionalnosti formatiranja u FastComments se vrše dodavanjem vidljivih HTML tagova kao što su <b></b> oko vašeg teksta. Klikom na traku sa alatkama ili korišćenjem prečica to se radi umesto vas. Međutim, neke zajednice možda žele da se odluče za korišćenje formatiranja bez vidljivih tagova. Ovo se naziva omogućavanjem WYSIWYG (ono što vidiš je ono što dobiješ) editora. Ovaj editor izgleda tačno isto kao podrazumevani, osim što učitava dodatni kod koji omogućava korisnicima da podebljaju, podvuču itd. svoj tekst bez vidljivih tagova.

Enabling WYSIWYG Editing

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 i bez koda. Na stranici za prilagođavanje widgeta, pogledajte opciju "Omogući napredno formatiranje".

Enable WYSIWYG

Podrazumevano, FastComments prikazuje traku sa alatkama prilikom pisanja komentara koja omogućava prečice za formatiranje teksta i otpremanje slika.

Ova traka sa alatkama može se onemogućiti u kodu ili putem korisničkog interfejsa za prilagođavanje.

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

Disabling The Toolbar

Onemogućavanje blokiranja

Podrazumevano, FastComments omogućava korisnicima da blokiraju druge korisnike. Blokiranje korisnika će prouzrokovati da njegovi komentari budu maskirani, sprečava slanje obaveštenja između korisnika i slično.

Možda je poželjno onemogućiti ovu funkcionalnost. To se može uraditi na sledeći način:

Disable Blocking

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 ispravnu validaciju na serverskoj strani, putem Interfejsa za prilagođavanje widgeta:

Disable Blocking

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.

Prebacivanje 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 "pre 11 minuta".

Može biti potrebno ili poželjno koristiti apsolutne datume, u kom slučaju podesite ovaj parametar na true.

Koristite 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:

Koristite apsolutne datume

Prikazivanje i apsolutnih i relativnih datuma

Podrazumevano se koriste lokalizovani relativni datumi. Na primer, pored komentara koji je nedavno ostavljen možete videti "pre 11 minuta".

Može biti potrebno ili poželjno zadržati ovaj relativni format datuma, ali takođe prikazati i puni datum pored njega. U tom slučaju postavite ovaj parametar na true.

Use Both Absolute and Relative Dates

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. Najpre ćete morati omogućiti Apsolutne datume da biste ovu opciju videli u korisničkom interfejsu.

Use Both Absolute and Relative Dates

Dodavanje teksta zaglavlja

Neki tekst, poput naslova ili poruke, može se prikazati ispod broja komentara ali iznad teksta o statusu prijave.

Ovo nazivamo zaglavljem, i podrazumevano 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 programiranja, na stranici za prilagođavanje vidžeta, u okviru Naprednih opcija:

Specifying Header HTML

Prikazivanje linkova kao teksta

Po podrazumevanoj vrednosti, FastComments će prikazivati linkove ovako: https://exmaple.com - gde URL linka postaje klikabilan HTML anchor tag.

Neki sajtovi možda žele da onemoguće ovo, na primer kako bi odvratili prevarante. To omogućavamo podešavanjem Comment HTML Rendering Option na Links as Text.

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

Render Links as Text

Prebacivanje komentara dugmetom

Po podrazumevanju, FastComments će istovremeno prikazati okvir za unos komentara i nit komentara. Da bi uštedeo vertikalni prostor, takođe će sakriti sva ostala obavezna polja dok se ne interaguje sa vidžetom.

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

Click to Show Comments

Dugme koristi različit prevedeni tekst u zavisnosti od toga 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. Prevodi mogu sadržati tekst [count] koji će biti zamenjen lokalizovanim brojem.

Click to Show or Hide Comments

Copy

Run

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

Ovo je namenjeno da zameni konfiguraciju hideCommentsUnderCountTextFormat.

Brojač se ažurira u realnom vremenu zajedno sa niti komentara. Dugme se ne prikazuje ako nema komentara.

Ovo se može omogućiti bez koda kreiranjem pravila za prilagođavanje i omogućavanjem "Klikni za prikaz komentara":

Enable Click to Show Comments

Prilagođavanje teksta broja komentara

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

Ovo može biti zamenjeno bilo kojim stringom, a vrednost [count] biće zamenjena stvarnim brojem, lokalizovanim za korisnika.

Customizing The Comment Count Text

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:

Customizing The Comment Count Text

Onemogućavanje preusmeravanja slika

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ćavanje automatskog kreiranja haštagova

Kada korisnici unesu heštagove, u formatu #someexampletag, FastComments će automatski kreirati taj HashTag i označiti ga u njihovom komentaru.

U nekim slučajevima poželjno je onemogućiti ovu funkciju ili kontrolisati koji heštagovi se mogu koristiti putem API-ja.

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

Disabling Automatic HashTag Creation

Isključivanje zvona za obaveštenja

Podrazumevano, FastComments će prikazati ikonicu zvona za obaveštenja u gornjem desnom uglu oblasti za komentare.

To 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 niti na kojoj ste komentarisali.
Korisnik je glasao za vaš komentar.
Korisnik je odgovorio na stranicu na kojoj ste pretplaćeni.

Ikonica za obaveštenja takođe omogućava mehanizam za pretplatu na celu stranicu.

Međutim, možemo u potpunosti onemogućiti ikonicu zvona za 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 takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak 'Onemogući zvono za obaveštenja'.

Disable Notification Bell

Onemogućavanje profila

Po podrazumevanoj postavci, FastComments će prikazati profil korisnika kada kliknete na njihov avatar.

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

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>

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta pogledajte odeljak "Onemogući profile".

Disable Profiles

Onemogućavanje poruke o uspehu

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

Disable Success Message

Copy

Run

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

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta:

Disable Success Message

Promena ocene sadržaja GIF-ova

Podrazumevano, komentarski vidžet FastComments postaviće gif rating na pg.

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

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

Set Gif Rating

Copy

Run

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

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

Setting The Gif Rating

Moderacija sadržaja slika

Po podrazumevanoj postavci, FastComments widget za komentare ima moderaciju sadržaja slika postavljenu na off.

Dostupne opcije su off, low, medium, i high.

U UI za prilagođavanje widgeta, ovo ćete pronaći pod Image Content Moderation Level sve dok Disable Image Uploads? nije čekirano.

Setting The Image Content Moderation Level

Promena stila glasanja

Po podrazumevanju, FastComments prikazuje opcije glasanja kao strelice gore i dole, omogućavajući korisnicima da glasaju za ili protiv komentara.

Međutim, moguće je promeniti stil alatne trake za glasanje. Trenutne opcije su podrazumevana dugmad Gore/Dole, ili korišćenje stila glasanja sa srcem.

Koristimo zastavicu voteStyle na sledeći način:

Enable Heart Button

Copy

Run

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

Toplo preporučujemo da ovo uradite bez koda, jer to takođe omogućava validacije na serverskoj strani. Na stranici za prilagođavanje widgeta pogledajte odeljak "Stil glasanja".

Change Voting Style

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

Onemogućavanje brisanja

Po podrazumevanoj postavci, FastComments dozvoljava korisnicima da brišu svoje komentare.

Međutim, moguće je to onemogućiti.

Na stranici za prilagođavanje widgeta, pogledajte opciju "Onemogući brisanje".

Disable Comment Deleting

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

Onemogućavanje uređivanja

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

Međutim, moguće je to onemogućiti.

Na stranici za prilagođavanje widgeta, pogledajte opciju "Onemogući uređivanje".

Disable Comment Editing

Ovo utiče samo na obične komentatore i ne utiče na moderatore ili admina, koji će i dalje moći da uređuju.
Ovo će takođe uticati na API integracije kada se prosledi 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 stranica

Podrazumevano, veličina stranice u FastComments je 30. Ovo uključuje odgovore u nitima.

Veličina stranice se može prilagoditi u UI za konfiguraciju vidžeta u različitim veličinama u rasponu od 10 do 200.

Imajte na umu da promena veličine stranice zahteva preračunavanje svih nitova komentara na vašem nalogu. Ovo može potrajati nekoliko minuta.

Ovo se ne može konfigurisati u klijentskom vidžetu jer se stranice izračunavaju na serverskoj strani.

Primer konfiguracije je prikazan ispod:

Custom Page Sizes

Veličine stranica mogu se prilagoditi globalno, po domenu ili po stranici kreiranjem različitih pravila za prilagođavanje.

Ovo će uticati na sve klijente, integracije i framework-e koje koristite za prikaz komentara preko 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

Prema zadatim postavkama, FastComments će prikazati ime korisnika onako kako su ga uneli, ili kako nam 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 je moguće uraditi bez koda u korisničkom interfejsu za prilagođavanje widgeta (Widget Customization UI), u podešavanju nazvanom Commenter Name Format:

Change Name Format

Dostupni formati su:

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

Efekat promene se primenjuje odmah. Korisnici će i dalje videti svoje puno korisničko ime na vrhu oblasti za komentare, za sebe, ali njihovi komentari će prikazivati izmenjeno korisničko ime.

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

Onemogućavanje postavljanja slika

Po podrazumevanoj vrednosti FastComments omogućava otpremanje slika. To se može onemogućiti podešavanjem zastavice noImageUploads na true.

Disabling Image Uploads

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:

Disabling Image Uploads

Omogućavanje polja za pretragu

Po podrazumevanoj vrednosti, u widgetu za komentare nije prikazano polje za pretragu.

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

Enabling Search

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 je moguće i bez pisanja koda. Na stranici za prilagođavanje widgeta, pogledajte opciju "Omogući polje za pretragu".

Enable Search Box

Omogućavanje spoilera

Podršku za spoilere možemo omogućiti postavljanjem zastavice enableSpoilers na true:

Enabling Spoilers

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

Enable Spoilers

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

Ovo je takođe kompatibilno sa WYSIWYG editorom.

Omogućavanje prikaza broja pregleda komentara

Podrazumevano, FastComments ne prati ko je pregledao svaki komentar i ne pruža statistiku o tome.

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

Kada se to desi, broj pored ikone oka koji se prikazuje na svakom komentaru biće uvećan. Brojač se ažurira uživo i skraćuje se prema lokalnim podešavanjima korisnika.

Ovo možemo omogućiti podešavanjem 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:

Enabling Comment View Counts

Pratimo ID korisnika* koji je pregledao komentar, tako da ako komentar pogledate ponovo broj se neće uvećati. Ako komentar pogledate ponovo nakon dve godine, broj će se ponovo povećati.

*Napomena: ili anon session id, ili IP korisnika kao hashovana vrednost.

Prikazivanje uživo komentara odmah

Po defaultu, komentarisanje u realnom vremenu je omogućeno. To znači da ako se bilo koji komentari dodaju, brišu, uređuju ili prikvače, promene bi trebalo da se pojave kod svih korisnika koji u isto vreme gledaju nit komentara.

Međutim, po defaultu ti novi komentari će se pojaviti ispod dinamički prikazanog dugmeta sa tekstom sličnim "Prikaži 2 nova komentara".

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 služi da se spreči stalna promena veličine stranice kod korisnika, što može izazvati frustraciju prilikom pokušaja da se uhvati traka za skrolovanje.

Za neke slučajeve upotrebe, kao što su licitacije uživo ili online događaji, ovo nije poželjno ponašanje - možda ćete želeti da widget za komentare bude više kao "čet" kutija gde se novi komentari "prikažu 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 widgeta:

Show Live Comments Right Away

Onemogućavanje komentarisanja uživo

Podrazumevano, FastComments ima omogućeno živo komentarisanje.

To znači da svaki gledalac niti komentara treba da vidi isti sadržaj.

Na primer, ako se komentar doda, taj komentar će se prikazati. Ako se komentar izmeni ili ukloni, onda će ti komentari biti izmenjeni ili uklonjeni za sve gledaoce niti. Isto važi za glasove i sve moderacione akcije.

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

Disable Live Commenting

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 može uraditi i bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Disable Live Commenting".

Disable Live Commenting

Novi uživo komentari na dnu

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ćavanje beskonačnog skrolovanja

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 smera sortiranja

Po defaultu, FastComments će sortirati komentare prema pravcu sortiranja "Most Relevant".

Sortiranje "Most Relevant" uzima u obzir vreme kada je komentar ostavljen i broj glasova prilikom sortiranja.

Korisnik zatim može promeniti pravac sortiranja u UI-ju widgeta za komentare na Oldest ili Newest First.

Međutim, možemo promeniti podrazumevano na bilo koju od ove tri. Na primer, ako želite da prikažete najstarije komentare prvi:

Changing The Default Sort To Oldest First

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 sortiranje koje prikazuje najnovije prvo, uradili bismo sledeće:

Changing The Default Sort To Newest First

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>

Važeće vrednosti za defaultSortDirection su:

MR: "Most Recent"
NF: "Newest First"
OF: "Oldest First"

Ovo se takođe može uraditi bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Default Sort Direction".

Changing The Default Sort Direction

Napomena: komentari na svakoj stranici za svaki pravac sortiranja su prethodno izračunati, tako da svi pravci sortiranja imaju isti nivo performansi.

Prikaz svih komentara odjednom - onemogući paginaciju

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

Render All Comments

Copy

Run

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

Premeštanje polja za odgovore posle komentara

Po podrazumevanoj vrednosti polje za unos komentara je pre niti komentara. Međutim, postavljanjem ovog konfiguracionog parametra na true možemo ga premestiti 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 pisanja koda, na stranici za prilagođavanje widgeta:

Moving The Reply Box to The Bottom

Ograničavanje dužine komentara

Najveći broj karaktera koji se može uneti u polje za unos komentara može biti ograničen parametrом maxCommentCharacterLength.

Podrazumevano je 2000.

Elementi poput URL-ova slika nisu uključeni u određivanje dužine.

Limit Comment Length

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:

Limit Comment Length

Onemogućavanje komentara u više redova

Podrazumevano, FastComments će dozvoliti korisniku da unese komentar sa onoliko redova koliko želi, do podrazumevanog ograničenja broja karaktera.

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

Uključujemo 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 i bez koda. Na stranici za prilagođavanje widgeta, pogledajte odeljak "Omogući unos komentara u jednoj liniji".

Enable Single-Line Comment Input

Imajte na umu da su komentari na svakoj stranici za svaki smer sortiranja prethodno izračunati, tako da svi smerovi sortiranja imaju iste performanse.

Ograničenje broja komentara po korisniku

Po podrazumevanoj postavci, svaki korisnik može da pošalje do 5 comments u istoj minuti.

Ovo se prati po user id, anon user id i ip address (hashed).

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

Limiting Comment Volume Per User

Imajte na umu da, ako koristite comment creation API, možda ćete želeti da prosledite originalnu ip adresu korisnika u zahtevu našem backendu tako da ograničenje brzine bude primenjeno po korisniku, a ne globalno na vaš nalog.

Sprečavanje novih komentara na prvom 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.

Pregled jedinstvene prijave (SSO)

SSO, odnosno single-sign-on, je skup konvencija koji omogućava vama ili vašim korisnicima da koriste FastComments bez potrebe za kreiranjem još jednog naloga.

Pod pretpostavkom da ne dozvoljavate anonimno komentarisanje, nalog je potreban da bi se komentarisalo sa FastComments. Mi ovaj proces prijave činimo vrlo jednostavnim — korisnik samo ostavi svoj email kada komentariše. Međutim, razumemo da je čak i to dodatna prepreka koju neke stranice žele da izbegnu.

Možemo smanjiti tu prepreku tako što ćemo imati samo jedan tok prijave za ceo vaš sajt.

How do I get it?

Svi tipovi naloga trenutno dobijaju pristup SSO. Međutim, maksimalan broj SSO korisnika varira u zavisnosti od vašeg paketa. Kao i kod drugih funkcija, Pro planovi i viši obezbeđuju direktnu razvojnu podršku.

Uporedićemo opcije, a zatim ćemo ući u detalje svake.

User and Comment Migrations

Kada migrirate sa platforme koja ima SSO, poput Disqus, već ćete imati korisnike i njihove komentare.

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

Sami korisnici se dodaju automatski prilikom prvog pregleda niti komentara. Alternativno, mogu biti unapred dodati preko API-ja, ali taj rad nema mnogo prednosti.

Ako su komentari importovani, a SSO korisnici nisu ručno dodatii preko API-ja, komentari će biti automatski dodeljeni korisničkom nalogu prvi put kada se nalog kreira kada korisnik pogleda bilo koju nit komentara. Oni će tada moći da upravljaju, uređuju i brišu komentare koje su prvobitno napisali.

Automatska migracija se radi putem email-a ili korisničkog imena. Neke platforme ne obezbeđuju emailove pri exportu, kao Disqus, pa se u tom slučaju oslanjamo na korisničko ime.

Sve dok prosledite odgovarajuće korisničko ime i email u SSO payload-u, dodaćemo email u pojedinačne objekte komentara tako da obaveštenja i pominjanja funkcionišu.

Ako želite da importujete komentare i korisnike odjednom, radite sa podrškom kako biste preneli komentare na odgovarajuće korisničke naloge nakon što su korisnici importovani preko API-ja.

Dakle, da sumiramo najlakši put za migraciju:

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

WordPress Users

Ako koristite naš WordPress dodatak, nema potrebe za pisanjem koda! Jednostavno idite na administratorsku stranicu dodatka, kliknite SSO Settings, i zatim Enable.

Ovo će vas odvesti do čarobnjaka sa jednim klikom koji će kreirati vaš API ključ, poslati ga na vašu WordPress instalaciju i uključiti SSO. Konsolidovali smo ovo u jedan klik za vas.

Obratite pažnju da ako instalirate dodatak po prvi put moraćete da završite proces podešavanja pre nego što vidite administratorsku stranicu sa dugmetom SSO Settings.

WordPress SSO - Moderators

Obratite pažnju da trenutno, da bi se bedž "Moderator" prikazao pored vaših moderatora kada komentarišu koristeći FastComments WordPress dodatak, oni takođe moraju biti dodati kao Moderator u FastComments kontrolnoj tabli, i imati svoj email verifikovan.

Custom Integrations

Za prilagođene integracije postoje dve opcije.

Option One - Secure SSO

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

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

Sa Secure SSO, SSO payload se kreira server-side koristeći HMAC autentifikaciju i zatim se prosleđuje widgetu na client-u.

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

Requirements

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

Pros

Sigurno.
Besprekorno iskustvo komentarisanja.

Cons

Zahteva razvoj na backend-u.

Updating User Data

Sa Secure SSO, svaki put kada prosledite sso user payload, mi ćemo ažurirati njihov nalog najnovijim informacijama. Na primer, ako korisnik ima korisničko ime X, i vi prosledite Y u SSO payload-u, njihovo korisničko ime će postati Y.

Ako želite da uklonite vrednosti koristeći ovaj pristup, postavite ih na null (ne undefined).

Secure SSO API

Takođe obezbeđujemo API za interakciju sa SSO korisnicima. Pogledajte the docs.

Napomena da kada koristite Secure SSO, korisnici se automatski kreiraju u pozadini prilikom učitavanja stranice. Ne morate masovno importovati svoje korisnike.

Option Two - Simple SSO

Alternativa Secure SSO je jednostavno prosleđivanje informacija o korisniku widgetu za komentarisanje.

Nije obavezno proslediti email sa Simple SSO, međutim bez njega njihovi komentari će se prikazivati kao "Unverified".

^Napomena! Od početka 2022. korisnička imena sa Simple SSO ne moraju biti jedinstvena preko celog FastComments.com.

Idealno, Simple SSO bi trebalo da se bira samo kada razvijate na platformi koja ne obezbeđuje pristup backend-u.

Requirements

Osnovno znanje o client-side razvoju.
Morate bar poznavati email korisnika.

Pros

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

Cons

Manje sigurno od Secure SSO jer se client-side payload može falsifikovati da postane bilo koji korisnik.

Simple SSO API

Korisnici koji su automatski kreirani putem Simple SSO toka sačuvani su kao SSOUser objekti. Može im se pristupiti i upravljati preko SSOUser API-ja. Pogledajte the docs.

Prilagođene integracije - sigurna jedinstvena prijava (SSO)

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

Postoji i dokumentacija o migraciji sa drugih provajdera koji koriste slične SSO mehanizme, i o razlikama.

Tok izgleda ovako:

Tok sigurnog SSO

Pošto Secure SSO zahteva 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, u ovim runtime okruženjima nisu potrebni nikakvi dodatni framework-ovi/biblioteke da biste implementirali FastComments SSO - rade native crypto paketi.

Ne morate pisati nikakve nove API endpoint-e za FastComments SSO. Jednostavno enkriptujte korisničke podatke koristeći vaš tajni ključ i prosledite payload comment widget-u.

Dobijte svoj API tajni ključ

Vaš API tajni ključ možete preuzeti sa ove stranice. Takođe možete doći do ove stranice tako što ćete otići na Moj nalog, kliknuti na API/SSO pločicu, i zatim kliknuti "Get API Secret Key".

Parametri komentarskog widgeta

Visok nivo API dokumentacije za comment widget možete pronaći ovde.

Idemo u više detalja šta ovi parametri znače.

Comment widget prihvata konfiguracioni objekat - to već prosleđujete ako koristite FastComments da biste poslali vaš tenant id (nazvan tenantId).

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

userDataJSONBase64: Podaci o korisniku u JSON formatu, koji su zatim Base64 enkodirani.
verificationHash: HMAC-SHA256 heš napravljen od UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch timestamp, u milisekundama. Ne sme biti u budućnosti, niti stariji više od dva dana.
loginURL: URL koji comment widget može prikazati za prijavu korisnika.
logoutURL: URL koji comment widget može prikazati za odjavu korisnika.
loginCallback: Kada je pruženo umesto login URL-a, funkcija koju će comment widget pozvati pri kliku na dugme za prijavu.
logoutCallback: Kada je pruženo umesto logout URL-a, funkcija koju će comment widget 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": 1768890094253,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout"
    }
}];
</script>

The User Object

The User object contains the following schema:

Objekat korisnika

Copy

interface SSOUser {
    /** Obavezno. Maksimalno 1k karaktera. **/
    id: string;
    /** Obavezno. Maksimalno 1k karaktera. Napomena: Mora biti jedinstven. **/
    email: string;
    /** Obavezno. Maksimalno 1k karaktera. Napomena: Korisničko ime ne može biti email. Ne mora biti jedinstveno. **/
    username: string;
    /** Opcionalno. Maksimalno 3k karaktera za URL-ove. Podrazumevano dolazi od gravatara na osnovu email-a. Podržava base64 enkodirane slike, u kom slučaju je limit 50k karaktera. **/ 
    avatar?: string;
    /** Opcionalno. Podrazumevano false. **/
    optedInNotifications?: boolean;
    /** Opcionalno. Podrazumevano false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Opcionalno. Maksimalno 100 karaktera. Ova oznaka će biti prikazana pored njihovog imena. Podrazumevano je Administrator/Moderator kada je primenljivo. **/
    displayLabel?: string;
    /** Opcionalno. Maksimalno 500 karaktera. Ovo će biti prikazano umesto korisničkog imena. **/
    displayName?: string;
    /** Opcionalno. Maksimalno 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. Oznacava korisnika kao administratora. **/
    isAdmin?: boolean;
    /** Opcionalno. Oznacava korisnika kao moderatora. **/
    isModerator?: boolean;
    /** Opcionalno, podrazumevano true. Postavite na false da omogućite karticu "activity" u korisnikovom profilu. **/
    isProfileActivityPrivate?: boolean;
    /** Opcionalno, podrazumevano false. Postavite na true da onemogućite komentare na profilu. **/
    isProfileCommentsPrivate?: boolean;
    /** Opcionalno, podrazumevano false. Postavite na true da onemogućite direktno slanje poruka ovom korisniku. **/
    isProfileDMDisabled?: boolean;
}

Moderators and Administrators

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

Notifications

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

Dodatno, ako želite da korisnici primaju email notifikacije o aktivnostima na stranicama na koje su pretplaćeni (za razliku od samo in-app notifikacija), postavite optedInSubscriptionNotifications na true.

VIP Users & Special Labels

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

Unauthenticated users

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

Ovi korisnici neće moći da komentarišu, i umesto toga biće im prikazana poruka za prijavu (poruka, link, ili dugme, u zavisnosti od konfiguracije).

Direct Examples for Serializing and Hashing User Data

Više detalja i primeri su dostupni ovde (js), ovde (java) i ovde (php).

Razumemo da bilo koja integracija može biti komplikovan i bolan proces. Ne oklevajte da kontaktirate vašeg predstavnika ili koristite stranicu za podršku.

Prilagođene integracije - jednostavna jedinstvena prijava (SSO)

Sa Simple SSO-om, možemo obezbediti widgetu za komentare informacije o korisniku tako da ne moraju da unose svoje korisničko ime ili email da bi komentarisali.

Možemo konfigurisati Simple SSO 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"
            ],
            "override": false
        }
    }
}];
</script>

Korisnik će biti prijavljen, i biće kreiran SSO User u pozadini. Korisnik će imati createdFromSimpleSSO postavljeno na true ako je dohvaćen iz API-ja.

Notes:

Email je jedinstveni identifikator za Simple SSO.
Navođenje email adrese uz Simple SSO nije obavezno, međutim po defaultu njihovi komentari će se prikazivati kao "Unverified". Ako nije obezbeđen email, korisnik ne može biti u potpunosti autentifikovan.
NOVO Od januara 2022: Korisnička imena ne moraju biti jedinstvena na celom fastcomments.com
Simple SSO može automatski da kreira i ažurira SSO korisnike, ako je email obezbeđen, i ako korisnik nije originalno kreiran preko Secure SSO.
Možete odrediti bedževe za korisnika pomoću svojstva badgeConfig. Niz badgeIds sadrži ID-jeve bedževa koji će biti povezani sa korisnikom. Ako je override postavljen na true, zamenit će sve postojeće bedževe prikazane na komentarima; ako je false, dodaće se postojećim bedževima.

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 jedinstvene prijave (SSO)

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

Međutim, samo ovo ne osigurava vaše niti komentara, pošto su po defaultu podaci komentara javno dostupne informacije - bilo ko ko može da pregleda stranicu može videti i komentare.

No-Code Setup

Možemo onemogućiti pregledanje i interakciju sa našim nitima komentara, kada je SSO podešen, kreiranjem pravila prilagođavanja.

Kada to uradite, pretražite SSO i naći ćete ovu opciju:

Require SSO To View Comments

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

Only Protect a Certain Domain or Page

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

Na vrhu korisničkog interfejsa za prilagođavanje naći ćemo dva unosa, Domain 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, možete ovde uneti tip ID-a umesto URL-a.

Security Levels

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 heširanim vašim API key-jem da bi bio vidljiv.

Opcija nivoa bezbednosti će se pojaviti kada izaberete "Require SSO To View Comments".

Protection Beyond Reading

Ako je ova opcija omogućena, stranica ili domen će biti zaštićeni od komentarisanja osim ako korisnik nije prijavljen preko SSO.

Napomene

Svi 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

Po podrazumevanoj postavci, FastComments će zahtevati e-poštu za komentarisanje. Ne mora da bude važeća adresa e-pošte, međutim dok korisnik ne klikne na link poslat njima, njihov komentar će prikazati oznaku "Nepotvrđen komentar".

Međutim, možemo ukloniti zahtev za e-poštom. Polje za unos e-pošte će i dalje biti vidljivo, ali više neće biti obavezno.

Ovo se može konfigurirati putem korisničkog interfejsa za prilagođavanje widgeta:

Enabling Anonymous Comments

Sprečavanje isteka anonimnih komentara

FastComments može biti konfigurisan da uklanja neverifikovane komentare nakon željenog broja dana. Ovo pomaže u borbi protiv spama.

Podrazumevano, ne uklanja.

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

Moderation Settings

Onemogućavanje unosa e-pošte

Kada korisnici komentarišu, a nisu prijavljeni, biće im zatraženo da navedu svoju email adresu.

To će za tog korisnika kreirati "nepotvrđenu sesiju", i tražićemo od njega da tu sesiju potvrdi putem email-a.

Za neke sajtove ili aplikacije poželjno je ne tražiti od korisnika njegovu email adresu prilikom komentarisanja ili glasanja.

Omogućavanje anonimnog komentarisanja čini polje za unos email-a opcionalnim. Međutim, možemo ga u potpunosti onemogućiti. Prvo omogućite anonymous commenting, i zatim će se pojaviti opcija za onemogućavanje polja za unos email-a.

Disable Email Inputs

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

Imajte na umu da će, sa ovom konfiguracijom, svi komentari biti nepotvrđeni osim ako korisnik ne napravi nalog i ne prijavi se na https://fastcomments.com.

Možda biste želeli razmotriti isključivanje oznake 'nepotvrđeno'.

Onemogućavanje oznake 'nepotvrđeno'

Po defaultu, FastComments će prikazati oznaku "Neverifikovan komentar" za komentare koji su ostavljeni za korisnika koji ima neverifikovanu sesiju u pregledaču. Pročitajte više o neverifikovanom komentisanju ovde.

Disable The Unverified Label

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>

Pored toga, ova funkcija se može koristiti, bez pisanja koda, u korisničkom interfejsu za prilagođavanje:

Disable The Unverified Label

Dozvoli anonimno glasanje

Kada korisnici pokušaju da glasaju za komentar, a nisu prijavljeni, biće im zatraženo da navedu svoje korisničko ime i e-poštu.

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

Allow Anonymous Votes

Podešavanje podrazumevanog korisničkog imena

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

U slučaju anonimnog komentarisanja, ponekad je poželjno definisati podrazumevano korisničko ime kako bi se smanjilo trenje prilikom komentarisanja. Ovo se može uraditi u interfejsu za prilagođavanje. Anonimno komentarisanje mora biti prvo omogućeno.

Setting The Default Username

Povratni pozivi

Sve biblioteke za widget za komentare (trenutno Angular, React, Vue) podržavaju callback-ove.

Callback-ovi 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 callback-ova

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.FastCommentsUI(document.getElementById('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čite podrazumevano ponašanje (otvaranje fastcomments.com profila korisnika).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // emuliranje asinhronog ponašanja (pozivanje API-ja itd).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // comments su sortirani prema podrazumevanom poretku na stranici koji može biti 'Most Relevant' (npr: najviše upvotovani, itd), ili 'Newest First'
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    });
</script>

Ručno određivanje lokalizacije korisnika

Po podrazumevanoj vrednosti, FastComments će prikazati widget za komentare u lokalu koji je određen podešavanjima sistema i pregledača korisnika.

Kada korisnik ostavi komentar ili se prijavi, ažuriramo njihov poslednji korišćeni lokal i koristimo ga i za slanje e‑poruka.

Ovo utiče na način na koji je widget za komentare preveden za korisnika. Lokal se sastoji od jezika korisnika i regiona, tako da konfiguracija lokala će obično promeniti jezik koji se koristi za prikaz teksta korisniku.

Preko korisničkog interfejsa

Ovo se može definisati koristeći interfejs za prilagođavanje widgeta. Pogledajte opciju "Lokal / Jezik":

Changing The Locale / Language

Putem koda

Ovo se može prebrisati željenim lokalom.

Manually Defining the User's Locale

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 lokala

Kompletan spisak podržanih jezika i odgovarajućih kodova lokala možete pronaći ovde.

Napomena za SSO

Ako koristite SSO, možda ćete želeti da prosledite lokal korisnika u user object, tako da su e‑poruke i druge stvari pravilno lokalizovane za njih.

Ograničavanje dozvoljenih jezika

Po podrazumevanoj postavci, 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 podesiti bez kodiranja, na stranici za prilagođavanje widgeta:

Allowed Languages

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

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

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čavanje novih odgovora i onemogućavanje glasanja

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

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

Postavljanje niti komentara na samo za čitanje

Copy

Run

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

Ovo se može prilagoditi bez koda, na stranici za prilagođavanje widgeta, za čitav domen, ili stranicu:

Postavljanje niti komentara na samo za čitanje

Ažuriranje!

Od novembra 2022. godine, niti se mogu zaključavati ili otključavati u realnom vremenu od strane administratora i moderatora putem menija sa tri tačke iznad polja za odgovore.

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

Ovo odgovara polju isClosed u Page API-ju.

Ograničavanje domena linkova

Podrazumevano, FastComments dozvoljava linkovanje ka bilo kom eksternom sajtu.

Ovo se može ograničiti umesto toga na željenu listu sajtova ili domena. Pokušaj da se objavi link ka sajtu ili domenu, koji nije na definisanoj listi prouzrokovaće da se korisniku prikaže greška.

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

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

Restrict External Link Domains

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ćavanje linkova komentatora

Prema zadatim podešavanjima, FastComments će od korisnika tražiti samo njihov komentar, korisničko ime i e-poštu.

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 kako bi korisnik ostavio URL svog sajta 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 taj URL navede, nalog korisnika će biti ažuriran i sva njihova korisnička imena na svim prošlim i budućim komentarima biće povezana sa ovim URL-om.

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

Enabling Commenter Links

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

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

Kada je ova postavka omogućena, to će izazvati mali iskačući prozor koji prikazuje poruku da se korisnik prijavljuje. Ovaj popup se prikazuje kad god korisnik stupi u interakciju sa widgetom za komentare; na primer, ako ostavi komentar.

Ovo možemo uraditi u kodu podešavanjem zastavice enableThirdPartyCookieBypass na true:

Ovo takođe možemo podesiti putem korisničkog interfejsa za prilagođavanje widgeta, pod Enable Third-Party Cookie Popup:

Enabling Third-Party Cookie Bypass

Brisanje komentara koji imaju odgovore

Po podrazumevanju, korisnici mogu da obrišu svoje komentare. Takođe, brisanje njihovog komentara automatski briše sve podređene i privremene komentare u niti. Ovo ponašanje važi i uživo.

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

Umesto toga, anonimizujte obrisani komentar (postavite name i text na [deleted] ili na prilagođenu vrednost).
Ne dozvolite brisanje komentara kada postoje odgovori. Prikazuje se prilagodljiva poruka o grešci.
Ograničite mogućnost brisanja komentara koji imaju odgovore samo na administratore i moderatore.

Ovo se može konfigurisati putem odeljka Comment Thread Deletion u UI za prilagođavanje widgeta.

Customize Delete Behavior for Replies

Prikaz znački u gornjoj traci

Po podrazumevanju, FastComments prikazuje značke korisnika samo na njihovim komentarima unutar niti komentara.

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

Show Badges in Top Bar Option

Ovo će prikazati značke korisnika pored njihovog imena u gornjem delu trake, čineći njihova postignuća i status istaknutijim dok pišu komentar.

Imajte na umu da ova funkcija mora biti omogućena u UI-ju za prilagođavanje widgeta da bi radila. Opcionalno možete postaviti zastavicu showBadgesInTopBar na false u konfiguraciji svog koda da biste je selektivno onemogućili čak i kada je uključena na serverskom nivou:

Disable Show Badges in Top Bar

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>

---

Prethodni vodič Sledeći vodič

Jezik 🇷🇸 Srpski (Latinica)

Osnove

Izgled i dojam

Komentarisanje uživo

Straničenje i sortiranje

Polje za odgovor

SSO

Anonimno komentarisanje

Razno

Prilagođavanja i konfiguracija

Kontekst

Identifikacija vašeg naloga

Kako su komentari povezani sa stranicama i člancima

Napomene

Prikazivanje istih komentara na različitim stranicama

Prilagođeni stilovi

External CSS Files

In Code - Not Recommended

User Profile Modal Styling

Backwards Compatibility

Prilagođeni fontovi

Kako definisati font

Uklanjanje brenda

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

Prebacivanje tamnog režima

Prepisivanje teksta

Promena podrazumevanog avatara

Onemogućavanje avatara

Onemogućavanje svih podrazumevanih stilova

Povezivanje komentara sa stranicama

Automatsko sklapanje odgovora

Omogućavanje WYSIWYG uređivača

Onemogućavanje alatne trake

Onemogućavanje blokiranja

Određivanje koju stranicu prikazati

Prebacivanje niti komentara bez ponovnog učitavanja stranice

Angular, React, Vue, i dr.

VanillaJS

Apsolutni datumi (onemogući čitljive vremenske oznake)

Prikazivanje i apsolutnih i relativnih datuma

Dodavanje teksta zaglavlja

Prikazivanje linkova kao teksta

Prebacivanje komentara dugmetom

Prilagođavanje teksta broja komentara

Onemogućavanje preusmeravanja slika

Onemogućavanje automatskog kreiranja haštagova

Isključivanje zvona za obaveštenja

Onemogućavanje profila

Onemogućavanje poruke o uspehu

Promena ocene sadržaja GIF-ova

Moderacija sadržaja slika

Promena stila glasanja

Onemogućavanje brisanja

Onemogućavanje uređivanja

Isticanje novih komentara

Veličine stranica

Šabloni e-pošte

Formati korisničkih imena

Onemogućavanje postavljanja slika

Omogućavanje polja za pretragu

Omogućavanje spoilera

Omogućavanje prikaza broja pregleda komentara

Prikazivanje uživo komentara odmah

Onemogućavanje komentarisanja uživo

Novi uživo komentari na dnu

Omogućavanje beskonačnog skrolovanja

Promena podrazumevanog smera sortiranja

Prikaz svih komentara odjednom - onemogući paginaciju

Premeštanje polja za odgovore posle komentara

Ograničavanje dužine komentara

Onemogućavanje komentara u više redova

Ograničenje broja komentara po korisniku

Sprečavanje novih komentara na prvom nivou

Maksimalna dubina odgovora

Pregled jedinstvene prijave (SSO)

How do I get it?

User and Comment Migrations

WordPress Users

WordPress SSO - Moderators

Custom Integrations