Prilagoditve in konfiguracija

Kontekst

Tukaj boste našli poglobljeno dokumentacijo o vsaki funkciji in nastavitvi, ki jih podpira pripomoček za komentarje.

Ta dokumentacija bo zajela osnovne koncepte in poglobila vsako področje funkcionalnosti, vključno z navodili po korakih in pogostimi pastmi.

Na voljo bodo primeri kode z označenimi relevantnimi vrsticami. Posnetki zaslona strani s konfiguracijo bodo na voljo tam, kjer je to primerno.

Primeri kode bodo uporabljali našo vanilla JavaScript knjižnico, vendar možnosti konfiguracije uporabljajo natanko ista imena za vse različice pripomočka za komentarje (React, Vue itd.).

Večina konfiguracij in funkcij, opisanih v tem vodniku, ne zahteva pisanja kode.

Identifikacija vašega računa

Opazili boste, da je mogoče pripomoček za komentarje uporabiti s 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>

To je namenjeno le preizkušanju in igranju s pripomočkom za komentarje. V produkciji boste posredovali svoj Tenant ID, na primer:

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>

Svoj Tenant ID lahko najdete že uporabljen v izrezku kode za pripomoček za komentarje v vašem računu.

Prav tako lahko svoj Tenant ID najdete in upravljate svoje API ključe na strani z API poverilnicami.

Od tega trenutka naprej, če ste prijavljeni v FastComments, bodo primeri kode uporabljali vaš pravi Tenant ID (če ste prijavljeni na https://fastcomments.com).

Kako so komentarji povezani s stranmi in članki

Pri izrisu niza komentarjev ali pri pisanju komentarja FastComments mora vedeti, kateri strani, članek ali izdelek ti komentarji pripadajo.

Za to uporabljamo nekaj, kar imenujemo "URL ID". To je lahko identifikator, kot je niz ali številka, ali pa URL.

Privzeto, če ne določite urlId, bo to URL strani. Vzeli bomo trenutni URL strani in ga očistili, da odstranimo morebitne običajne marketinške parametre ali sledilne identifikatorje.

V primeru integracij tretjih strani, kot je WordPress, naš vtičnik običajno uporabi identifikator, ki predstavlja trenutno prikazano informacijo, kot URL ID, na primer ID članka/strani.

Določanje po meri 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>

Ena stvar, na katero bomo v tem dokumentu pogosto sklicovali, je uporabniški vmesnik za prilagajanje gradnika.

Ta vmesnik se lahko uporabi za številne spremembe gradnika za komentarje brez uporabe kode.

Ko ustvarjamo pravilo za prilagajanje, ga pogosto želimo uporabiti za vse strani našega spletnega mesta. Vendar pa v nekaterih primerih želimo prilagoditi gradnik za komentarje na določeni strani, bodisi za uporabo po meri oblikovanja, bodisi za anonimnost komentarjev na tej strani. Lahko tudi, na primer, omogočite, da se živi komentarji takoj prikažejo na nekaterih straneh, medtem ko so na drugih skriti pod obvestilnimi gumbi.

Vse to je mogoče preko vnosnega polja URL ID na tej strani, ki izgleda takole:

Vnos URL ID na strani za prilagajanje gradnika

Polje URL ID, uporabljeno za omejitev pravila prilagajanja na eno stran ali na vzorec, kot je */blog/*

Vrednost v tem polju mora ustrezati parametru urlId, ki se posreduje gradniku za komentarje. Če želite, da je vaše pravilo prilagajanja neodvisno od urlId, pustite to polje prazno ali vnesite *.

Od leta 2023 polje URL ID v prilagajanju gradnika zdaj sprejema tudi vzorce! Na primer, lahko imate */blog/* za dodajanje oblikovanja, specifičnega za vaš blog, in */store/* za oblikovanje, specifično za vašo trgovino, vse pri uporabi iste domene.

Pastrežki

Če vaša stran vsebuje hash parametre (npr. example.com#page-1) – ti bodo privzeto postali del URL ID.
Med migracijami, na primer iz WordPressa v Gatsby, boste morda morali po začetni migraciji prenesti vrednosti komentarjev URL ID. Za to nas kontaktirajte.

Prikaz enakih komentarjev na različnih straneh

Ker parameter urlId omogoča, da določimo, na katero stran ali id so komentarji vezani, lahko preprosto nastavimo urlId na isto vrednost na teh straneh.

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>

Po meri oblikovanje

FastComments je zasnovan za prilagajanje. Samo pripomoček za komentarje se iz varnostnih razlogov izvaja znotraj iframe-a, zato morate za uporabo sloga po meri slediti enemu od dveh pristopov.

Prvi, najlažji pristop, ki ga tudi mi priporočamo, je uporaba strani za prilagajanje pripomočka.

Na strani za prilagajanje pripomočka poglejte razdelek "Show Advanced Options", pod katerim je območje z oznako "Custom CSS":

Vnosno območje za CSS po meri

Urejevalnik CSS po meri pod Show Advanced Options na strani za prilagajanje pripomočka

Ta pristop ima nekaj prednosti:

Vneseni CSS je pred pošiljanjem uporabniku pomanjšan (minificiran), oblika pa je v urejevalnem vmesniku ohranjena dosledna.
Izkoristite vse prednosti vmesnika za prilagajanje pripomočka, na primer enostavno prilagajanje pripomočka za komentarje različno za različne spletne strani.
Ko naredimo spremembe v pripomočku za komentarje, bo vaš slog po meri testiran kot del našega procesa izdaje.

Drugi pristop je določitev parametra customCSS v konfiguraciji pripomočka, takole:

Posredovanje CSS po meri

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>

Vendar ima to omejitve:

Obstaja omejitev, koliko CSS po meri lahko posredujemo, preden naši strežniki zavrnejo zahtevo, zaradi velikosti glav (headers).
CSS po meri morate upravljati v svoji infrastrukturi in sistemu za gradnjo. To je lahko tudi prednost, ne slabost.
V tem primeru je dodatna obremenitev, ker se CSS po meri pošilja po omrežju dvakrat, saj ga je treba poslati našim strežnikom in nato nazaj v vsebino iframe-a. Za večino velikosti podatkov pa tega ni opaziti.
Pogosta optimizacija je pomanjšanje (minificiranje) CSS za zmanjšanje velikosti prenosov, vendar pri tem pristopu morate to urediti sami.
Vaš CSS po meri ne bo testiran, ko naredimo spremembe.

Zunanje datoteke CSS

Pripomočku lahko naročite, naj pridobi zunanjo datoteko z uporabo @import!

Priporočamo, da @import umestite v pravilo prilagajanja. Tako, če bomo kdaj morali narediti spremembo v pripomočku za komentarje, lahko z našo avtomatizacijo preverimo vašo nastavitev. Torej bi na primer ustvarili pravilo prilagajanja v vmesniku Widget Customization, kliknili Advanced in vnesli v Custom CSS:

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

V kodi - ni priporočljivo

Zunanjo datoteko CSS lahko naložite tudi prek lastnosti customCSS:

Zunanja datoteka 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": "@import url(https://example.com/styles.css);"
}];
</script>

Vendar ne pozabite, da vašega CSS v tem primeru ne bomo mogli testirati.

Slog modala profila uporabnika

Tudi modale profilov uporabnikov je mogoče oblikovati s CSS po meri. Vendar, da se slog po meri uporabi na profilih uporabnikov, morajo biti vsi CSS selektorji predponjeni z .user-profile. Brez te predpone bo slog po meri pri modalih profilov uporabnikov prezrt.

Na primer:

CSS profila uporabnika

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>

Združljivost z nazaj

Pri FastComments vemo, da naši stranke prilagajajo pripomoček za komentarje. To je po zasnovi - zadnja stvar, ki si je želimo, je, da bi naš izdelek povzročil nedoslednosti v oblikovanju vašega izdelka.

Ker je to pomemben del našega izdelka, imamo gradbeni proces (build pipeline), ki nam omogoča pregled sprememb pripomočka za komentarje, za vsako stranko, ob vsaki izdaji.

Če odkrijemo manjše težave, bomo posodobili vaš račun, da bo izdaja potekala gladko. Če opazimo večje spremembe, ki bi povzročile težave, nam to omogoča, da izdajo ustavimo.

Po meri pisave

FastComments je zasnovan tako, da je mogoče opraviti prilagoditve, in pisava, ki jo uporabljajo naši pripomočki, ni izjema.

Privzeto FastComments uporablja system font stack, da izgleda čim bolje na širokem naboru naprav.

Za določitev lastnih pisav glejte Dokumentacija za prilagojen CSS.

Tam boste našli način za definiranje prilagojenega CSS-a, kar vam bo omogočilo nastaviti želene pisave.

Kako določiti pisavo

Za preglasitev pisave priporočamo, da svoj CSS definirate z selektorjema .fast-comments, textarea. Na primer:

Primer zunanje prilagojene pisave

Copy

Run

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

Odstranjevanje blagovne znamke

Strankam, ki imajo Pro ali Enterprise račun, je omogočena odstranitev ali zamenjava naše blagovne znamke. Preprosto se obrnite na nas in z veseljem vam pomagamo.

Če želite zgolj odstraniti naš logotip iz pripomočka za komentarje, je to samodejno omogočeno pri načrtih Flex in Pro.

Ti načrti prav tako nudijo enako funkcionalnost za e-pošto, poslano iz naše platforme.

Podpora temnim ozadjem (temni način)

Privzeto bo pripomoček za komentarje FastComments samodejno zaznal temni način na večini spletnih mest.

Ko je zaznan temni način, bo FastComments prešel iz črnega besedila na belem ozadju v belo besedilo na črnem ozadju. Spremembe bodo vidne tudi pri slikah.

Ob nalaganju strani bo pripomoček poskušal določiti, kako temno je ozadje strani za pripomočkom za komentarje. To pomeni, da lahko stran ima belo ozadje, vendar če pripomoček za komentarje postavite v vsebnik s črnim ozadjem, bi moral biti temni način še vedno samodejno omogočen, da bodo komentarji berljivi.

Vendar pa mehanizem zaznavanja, ki temelji na določanju "svetilnosti", morda ne bo omogočil temnega načina, ko ga želite. Če ga želite prisilno omogočiti, nastavite zastavico hasDarkBackground na true kot sledi:

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>

Preklapljanje temnega načina

Za spletna mesta, ki dovolijo preklapljanje temnega načina po začetnem nalaganju strani, je to nekoliko bolj zapleteno.

Najprej imajo vse trenutne različice knjižnice pripomočka Comment (React, Vue) primere preklapljanja temnega načina v svojih ustreznih repozitorijih.

Za pripomoček VanillaJS bo potrebno narediti še nekaj dodatnega dela. Najprej FastCommentsUI vrne objekt s funkcijama "destroy" in "update".

Preprosto lahko vsakokrat pokličemo funkcijo update, kadar želimo posodobiti konfiguracijo pripomočka za komentarje, kot sledi. Tukaj je popoln delujoč primer preklapljanja temnega načina z uporabo pripomočka VanillaJS.

Popoln primer preklopa temnega 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>

Prepisovanje besedila

S FastComments je vse besedilo v pripomočku za komentarje prilagodljivo.

Lahko prepišete en sam del besedila, kot je gumb za pošiljanje, ali vso besedilo v celotnem pripomočku za komentarje.

Privzeto je besedilo v pripomočku za komentarje prevedeno glede na uporabnikovo lokalno nastavitev. Vendar lahko besedilo prepišemo, če smo prepričani, da naša baza uporabnikov uporablja enako lokalno/jezikovno nastavitev, na primer:

Po meri besedilo

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>

Vse prilagodljive prevode lahko najdete tukaj pod zavihkom "napredne možnosti".

Vendar obstaja preprostejši način, prek uporabniškega vmesnika za prilagajanje pripomočka. Tam lahko preprosto najdemo besedilo, ki se prikaže v pripomočku za komentarje v lokalni nastavitvi EN_US, in določimo nadomestilo.

Po meri besedilo

Panel po meri besedila z izbranim nizom pripomočka iz spustnega menija in poljem za nadomestno besedilo

Vsi prepisani prevodi trenutno vplivajo na vse lokalne nastavitve.

To pokriva besedilo samega pripomočka. Za prevajanje komentarjev, ki jih pišejo vaši obiskovalci, glejte Comment Translation.

Sprememba privzetega avatarja

Ko uporabnik prvič komentira z FastComments, poskušamo pridobiti njegov avatar iz https://gravatar.com/.

Vendar, če avatarja ne najdemo ali uporabnik nikoli ne nastavi avatarja v svoj račun, prikažemo statično privzeto sliko avatarja.

Za določitev lastne statične slike avatarja lahko uporabimo nastavitev defaultAvatarSrc.

Prepis privzetega avatarja

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>

To lahko storite tudi brez kode. Na strani za prilagajanje gradnika si oglejte razdelek "Privzeti avatar".

Prilagajanje privzetega avatarja

Upoštevajte, da je določanje avatarja za določenega uporabnika, na primer s SSO, obravnavano v svojem razdelku.

Onemogočanje avatarjev

Avatarje je mogoče v celoti odstraniti iz gradnika za komentarje, tudi če so uporabniki določili svoj avatar.

Skrivanje avatarjev

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>

To je mogoče prilagoditi brez kode, na strani za prilagajanje gradnika:

Skrivanje avatarjev

Možnost Skrij avatarje na strani za prilagajanje gradnika, ki odstrani vse avatarje iz gradnika za komentarje

Onemogočanje vseh privzetih stilov

Za večje projekte po meri po oblikovanju je morda zaželeno začeti s čisto ploščo in sploh ne uporabljati privzetega oblikovanja.

Vso privzeto oblikovanje je mogoče odstraniti tako, da nastavite parameter noStyles na true, kot sledi:

Onemogočanje vseh privzetih stilov

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>

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika, pod naprednimi možnostmi:

Onemogočanje vseh privzetih stilov

Povezovanje iz komentarjev na strani

Ko pošiljate obvestilna e‑poštna sporočila ali prikazujete komentarje v uporabniških vmesnikih, kot je stran za moderacijo, je koristno, da lahko povežete iz komentarja na stran, na kateri se nahaja.

Če URL ID ni vedno dejanski ID, moramo URL shraniti nekje drugje. Za to je namenjena lastnost "url", definirana takole.

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>

Pogosta uporaba je vezava nitke komentarjev na identifikator, kot je članek, in nato povezava nazaj na določeno stran, 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 ni očiščen običajnih marketinških parametrov. Privzeto se shrani URL, kakršen je trenutni URL strani.

Privzeto skrčenje odgovorov

Privzeto se odgovori na komentarje najvišje ravni prikažejo.

To je mogoče nastaviti tako, da mora uporabnik klikniti "Show Replies" na komentarjih najvišje ravni, da vidi podkomentarje.

Strni odgovore na komentarje najvišje ravni

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>

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika:

Strni odgovore

Možnost strnitve odgovorov v uporabniškem vmesniku za prilagajanje gradnika, ki skriva podkomentarje za povezavo Show Replies link

Ta nastavitev ne bo vplivala na število začetno naloženih komentarjev najvišje ravni. Če imate en komentar najvišje ravni in 29 podkomentarjev, boste z vklopljeno nastavitvijo:

Videli boste komentar najvišje ravni.
Videli boste Show Replies (29) pod tem komentarjem.

Če želite prikazati vse komentarje najvišje ravni v kombinaciji s to možnostjo, nastavite začetno stran na -1.

Omogoči WYSIWYG

Privzeto se funkcionalnosti oblikovanja v FastComments izvajajo z dodajanjem vidnih sidrnih oznak, kot je <b></b>, okoli vašega besedila. Klik na orodno vrstico ali uporaba bližnjic to naredi za vas. Vendar pa nekatere skupnosti morda želijo uporabljati oblikovanje brez sidrnih oznak. To se imenuje omogočanje urejevalnika WYSIWYG (what you see is what you get). Ta urejevalnik izgleda povsem enako kot privzeti, razen da naloži dodatno kodo, ki uporabnikom omogoča, da besedilo odebelijo, podčrtajo itd., brez vidnih sidrnih oznak.

Omogočanje urejanja WYSIWYG

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>

To je mogoče storiti tudi brez kode. Na strani za prilagajanje gradnika si oglejte možnost "Enable Advanced Formatting".

Omogoči WYSIWYG

Stran za prilagajanje gradnika z označeno potrditveno polje Omogoči napredno oblikovanje za vklop urejevalnika WYSIWYG

Privzeto bo FastComments prikazal orodno vrstico pri pisanju komentarja, da zagotavlja bližnjice za oblikovanje besedila in nalaganje slik.

To orodno vrstico je mogoče onemogočiti v kodi ali prek uporabniškega vmesnika za prilagajanje.

Onemogočanje orodne vrstice

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

To je mogoče storiti tudi brez kode. Na strani za prilagajanje gradnika si oglejte možnost "Onemogoči orodno vrstico za odgovor".

Onemogočanje orodne vrstice

Stran za prilagajanje gradnika z označeno potrditveno polje Onemogoči orodno vrstico za odgovor, da se odstranijo bližnjice za oblikovanje

Onemogočanje blokiranja

Privzeto FastComments omogoča uporabnikom, da blokirajo druge uporabnike. Blokiranje uporabnika bo povzročilo, da se njihovi komentarji skrijejo, preprečuje obvestila med uporabniki in podobno.

Morda bo zaželeno onemogočiti to funkcionalnost. To lahko storite na naslednji način:

Onemogoči blokiranje

Copy

Run

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

To je mogoče storiti tudi brez kode, kar omogoča tudi ustrezno strežniško validacijo, prek uporabniškega vmesnika za prilagajanje gradnika:

Onemogoči blokiranje

Možnost onemogočanja blokiranja v uporabniškem vmesniku za prilagajanje gradnika, ki preprečuje uporabnikom, da bi se med seboj blokirali

Določanje, katera stran naj se prikaže

Ko se komentarji pridobivajo in prikazujejo, mora pripomoček za komentarje vedeti, s katere strani naj začne. Privzeto začne na prvi strani in prikaže le to stran.

Če želite, lahko natančno stran, ki naj se prikaže, posredujete pripomočku za komentarje z nastavitvijo 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>

Upoštevajte, da se številčenje strani začne pri ničli, zato zgornji primer prikaže drugo stran.

Preklapljanje niti komentarjev brez ponovnega nalaganja strani

Pokrili smo, kako je urlId id strani ali članka, na katerega so vezani komentarji.

Pravtako, za povzetek: če ni definiran, se urlId privzeto nastavi na URL trenutne strani.

Kaj pa SPA-ji (Single-Page-Applications), kjer se stran ali vsebina, na katero so vezani komentarji, dinamično spreminja brez ponovnega nalaganja strani?

Angular, React, Vue itd.

Z našimi knjižnicami, kot sta Angular in React, preprosta posodobitev lastnosti urlId, podane gradniku, povzroči osvežitev gradnika komentarjev. To lahko vidite v akciji za React aplikacijo na primer tukaj.

VanillaJS

Če uporabljate knjižnico VanillaJS, je to nekoliko bolj zapleteno, saj ni ogrodja, kot sta Angular ali React, ki bi upravljalo vezavo podatkov ali propagacijo stanja.

Ko instancirate VanillaJS gradnik, ta vrne nekatere funkcije, ki jih lahko pokličete za njegovo posodobitev.

Tu je funkcionalen primer, kjer spremenimo hash strani in posodobimo gradnik komentarjev:

Primer preklopa hash strani

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; // Posodobimo tudi url, da se lahko obvestila povežejo nazaj na pravo stran
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Absolutni datumi (onemogoči človeško berljive časovne žige)

Privzeto se uporabljajo lokalizirani relativni datumi. Na primer, poleg nedavno objavljenega komentarja lahko vidite "11 minut nazaj".

Morda bo potrebno ali zaželeno uporabiti absolutne datume, v tem primeru nastavite ta parameter 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>

To je mogoče prilagoditi brez kode, na strani za prilagajanje gradnika, pod naprednimi možnostmi:

Uporabi absolutne datume

Napredne možnosti na strani za prilagajanje gradnika z vklopljenim preklopom absolutnih datumov

Prikaz absolutnih in relativnih datumov

Privzeto se uporabljajo lokalizirani relativni datumi. Na primer, poleg nedavno objavljenega komentarja lahko vidite "11 minut nazaj".

Morda je potrebno ali zaželeno ohraniti ta relativni format datuma, hkrati pa prikazati tudi celoten datum poleg njega; v tem primeru nastavite ta parameter na true.

Uporabi tako absolutne kot relativne datume

Copy

Run

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

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika, pod naprednimi možnostmi. Najprej boste morali omogočiti absolutne datume, da vidite to možnost v uporabniškem vmesniku.

Uporabi tako absolutne kot relativne datume

Napredne možnosti na strani za prilagajanje gradnika z omogočenimi absolutnimi datumi in združenim nastavitvijo relativnega datuma

Dodajanje besedila v glavo

Nekaj besedila, kot je glava ali sporočilo, se lahko prikaže pod številom komentarjev, a nad besedilom stanja prijave.

To imenujemo glava, privzeto pa je skrita.

Določanje HTML glave

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>

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika, pod naprednimi možnostmi:

Določanje HTML glave

Območje naprednih možnosti na strani za prilagajanje gradnika, kjer se vnese prilagojeno HTML glave

Prikaz povezav kot besedilo

Privzeto bo FastComments prikazal povezave takole: https://exmaple.com – kjer URL povezave postane klikabilna HTML sidrična oznaka.

Nekatera spletna mesta morda želijo to onemogočiti, na primer za odvrnitev prevarantov. To omogočimo tako, da nastavimo Comment HTML Rendering Option na Links as Text.

To je mogoče prilagoditi brez kode, na strani za prilagajanje gradnika, za celotno domeno ali stran:

Prikaz povezav kot besedilo

Možnost prikaza HTML komentarjev nastavljena na Povezave kot besedilo pod naprednimi možnostmi v prilagajanju gradnika

Preklapljanje komentarjev z gumbom

Privzeto bo FastComments izrisal vnosno polje za komentar in nit komentarjev hkrati. Za prihranek nekaj navpičnega prostora, bo tudi skril vsa druga zahtevana polja, dokler se z vtičnikom ne interagira.

Vendar pa je lahko pripomoček za komentarje skrit za gumbom, na primer:

Klikni za prikaz komentarjev

Pripomoček za komentarje je zrušen za gumbom, ki prikazuje število komentarjev, dokler bralec ne klikne nanj

Gumb uporablja različna prevedena besedila, odvisno od tega, ali so komentarji trenutno prikazani ali ne. Če so komentarji skriti, uporablja translations.SHOW_COMMENTS_BUTTON_TEXT. Če so komentarji prikazani, uporablja translations.HIDE_COMMENTS_BUTTON_TEXT. Prevajanja lahko vsebujejo besedilo [count], ki bo zamenjano z lokaliziranim številom.

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>

To je zasnovano za nadomestitev nastavitve hideCommentsUnderCountTextFormat.

Število se posodablja v živo skupaj z nitjo komentarjev. Gumb se ne prikaže, če ni komentarjev.

To je mogoče omogočiti brez kode tako, da ustvarite pravilo prilagoditve in omogočite "Click to Show Comments":

Omogoči prikaz komentarjev

Potrditveno polje za prikaz komentarjev je označeno v pravilu prilagoditve na strani za prilagajanje pripomočka

Prilagajanje besedila števila komentarjev

Število komentarjev, prikazano na vrhu gradnika za komentarje, je mogoče prilagoditi.

To lahko nadomestite s katerimkoli nizom, vrednost [count] pa bo zamenjana s številom komentarjev, lokaliziranim za uporabnika.

Prilagajanje besedila števila komentarjev

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>

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika:

Prilagajanje besedila števila komentarjev

Polje besedila števila komentarjev na strani za prilagajanje gradnika, kjer je [count] nadomeščen s trenutnim skupnim številom

Onemogoči preusmeritev slik

Privzeto FastComments dovoljuje uporabnikom nalaganje slik. Ko uporabnik klikne to sliko, FastComments privzeto odpre nov zavihek, da prikaže sliko v celoti. Nastavitev te zastavice na true onemogoči to vedenje:

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>

Če ne nameravate sami prestrezati klika na sliko (glejte onImageClicked), priporočamo, da to kombinirate z nekim stiliranjem da odstranite videz, da je slika klikljiva.

Onemogoči samodejno ustvarjanje hashtagov

Ko uporabniki vnašajo hashtag-e v obliki #someexampletag, FastComments bo samodejno ustvaril ta HashTag in poudaril ga v njihovem komentarju.

V nekaterih primerih je zaželeno onemogočiti to funkcijo ali nadzorovati, kateri hashtag-i se lahko uporabljajo prek API-ja.

Za to preprosto omogočite Disable Automatic #hashtag Creation prek uporabniškega vmesnika za prilagajanje gradnikov.

Onemogočanje samodejne ustvaritve HashTag-a

Možnost onemogočanja samodejne ustvaritve #hashtag-a omogočena v uporabniškem vmesniku za prilagajanje gradnika

Onemogoči zvonec obvestil

Privzeto bo FastComments prikazal obvestilni zvonec v zgornjem desnem kotu območja komentarjev.

Zvonec bo postal rdeč in prikazal število obvestil, ki jih ima uporabnik. Nekateri primeri obvestil so:

Uporabnik je odgovoril vam.
Uporabnik je odgovoril v nitki, v kateri ste komentirali.
Uporabnik je glasoval za vaš komentar.
Uporabnik je odgovoril na stran, na katero ste se naročili.

Obvestilni zvonec prav tako omogoča naročanje na celotno stran.

Vendar pa lahko obvestilni zvonec popolnoma onemogočimo:

Onemogoči obvestilno zvonec

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>

To je mogoče tudi brez kode. Na strani za prilagajanje gradnika si oglejte razdelek "Onemogoči obvestilno zvonec".

Onemogoči obvestilno zvonec

Onemogoči profile

Privzeto bo FastComments prikazal uporabnikov profil, ko kliknete na njihov avatar.

Vendar lahko to funkcionalnost onemogočimo:

Onemogoči profile

Copy

Run

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

To je mogoče storiti tudi brez kode. Na strani za prilagajanje gradnika si oglejte razdelek "Onemogoči profile".

Onemogoči profile

Onemogoči komentarje v profilu

Privzeto bo FastComments prikazal zavihek "Komentarji profila" na uporabniških profilih, kar obiskovalcem omogoča, da pustijo komentarje na nečijem profilu.

Vendar lahko ta zavihek onemogočimo:

Disable Profile Comments

Copy

Run

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

To je mogoče storiti tudi brez kode. Na strani za prilagajanje gradnika si oglejte razdelek "Onemogoči komentarje profila".

Onemogoči komentarje profila

Onemogoči neposredna sporočila v profilu

Privzeto bo FastComments prikazal zavihek "Direktna sporočila" na uporabniških profilih, kar obiskovalcem omogoča pošiljanje neposrednih sporočil uporabniku.

Vendar lahko ta zavihek onemogočimo:

Onemogoči neposredna sporočila 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",
    "disableProfileDirectMessages": true
}];
</script>

To lahko storimo tudi brez kode. Na strani za prilagajanje gradnika si oglejte odsek "Onemogoči neposredna sporočila".

Onemogoči neposredna sporočila profila

Stran za prilagajanje gradnika z označeno potrditveno polje Onemogoči neposredna sporočila, da se skrije zavihek sporočil profila

Onemogoči sporočilo o uspehu

Privzeto FastComments prikaže sporočilo o uspehu po objavi komentarja. To lahko onemogočite na naslednji način:

Onemogoči sporočilo o uspehu

Copy

Run

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

To lahko storite tudi brez kode. Na strani za prilagajanje gradnika:

Onemogoči sporočilo o uspehu

Spremeni oceno vsebine GIF-ov

Privzeto bo pripomoček za komentarje FastComments nastavil gif rating na pg.

Razpoložljive možnosti so g, pg, pg-13 in r.

To lahko nastavite v kodi ali prek uporabniškega vmesnika. V kodi to lahko storimo na naslednji način:

Nastavi oceno GIF

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>

V uporabniškem vmesniku boste to našli pod Gif Picker Rating, dokler ni potrjeno Disable Image Uploads?.

Nastavitev ocene GIF

Spustni meni Gif Picker Rating na strani za prilagajanje pripomočka, ki ponuja g, pg, pg-13 in r

Moderiranje vsebine slik

Privzeto ima pripomoček za komentarje FastComments moderiranje vsebine slik nastavljeno na off.

Razpoložljive možnosti so off, low, medium in high.

V uporabniškem vmesniku za prilagajanje pripomočka boste to našli pod Image Content Moderation Level, dokler ni označena možnost Disable Image Uploads?.

Nastavitev ravni moderiranja vsebine slik

Spustni meni Image Content Moderation Level na strani za prilagajanje pripomočka, nastavljen na off, low, medium ali high

Spremeni stil glasovanja

Privzeto bo FastComments prikazal možnosti glasovanja kot puščici za glasovanje gor in dol, kar uporabnikom omogoča, da komentar glasujejo gor ali dol.

Vendar je mogoče spremeniti stil orodne vrstice za glasovanje. Trenutne možnosti so privzeti gumbi Gor/Dol ali uporaba mehanizma glasovanja v slogu srca.

Za to uporabljamo zastavico voteStyle na naslednji način:

Omogoči srčni gumb

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>

Močno priporočamo, da to storite brez kode, saj to omogoča tudi strežniške validacije. Na strani za prilagajanje gradnika si oglejte razdelek "Vote Style".

Spremeni slog glasovanja

Nastavitev sloga glasovanja na strani za prilagajanje gradnika, ki ponuja puščice gor/dol ali glasovanje s srcem

Glasovanje je mogoče tudi onemogočiti, glejte Disable Voting nad možnostmi sloga.

Onemogoči brisanje

Privzeto bo FastComments dovolil uporabnikom brisati svoje komentarje.

Vendar je mogoče to preprečiti.

Na strani za prilagajanje gradnika poiščite možnost "Onemogoči brisanje".

Onemogoči brisanje komentarjev

Možnost Onemogoči brisanje na strani za prilagajanje gradnika, ki preprečuje komentatorjem odstranjevanje njihovih komentarjev

To vpliva le na običajne komentatorje in ne na moderatorje ali skrbnike, ki bodo še vedno lahko brisali.
To bo vplivalo tudi na API integracije, ko je poslan contextUserId.

Onemogoči urejanje

Privzeto FastComments dovoljuje uporabnikom urejanje njihovih komentarjev.

Vendar je to mogoče preprečiti.

Na strani za prilagajanje gradnika si oglejte možnost "Onemogoči urejanje".

Onemogoči urejanje komentarjev

Možnost Onemogoči urejanje na strani za prilagajanje gradnika, ki preprečuje komentatorjem urejanje njihovih komentarjev

To vpliva le na običajne komentatorje in ne na moderatorje ali skrbnike, ki bodo še vedno lahko urejali.
To bo vplivalo tudi na API integracije, ko je poslan contextUserId.

Označevanje novih komentarjev

FastComments nudi več načinov za označevanje novih komentarjev.

Najprej in predvsem, privzeto bodo komentarji, ki so sprožili obvestilo v aplikaciji (odgovori, odgovori v isti niti ali komentarji na strani na katero ste naročeni), samodejno označeni z rahlo svetlečim avatarjem uporabnika. Barvo lahko prilagodite s CSS z uporabo razreda is-unread.

Komentarji, objavljeni v zadnjih 24 urah, imajo dodeljen razred 24hr, ki ga lahko uporabite za oblikovanje.

Nazadnje, vsi novi živi komentarji, ki se pojavijo v uporabnikovi seji, bodo za nekaj sekund poudarjeni z animacijo. To se izvede z is-live CSS razredom in ga je mogoče tudi prilagoditi.

Velikosti strani

Privzeto je velikost strani FastComments 30. To vključuje odgovore v nitih.

Velikost strani je mogoče prilagoditi v Widget Configuration UI v različnih velikostih, ki se gibljejo od 10 do 200.

Upoštevajte, da sprememba velikosti strani zahteva ponovno izračunavanje vseh nitkov komentarjev v vašem računu. To lahko traja nekaj minut.

Tega ni mogoče nastaviti v vtičniku na strani odjemalca, saj se strani izračunavajo na strežniku.

Primer konfiguracije je prikazan spodaj:

Prilagojene velikosti strani

Izbirnik velikosti strani na strani za prilagajanje vtičnika, kjer je mogoče izbrati vrednost od 10 do 200

Velikosti strani je mogoče prilagoditi globalno, po domeni ali po strani, tako da ustvarite različna pravila prilagajanja.

To bo vplivalo na vse odjemalce, integracije in ogrodja, ki jih morda uporabljate za prikaz komentarjev prek naše platforme.

Predloge e-pošte

E-poštna sporočila, poslana iz FastComments vašim strankam, je mogoče prilagoditi. Predloga, logika, in prevodi se lahko spremenijo. Besedilo je mogoče prilagoditi za posamezno lokalizacijo, oblikovanje lahko se spremeni tudi za posamezno domeno. Več o prilagojenih e-poštnih predlogah najdete tukaj.

Oblike uporabniških imen

Privzeto FastComments prikaže uporabniško ime, kot ga je uporabnik vnesel, ali pa tako, kot nam je bilo posredovano prek SSO.

Vendar je lahko zaželeno ime uporabnika maskirati ali prikazati na drugačen način. Na primer, če se uporabnik imenuje Allen Rex, morda želite prikazati le "Allen R.".

To je mogoče storiti brez kode v uporabniškem vmesniku za prilagoditev pripomočka, pod nastavitvijo Commenter Name Format:

Sprememba formata imena

Odprt spustni meni Commenter Name Format z možnostmi, kot so Capitalize, Last Initial in All Initials

Na voljo so naslednji formati:

Capitalize (uporabnik Example User se prikaže kot Example User)
Last Initial (uporabnik Example User se prikaže kot Example U.)
All Initials (uporabnik Example User se prikaže kot E. U.)
Prikaži "Anonymous"

Učinek spremembe je takojšen. Uporabniki bodo še vedno videli svoje polno uporabniško ime na vrhu območja za komentarje, zase, njihovi komentarji pa bodo prikazali spremenjeno uporabniško ime.

Uporabniška imena so maskirana na strani strežnika, da se uporabniki zaščitijo.

Onemogočanje nalaganja slik

Privzeto FastComments omogoča nalaganje slik. To lahko onemogočite tako, da nastavite zastavico noImageUploads na true.

Onemogočanje nalaganja slik

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>

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika:

Onemogočanje nalaganja slik

Dovoli vdelavo medijev

Privzeto FastComments ne dovoljuje iframe-ov v komentarjih. Ko omogočite vdelave medijev, lahko komentatorji prilepijo kodo vdelave (odsek <iframe>) od zaupanja vrednih ponudnikov, kot so YouTube, Vimeo, SoundCloud in Spotify, in ta se bo prikazala v vrstici v komentarju.

Zaradi varnosti to ni nastavitvena zastavica gradnika na strani odjemalca. Gre za nastavitev na strežniku, ki se preveri, ko se vsak komentar shrani, zato je ni mogoče vklopiti s strani. Dovoljeni so le iframe-ji, ki kažejo na vgrajen seznam zaupanja vrednih ponudnikov. Vsak drug iframe je odstranjen.

To je izvedeno brez kode, na strani za prilagajanje gradnika:

Dovoli vdelave medijev

Nastavitev vdelav medijev je vklopljena na strani za prilagajanje gradnika, kar omogoča komentatorjem lepljenje zaupanja vrednih iframe vdelav

Dodajanje lastnih ponudnikov

Če želite dovoliti vdelave od ponudnika, ki ni na vgrajenem seznamu zaupanja vrednih, dodajte njegovo ime gostitelja v polje "Dodatna domena vdelav" na isti strani. Ta imena gostiteljev so dovoljena poleg vgrajenih ponudnikov. Ujemanje je natančno, zato vključite celotno ime gostitelja (na primer, player.example.com). Vse, kar ne navedete, ostane blokirano.

Tako običajno polje za komentar kot urejevalnik WYSIWYG podpirata lepljenje vdelave. V urejevalniku WYSIWYG je vdelava vstavljena kot odstranljiv blok.

Omogoči iskalno polje

Privzeto v pripomočku za komentarje ni prikazanega iskalnega polja.

Vendar ga lahko vklopimo tako, da nastavimo zastavico enableSearch na true:

Omogočanje iskanja

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>

To lahko storimo tudi brez kode. Na strani za prilagajanje pripomočka poiščite možnost "Enable Search Box".

Omogoči iskalno polje

Stran za prilagajanje pripomočka z označeno potrditveno polje Enable Search Box, ki prikaže iskalno polje v pripomočku

Omogoči spoilerje

Podporo za skrivanje vsebine (spoilerje) lahko omogočimo tako, da zastavico enableSpoilers nastavimo na true:

Omogočanje spoilerjev

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>

To je mogoče storiti tudi brez kode. Na strani za prilagoditve pripomočka si oglejte možnost "Enable Spoilers".

Omogoči spoilerje

Stran za prilagoditve pripomočka z označeno potrditveno polje Enable Spoilers, ki doda gumb SPOILER v urejevalnik

Ko je besedilo označeno in uporabnik klikne zdaj vidni gumb SPOILER, bo besedilo maskirano, dokler uporabnik ne premakne miške nanj. V temnem načinu naredimo enako, vendar z drugačnimi barvami, ki bolje ustrezajo temnemu načinu.

To je združljivo tudi z urejevalnikom WYSIWYG.

Omogoči število ogledov komentarjev

Privzeto FastComments ne sledi, kdo je ogledal vsak komentar, niti ne zagotavlja kakršnihkoli statistik o tem.

Vendar lahko to funkcijo omogočimo, nato pa bo sistem začel slediti, ko vsak uporabnik pomakne do komentarja.

Ko se to zgodi, se bo število poleg ikone očesa, prikazane na vsakem komentarju, povečalo. Število se posodablja v živo in je skrajšano glede na uporabnikovo lokalno nastavitev.

To lahko omogočimo tako, da nastavimo zastavico 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 je mogoče prilagoditi brez kode na strani za prilagajanje gradnika:

Omogočanje števila ogledov komentarjev

Stran za prilagajanje gradnika z označenim potrditvenim poljem za število ogledov, tako da vsak komentar prikazuje ikono očesa in število

Sledimo ID-ju uporabnika*, ki je ogledal komentar, eno teden, tako da se pri ponovnem ogledu v tem tednu število ne poveča. Če komentar ogledate po preteku tedna, se število ponovno poveča.

*Opomba: ali anonimni ID seje, ali uporabnikov IP kot zgoščena vrednost.

Takoj prikaži žive komentarje

Privzeto je omogočeno živo komentiranje. To pomeni, da se bodo spremembe, kot so dodajanje, brisanje, urejanje ali pripenjanje komentarjev, prikazale vsem uporabnikom, ki si ogledajo nit komentarjev, hkrati.

Vendar se bodo ti novi komentarji privzeto pojavili pod dinamično prikazanim gumbom z besedilom, podobnim "Show 2 New Comments".

Če so novi komentarji odgovori neposredno na stran, se bo gumb prikazal na vrhu nite komentarjev. Če so odgovori na določen komentar, se bo gumb prikazal pod tem komentarjem.

To je zato, da se velikost strani ne spreminja nenehno za uporabnika, kar bi lahko povzročilo frustracije pri poskusu uporabe drsnika.

Za nekatere primere uporabe, kot so živa dražba ali spletni dogodki, to ni želeno vedenje – morda želite, da je pripomoček za komentiranje bolj podoben "chat" oknu, kjer se novi komentarji "prikažejo takoj".

Zato je ime zastavice, ki omogoča to funkcijo: showLiveRightAway.

To lahko vklopimo na naslednji 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>

To je mogoče prilagoditi brez kode na strani za prilagajanje pripomočka:

Prikaži žive komentarje takoj

Nastavitev za skrivanje živih komentarjev je preklopljena, tako da se novi komentarji prikažejo takoj namesto za gumbom

Onemogočanje živih komentarjev

Privzeto bo FastComments imel omogočeno živo komentiranje.

To pomeni, da naj bi vsak gledalec niti komentarjev videl enako vsebino.

Na primer, če je komentar dodan, se naj ta komentar prikaže. Če je komentar urejen ali odstranjen, potem bodo ti komentarji urejeni ali odstranjeni za vse gledalce niti. Enako velja za glasove in vse moderacijske akcije.

Vendar pa lahko to onemogočimo:

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>

To je mogoče storiti tudi brez kode. Na strani za prilagajanje gradnika poiščite razdelek "Onemogoči živo komentiranje".

Onemogoči živo komentiranje

Novi živi komentarji na dno

Privzeto se novi komentarji v živo pojavijo na vrhu seznama komentarjev, ko so objavljeni v realnem času.

Ko je ta možnost omogočena, se novi komentarji v živo namesto tega dodajo na dno seznama. To vpliva na način prikaza komentarjev, ko so objavljeni v živo, medtem ko uporabniki gledajo nit komentarjev.

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>

Ko je ta nastavitev omogočena:

Novi komentarji v živo, ki jih objavijo drugi uporabniki, se bodo pojavili na dnu seznama komentarjev
Uporabniki bodo v realnem času videli, kako se novi komentarji pojavljajo pod obstoječimi komentarji
To vpliva samo na posodobitve komentarjev v živo - ne na začetno nalaganje strani
To lahko pomaga ohranjati tok branja, ko uporabniki spremljajo razpravo

Upoštevajte, da ta nastavitev vpliva le na to, kje so novi komentarji v živo umeščeni, ko prispevajo v realnem času. Ne vpliva na začetni vrstni red razvrščanja ob nalaganju strani.

Omogoči neskončno pomikanje

Privzeto se pripomoček FastComments navpično prilagodi, da ustreza vsem vidnim komentarjem. Paginacija je dosežena z gumbom "Prikaži naslednje" na koncu trenutne strani, saj ugotavljamo, da je to interakcija, ki je za večino uporabnikov najbolj prijetna.

Vendar obstajajo primeri, kjer je bolj zaželeno neskončno pomikanje. Na primer, to funkcijo uporabljamo v našem izdelku Stream Chat.

Gumbe "Prikaži naslednje" lahko skrijemo in preklopimo na neskončno pomikanje tako, da zastavico enableInfiniteScrolling nastavite 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 zahteva tudi dodajanje prilagojenega CSS-a. Dodajte prilagojen CSS za selektor .comments, da omogočite pomikanje, na primer:

Omogoči neskončno pomikanje

Copy

Run

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

Popoln delujoč primer bi bil:

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>

V zgornjem primeru uporabljamo lastnost customCSS, vendar je zaradi razlogov zmogljivosti priporočljivo namesto tega uporabiti vmesnik za konfiguracijo pripomočka (Widget Configuration UI). Oglejte si dokumentacijo za Custom CSS.

Sprememba privzete smeri razvrščanja

Privzeto bo FastComments razvrstil komentarje po smeri razvrščanja "Najbolj relevantno".

Razvrščanje Najbolj relevantno upošteva čas, ko je bil komentar objavljen, in število glasov pri razvrščanju.

Uporabnik lahko nato spremeni smer razvrščanja na najstarejše ali najnovejše najprej v uporabniškem vmesniku pripomočka za komentarje.

Vendar lahko privzeto spremenimo v katerokoli od treh možnosti. Na primer, če želite prikazati najstarejše komentarje najprej:

Sprememba privzete smeri razvrščanja na najstarejše najprej

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>

Nastavimo vrednost defaultSortDirection na "OF", da nastavimo smer na "OF".

Za smer razvrščanja najnovejše najprej bi naredili naslednje:

Sprememba privzete smeri razvrščanja na najnovejše najprej

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>

Veljavne vrednosti za defaultSortDirection so:

MR: "Najbolj nedavno"
NF: "Najnovejše najprej"
OF: "Najstarejše najprej"

To je mogoče storiti tudi brez kode. Na strani za prilagajanje pripomočka si oglejte razdelek "Privzeta smer razvrščanja".

Sprememba privzete smeri razvrščanja

Izbirnik privzete smeri razvrščanja, ki ponuja Najbolj relevantno, Najnovejše najprej in Najstarejše najprej

Upoštevajte, da so komentarji na vsaki strani za vsako smer razvrščanja vnaprej izračunani, zato imajo vse smeri razvrščanja enako zmogljivost.

Prikaz vseh komentarjev hkrati – onemogoči paginacijo

Če želite onemogočiti straničenje in prikazati vse komentarje naenkrat, nastavite 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>

Premik polja za odgovor za komentarje

Privzeto je območje za vnos komentarja pred nitjo komentarjev. Vendar, z nastavitvijo tega konfiguracijskega parametra na true ga lahko premaknemo na za.

Premikanje polja za odgovor na dno

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>

To je mogoče prilagoditi brez kode, na strani za prilagajanje gradnika:

Premikanje polja za odgovor na dno

Možnost na strani za prilagajanje gradnika, ki postavi območje za vnos komentarja za nitjo komentarjev namesto pred njo

Omejitev dolžine komentarja

Največje število znakov, ki jih je dovoljeno vnesti v polje za vnos komentarja, je mogoče omejiti s parametrom maxCommentCharacterLength.

Privzeta vrednost je 2000.

Stvari, kot so URL-ji slik, niso vključeni v določanje dolžine.

Omeji dolžino komentarja

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>

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika:

Omeji dolžino komentarja

Polje največje velikosti komentarja na strani za prilagajanje gradnika, ki se uporablja za omejitev števila znakov, ki jih lahko komentar vsebuje

Onemogoči večvrstični komentar

Privzeto FastComments uporabniku omogoča vnos komentarja v poljubnem številu vrstic, do privzete omejitve znakov.

Vendar je včasih zaželeno omejiti uporabnika na vnos le ene vrstice besedila. Nekateri primeri uporabe vključujejo spletno dražbo ali klepet v živo, za kar se lahko uporabi FastComments.

Zastavico useSingleLineCommentInput omogočimo na naslednji 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 je mogoče tudi brez kode. Na strani za prilagajanje gradnika poiščite odsek "Enable Single-Line Comment Input".

Omogoči vnos enovrstičnega komentarja

Potrditveno polje za vnos enovrstičnega komentarja je vklopljeno na strani za prilagajanje gradnika, kar omeji vnos na eno vrstico

Upoštevajte, da so komentarji na vsaki strani za vsako smer sortiranja vnaprej izračunani, zato imajo vse smeri sortiranja enako zmogljivost.

Omeji število komentarjev na uporabnika

Privzeto lahko vsak uporabnik odda največ 5 komentarjev v isti minuti.

To se sledi po uporabniškem id, anonimnem uporabniškem id in ip naslovu (zgostljenem).

To je mogoče prilagoditi brez kode, na strani za prilagoditev pripomočka:

Omejevanje količine komentarjev na uporabnika

Polje za največje število komentarjev na minuto na strani za prilagoditev pripomočka, privzeto nastavljeno na 5

Upoštevajte, da če uporabljate API za ustvarjanje komentarjev, boste morda želeli v zahtevi posredovati izvirni ip naslov uporabnika našemu zaledju, da se omejitev hitrosti uporabi na uporabnika in ne globalno na vaš račun.

Prepreči nove komentarje najvišje ravni

Če nastavite noNewRootComments na true, bo widget skril območje za odgovore korenskih komentarjev, vendar bo še vedno dovoljeval uporabnikom odgovarjati na podkomentarje. Na primer, to lahko pogojno nastavite ob nalaganju strani, da boste dovolili le nekaterim uporabnikom pustiti komentarje na najvišji ravni.

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>

Največja globina odgovorov

Privzeto FastComments dovoljuje neomejeno gnezdenje odgovorov, kar ustvarja strukturo pogovora, kjer lahko uporabniki neomejeno odgovarjajo na odgovore.

Možnost maxReplyDepth vam omogoča omejiti, kako globoko se lahko razvežejo nitke odgovorov. Ko je dosežena največja globina, uporabniki na komentarjih na tej ravni ne bodo več videli gumba za odgovor.

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>

Ob nastavitvi maxReplyDepth na 2:

Uporabniki lahko komentirajo na najvišji ravni (globina 0)
Uporabniki lahko odgovarjajo na komentarje na najvišji ravni (globina 1)
Uporabniki lahko odgovarjajo na te odgovore (globina 2)
Nadaljnji odgovori onkraj globine 2 niso dovoljeni

Nastavitev na 1 bi dovolila le odgovore na komentarje na najvišji ravni, kar ustvari bolj plosko strukturo razprave.

Nastavitev maxReplyDepth na 0 bi onemogočila vse odgovore in dovolila le komentarje na najvišji ravni. Če ni določeno, so odgovori lahko gnezdeni brez omejitve.

[code-example-end]

Zahtevaj sprejem pogojev uporabe

FastComments vam omogoča, da od prvih komentatorjev zahtevate sprejem vaših pogojev uporabe, preden oddajo komentar.

Ko je omogočeno:

Anonimni uporabniki bodo videli potrditveno polje TOS pri vsakem komentarju
Avtenticirani uporabniki bodo videli potrditveno polje le pri njihovem prvem komentarju ali ko posodobite svoje TOS

Konfiguracija

Pojdite na stran za prilagajanje gradnika in omogočite potrditveno polje "Zahtevaj sprejem pogojev uporabe". Ko je omogočeno, boste videli naslednje možnosti:

Možnosti pogojev uporabe

Pult s pogoji uporabe, ki prikazuje izbirnik načina besedila TOS in polje datuma zadnje posodobitve

Način besedila TOS: Privzeto potrditveno polje prikazuje "Strinjam se s pogoji uporabe in pravilnikom o zasebnosti" z povezavami do obeh dokumentov. Izberite "Prilagodi besedilo po jezikih", da zagotovite svoje besedilo za vsak jezik.
Datum zadnje posodobitve TOS: Ko posodobite svoje pogoje uporabe, nastavite ta datum. Uporabniki, ki so sprejeli pred tem datumom, bodo morali sprejeti ponovno.

Kako deluje

Časovni žig sprejema TOS se shrani po uporabniku in po komentarju
Ko uporabnik sprejme TOS, se datum zabeleži v njegovem uporabniškem profilu (po najemniku)
Če nastavite datum "Zadnje posodobitve", ki je po datumu sprejema uporabnika, bo moral ponovno sprejeti
Za anonimne uporabnike, ki jih ni mogoče slediti, se potrditveno polje pojavi pri vsaki oddaji komentarja

Opozori pred zapustitvijo z neposlanim komentarjem

Privzeto, če uporabnik napiše komentar in nato osveži stran, zapre zavihek ali zapusti stran, preden ga pošlje, se osnutek tiho izgubi.

Nastavitev warnOnUnsavedComment na true povzroči, da brskalnik uporabnika vpraša za potrditev, preden zapusti stran, medtem ko katerokoli polje za komentar ali urejanje, ki je v teku, še vsebuje besedilo. Ko je komentar poslan, se besedilo počisti, zato se poziv ne prikaže.

Opozori na neshranjene komentarje

Copy

Run

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

Poziv uporablja lastni dialog brskalnika. Sodobni brskalniki prikazujejo svoje besedilo in ignorirajo prilagojeno besedilo, zato sporočila ni mogoče prilagoditi.

Ta možnost po potrebi naloži majhno razširitev, zato ne doda ničesar v gradnik za spletna mesta, ki je ne omogočijo.

Omogoči ankete

Ankete omogočajo komentatorjem, da komentarju priložijo vprašanje z 2 do 10 možnostmi. Vsi na strani glasujejo na mestu in vidijo rezultate, ki se posodabljajo v živo.

Ankete so privzeto izklopljene. Označite Enable Polls v nastavitvah prilagajanja pripomočka, da dodate gumb za anketo v orodno vrstico komentarja. Nato se prikažeta še dve nastavitvi:

Who Can Create Polls: Samo skrbniki/moderatorji (privzeto) ali Vsi.
Allow Anonymous Poll Votes: ko ni označeno (privzeto), lahko glasujejo samo prijavljeni uporabniki.

Enable Polls

Oglejte si vodnik za ankete, kako delujejo ustvarjanje, glasovanje, zasebnost in obvestila o anketah.

Pregled enotne prijave (SSO)

SSO, oziroma single-sign-on, je niz konvencij, ki omogoča vam ali vašim uporabnikom uporabo FastComments brez potrebe po ustvarjanju dodatnega računa.

Če ne dovolite anonimnega komentiranja, je za komentiranje z FastComments potreben račun. Ta postopek prijave naredimo zelo enostaven – uporabnik ob komentiranju pusti samo svoj e-poštni naslov. Vendar razumemo, da je tudi to lahko dodatna ovira, ki jo nekatere strani želijo odpraviti.

To trenuten trenutek zmanjšamo tako, da za celotno spletno mesto uporabi samo en prijavni tok.

Kako ga dobim?

Vse vrste računov trenutno dobijo dostop do SSO. Vendar se največje število SSO uporabnikov razlikuje glede na vaš paket. Tako kot pri drugih funkcijah, tudi načrti Pro in višji nudijo neposredno razvojno podporo.

Primerjajmo možnosti in se nato podrobno lotimo vsake izmed njih.

Migracije uporabnikov in komentarjev

Pri migraciji z platforme, ki podpira SSO, kot je Disqus, boste že imeli uporabnike in njihove komentarje.

Komentarji so uvoženi kot del migracije, bodisi preko API-ja, našega uvoznega vmesnika (Import UI) ali s podporo strankam. Import UI je prednostna izbira, če podpira platformo, iz katere migrirate, saj vključuje obravnavo napak, izvoz in nalaganje avatarjev in medijskih vsebin ter sistem za spremljanje serijskih opravil.

Samo uporabniki se dodajo samodejno ob prvem ogledu nitk komentarjev. Alternativno jih je mogoče predhodno dodati preko API-ja, vendar to delo ne prinaša veliko prednosti.

Če so komentarji uvoženi in SSO uporabniki niso ročno dodani preko API-ja, bodo komentarji samodejno pripisani uporabnikovemu računu ob prvem ustvarjanju tega računa, ko si ogleda katerokoli nit komentarjev. Nato bodo lahko upravljali, urejali in brisali komentarje, ki so jih prvotno napisali.

Samodejna migracija poteka preko e-pošte ali uporabniškega imena. Nekatere platforme ob izvozu ne zagotavljajo e-poštnih naslovov, kot je Disqus, zato v tem primeru uporabimo uporabniško ime.

Dokler posredujete ujemajoče se uporabniško ime in e-poštni naslov v SSO obremenitvi, bomo e-poštni naslov dodali posameznim objektom komentarjev, tako da bodo obvestila in omembe delovale.

Če želite uvoziti komentarje in uporabnike hkrati, sodelujte s podporo, da prebijejo komentarje na ustrezne račune uporabnikov potem, ko so uporabniki uvoženi preko API-ja.

Torej, da povzemo najlažjo pot za migracijo:

Uvozite komentarje.
1. Avatarji in druga medijska vsebina se samodejno uvozijo, če uporabljate Import UI v Manage Data -> Imports.
Nastavite Secure ali Simple SSO.
Naj se migracija izvede za vsakega uporabnika samodejno, ko se prvič prijavi.
1. To običajno doda manj kot sekundo k času nalaganja strani, če ima uporabnik manj kot 50k komentarjev.

Uporabniki WordPressa

Če uporabljate naš WordPress vtičnik, potem ni treba pisati nobene kode! Preprosto pojdite na stran skrbnika vtičnika, kliknite SSO Settings in nato Enable.

To vas pripelje do čarovnika z enim klikom, ki bo ustvaril vaš API ključ, ga poslal na vašo WordPress namestitev in vklopil SSO. To smo za vas združili v en sam klik.

Upoštevajte, da če nameščate vtičnik prvič, boste morali dokončati postopek namestitve, preden boste videli stran skrbnika z gumbom SSO Settings.

WordPress SSO - Moderatorji

Upoštevajte, da se zaenkrat, da bi se znašla značka "Moderator" ob komentarjih vaših moderatorjev, ko komentirajo z FastComments WordPress vtičnikom, morajo biti ti tudi dodani kot Moderator v nadzorni plošči FastComments in imeti preverjen e-poštni naslov.

Prilagojene integracije

Za prilagojene integracije sta na voljo dve možnosti.

Možnost ena - Secure SSO

S Secure SSO FastComments ve, da je uporabnik, ki komentira, glasuje in bere komentarje, resničen uporabnik na vašem spletnem mestu.

Dokler ustvarite veljaven payload, bo uporabnik vedno imel nemoteno izkušnjo komentiranja.

Pri Secure SSO se SSO payload ustvari na strežniku z uporabo HMAC avtentikacije in se nato posreduje v pripomoček na odjemalcu.

Pri Secure SSO je uporabnikov račun popolnoma ločen od preostale baze uporabnikov FastComments. To pomeni, da če imamo dva partnerja Firma A in Firma B, lahko imata oba SSO uporabnika z uporabniškim imenom "Bob".

Zahteve

Nekaj osnovnega znanja o strežniškem razvoju.
Nekaj osnovnega znanja o ravnanju s skrivnimi API ključi.
Nekaj osnovnega znanja o razvoju API-jev ali strežniškem upodabljanju.

Prednosti

Varen.
Nemotena izkušnja komentiranja.

Slabosti

Zahteva razvoj na strežniku.

Posodabljanje podatkov uporabnika

Pri Secure SSO bomo ob vsakem posredovanju sso uporabniškega payloada posodobili njihov uporabniški račun z najnovejšimi informacijami. Na primer, če ima uporabnik uporabniško ime X, in v SSO payloadu posredujete Y, bo njihovo uporabniško ime postalo Y.

Če s tem pristopom želite odstraniti vrednosti, jih nastavite na null (ne undefined).

Secure SSO API

Nudimo tudi API za interakcijo s SSO uporabniki. Oglejte si the docs.

Upoštevajte, da se pri uporabi Secure SSO uporabniki ob nalaganju strani samodejno ustvarijo v ozadju. Ni vam treba množično uvažati uporabnikov.

Možnost dve - Simple SSO

Alternativa Secure SSO je, da preprosto posredujete uporabniške informacije v pripomoček za komentiranje.

Posredovanje e-poštnega naslova pri Simple SSO ni obvezno, vendar bodo brez njega njihovi komentarji prikazani kot "Unverified".

^Opomba! Od začetka leta 2022 uporabniška imena pri Simple SSO ne potrebujejo biti edinstvena po celotnem FastComments.com.

Idealno naj bi bil Simple SSO izbran le pri razvoju na platformi, ki ne omogoča dostopa do strežniškega dela.

Zahteve

Nekaj osnovnega znanja o razvoju na strani odjemalca.
Poznavanje vsaj e-poštnega naslova uporabnika.

Prednosti

Preprosto.
Vsa aktivnost se kljub temu preveri.
Uporabnik nikoli ne vnese svojega uporabniškega imena ali e-poštnega naslova.

Slabosti

Manj varno kot Secure SSO, saj bi lahko bilo podatkovno breme na strani odjemalca zlonamerno konstruirano tako, da postanete kateri koli uporabnik.

Simple SSO API

Uporabniki, samodejno ustvarjeni preko Simple SSO toka, so shranjeni kot SSOUser objekti. Dostopate in jih upravljate lahko preko SSOUser API-ja. Oglejte si the docs.

Po meri integracije – varna enotna prijava (SSO)

FastComments Secure SSO uporablja HMAC-SHA256 šifriranje kot mehanizem za implementacijo SSO. Najprej bomo predstavili splošno arhitekturo, nato primere in podrobne korake.

Obstaja tudi dokumentacija o migraciji od drugih ponudnikov s podobnimi SSO mehanizmi ter o razlikah.

Potek izgleda takole:

Potek Secure SSO

Ker Secure SSO vključuje razvoj celotnega sklada (full-stack), so popolni delujoči primeri kode v Java/Spring, NodeJS/Express in navadnem PHP trenutno na GitHubu.

Čeprav v primeru NodeJS uporabljamo ExpressJS in v primeru Java Spring, za implementacijo FastComments SSO v teh izvajalnih okoljih niso potrebni nobeni frameworki/knjižnice - delujejo izvorne crypto paketi.

S FastComments SSO vam ni treba pisati novih API endpointov. Preprosto šifrirajte podatke uporabnika s svojim skrivnim ključem in podatek (payload) posredujte widgetu za komentarje.

Pridobite svoj API skrivni ključ

Svoj API skrivni ključ lahko pridobite na tej strani. To stran najdete tudi tako, da odprete Moj račun, kliknete ploščico API/SSO in nato kliknete "Get API Secret Key".

Parametri widgeta za komentarje

API dokumentacija widgeta za komentarje na visoki ravni je na voljo tukaj.

Poglejmo podrobneje, kaj ti parametri pomenijo.

Widget za komentarje sprejme konfiguracijski objekt - ta že posredujete, če uporabljate FastComments in podate svoj ID stranke (imenovan tenantId).

Za omogočitev SSO posredujte nov objekt "sso", ki mora imeti naslednje parametre. Vrednosti je treba generirati na strežniški strani.

userDataJSONBase64: Podatki uporabnika v JSON formatu, ki so nato kodirani v Base64.
verificationHash: HMAC-SHA256 hash, ustvarjen iz UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch časovni žig, v milisekundah. Ne sme biti v prihodnosti ali več kot dva dni v preteklosti.
loginURL: URL, ki ga widget za komentarje lahko prikaže za prijavo uporabnika.
logoutURL: URL, ki ga widget za komentarje lahko prikaže za odjavo uporabnika.
loginCallback: Če je podan namesto URL-ja za prijavo, funkcija, ki jo widget za komentarje pokliče ob kliku na gumb za prijavo.
logoutCallback: Če je podan namesto URL-ja za odjavo, funkcija, ki jo widget za komentarje pokliče ob kliku na gumb za odjavo.

Odjemalska koda Secure SSO

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

Objekt User

Objekt User vsebuje naslednjo shemo:

Objekt User

Copy

interface SSOUser {
    /** Obvezno. Največ 1k znakov. **/
    id: string;
    /** Obvezno. Največ 1k znakov. Opomba: Morala biti unikatna. **/
    email: string;
    /** Obvezno. Največ 1k znakov. Opomba: Uporabniško ime ne more biti e-poštni naslov. Ni nujno, da je unikatno. **/
    username: string;
    /** Neobvezno. Največ 3k znakov za URL-je. Privzeto se uporabi gravatar na podlagi e-pošte. Podpira 64 kodirane slike, v tem primeru je omejitev 50k znakov. **/ 
    avatar?: string;
    /** Neobvezno. Privzeto false. **/
    optedInNotifications?: boolean;
    /** Neobvezno. Privzeto false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Neobvezno. Največ 100 znakov. Ta oznaka bo prikazana poleg imena. Privzeto Administrator/Moderator, kadar je to primerno. **/
    displayLabel?: string;
    /** Neobvezno. Največ 500 znakov. To bo prikazano namesto uporabniškega imena. **/
    displayName?: string;
    /** Neobvezno. Največ 2k znakov. Ime uporabnika bo povezano na to. **/
    websiteUrl?: string;
    /** Neobvezno. Do 100 skupin na uporabnika. ID skupine ne sme biti daljši od 50 znakov. **/
    groupIds?: string[];
    /** Neobvezno. Označi uporabnika kot administratorja. **/
    isAdmin?: boolean;
    /** Neobvezno. Označi uporabnika kot moderatorja. **/
    isModerator?: boolean;
    /** Neobvezno, privzeto true. Nastavite na false, da omogočite zavihek "activity" v profilu uporabnika. **/
    isProfileActivityPrivate?: boolean;
    /** Neobvezno, privzeto false. Nastavite na true, da onemogočite komentarje profila. **/
    isProfileCommentsPrivate?: boolean;
    /** Neobvezno, privzeto false. Nastavite na true, da onemogočite neposredna sporočila temu uporabniku. **/
    isProfileDMDisabled?: boolean;
    /** Neobvezna konfiguracija za značke uporabnika. **/
    badgeConfig?: {
        /** Polje globalnih ID-jev značk za dodelitev. Omejeno na 30 značk. Vrstni red je upoštevan. **/
        badgeIds: string[];
        /** Polje ID-jev značk, obseženih na trenutno stran (urlId). Prikazane so samo na dodeljeni strani. **/
        pageBadgeIds?: string[];
        /** Če je true, zamenja obstoječe prikazane značke. Globalne in stransko obsežene so prepisane neodvisno. **/
        override?: boolean;
        /** Če je true, posodobi lastnosti prikaza značk iz konfiguracije najemnika. **/
        update?: boolean;
    };
}

Moderatorji in administratorji

Za administratorje in moderatorje posredujte ustrezni zastavici isAdmin ali isModerator v objektu SSOUser.

Obvestila

Za omogočitev ali onemogočitev obvestil nastavite vrednost optedInNotifications na true oz. false. Ko uporabnik prvič naloži stran s to vrednostjo v SSO podatku, bodo njegove nastavitve obvestil posodobljene.

Poleg tega, če želite, da uporabniki prejemajo e-poštna obvestila o aktivnosti na straneh, na katere so naročeni (namesto samo obvestil v aplikaciji), nastavite optedInSubscriptionNotifications na true.

VIP uporabniki & posebne oznake

Poleg imena uporabnika lahko prikažete posebno oznako z uporabo neobveznega polja "displayLabel".

Neprijavljeni uporabniki

Za predstavitev neprijavljenega uporabnika preprosto ne izpolnite userDataJSONBase64, verificationHash ali timestamp. Podajte loginURL.

Ti uporabniki ne bodo mogli komentirati, namesto tega jim bo prikazano sporočilo za prijavo (sporočilo, povezava ali gumb, odvisno od konfiguracije).

Neposredni primeri za serializacijo in hashiranje podatkov uporabnika

Več podrobnosti kot primeri najdete tukaj (js), tukaj (java) in tukaj (php).

Zavedamo se, da je lahko vsaka integracija zapleten in boleč proces. Ne oklevajte in se obrnite na svojega predstavnika ali uporabite stran za podporo.

Po meri integracije – preprosta enotna prijava (SSO)

Z enostavnim SSO lahko zagotovimo pripomočku za komentiranje informacije o uporabniku, tako da ne mora vpisati svojega uporabniškega imena ali e‑naslova za komentiranje.

Enostavni SSO lahko konfiguriramo na naslednji način:

Enostavni SSO

Copy

Run

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

Uporabnik bo prijavljen in v ozadju bo ustvaril SSO uporabnika. Uporabnik bo imel createdFromSimpleSSO nastavljen na true, če je pridobljen iz API-ja.

Opombe:

E‑naslov je edinstveni identifikator za enostavni SSO.
Zagotovitev e‑naslova pri enostavnem SSO ni obvezna, vendar bodo njihovi komentarji privzeto prikazani kot "Neoverjeni". Če e‑naslov ni naveden, uporabnik ne more biti popolnoma avtenticiran.
NOVO Od januarja 2022: Uporabniška imena ne morajo biti edinstvena po celotnem fastcomments.com
Enostavni SSO lahko samodejno ustvari in posodobi SSO uporabnike, če je naveden e‑naslov, in uporabnik ni bil prvotno ustvarjen iz varnega SSO. Če enostavni SSO paket poimenuje uporabnika, ustvarjenega z varnim SSO ali API-jem, ostane ta uporabnik nedotaknjen, obiskovalec pa dobi ločenega uporabnika.
Z lastnostjo badgeConfig lahko določite značke za uporabnika. Polje badgeIds vsebuje ID-je globalnih značkov, ki se povežejo z uporabnikom. Polje pageBadgeIds vsebuje ID-je značkov, omejenih na trenutno stran (urlId) — ti znački so prikazani le na strani, kjer so dodeljeni. Če je override nastavljeno na true, bo nadomestilo obstoječe prikazane značke (globalni in stranični znački se neodvisno prepišejo); če je false, se bodo dodali k obstoječim značkom.

Nastavitve enostavnega SSO

Enostavni SSO je vedno na voljo. Dve nastavitvi nadzorujeta, koliko FastComments mu zaupa. Najdete ju lahko z iskanjem SSO v pravilu prilagoditve. Obe sta privzeto izklopljeni in se uporabljata ne glede na to, ali je "Zahtevaj SSO za ogled komentarjev" vklopljeno.

Računi, ki so že uporabljali enostavni SSO, ko so bile te nastavitve dodane, imata obe vklopljeni, zato se za njih ni nič spremenilo.

Velja le pravilo prilagoditve, ki se najbolj ujema s stranjo, zato če imate več pravil, nastavite te na vsakem od njih. Novo pravilo se začne z vklopljenimi nastavitvami, če je katerokoli od vaših drugih pravil imel nastavitve vklopljene.

Samodejno potrdi komentarje prek enostavnega SSO

Ko je to vklopljeno, so komentarji uporabnikov enostavnega SSO takoj potrjeni.

Ko je to izklopljeno, se komentarji uporabnikov enostavnega SSO prikažejo kot "Neoverjeni", dokler uporabnik ne klikne povezave, ki jo pošljemo na e‑naslov v paketu enostavnega SSO. Če samodejno odobrite le potrjene komentarje, tudi ti čakajo na to povezavo. Če v paketu ni e‑naslova, komentar ostane neoverjen.

Ta nastavitev vpliva le na komentarje. Glasovi uporabnikov enostavnega SSO se vedno štejejo takoj.

Dovoli admine enostavnega SSO

Ko je to vklopljeno, lahko uporabnik enostavnega SSO postane skrbnik ali moderator vašega računa:

Uporabnik enostavnega SSO, ki ima pravice skrbnika ali moderatorja, jih ohrani.
Uporabnik enostavnega SSO z enakim e‑naslovom kot eden od vaših skrbnikov ali moderatorjev prevzame njihove pravice.

Ko je to izklopljeno, enostavni SSO ne dodeli teh pravic. Paket enostavnega SSO, ki poimenuje uporabnika s pravicami, ustvari ločenega uporabnika brez pravic, izvirni uporabnik pa ostane nedotaknjen.

Paketi enostavnega SSO niso podpisani, zato ko je to vklopljeno, lahko kdorkoli, ki pozna e‑naslov ali ID skrbnika, deluje v njegovem imenu. Če je to pomembno za vaše spletno mesto, pustite to izklopljeno in uporabite varni SSO za svoje skrbnike.

Uporabnikov, ustvarjenih z varnim SSO ali API-jem, enostavni SSO ne more doseči, ne glede na to, ali je to vklopljeno.

Po meri integracije – migracija iz Disqus SSO

Največja razlika med Disqus in FastComments Secure SSO je, da Disqus uporablja SHA1 za šifriranje, medtem ko mi uporabljamo SHA256. To pomeni, da je migracija iz Disqus enostavna - zamenjajte algoritem zgoščevanja iz SHA1 v SHA256 in posodobite imena lastnosti, posredovana v UI.

Po meri integracije – migracija iz Commento SSO

Commento uporablja povsem drugačen pristop k SSO - zahtevajo, da imate endpoint, ki ga pokličejo za overitev uporabnika. FastComments pa deluje obratno - preprosto zakodirajte in zgoščite (hash) podatke o uporabniku z uporabo vašega secret key in jih posredujte naprej.

Zaščita niti komentarjev z enotno prijavo

FastComments SSO (podrobnosti tukaj) vašim uporabnikom omogoča komentiranje brez prijave na drugo platformo.

Vendar to samo po sebi ne zavaruje vaših komentarjev, saj so podatki o komentarjih privzeto javno dostopne informacije - vsakdo, ki si lahko ogleda stran, si lahko ogleda tudi komentarje.

S spremembo nastavitve lahko omejimo pridobivanje komentarjev, razen za administratorje ali veljavne SSO uporabnike.

Nastavitev brez kode

Ko je SSO nastavljen, lahko preprečimo ogled in interakcijo z našimi komentarji z ustvarjanjem pravila prilagoditve.

Pri tem poiščite SSO in našli boste to možnost:

Zahtevaj SSO za ogled komentarjev

Omogočite jo in shranite pravilo prilagoditve.

Zaščita samo določene domene ali strani

Za zaščito samo določene domene ali strani preprosto nastavimo pravilo prilagoditve.

Na vrhu vmesnika za prilagoditve bomo našli dve polji: Domain in URL ID.

Za zaščito določene domene vnesite dotično domeno v polje "domain".

Za zaščito določene strani vnesite URL strani v polje "URL ID". Če imate prilagojeno integracijo s FastComments, lahko tukaj vnesete vrsto ID-ja namesto URL-ja.

Varnostne ravni

Ko zahtevate SSO, se boste morali odločiti, ali zahtevate Simple SSO ali Secure SSO. Če zahtevate Simple SSO, sta dovoljena oba, če pa zahtevate Secure SSO, mora biti vsebina pridobljena z Secure SSO payloadom, ki je hashiran z vašim API ključem, da si jo je mogoče ogledati.

Možnost varnostne ravni se prikaže, ko izberete "Zahtevaj SSO za ogled komentarjev", in deluje samo, dokler je ta možnost vklopljena.

Nastavitvi Samodena potrditev komentarjev prek Simple SSO in Dovoli Simple SSO administratorje sta ločeni in veljata ne glede na to, ali je ta možnost vklopljena.

Zaščita onkraj branja

Omogočitev te možnosti bo zavarovala stran ali domeno pred komentiranjem, razen če je uporabnik prijavljen prek SSO.

Pasti

Uporabniki, ki so ustvarili komentarje pred vašo SSO integracijo, jih ne bodo mogli videti, razen če se prijavijo prek vaše SSO integracije.

Dovoli anonimno komentiranje

Privzeto FastComments zahteva e-pošto za komentiranje. Vendar ni nujno, da je veljavna — dokler uporabnik ne klikne povezave, ki mu je bila poslana, bo njegov komentar prikazan z oznako "Nepreverjen komentar".

Vendar pa lahko zahtevo po e-pošti odstranimo. Vnosno polje za e-pošto se bo še vedno prikazalo, ne bo pa več obvezno.

To je mogoče nastaviti v uporabniškem vmesniku za prilagoditev pripomočka:

Omogočanje anonimnih komentarjev

Možnost anonimnih komentarjev v vmesniku za prilagoditev pripomočka, ki naredi polje za e-pošto neobvezno

Uporabniško ime je še vedno obvezno. Da odstranite tudi ta korak, lahko nastavite privzeto uporabniško ime, ki ga delijo vsi, ali pa pustite, da FastComments samodejno ustvari edinstveno uporabniško ime za vsakega obiskovalca.

Preprečevanje izteka anonimnih komentarjev

FastComments je mogoče nastaviti, da odstrani nepreverjene komentarje po želenem številu dni. To pomaga v boju proti neželeni pošti.

Privzeto tega ne počne.

To je mogoče nastaviti ali onemogočiti prek strani Nastavitve moderiranja.

Nastavitve moderiranja

Onemogoči vnos e-pošte

Ko uporabniki komentirajo in niso prijavljeni, bodo pozvani, da vpišejo svoj e‑mail.

To bo ustvarilo “nepreverjeno sejo” za tega uporabnika, in jih bomo prosili, da to sejo preverijo prek e‑maila.

Za nekatere strani ali aplikacije je zaželeno, da uporabnika ne sprašujemo po e‑mailu pri komentiranju ali glasovanju.

Omogočanje anonimnih komentarjev naredi polje za vnos e‑maila neobvezno. Vendar ga lahko popolnoma onemogočimo. Najprej omogočite anonimne komentarje, nato se bo pojavila možnost onemogočanja polj za vnos e‑maila.

Onemogoči vnos e-pošte

Možnost popolne skritja polj za e-pošto, prikazana po omogočitvi anonimnih komentarjev v vmesniku za prilagajanje

Ko je to omogočeno, polja za e‑mail ne bodo prikazana v nobenem od naših produktov za komentiranje.

Upoštevajte, da bodo pri tej nastavitvi vsi komentarji nepreverjeni, razen če uporabnik ustvari račun in se prijavi na https://fastcomments.com.

Morda boste želeli razmisliti o onemogočanju oznake nepreverjenega.

Onemogoči oznako nepreverjeno

Privzeto bo FastComments prikazal oznako "Neoverjen komentar" za komentarje, ki so bili puščeni za uporabnika z neoverjeno sejo brskalnika. Preberite več o neoverjenih komentarjih here.

Onemogoči oznako neoverjenega komentarja

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>

Ta funkcija se lahko uporablja tudi brez pisanja kode v uporabniškem vmesniku za prilagajanje:

Onemogoči oznako neoverjenega komentarja

Dovoli anonimno glasovanje

Ko uporabniki poskušajo glasovati o komentarju in niso prijavljeni, bodo pozvani, da vpišejo svoje uporabniško ime in e‑pošto.

To zahtevo lahko odstranimo, kar omogoča, da kdorkoli glasuje o komentarju, ne da bi pustil kakršnekoli podatke.

Omogoči anonimne glasove

Stran za prilagajanje gradnika z omogočeno možnostjo anonimnih glasov, tako da glasovanje ne zahteva imena ali e‑pošte

Nastavitev privzetega uporabniškega imena

Ko uporabniki komentirajo ali glasujejo, in niso prijavljeni, bodo pozvani, da vpišejo svoj e‑mail in uporabniško ime.

V primeru anonimnega komentiranja je včasih zaželeno določiti privzeto uporabniško ime, da se zmanjša ovira pri komentiranju. To je mogoče storiti prek vmesnika za prilagoditve. Anonimno komentiranje mora biti najprej omogočeno.

Nastavitev privzetega uporabniškega imena

Polje privzetega uporabniškega imena, ki se prikaže v uporabniškem vmesniku prilagoditev, ko je omogočeno anonimno komentiranje

Deljenje privzetega uporabniškega imena

Privzeto uporabniško ime je skupno prikazno ime, ne identiteta. Obiskovalec, ki ohrani privzeto ime in vpiše svoj e‑mail, dobi svoj račun, pri čemer je privzeto ime prikazano kot njegovo javno ime. Poljubno število obiskovalcev lahko ohrani isto privzeto ime, zato se »Anonimno« nikoli ne prikaže kot že zasedeno.

Uporabniška imena, ki jih obiskovalec vnese sam, morajo biti še vedno edinstvena.

Če želite, da vsak obiskovalec dobi edinstveno ime, ne da bi moral razmišljati o tem, si oglejte Samodejno ustvarjanje uporabniških imen.

Samodejno ustvarjanje uporabniških imen

Ko uporabniki komentirajo ali glasujejo, in niso prijavljeni, bodo pozvani, da vneseta svoj e-poštni naslov in uporabniško ime.

Za nekatere spletna mesta je zahtevanje, da obiskovalec izmisli edinstveno uporabniško ime, ovira, zlasti na mobilnih napravah. FastComments lahko ustvari nevtralno uporabniško ime za vsakega novega obiskovalca in ga vnaprej izpolni v polje za uporabniško ime, na primer BraveOtter4172.

Obiskovalec ga lahko pusti takšnega, kot je, ali ga zamenja z imenom po svoji izbiri.

To je mogoče omogočiti v vmesniku za prilagajanje, pod nastavitvijo z imenom Generate Usernames Automatically:

Samodejno generiranje uporabniških imen

Možnost Generate Usernames Automatically v vmesniku za prilagajanje pripomočka

Kako deluje

Vsako generirano ime je edinstveno. Preveri se glede na obstoječe račune in je rezervirano za brskalno sejo tistega obiskovalca, tako da dva obiskovalca ne dobita istega imena.
Ime se generira samo za obiskovalce, ki ga še nimajo. Prijavljeni uporabniki, uporabniki SSO in obiskovalci, ki so že komentirali, obdržijo svoje obstoječe ime.
Deluje z anonimnim komentiranjem ali brez njega (anonymous commenting). Ko je anonimno komentiranje izklopljeno, obiskovalec še vedno vpiše svoj e-poštni naslov, vendar si ne mora več izmisliti uporabniškega imena.
Vrnjeni obiskovalec, ki vpiše e-poštni naslov, ki ga je že uporabljal, se poveže z obstoječim računom in obdrži ime na tem računu.
Če je nastavljeno tudi Privzeto uporabniško ime, ima generirano ime prednost.

Povratni klici

Vse knjižnice za komentarni vtičnik (trenutno Angular, React, Vue) podpirajo povratne klice.

Povratni klici so določeni v konfiguracijskem objektu, z istimi podpisi za vsako knjižnico.

Podprti povratni klici so:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

Natančne podpise najdete v TypeScript definicije.

Tukaj je primer z vsemi uporabljenimi povratnimi klici:

Primeri povratnih klicev

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.fcConfigs = [{
        target: '#fastcomments-widget',
        tenantId: 'demo',
        onInit: function () {
            console.log('Library started to fetch comments!');
        },
        onAuthenticationChange: function (eventName, userObj) {
            console.log('User authenticated!', eventName, userObj);
        },
        onRender: function () {
            console.log('Render event happened!');
        },
        commentCountUpdated: function (newCount) {
            console.log('New comment count:', newCount);
        },
        onReplySuccess: function (comment) {
            console.log('New comment saved!', comment);
        },
        onVoteSuccess: function (comment, voteId, direction, status) {
            console.log('New vote saved!', comment, voteId, direction, status);
        },
        onImageClicked: function (src) {
            console.log('Image clicked!', src);
        },
        onOpenProfile: function (userId) {
            console.log('User tried to open profile', userId);
            // return true; // vrni true, da preprečiš privzeto vedenje (odpiranje uporabniškega profila na fastcomments.com).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // simuliranje asinhronega vedenja (klicanje API itd.).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // komentarji so razvrščeni po privzetem vrstnem redu na strani, ki je lahko 'Najbolj relevantni' (npr. najbolj všečkani, itd.) ali 'Najnovejši prvi'
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    }];
</script>

Ročno določanje jezikovne nastavitve uporabnika

Privzeto bo FastComments prikazal pripomoček za komentarje v lokalizaciji, ki jo določi uporabnikov sistem in brskalnik.

Ko uporabnik komentira ali se prijavi, posodobimo njegovo zadnjo uporabljeno lokalizacijo in jo uporabimo tudi za pošiljanje e-pošte.

To vpliva na to, kako je pripomoček za komentarje preveden za uporabnika. Lokalizacija sestavlja uporabnikov jezik in regija, zato bo nastavitev lokalizacije običajno spremenila jezik, ki se uporablja za prikaz besedila uporabniku.

Preko uporabniškega vmesnika

To je mogoče določiti prek uporabniškega vmesnika za prilagajanje pripomočka. Oglejte si možnost "Lokalizacija / Jezik":

Spreminjanje lokalizacije / jezika

Spustni meni Lokalizacija / Jezik na strani za prilagajanje pripomočka, ki se uporablja za preglasitev zaznane lokalizacije obiskovalca

Preko kode

To je mogoče preglasiti z želeno lokalizacijo.

Ročno določanje uporabnikove lokalizacije

Copy

Run

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

Podprti jeziki in kode lokalizacije

Tukaj lahko najdete popoln seznam podprtih jezikov in ustreznih kod lokalizacije.

Opomba o SSO

Če uporabljate SSO, boste morda želeli v uporabniškem objektu posredovati uporabnikovo lokalizacijo, da bodo e-poštna sporočila in druge stvari pravilno lokalizirane zanj.

Omejitev dovoljenih jezikov

Privzeto FastComments ne omejuje jezikov, ki se uporabljajo za komentarje.

Morda je zaželeno omejiti jezike, ki jih skupnost uporablja.

To je mogoče nastaviti brez kode na strani za prilagajanje gradnika:

Dovoljeni jeziki

Izbirnik dovoljenih jezikov na strani za prilagajanje gradnika za omejevanje, katere jezike lahko komentarji uporabljajo

Sistem bo prebral njihov komentar, določil njegov jezik in ga nato primerjal z dovoljenim seznamom.

Če je komentar napisan v jeziku, ki ni dovoljen, se prikaže lokalizirano sporočilo o napaki.

Prevod komentarjev

Privzeto FastComments prevede vmesnik vtičnika (gumba, oznake, sporočila o napakah) v jezik gledalca, vendar so komentarji prikazani natančno takšni, kot so bili napisani.

Prevod komentarjev doda prevajanje samih komentarjev, tako da lahko skupnost, ki piše v več jezikih, prebere vsak komentar v svojem jeziku.

Obstajata dva načina:

Samodejno: komentarji, napisani v jeziku, ki ni jezik vtičnika, so prikazani prevedeni. Pod komentarjem se pojavi vrstica "Prevedeno iz španščine" z povezavo Prikaži izvirnik, ki preklaplja med prevodom in neprevedenim besedilom.
Ročno: vsak komentar dobi povezavo Prevedi. Klik na to prevede ta komentar v jezik gledalca, z enako možnostjo Prikaži izvirnik po tem. Komentarji, ki so že v jeziku gledalca, to sporočijo namesto tega.

Ciljni jezik je jezik vtičnika: nastavitev Locale / Language na isti pravili prilagoditve, če je nastavljena, sicer je jezik brskalnika obiskovalca. Od obiskovalca ni potrebno ničesar, nobenega računa, razširitve ali dodatne programske opreme, in deluje enako v vdelanem vtičniku ter na samostojnih straneh s komentarji.

To je omogočeno po pravilu prilagoditve, zato se lahko uporablja za celotno spletno mesto, eno domeno ali posamezno stran. Privzeto je izklopljeno.

Prevod komentarjev

Prevod je nastavitev na strežniški strani. Posredovanje commentTranslation v JavaScript konfiguraciji vtičnika ga ne omogoči; to naredi pravilo.

Vsak komentar je preveden največ enkrat na ciljni jezik, rezultat pa je shranjen skupaj s komentarjem, tako da se komentar, ki ga prebere tisoč španskih govorcev, prevede le enkrat. Če avtor ali moderator komentar ureja, se shranjeni prevod zavrže in komentar se ob naslednjem ogledu ponovno prevede. Prevedeno besedilo gre skozi enako čiščenje in pravila za povezave kot izvirni komentar. Komentarji, ki so predolgi ali katerih jezik ni mogoče zaznati, so prikazani neprevedeni.

Uporaba se obračuna kot LLM žetoni po isti ceni kot AI Agents in se prikaže na istem mestu v vaših podrobnostih obračuna.

Naslovi strani

Trenutni naslov strani je povezan z določenim urlId in je shranjen za uporabo v orodjih za moderiranje.

Privzeto se pridobi iz document.title.

Če želite, lahko svoj naslov strani določite na naslednji 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>

Prepreči nove odgovore in onemogoči glasove

Komentiranje je mogoče zakleniti, tako da z nastavitvijo zastavice readonly na true ne morejo biti objavljeni novi komentarji ali glasovi.

Komentarji tudi ne bodo mogli biti urejani ali izbrisani.

Zaklepanje niti komentarjev

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 je mogoče prilagoditi brez kode, na strani za prilagajanje gradnika, za celotno domeno ali stran:

Zaklepanje niti komentarjev

Nastavitev preprečevanja novih odgovorov na strani za prilagajanje gradnika, ki zaklene nit za domeno ali stran

Posodobitev!

Od novembra 2022 je mogoče niti zakleniti ali odkleniti v živo s strani skrbnikov in moderatorjev prek menija s tremi pikami nad območjem odgovora.

To bo preprečilo nove komentarje, hkrati pa bo še vedno omogočalo glasovanje in omogočalo uporabnikom, da po želji izbrišejo svoje komentarje, medtem ko readonly teh stvari ne dovoljuje.

To ustreza polju isClosed v API-ju Page.

Omejevanje domen povezav

Privzeto FastComments omogoča povezovanje na katerokoli zunanjo stran.

To je mogoče omejiti na želeni seznam strani ali domen. Poskus objave povezave na stran ali domeno, ki ni v določenem seznamu, bo povzročil prikaz napake uporabniku.

Ta preverjanje velja le za pripomoček za komentarje in API. Uvozi niso prizadeti.

To je izvedeno brez kode, na strani za prilagajanje pripomočka:

Omeji domene zunanjih povezav

Nastavitve zunanjih povezav s seznamom omejenih domen povezav, kjer so vnesena dovoljena mesta

Število komentarjev in štetje vseh vgrajenih odgovorov

Število komentarjev, prikazano na vrhu pripomočka za komentarje, lahko prikaže bodisi vse komentarje na najvišji ravni, to pomeni odgovore, ki so neposredni odgovori na stran ali članek, ali pa je lahko to število vseh gnezdenih komentarjev.

Privzeto je to true - to je števec slednjega - vseh komentarjev. V starejših različicah pripomočka za komentarje je bila privzeta vrednost false.

Obnašanje lahko spremenimo, tako da bo štel vse gnezdene komentarje, tako da zastavico countAll nastavite 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>

Če želimo, da števec odraža le komentarje na najvišji ravni, zastavico nastavimo 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>

To trenutno ni mogoče prilagoditi brez sprememb kode.

Omogoči povezave komentatorjev

Privzeto FastComments zahteva od uporabnika le njihov komentar, uporabniško ime in e‑pošto.

Vendar pa v nekaterih situacijah morda želite, da uporabnik pusti povezavo do svojega bloga ali spletnega mesta.

Lahko omogočimo prikaz dodatnega vnosnega polja za vnos URL-ja spletnega mesta uporabnika, tako da nastavimo zastavico enableCommenterLinks na true:

Omogočanje povezav komentatorjev

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>

Ko je URL naveden, se bo uporabniški račun posodobil in vse njihove uporabniške ime na vseh preteklih in prihodnjih komentarjih bo povezano s tem URL-jem.

To je mogoče prilagoditi brez kode na strani za prilagajanje gradnika:

Omogočanje povezav komentatorjev

Stran za prilagajanje gradnika s potrditvijo potrditvenega polja povezav komentatorjev, ki doda polje za URL spletnega mesta v obrazec za komentar

Skupine moderacije

Seznam ID-jev, ustvarjenih na strani Skupine za moderiranje.

Če je določeno, bodo komentarji, oddani z navedeno konfiguracijo, vsebovali isti nabor moderationGroupIds.

Če ima Moderator definirano eno ali več Skupine za moderiranje, bo na strani Moderate Comments videl le komentarje, povezane z njegovo skupino ali skupinami.

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>

Omenjanje ID-jev skupin

Seznam ID-jev za uporabo pri samodokončanju @omemb. Uporabno, če želite preprečiti označevanje uporabnikov, kadar nimajo prekrivajočih se skupin.

Če je določeno, bodo v samodokončanju po vnosu znaka @ prikazani le uporabniki iz drugih skupin.

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 avtentikacijo FastComments zahteva, da so v vašem brskalniku omogočeni piškotki tretjih oseb. Brez njih bodo uporabniki vedno morali pustiti svoj e‑mail, da komentirajo (razen če je polje za e‑mail skrito), in njihovi komentarji bodo privzeto prikazani kot neverificirani.

Da to zaobidete, lahko omogočite zaobidenje piškotkov tretjih oseb.

Ko je ta nastavitev omogočena, bo povzročila majhno pojavno okno, ki prikaže sporočilo, da je uporabnik prijavljen. To pojavno okno se prikaže vsakič, ko uporabnik sodeluje z gradnikom za komentarje; na primer, če pusti komentar.

To lahko storimo v kodi tako, da nastavimo zastavico enableThirdPartyCookieBypass na true:

Omogočanje zaobidenja piškotkov tretjih oseb

Copy

Run

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

To lahko nastavite tudi prek uporabniškega vmesnika za prilagajanje gradnika, pod Enable Third-Party Cookie Popup:

Omogočanje zaobidenja piškotkov tretjih oseb

Stran prilagajanja gradnika z označeno potrditveno polje Omogoči pojavno okno piškotkov tretjih oseb

Brisanje komentarjev z odgovori

Privzeto lahko uporabniki izbrišejo svoje komentarje. Prav tako brisanje njihovega komentarja samodejno izbriše vse podkomentare in prehodne komentarje v nitki. To vedenje je tudi aktivno.

To lahko omejite na naslednje načine:

Namesto tega anonimizirajte izbrisan komentar (nastavite ime in besedilo na [deleted] ali na poljubno vrednost).
Ne dovolite brisanja komentarjev, ko so odgovori. Prikaže se prilagodljivo sporočilo o napaki.
Omejite brisanje, ko ima komentar odgovore, le na skrbnike in moderatorje.

To lahko konfigurirate prek razdelka Comment Thread Deletion v uporabniškem vmesniku prilagajanja gradnika.

Prilagodite vedenje brisanja za odgovore

Možnosti brisanja niti komentarjev v uporabniškem vmesniku prilagajanja gradnika za anonimiziranje ali omejevanje brisanj z odgovori

Prikaži značke v zgornji vrstici

Privzeto bo FastComments prikazal uporabniške značke le na njihovih komentarjih znotraj niza komentarjev.

Vendar lahko uporabniške značke prikažemo poleg njihovega imena nad obrazcem za komentar tako, da omogočimo to funkcijo na strani za prilagajanje gradnika:

Možnost prikaza značk v zgornji vrstici

Potrdno polje za prikaz značk v zgornji vrstici na strani za prilagajanje gradnika, ki postavi značke poleg imena nad obrazcem za komentar

To bo prikazalo uporabniške značke poleg njihovega imena v območju zgornje vrstice, kar bo njihove dosežke in status naredilo bolj opazen, ko pišejo komentar.

Upoštevajte, da mora biti ta funkcija omogočena v uporabniškem vmesniku za prilagajanje gradnika, da deluje. Po želji lahko v konfiguraciji kode nastavite zastavico showBadgesInTopBar na false, da jo izberete onemogočite, tudi če je na strežniku vklopljena:

Onemogoči prikaz značk v zgornji vrstici

Copy

Run

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

Prikaži seznam spletnih uporabnikov

Privzeto FastComments ne prikazuje seznama uporabnikov na strani.

Lahko prikažete seznam ljudi, ki trenutno gledajo stran, poleg pripomočka za komentarje. Seznam se v živo posodablja, ko se uporabniki pridružijo ali odidejo, in prikazuje njihovo ime, avatar ter indikator, da so online.

Obstajajo tri možnosti postavitve:

1 - Zgoraj: vodoravna vrstica prekrivajočih se avatarjev, prikazana nad komentarji.
2 - Levo: stranska vrstica z imeni in točkami, ki označujejo online stanje, prikazana levo od pripomočka.
3 - Desno: ista stranska vrstica, prikazana desno od pripomočka.

Nastavite zastavico usersListLocation, da omogočite funkcijo:

Prikaži seznam uporabnikov na desni

Copy

Run

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

Privzeto seznam prikazuje le uporabnike, ki so trenutno online. Če želite vključiti tudi ljudi, ki so v preteklosti komentirali stran (a je trenutno ne gledajo), nastavite usersListIncludeOffline na true:

Vključi pretekle komentatorje

Copy

Run

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

Pretekli komentatorji so prikazani brez zelenega online pika, da je jasno, kdo je trenutno prisoten.

Uporabniki z zasebnimi profili so prikazani z generičnim avatarjem in oznako "Zasebni profil", tako da je število natančno, ne da bi razkrili identitete.

To lahko nastavite tudi brez kode. Na strani za prilagajanje pripomočka poiščite možnost "Lokacija seznama uporabnikov". Ko je lokacija nastavljena na karkoli drugega kot Izklopljeno, se pod njo prikaže potrditveno polje "Vključi pretekle komentatorje".

Nastavitve seznama uporabnikov

Lokacija seznama uporabnikov nastavljena na desno, s potrditvenim poljem za vključitev preteklih komentatorjev, prikazanim pod njo

Pri več kot 500 živih uporabnikih je seznam lahko zakasnel do 30 sekund.

Prejšnji vodnik Naslednji vodnik

Jezik 🇸🇮 Slovenščina

Osnove

Videz in občutek

Živo komentiranje

Paginacija in razvrščanje

Polje za odgovor

SSO

Anonimno komentiranje

Razno

Prilagoditve in konfiguracija