Customizations & Configuration

Prilagodbe i konfiguracija

Kontekst

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

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

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

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

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

Identifikacija vašeg računa

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

Demo Tenant ID

Copy

Run

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

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

Defining Your Tenant ID

Copy

Run

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

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

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

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

Kako su komentari povezani sa stranicama i člancima

When rendering a comment thread, or leaving a comment, FastComments needs to know what page, or article, or product those comments belong to.

To do this, we use something we call the "URL ID". It's either an identifier, like a string or a number, or a URL.

By default, if you do not specify the urlId, it will become the page URL. We will take the current page URL, and clean it to remove any common marketing parameters or tracking identifiers.

In the case of third party integrations, like WordPress, our plugin will usually use the identifier that represents the current information being viewed as the URL ID, for example the article/page id.

Definiranje prilagođenog URL ID-a

Copy

Run

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

One thing that we'll often reference in this document is the Sučelje za prilagodbu widgeta.

This UI can be used to make many changes to the comment widget without using code.

When creating a customization rule, we'll often want it to apply to all pages to our site. However, in some cases we want to customize the comment widget on a particular page, either to apply custom styling, or maybe make comments for that particular page anonymous. You could also, for example, have live comments appear right away on some pages, while hiding them under notification buttons on others.

This is all possible via the URL ID input field on this page, which looks like as follows:

Unos URL ID-a na stranici za prilagodbu widgeta

The value in this field should match the urlId parameter passed into the comment widget. If you want your customization rule to be urlId agnostic, leave this field empty or enter *.

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

If your page has hash parameters (like example.com#page-1) - this will become part of the URL ID, by default.
During migrations, for example from WordPress to Gatsby, you may have to migrate the URL ID comment values after the initial migration. For that, reach out to us.

Prikaz istih komentara na različitim stranicama

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

The Same Comments on Multiple Pages

Copy

Run

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

Prilagođeni stil

FastComments je dizajniran da se može prilagoditi. Sam widget za komentare radi unutar iframe-a iz sigurnosnih razloga, pa za primjenu prilagođenog stiliziranja morate slijediti jedan od dva pristupa.

Prvi, najjednostavniji pristup, i onaj koji mi preferiramo, jest korištenje stranice za prilagodbu widgeta.

U stranici za prilagodbu widgeta pogledajte odjeljak "Show Advanced Options", ispod kojeg se nalazi područje označeno "Custom CSS":

Područje za unos prilagođenog CSS-a

Ovaj pristup ima nekoliko prednosti:

Uneseni CSS se minificira prije nego se pošalje korisniku, a oblikovanje se održava konzistentnim u sučelju za uređivanje.
Dobivate sve prednosti sučelja za prilagodbu widgeta, na primjer lako prilagođavanje widgeta za komentare drugačije za različite stranice.
Kada napravimo promjene u widgetu za komentare, vaše prilagođeno stiliziranje će biti testirano kao dio našeg procesa objave.

Drugi pristup je specificirati parametar customCSS u konfiguraciji widgeta, kako slijedi:

Prosljeđivanje prilagođenog CSS-a

Copy

Run

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

Međutim, ovo ima ograničenja:

Postoji ograničenje koliko prilagođenog CSS-a se može proslijediti prije nego što naši serveri odbiju zahtjev zbog veličine zaglavlja.
Morate upravljati prilagođenim CSS-om u vlastitoj infrastrukturi i sustavu za gradnju. To također može biti prednost umjesto nedostatka.
Postoji dodatno opterećenje slanja prilagođenog CSS-a preko mreže dvaput u ovom slučaju, jer ga treba poslati našim serverima, a zatim vratiti u sadržaju iframe-a. Međutim, za većinu veličina sadržaja, to nije uočljivo.
Uobičajena optimizacija je minificiranje CSS-a kako bi se smanjila njegova veličina na mreži, no s ovim pristupom to ćete morati sami riješiti.
Vaš prilagođeni CSS neće biti testiran kada mi napravimo promjene.

Vanjske CSS datoteke

Možete instruirati widget da preuzme vanjsku datoteku koristeći @import!

Preporučuje se staviti @import u pravilo za prilagodbu. Na taj način, ako ikada budemo morali napraviti promjenu widgeta za komentare, možemo upotrijebiti našu automatizaciju za provjeru vaše konfiguracije. Na primjer, kreirali biste pravilo za prilagodbu u sučelju za prilagodbu widgeta, kliknuli Advanced, i unijeli u Custom CSS:

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

U kodu - nije preporučeno

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

Vanjska CSS datoteka

Copy

Run

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

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

Stiliziranje modalnog prozora korisničkog profila

Modalni prozori korisničkih profila također se mogu stilizirati prilagođenim CSS-om. Međutim, kako bi se osiguralo da se prilagođeno stiliziranje primijeni na korisničke profile, svi CSS selektori moraju biti prefiksirani s .user-profile. Bez ovog prefiksa, prilagođeno stiliziranje će biti ignorirano za modale korisničkih profila.

Na primjer:

CSS korisničkog profila

Copy

Run

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

Povratna kompatibilnost

U FastCommentsu znamo da naši korisnici prilagođavaju widget za komentare. To je namjerno dizajnirano - zadnje što želimo je da naš proizvod uzrokuje dizajnerske nedosljednosti u vašem proizvodu.

Budući da je ovo važan dio našeg proizvoda, imamo proces izgradnje koji nam omogućava pregled promjena widgeta za komentare, za svakog korisnika, pri svakoj objavi.

Ako pronađemo manje probleme, ažurirat ćemo vaš račun kako bismo osigurali glatku objavu. Ako uočimo velike kritične promjene, to nam omogućava zaustavljanje objave.

Prilagođeni fontovi

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

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

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

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

Kako definirati font

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

Primjer prilagođenog vanjskog fonta

Copy

Run

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

Uklanjanje brendiranja

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

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

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

Podrška tamnim pozadinama (tamni način rada)

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

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

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

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

Force Dark Background Mode

Copy

Run

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

Prebacivanje tamnog načina rada

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

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

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

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

Potpuni primjer prebacivanja tamnog načina

Copy

Run

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

Prepisivanje teksta

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

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

Po zadanom se tekst u widgetu za komentare prevodi prema korisničkoj lokalnoj postavci. Međutim, možemo prebrisati tekst, ako smo sigurni da naša baza korisnika koristi istu lokalnu postavku/jezik, na primjer:

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 prijevode možete pronaći ovdje pod karticom "advanced options".

Međutim, postoji lakši način, putem korisničkog sučelja za prilagodbu widgeta. Tamo možemo jednostavno pronaći tekst koji se prikazuje u widgetu za komentare u EN_US lokalizaciji, i navesti zamjenski tekst.

Custom Text

Sve zamjene prijevoda trenutno utječu na sve lokalizacije.

Promjena zadane slike avatara

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

Međutim, ako ne pronađemo avatar, ili korisnik nikada ne postavi jedan u svom računu, prikazujemo statičnu zadanu sliku avatara.

Za određivanje vlastite statične slike avatara možemo koristiti postavku 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 također može učiniti bez koda. Na stranici za prilagodbu widgeta pogledajte odjeljak "Zadani avatar".

Customizing The Default Avatar

Imajte na umu da je definiranje avatara za pojedinog korisnika, kao npr. pomoću SSO-a, obuhvaćeno u zasebnom odjeljku.

Onemogućavanje avatara

Avatare je moguće u potpunosti ukloniti iz widgeta za komentare, čak i ako su korisnici postavili vlastiti avatar.

Hiding Avatars

Copy

Run

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

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

Hiding Avatars

Onemogućavanje svih zadanih stilova

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

Svi zadani stilovi mogu se ukloniti postavljanjem parametra noStyles na true, na sljedeći način:

Disabling All Default Styles

Copy

Run

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

Ovo se može prilagoditi bez korištenja koda, na stranici za prilagodbu widgeta, pod Naprednim opcijama:

Disabling All Default Styles

Povezivanje komentara sa stranicama

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

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

Defining a Custom URL

Copy

Run

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

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

Defining Custom URL and URL IDs together

Copy

Run

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

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

Skrivanje odgovora prema zadanim postavkama

Prema zadanim postavkama, odgovori na komentare najviše razine su vidljivi.

To se može konfigurirati tako da korisnik mora kliknuti "Prikaži odgovore" na komentarima najviše razine da bi vidio 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 prilagodbu widgeta:

Collapse Replies

Ova postavka neće utjecati na broj komentara najviše razine koji se inicijalno učitavaju. Ako imate jedan komentar najviše razine i 29 podkomentara, s uključenom ovom postavkom vidjet ćete:

Vidjet ćete komentar najviše razine.
Vidjet ćete 'Prikaži odgovore (29)' ispod ovog komentara.

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

Omogući WYSIWYG uređivač

Prema zadanim postavkama, funkcionalnosti formatiranja u FastComments postižu se dodavanjem vidljivih anchor tagova poput <b></b> oko vašeg teksta. Klikom na alatnu traku ili korištenjem prečaca to se radi za vas. Međutim, neke zajednice možda žele odlučiti se za korištenje formatiranja bez anchor tagova. To se naziva omogućavanjem WYSIWYG (ono što vidiš je ono što dobiješ) uređivača. Ovaj uređivač izgleda točno isto kao zadani, osim što učitava neki dodatni kod koji korisnicima omogućuje podebljavanje, podcrtavanje i slično njihovog teksta bez vidljivih anchor 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đer može učiniti i bez koda. Na stranici za prilagodbu widgeta potražite opciju "Omogući napredno formatiranje".

Enable WYSIWYG

Prema zadanim postavkama, FastComments će prikazati alatnu traku pri pisanju komentara kako bi pružio prečace za uređivanje teksta i prijenos slika.

Ova alatna traka može se onemogućiti u kodu ili putem sučelja za prilagodbu.

Ovo se također može učiniti bez koda. Na stranici za prilagodbu widgeta pogledajte opciju "Onemogući alatnu traku za odgovore".

Disabling The Toolbar

Onemogućavanje blokiranja

Po zadanim postavkama, FastComments korisnicima omogućuje blokiranje drugih korisnika. Blokiranje korisnika uzrokovat će da njihovi komentari budu zamagljeni, spriječiti će obavijesti između korisnika i slično.

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

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đer može učiniti bez koda, što također omogućuje ispravnu validaciju na strani poslužitelja, putem sučelja za prilagodbu widgeta:

Disable Blocking

Određivanje koju stranicu prikazati

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

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

Specifying The Page to Render

Copy

Run

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

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

Prebacivanje niti komentara bez ponovnog učitavanja stranice

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

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

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

Angular, React, Vue, itd

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

VanillaJS

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

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

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

Primjer promjene hash-a stranice

Copy

Run

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

Apsolutni datumi (onemogućavanje čitljivih vremenskih oznaka)

Po zadanim postavkama koriste se lokalizirani relativni datumi. Na primjer, pored nedavno ostavljenog komentara možete vidjeti "prije 11 minuta".

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

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

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

Use Absolute Dates

Prikaz i apsolutnih i relativnih datuma

Po zadanoj postavci koriste se lokalizirani relativni datumi. Na primjer, uz nedavno objavljeni komentar možete vidjeti "prije 11 minuta".

Može biti potrebno ili poželjno zadržati ovaj relativni format datuma, ali također 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 prilagodbu widgeta, pod Advanced Options. Najprije ćete morati omogućiti Absolute Dates da biste vidjeli ovu opciju u korisničkom sučelju.

Use Both Absolute and Relative Dates

Dodavanje zaglavnog teksta

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

To nazivamo zaglavljem, a prema zadanim postavkama 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 prilagodbu widgeta, pod Naprednim opcijama:

Specifying Header HTML

Prikaz poveznica kao teksta

Po zadanoj postavci, FastComments će prikazati poveznice ovako: https://exmaple.com - gdje URL poveznice postaje klikabilni HTML anchor tag.

Neki sajtovi možda žele onemogućiti ovo, npr. kako bi obeshrabrili prevarante. To omogućujemo postavljanjem Comment HTML Rendering Option na Links as Text.

Ovo se može prilagoditi bez koda, na stranici za prilagodbu widgeta, za cijeli domen, ili pojedinačnu stranicu:

Render Links as Text

Prebacivanje komentara pomoću gumba

Prema zadanim postavkama, FastComments će prikazati polje za unos komentara i nit komentara istovremeno. Kako bi uštedio malo okomite površine, također će sakriti sva ostala obavezna polja dok se widget ne upotrijebi.

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

Click to Show Comments

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

Click to Show or Hide Comments

Copy

Run

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

Ovo je namijenjeno zamjenjivanju konfiguracije hideCommentsUnderCountTextFormat.

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

Ovo se može omogućiti bez koda stvaranjem pravila prilagodbe i omogućavanjem "Kliknite 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 se može zamijeniti bilo kojim tekstom, a vrijednost [count] bit će zamijenjena brojem, lokaliziranim 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 prilagodbu widgeta:

Customizing The Comment Count Text

Onemogućavanje preusmjeravanja slika

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

Disable Image Redirect

Copy

Run

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

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

Onemogućavanje automatskog stvaranja hashtagova

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

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

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

Disabling Automatic HashTag Creation

Onemogućavanje zvona za obavijesti

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

Zvono će postati crveno i prikazat će broj obavijesti koje korisnik ima. Neki primjeri obavijesti su:

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

Zvono za obavijesti također pruža mogućnost pretplate na cijelu stranicu.

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

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 je moguće i bez koda. Na stranici za prilagodbu widgeta pogledajte odjeljak "Onemogući zvono obavijesti".

Disable Notification Bell

---

Onemogućavanje profila

Prema zadanim postavkama, FastComments će prikazati korisnički profil 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>

To se može učiniti i bez koda. Na stranici za prilagodbu widgeta, pogledajte odjeljak "Onemogući profile".

Disable Profiles

Onemogućavanje poruke o uspjehu

Po zadanom, FastComments prikazuje poruku o uspjehu nakon komentiranja. To se može onemogućiti na sljedeći način:

Disable Success Message

Copy

Run

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

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

Disable Success Message

Promjena ocjene sadržaja GIF-ova

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

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

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

Set Gif Rating

Copy

Run

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

U UI-ju, to ćete pronaći pod Gif Picker Rating sve dok Disable Image Uploads? nije označeno.

Setting The Gif Rating

Moderiranje sadržaja slika

Po zadanim postavkama, FastComments widget za komentare ima moderaciju sadržaja slika isključenu off.

Dostupne opcije su off, low, medium i high.

U sučelju za prilagodbu widgeta, ovo ćete pronaći pod Image Content Moderation Level, pod uvjetom da opcija Disable Image Uploads? nije označena.

Setting The Image Content Moderation Level

Promjena stila glasovanja

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

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

Koristimo zastavicu voteStyle na sljedeći način:

Enable Heart Button

Copy

Run

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

Toplo preporučamo da to učinite bez koda jer to također omogućuje provjere na strani poslužitelja. Na stranici za prilagodbu widgeta pogledajte odjeljak "Stil glasanja".

Change Voting Style

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

Onemogućavanje brisanja

Po zadanim postavkama, FastComments dopušta korisnicima brisanje njihovih komentara.

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

Na stranici za prilagodbu widgeta pogledajte opciju "Onemogući brisanje".

Disable Comment Deleting

Ovo utječe samo na obične komentatore, a ne na moderatore ili administratore, koji će i dalje moći brisati.
Ovo će također utjecati na API integracije kada se proslijedi contextUserId.

Onemogućavanje uređivanja

Po zadanim postavkama, FastComments će dopustiti korisnicima da uređuju svoje komentare.

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

Na stranici za prilagodbu widgeta pogledajte opciju "Onemogući uređivanje".

Disable Comment Editing

Ovo utječe samo na obične komentatore, a ne na moderatore ili administratore, koji će i dalje moći uređivati.
Ovo će također utjecati na API integracije kada se proslijedi contextUserId.

Isticanje novih komentara

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

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

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

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

Veličine stranica

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

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

Imajte na umu da promjena veličine stranice zahtijeva ponovno izračunavanje svih niti komentara na vašem računu. To može potrajati nekoliko minuta.

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

Primjer konfiguracije prikazan je u nastavku:

Custom Page Sizes

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

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

Predlošci e-pošte

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

Formati korisničkih imena

Po zadanom, FastComments će prikazati ime korisnika kako su ga unijeli ili kako nam je proslijeđeno putem SSO.

Ipak, može biti poželjno zamaskirati ili prikazati korisnikovo ime na drugačiji način. Na primjer, ako je korisnikovo ime Allen Rex, možda želite prikazati samo "Allen R.".

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

Change Name Format

Dostupni formati su:

Početna velika slova (prikazuje Example User kao Example User)
Inicijal prezimena (prikazuje Example User kao Example U.)
Svi inicijali (prikazuje Example User kao E. U.)
Prikaži "Anoniman"

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

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

Onemogućavanje učitavanja slika

Po zadanom FastComments omogućuje prijenos slika. To se može onemogućiti postavljanjem 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 prilagodbu widgeta:

Disabling Image Uploads

Omogući okvir za pretraživanje

Po zadanim postavkama u widgetu za komentare nije prikazan okvir za pretraživanje.

Međutim, to 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 se također može napraviti bez koda. Na stranici za prilagodbu widgeta potražite opciju "Omogući okvir za pretraživanje".

Enable Search Box

Omogućivanje spoilera

Možemo omogućiti podršku za spoilere 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 učiniti i bez koda. Na stranici za prilagodbu widgeta pogledajte opciju "Omogući spoilere".

Enable Spoilers

Kada je tekst označen, i sada vidljivi SPOILER gumb kliknut, tekst će biti zamaskiran dok korisnik ne prijeđe mišem preko njega. Za tamni način rada radimo isto, s različitim bojama koje bolje odgovaraju tamnom načinu rada.

Ovo je također kompatibilno s WYSIWYG uređivačem.

Omogućavanje broja pregleda komentara

Prema zadanim postavkama, FastComments ne bilježi tko je pogledao svaki komentar niti ne pruža statistike o tome.

Međutim, ovu značajku možemo uključiti, i tada će sustav početi pratiti kada se svaki korisnik pomakne do komentara.

Kada se to dogodi, broj pored ikone oka na svakom komentaru će se povećati. Broj se ažurira uživo i skraćuje prema lokalnim postavkama korisnika.

Ovo možemo 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>

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

Enabling Comment View Counts

Pratimo user id* koji je pogledao komentar, tako da se ponovnim pregledom komentara broj neće povećati. Ako komentar ponovno pregledate nakon dvije godine, broj će se ponovno povećati.

*Napomena: ili anon session id, ili IP korisnika kao haširana vrijednost.

Prikazivanje komentara uživo odmah

Po zadanim postavkama, komentiranje uživo je omogućeno. To znači da ako se bilo koji komentari dodaju, izbrišu, urede ili pričvrste, promjene bi se trebale pojaviti svim korisnicima koji u istom trenutku gledaju nit komentara.

Međutim, prema zadanim postavkama ti novi komentari pojavljuju se ispod dinamički prikazanog gumba s tekstom sličnim "Prikaži 2 nova komentara".

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

To sprječava stalno mijenjanje veličine stranice za korisnika, što može izazvati frustraciju pri pokušaju hvatanja klizača za pomicanje.

Za neke slučajeve upotrebe, poput živog licitiranja ili online događaja, ovo nije poželjno ponašanje - možda ćete htjeti da widget za komentiranje bude više poput "chat" okvira gdje se novi komentari "prikažu odmah".

Otud i ime zastavice koja omogućava tu značajku: showLiveRightAway.

Možemo ga uključiti na sljedeć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 prilagodbu widgeta:

Show Live Comments Right Away

Onemogućavanje komentiranja uživo

Po zadanim postavkama, FastComments ima omogućeno komentiranje uživo.

To znači da će svaki gledatelj niti komentara vidjeti isti sadržaj.

Na primjer, ako se doda komentar, taj će komentar biti prikazan. Ako se komentar uredi ili ukloni, ti će komentari biti uređeni ili uklonjeni za sve gledatelje niti. Isto vrijedi za glasove i sve radnje moderiranja.

Međutim, možemo to 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 učiniti i bez koda. Na stranici za prilagodbu widgeta pogledajte odjeljak "Onemogući komentiranje uživo".

Disable Live Commenting

Novi komentari uživo na dnu

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

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

New Live Comments to Bottom

Copy

Run

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

Kada je ova postavka omogućena:

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

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

Omogućavanje beskonačnog pomicanja

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

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

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

Enabling Infinite Scrolling

Copy

Run

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

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

Omogućavanje beskonačnog pomicanja

Copy

Run

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

Potpuni radni primjer bio bi:

Enabling Infinite Scrolling

Copy

Run

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

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

Promjena zadanog smjera sortiranja

Po zadanom, FastComments će sortirati komentare prema smjeru sortiranja "Najrelevantnije".

Sortiranje "Najrelevantnije" uzima u obzir vrijeme ostavljanja komentara i broj glasova prilikom sortiranja.

Korisnik zatim može promijeniti smjer sortiranja u korisničkom sučelju widgeta komentara na "Najstariji prvo" ili "Najnoviji prvo".

Međutim, zadanu vrijednost možemo postaviti na bilo koje od ta tri. Na primjer, ako želite prikazati najstarije komentare prvo:

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 vrijednost defaultSortDirection na "OF" kako bismo postavili smjer na "OF".

Za smjer sortiranja "Najnoviji prvo", učinili bismo sljedeć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>

Valjane vrijednosti za defaultSortDirection su:

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

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

Changing The Default Sort Direction

Imajte na umu da su komentari na svakoj stranici za svaki smjer sortiranja unaprijed izračunati, tako da svi smjerovi sortiranja imaju iste performanse.

Prikaz svih komentara odjednom - onemogućavanje straničenja

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 iza komentara

Po zadanom je područje za unos komentara ispred niti komentara. Međutim, postavljanjem ovog konfiguracijskog parametra na true možemo ga premjestiti iza.

Moving The Reply Box to The Bottom

Copy

Run

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

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

Moving The Reply Box to The Bottom

Ograničavanje duljine komentara

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

Zadano je 2000.

URL-ovi slika se ne računaju u određivanju duljine.

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 prilagodbu widgeta:

Limit Comment Length

Onemogućavanje višerednog komentiranja

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

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

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

Enable Single-Line Comment Input

Copy

Run

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

To se također može učiniti bez koda. Na stranici za prilagodbu widgeta pogledajte odjeljak "Omogući unos komentara u jednom retku".

Enable Single-Line Comment Input

Imajte na umu da su komentari na svakoj stranici za svaki smjer sortiranja prethodno izračunati, pa svi smjerovi sortiranja imaju istu izvedbu.

Ograničenje broja komentara po korisniku

Po zadanim postavkama, 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 (heširano).

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

Limiting Comment Volume Per User

Imajte na umu da, ako koristite comment creation API, možda ćete htjeti proslijediti korisnikovu izvornu ip adresu u zahtjevu našem backendu kako bi se ograničavanje stope primjenjivalo po korisniku, a ne globalno na vaš račun.

Sprječavanje novih komentara na najvišoj razini

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

Prevent New Root Comments

Copy

Run

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

Maksimalna dubina odgovora

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

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

Limiting Reply Depth to 2 Levels

Copy

Run

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

With maxReplyDepth set to 2:

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

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

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

Pregled jedinstvene prijave (SSO)

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

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

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

Kako dobijem pristup?

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

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

Migracije korisnika i komentara

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

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

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

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

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

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

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

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

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

Korisnici WordPress-a

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

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

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

WordPress SSO - Moderatori

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

Prilagođene integracije

Za prilagođene integracije postoje dvije opcije.

Opcija jedna - Secure SSO

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

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

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

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

Zahtjevi

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

Prednosti

Sigurno.
Besprijekorno iskustvo komentiranja.

Nedostaci

Zahtijeva razvoj na backend-u.

Ažuriranje podataka korisnika

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

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

Secure SSO API

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

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

Opcija dva - Simple SSO

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

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

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

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

Zahtjevi

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

Prednosti

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

Nedostaci

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

Simple SSO API

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

Prilagođene integracije - sigurna jedinstvena prijava (SSO)

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

Postoji i dokumentacija u vezi migracije s drugih pružatelja usluga koji imaju slične SSO mehanizme, te razlike.

Tijek izgleda ovako:

Secure SSO tok

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

Iako koristimo ExpressJS u NodeJS primjeru i Spring u Java primjeru, u tim runtime okruženjima nisu potrebne dodatne biblioteke/okviri za implementaciju FastComments SSO - ugrađeni kriptografski paketi su dovoljni.

Ne morate pisati nove API krajnje točke s FastComments SSO. Jednostavno enkriptirajte korisnikove informacije koristeći svoj tajni ključ i proslijedite payload u komentar widget.

Nabavite svoj API tajni ključ

Svoj API Secret možete dobiti s ove stranice. Ovu stranicu također možete pronaći tako da odete na My Account, kliknete na pločicu API/SSO, a zatim kliknete "Get API Secret Key".

Parametri widgeta za komentare

Dokumentacija visokog nivoa za API komentarskog widgeta može se pronaći ovdje.

Idemo detaljnije objasniti što ti parametri znače.

Komentarski widget prima konfiguracijski objekt - već prosljeđujete ovaj objekt ako koristite FastComments za prosljeđivanje vašeg customer id (nazvan tenantId).

Da biste omogućili SSO, proslijedite novi objekt "sso", koji mora sadržavati sljedeće parametre. Vrijednosti bi trebale biti generirane na strani servera.

userDataJSONBase64: Podaci korisnika u JSON formatu, koji su zatim Base64 kodirani.
verificationHash: HMAC-SHA256 hash kreiran od UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch timestamp, u milisekundama. Ne smije biti u budućnosti, niti više od dva dana u prošlosti.
loginURL: URL koji komentarski widget može prikazati za prijavu korisnika.
logoutURL: URL koji komentarski widget može prikazati za odjavu korisnika.
loginCallback: Kada je pruženo umjesto login URL-a, funkcija koju će komentarski widget pozvati pri kliku na gumb za prijavu.
logoutCallback: Kada je pruženo umjesto logout URL-a, funkcija koju će komentarski widget pozvati pri kliku na gumb 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": 1768890091878,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout"
    }
}];
</script>

Objekt korisnika

The User object contains the following schema:

Objekt korisnika

Copy

interface SSOUser {
    /** Obavezno. Maksimalno 1k znakova. **/
    id: string;
    /** Obavezno. Maksimalno 1k znakova. Napomena: Mora biti jedinstven. **/
    email: string;
    /** Obavezno. Maksimalno 1k znakova. Napomena: Korisničko ime ne može biti e-adresa. Ne mora biti jedinstveno. **/
    username: string;
    /** Opcionalno. Maks. 3k znakova za URL-ove. Zadano je s gravatara temeljeno na e-pošti. Podržava 64 kodirane slike, u tom slučaju ograničenje je 50k znakova. **/ 
    avatar?: string;
    /** Opcionalno. Zadano false. **/
    optedInNotifications?: boolean;
    /** Opcionalno. Zadano false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Opcionalno. Maks. 100 znakova. Ovaj će se naziv prikazati uz njihovo ime. Zadano je Administrator/Moderator kada je primjenjivo. **/
    displayLabel?: string;
    /** Opcionalno. Maks. 500 znakova. Ovo će se prikazati umjesto korisničkog imena. **/
    displayName?: string;
    /** Opcionalno. Maks. 2k znakova. Ime korisnika će voditi na ovo. **/
    websiteUrl?: string;
    /** Opcionalno. Do 100 grupa po korisniku. ID grupe ne smije biti dulji od 50 znakova. **/
    groupIds?: string[];
    /** Opcionalno. Označava korisnika kao administratora. **/
    isAdmin?: boolean;
    /** Opcionalno. Označava korisnika kao moderatora. **/
    isModerator?: boolean;
    /** Opcionalno, zadano true. Postavite na false da omogućite karticu "aktivnost" u korisničkom profilu. **/
    isProfileActivityPrivate?: boolean;
    /** Opcionalno, zadano false. Postavite na true da onemogućite komentare na profilu. **/
    isProfileCommentsPrivate?: boolean;
    /** Opcionalno, zadano false. Postavite na true da onemogućite slanje izravnih poruka ovom korisniku. **/
    isProfileDMDisabled?: boolean;
}

Moderatori i administratori

For admins and moderators, pass the respective isAdmin or isModerator flags in the SSOUser object.

Obavijesti

To enable or disable notifications, set the value of optedInNotifications to true or false respectively. The first time the user loads the page with this value in the SSO payload, their notification settings will be updated.

Additionally, if you want users to receive notification emails for activity on pages they subscribed to (as opposed to just in-app notifications), then set optedInSubscriptionNotifications to true.

VIP korisnici i posebne oznake

You can display a special label next to the user's name by using the optional "displayLabel" field.

Neautentificirani korisnici

To represent an unauthenticated user, simply do not populate userDataJSONBase64, verificationHash, or timestamp. Provide a loginURL.

These users will not be able to comment, and instead will be presented with a login message (message, link, or button, depending on configuration).

Izravni primjeri serijalizacije i hashiranja podataka korisnika

More details as an examples ovdje (js), ovdje (java) and ovdje (php).

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

Prilagođene integracije - jednostavna jedinstvena prijava (SSO)

Pomoću Simple SSO-a možemo pružiti widgetu za komentare informacije o korisniku tako da ne moraju unositi svoje korisničko ime ili e-poštu da bi komentirali.

Simple SSO možemo konfigurirati na sljedeć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 u pozadini će se stvoriti SSO korisnik. Korisnik će imati createdFromSimpleSSO postavljeno na true ako je dohvaćen iz API-ja.

Napomene:

E-pošta je jedinstveni identifikator za Simple SSO.
Davanje e-pošte s Simple SSO-om nije obavezno, međutim, prema zadanim postavkama njihovi će komentari biti prikazani kao "Unverified". Ako e-pošta nije navedena, korisnik se ne može u potpunosti autentificirati.
NEW Od siječnja 2022.: Korisnička imena ne moraju biti jedinstvena širom fastcomments.com
Simple SSO može automatski stvarati i ažurirati SSO korisnike ako je e-pošta dostavljena i ako korisnik nije prvotno stvoren putem Secure SSO.
Možete specificirati značke za korisnika koristeći svojstvo badgeConfig. Niz badgeIds sadrži ID-jeve znački koje će se povezati s korisnikom. Ako je override postavljen na true, zamijenit će sve postojeće značke prikazane na komentarima; ako je false, dodat će ih postojećim značkama.

Prilagođene integracije - migracija s Disqus SSO

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

Prilagođene integracije - migracija s Commento SSO

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

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

Zaštita niti komentara pomoću jedinstvene prijave

FastComments SSO (detalji ovdje) omogućuje vašim korisnicima da komentiraju bez potrebe za prijavom na drugu platformu.

Međutim, samo to ne štiti vaše niti komentara, jer su prema zadanim postavkama podaci komentara javno dostupne informacije - svatko tko može pregledati stranicu može vidjeti komentare.

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

Postavljanje bez koda

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

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

Require SSO To View Comments

Omogućite je i spremite pravilo prilagodbe.

Zaštita samo određenog domena ili stranice

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

Na vrhu sučelja za prilagodbu pronaći ćemo dva unosa, Domena i URL ID.

Za zaštitu određene domene unesite odgovarajuću domenu u polje "domain".

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

Razine sigurnosti

Pri zahtjevu za SSO trebate odlučiti zahtijevate li Simple SSO ili Secure SSO. Ako zahtijevate Simple SSO, oba su dopuštena, ali ako zahtijevate Secure SSO tada se sadržaj mora dohvatiti sa Secure SSO payload-om heširanim vašim API ključem kako bi bio vidljiv.

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

Zaštita iznad samog čitanja

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

Napomene

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

Dozvoli anonimno komentiranje

Po zadanim postavkama, FastComments će zahtijevati adresu e-pošte za komentiranje. Ne mora biti valjana adresa e-pošte, međutim dok korisnik ne klikne na poveznicu poslan na nju, njihov komentar će prikazati oznaku "Nepotvrđeni komentar".

Međutim, možemo ukloniti zahtjev za adresom e-pošte. Polje za unos adrese e-pošte i dalje će se prikazivati, ali više neće biti obavezno.

Ovo se može konfigurirati putem korisničkog sučelja za prilagodbu widgeta:

Enabling Anonymous Comments

Sprječavanje isteka anonimnih komentara

FastComments se može konfigurirati da uklanja neprovjerene komentare nakon određenog broja dana. To pomaže u borbi protiv spama.

Po zadanim postavkama ne uklanja.

To se može konfigurirati, ili onemogućiti, putem stranice Postavke moderiranja.

Moderation Settings

Onemogućavanje unosa e-pošte

Kada korisnici komentiraju, a nisu prijavljeni, bit će im zatraženo da navedu svoju e-poštu.

To će stvoriti "nepotvrđenu sesiju" za tog korisnika, i zatražit ćemo od njih da potvrde tu sesiju putem e-pošte.

Za neke web-lokacije ili aplikacije poželjno je ne tražiti od korisnika njihovu e-poštu prilikom komentiranja ili glasovanja.

Omogućavanje anonimnog komentiranja čini polje za unos e-pošte opcionalnim. Međutim, možemo ga u potpunosti onemogućiti. Prvo, omogućite anonymous commenting, and then the option to disable the email input fields will appear.

Disable Email Inputs

Kad je ovo uključeno, polja za e-poštu se uopće neće prikazivati u svim našim proizvodima za komentiranje.

Imajte na umu da će, s ovom konfiguracijom, svi komentari biti nepotvrđeni osim ako korisnik ne stvori račun i ne prijavi se na https://fastcomments.com.

Možda biste htjeli razmotriti onemogućavanje oznake 'nepotvrđeno'.

Onemogućavanje oznake "Nepotvrđeno"

Po zadanim postavkama, FastComments će prikazati oznaku "Neprovjereni komentar" za komentare koji su ostavljeni korisniku koji ima nepotvrđenu sesiju preglednika. Više o neprovjerenom komentiranju pročitajte ovdje.

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>

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

Disable The Unverified Label

Dozvoli anonimno glasanje

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

Možemo ukloniti ovaj zahtjev, dopuštajući svima da glasaju za komentar bez ostavljanja ikakvih informacija.

Allow Anonymous Votes

Postavljanje zadanog korisničkog imena

Kada korisnici komentiraju ili glasaju, a nisu prijavljeni, bit će im zatraženo da unesu svoju e-poštu i korisničko ime.

U slučaju anonimnog komentiranja, ponekad je poželjno definirati zadano korisničko ime kako bi se smanjile prepreke pri komentiranju. To se može učiniti iz sučelja za prilagodbu. Prvo mora biti omogućeno anonimno komentiranje.

Setting The Default Username

Povratni pozivi

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

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

Podržani povratni pozivi su:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

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

Evo primjera sa svim korištenim povratnim pozivima:

Primjeri povratnih poziva

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; // vratite true da spriječite zadano ponašanje (otvaranje korisničkog profila na fastcomments.com).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // emuliranje asinkronog ponašanja (pozivanje API-ja itd).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // komentari su sortirani prema zadanom načinu sortiranja na stranici, koji može biti Najrelevantniji (npr. najviše glasova itd.) ili Najnoviji prvi
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    });
</script>

Ručno definiranje lokalne postavke korisnika

Prema zadanim postavkama, FastComments će prikazati widget za komentare u lokalizaciji koju određuju postavke korisnikovog sustava i preglednika.

Kad korisnik ostavi komentar ili se prijavi, ažuriramo zadnju korištenu lokalizaciju i koristimo je i za slanje e-poruka.

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

Putem korisničkog sučelja

To se može postaviti putem sučelja za prilagodbu widgeta. Pogledajte opciju "Lokalizacija / Jezik":

Changing The Locale / Language

Putem koda

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

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 lokalizacija

Puni popis podržanih jezika i odgovarajućih kodova lokalizacija možete pronaći ovdje.

Napomena o SSO

Ako koristite SSO, možda ćete htjeti proslijediti lokalizaciju korisnika u objektu user, kako bi e-poruke i ostalo bili ispravno lokalizirani za njih.

Ograničavanje dopuštenih jezika

Po zadanom, FastComments ne ograničava jezike koji se koriste za komentiranje.

Može biti poželjno ograničiti jezike koje zajednica koristi.

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

Allowed Languages

Sustav će analizirati njihov komentar i odrediti njegov jezik, a zatim ga usporediti s popisom dopuštenih jezika.

Ako je komentar napisan na jeziku koji nije dopušten, prikazuje se lokalizirana poruka o pogrešci.

Naslovi stranica

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

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

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

Specifying The Page Title

Copy

Run

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

Onemogućavanje novih odgovora i glasovanja

Komentiranje se može zaključati tako da se postavi zastavica readonly na true, čime će biti onemogućeno ostavljanje novih komentara ili davanje glasova.

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

Postavljanje niti komentara u način 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>

To se može prilagoditi bez kodiranja, na stranici za prilagodbu widgeta, za cijeli domen ili pojedinu stranicu:

Postavljanje niti komentara u način samo za čitanje

Ažuriranje!

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

To će spriječiti nove komentare, ali će i dalje omogućavati glasanje te korisnicima omogućiti brisanje svojih komentara ako to žele, dok readonly to ne dopušta.

Ovo odgovara polju isClosed u Page API-ju.

Ograničavanje domena poveznica

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

Ovo se može ograničiti na željeni popis web-mjesta ili domena. Pokušaj objave poveznice na web-mjesto ili domenu, koja nije na definiranoj listi prikazat će korisniku pogrešku.

Ova provjera vrijedi samo za Comment Widget i API. Uvozi nisu pogođeni.

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

Restrict External Link Domains

Broj komentara i brojanje svih ugniježđenih odgovora

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

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

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

Counting All Comments

Copy

Run

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

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

Counting Top Level Comments

Copy

Run

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

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

Omogućavanje poveznica komentatora

Po zadanim postavkama, FastComments će od korisnika tražiti samo njihov komentar, korisničko ime i e-poštu.

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

Možemo omogućiti prikaz dodatnog polja za unos URL-a korisnikove web-stranice postavljanjem zastavice 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 je taj URL naveden, korisnički račun će biti ažuriran i svi njihovi korisnički nazivi na svim prošlim i budućim komentarima vodit će na taj URL.

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

Enabling Commenter Links

Grupe za moderaciju

Popis ID-jeva generiranih sa stranice Grupe za moderiranje.

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

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

Specify Moderation Groups

Copy

Run

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

ID-ovi grupa za spominjanje

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

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

Limit Groups for Mentions

Copy

Run

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

Za autentifikaciju, FastComments ovisi o tome da su kolačići treće strane omogućeni u vašem pregledniku. Bez njih, korisnici će uvijek morati ostaviti svoju e-poštu da bi komentirali (osim ako je polje za unos e-pošte skriveno), i njihovi će komentari uvijek prikazivati kao neprovjereni (po defaultu).

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

Kada je ovo podešenje omogućeno, pojavit će se mali popup koji prikazuje poruku da se korisnik prijavljuje. Ovaj popup se prikazuje kad god korisnik interagira s widgetom komentara; na primjer, kada ostavi komentar.

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

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

Enabling Third-Party Cookie Bypass

Brisanje komentara s odgovorima

Po zadanim postavkama, korisnici mogu izbrisati vlastite komentare. Također, brisanjem svog komentara automatski se brišu svi podređeni i privremeni komentari u niti. Ovo ponašanje je također aktivno.

To možete ograničiti na sljedeće načine:

Umjesto toga, anonimizirajte izbrisani komentar (postavite ime i tekst na [deleted] ili neku prilagođenu vrijednost).
Onemogućite brisanje komentara kada postoje odgovori. Prikazuje se prilagodljiva poruka o pogrešci.
Ograničite brisanje komentara koji imaju odgovore samo na administratore i moderatore.

Ovo se može konfigurirati putem odjeljka Comment Thread Deletion u sučelju za prilagodbu widgeta.

Prilagodite ponašanje brisanja za odgovore

Prikaz znački u gornjoj traci

Po zadanim postavkama, FastComments će prikazivati značke korisnika samo uz njihove komentare unutar niti komentara.

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

Show Badges in Top Bar Option

Ovo će prikazati značke korisnika uz njihovo ime u gornjem području trake, čineći njihova postignuća i status istaknutijima dok pišu komentar.

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

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č Sljedeći vodič

Jezik 🇭🇷 Hrvatski

Osnove

Izgled i dojam

Komentiranje uživo

Straničenje i sortiranje

Polje za odgovor

Jedinstvena prijava (SSO)

Anonimno komentiranje

Razno

Prilagodbe i konfiguracija

Kontekst

Identifikacija vašeg računa

Kako su komentari povezani sa stranicama i člancima

Napomene

Prikaz istih komentara na različitim stranicama

Prilagođeni stil

Vanjske CSS datoteke

U kodu - nije preporučeno

Stiliziranje modalnog prozora korisničkog profila

Povratna kompatibilnost

Prilagođeni fontovi

Kako definirati font

Uklanjanje brendiranja

Podrška tamnim pozadinama (tamni način rada)

Prebacivanje tamnog načina rada

Prepisivanje teksta

Promjena zadane slike avatara

Onemogućavanje avatara

Onemogućavanje svih zadanih stilova

Povezivanje komentara sa stranicama

Skrivanje odgovora prema zadanim postavkama

Omogući WYSIWYG uređivač

Onemogućavanje alatne trake

Onemogućavanje blokiranja

Određivanje koju stranicu prikazati

Prebacivanje niti komentara bez ponovnog učitavanja stranice

Angular, React, Vue, itd

VanillaJS

Apsolutni datumi (onemogućavanje čitljivih vremenskih oznaka)

Prikaz i apsolutnih i relativnih datuma

Dodavanje zaglavnog teksta

Prikaz poveznica kao teksta

Prebacivanje komentara pomoću gumba

Prilagođavanje teksta broja komentara

Onemogućavanje preusmjeravanja slika

Onemogućavanje automatskog stvaranja hashtagova

Onemogućavanje zvona za obavijesti

Onemogućavanje profila

Onemogućavanje poruke o uspjehu

Promjena ocjene sadržaja GIF-ova

Moderiranje sadržaja slika

Promjena stila glasovanja

Onemogućavanje brisanja

Onemogućavanje uređivanja

Isticanje novih komentara

Veličine stranica

Predlošci e-pošte

Formati korisničkih imena

Onemogućavanje učitavanja slika

Omogući okvir za pretraživanje

Omogućivanje spoilera

Omogućavanje broja pregleda komentara

Prikazivanje komentara uživo odmah

Onemogućavanje komentiranja uživo

Novi komentari uživo na dnu

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

Omogućavanje beskonačnog pomicanja

Promjena zadanog smjera sortiranja

Prikaz svih komentara odjednom - onemogućavanje straničenja

Premještanje polja za odgovor iza komentara

Ograničavanje duljine komentara

Onemogućavanje višerednog komentiranja

Ograničenje broja komentara po korisniku

Sprječavanje novih komentara na najvišoj razini

Maksimalna dubina odgovora

Pregled jedinstvene prijave (SSO)

Kako dobijem pristup?

Migracije korisnika i komentara

Korisnici WordPress-a

WordPress SSO - Moderatori