Comment Count Widgets | FastComments Docs

FastComments dostarcza lekkie, samodzielne widżety licznika komentarzy, które mogą wyświetlać liczbę komentarzy dla konkretnych stron lub wpisów. Te widżety są oddzielone od głównego widżetu komentowania i zostały zaprojektowane do użycia wszędzie tam, gdzie chcesz pokazać liczbę komentarzy bez pełnego interfejsu komentarzy.

There are two types of comment count widgets available:

Comment Count Widget - Do wyświetlania liczby komentarzy dla pojedynczej strony
Bulk Comment Count Widget - Do efektywnego wyświetlania liczby komentarzy dla wielu stron na tej samej stronie

This article covers the VanillaJS widgets. Our React/Angular/etc libraries also have their own widgets.

Widget Liczenia Komentarzy jest zaprojektowany do wyswietlania liczby komentarzy pojedynczej strony. Jest lekki i zapewnia aktualizacje w czasie rzeczywistym, jesli jest skonfigurowany.

Podstawowa Instalacja

Comment Count Widget Installation

Copy

Run

<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
<div id="comment-count"></div>
<script>
    window.FastCommentsCommentCount(document.getElementById('comment-count'), {
        tenantId: 'demo'
    });
</script>

Opcje Konfiguracji

Funkcja FastCommentsCommentCount akceptuje nastepujace opcje konfiguracji:

tenantId (wymagane): Twoj identyfikator najemcy FastComments
urlId (opcjonalne): Identyfikator strony. Domyslnie window.location.href, jesli nie okreslono
numberOnly (opcjonalne): Jesli true, wyswietla tylko liczbe bez tekstu. Domyslnie false
isLive (opcjonalne): Jesli true, liczba bedzie aktualizowana automatycznie. Domyslnie false

Zaawansowane Przyklady

Niestandardowy URL ID

Comment Count with Custom URL ID

Copy

Run

<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
<div id="comment-count-custom"></div>
<script>
    window.FastCommentsCommentCount(document.getElementById('comment-count-custom'), {
        tenantId: 'demo',
        urlId: 'my-custom-page-id'
    });
</script>

Wyswietlanie Tylko Liczby

Comment Count Number Only

Copy

Run

<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
<div id="comment-count-number"></div>
<script>
    window.FastCommentsCommentCount(document.getElementById('comment-count-number'), {
        tenantId: 'demo',
        numberOnly: true
    });
</script>

Aktualizacje na Zywo

Live Comment Count Updates

Copy

Run

<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
<div id="comment-count-live"></div>
<script>
    window.FastCommentsCommentCount(document.getElementById('comment-count-live'), {
        tenantId: 'demo',
        isLive: true
    });
</script>

Metody Widgetu

Widget zwraca obiekt z nastepujacymi metodami:

destroy(): Usuwa widget i czysci wszystkie timery
update(config): Aktualizuje widget z nowa konfiguracja

Przyklad Uzycia

Widget Methods Example

Copy

Run

<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
<div id="comment-count-methods"></div>
<script>
    const widget = window.FastCommentsCommentCount(document.getElementById('comment-count-methods'), {
        tenantId: 'demo'
    });
    // Update the widget to show a different page's count
    setTimeout(() => {
        widget.update({
            tenantId: 'demo',
            urlId: 'different-page-id'
        });
    }, 5000);
    // Destroy the widget after 10 seconds
    setTimeout(() => {
        widget.destroy();
    }, 10000);
</script>

Stylowanie

Widget renderuje zwykly HTML z liczba komentarzy i przychodzi z minimalnym stylowaniem. Mozesz dostosowac wyglad za pomoca CSS:

Custom Styling

Copy

Run

<style>
    .comment-count-styled {
        background: #f0f0f0;
        padding: 5px 10px;
        border-radius: 15px;
        font-size: 14px;
        color: #666;
        display: inline-block;
    }
</style>
<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
<div id="comment-count-styled" class="comment-count-styled"></div>
<script>
    window.FastCommentsCommentCount(document.getElementById('comment-count-styled'), {
        tenantId: 'demo'
    });
</script>

Widget Masowego Liczenia Komentarzy jest zaprojektowany do wydajnego wyswietlania liczby komentarzy dla wielu stron na tej samej stronie. Zamiast wykonywac indywidualne wywolania API dla kazdej liczby komentarzy, ten widget laczy zadania dla optymalnej wydajnosci.

Podstawowa Instalacja

Bulk Comment Count Widget Installation

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-widget-comment-count-bulk.min.js"></script>
<!-- Multiple elements with comment counts -->
<div class="fast-comments-count" data-fast-comments-url-id="page-1"></div>
<div class="fast-comments-count" data-fast-comments-url-id="page-2"></div>
<div class="fast-comments-count" data-fast-comments-url-id="page-3"></div>
<script>
    window.FastCommentsBulkCountConfig = {
        tenantId: 'demo'
    };
</script>

Jak To Dziala

Widget masowy dziala poprzez:

Skanowanie strony w poszukiwaniu elementow z klasa fast-comments-count
Odczytywanie atrybutu data-fast-comments-url-id z kazdego elementu
Laczenie zadan API w celu wydajnego pobierania wielu liczb komentarzy
Aktualizowanie kazdego elementu odpowiednia liczba komentarzy

Opcje Konfiguracji

Funkcja FastCommentsCommentCountBulk akceptuje nastepujace opcje konfiguracji:

tenantId (wymagane): Twoj identyfikator najemcy FastComments
apiHost (opcjonalne): Niestandardowy host API, jesli uzywasz instancji samodzielnie hostowanej

Przyklad z Rzeczywistego Swiata

Oto praktyczny przyklad pokazujacy, jak mozesz uzyc widgetu masowego w liscie wpisow na blogu:

Blog Post Listing with Comment Counts

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-widget-comment-count-bulk.min.js"></script>
<style>
    .blog-post {
        border: 1px solid #ddd;
        margin: 10px 0;
        padding: 15px;
        border-radius: 5px;
    }
    .post-meta {
        color: #666;
        font-size: 14px;
        margin-top: 10px;
    }
    .comment-count {
        background: #e7f3ff;
        padding: 2px 8px;
        border-radius: 12px;
        font-size: 12px;
        display: inline-block;
    }
</style>
<div class="blog-post">
    <h3>How to Install FastComments</h3>
    <p>Learn how to add FastComments to your website in just a few minutes...</p>
    <div class="post-meta">
        Published: March 15, 2024 |
        <span class="fast-comments-count comment-count" data-fast-comments-url-id="how-to-install-fastcomments"></span>
    </div>
</div>
<div class="blog-post">
    <h3>Advanced FastComments Configuration</h3>
    <p>Dive deep into the advanced configuration options for FastComments...</p>
    <div class="post-meta">
        Published: March 10, 2024 |
        <span class="fast-comments-count comment-count" data-fast-comments-url-id="advanced-fastcomments-config"></span>
    </div>
</div>
<div class="blog-post">
    <h3>FastComments vs Other Solutions</h3>
    <p>See how FastComments compares to other commenting solutions...</p>
    <div class="post-meta">
        Published: March 5, 2024 |
        <span class="fast-comments-count comment-count" data-fast-comments-url-id="fastcomments-comparison"></span>
    </div>
</div>
<script>
    window.FastCommentsBulkCountConfig = {
        tenantId: 'demo'
    };
</script>

Kwestie Wydajnosci

Widget masowy automatycznie optymalizuje wydajnosc poprzez:

Laczenie zadan: Wiele liczb komentarzy jest pobieranych w jednym wywolaniu API
Limity rozmiaru zadan: Zadania sa automatycznie dzielone, jesli lista URL staje sie zbyt dluga (ponad 1000 znakow)
Deduplikacja: Wiele elementow z tym samym data-fast-comments-url-id uzywa tej samej liczby

Wiele Elementow z Tym Samym URL ID

Mozesz miec wiele elementow na stronie z tym samym data-fast-comments-url-id. Wszystkie zostana zaktualizowane ta sama liczba:

Multiple Elements Same URL ID

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-widget-comment-count-bulk.min.js"></script>
<style>
    .count-example {
        margin: 10px 0;
        padding: 10px;
        background: #f9f9f9;
        border-radius: 5px;
    }
</style>
<div class="count-example">
    Header Count: <span class="fast-comments-count" data-fast-comments-url-id="shared-article"></span>
</div>
<div class="count-example">
    Sidebar Count: <span class="fast-comments-count" data-fast-comments-url-id="shared-article"></span>
</div>
<div class="count-example">
    Footer Count: <span class="fast-comments-count" data-fast-comments-url-id="shared-article"></span>
</div>
<script>
    window.FastCommentsBulkCountConfig = {
        tenantId: 'demo'
    };
</script>

Lokalizacja

Widget masowy automatycznie formatuje liczby komentarzy na podstawie ustawien jezyka FastComments. Zapewnia odpowiedni tekst dla:

Zero komentarzy
Jeden komentarz
Wiele komentarzy

Kiedy Uzywac Widgetu Masowego vs Pojedynczego

Uzyj widgetu masowego gdy:

Masz wiele liczb komentarzy na tej samej stronie
Wyswietlasz liste wpisow/artykulow z liczbami komentarzy
Wydajnosc jest wazna (zmniejsza wywolania API)

Uzyj widgetu pojedynczego gdy:

Potrzebujesz tylko jednej liczby komentarzy na stronie
Potrzebujesz aktualizacji na zywo (widget pojedynczy obsluguje aktualizacje w czasie rzeczywistym)
Chcesz wiecej kontroli nad zachowaniem pojedynczego widgetu

API licznika komentarzy

Istnieje kilka punktow koncowych do uzyskania liczb, w zaleznosci od tego, czego potrzebujesz i czy chcesz je pobrac z przegladarki, serwera lub uzywajac SDK API.

Publiczne liczby komentarzy

Mozesz uzyskac publiczne liczby komentarzy uzywajac powyzszych widgetow lub uzywajac API, ktore one wykorzystuja. Te API pozostaja niezmienione od 2019 roku i nigdy sie nie zmienia.

Single Count Endpoint

Copy

https://fastcomments.com/widgets/comment-count/:tenantId?urlId=page_id_or_url

To zwroci strukture jak:

Single Count Endpoint Response

Copy

{"count":0,"postfix":"comments"}

Wlasciwosc postfix jest zawsze dolaczona.

Bulk Count Endpoint

Copy

https://fastcomments.com/widgets/comment-count-bulk/:tenantId?urlIds=x,y,z

To zwroci strukture jak:

Bulk Count Endpoint Response

Copy

{
    "status": "success",
    "translations": {
        "t174": "0 Comments",
        "t175": "1 Comment",
        "t176": "[count] Comments"
    },
    "counts": {
        "x": 10
    }
}

Obiekt counts jest wypelniany tylko dla stron, ktore maja liczby. Mapa translations jest zawsze obecna, poniewaz jest uzywana przez widget.

Zachowanie publicznych punktow koncowych / Buforowanie

Publiczne punkty koncowe maja 60-sekundowy mechanizm buforowania do obslugi skokow ruchu. Wewnetrznie jest to pamiec podreczna LRU na watek w pamieci serwera, wiec mozesz zobaczyc, ze liczby nieznacznie sie zmieniaja (rosna, a potem tymczasowo spadaja), gdy ludzie zostawiaja wiele komentarzy.

Publiczne punkty koncowe zawsze zwracaja calkowita liczbe komentarzy, a nie liczbe komentarzy glownych.

API po stronie serwera / SDK

Sposobem na uzyskanie komentarzy z serwera jest wywolanie Pages API i pobranie obiektu strony, ktory zawiera calkowita liczbe komentarzy i liczbe komentarzy glownych. Dostarczamy SDK, ktore pozwalaja wywolac to API bez recznego konstruowania zadania API i zapewniaja typowane wartosci zwracane.

Widgety liczników komentarzy FastComments zapewniają prosty i wydajny sposób wyświetlania liczby komentarzy na całej Twojej witrynie.

Mamy nadzieję, że ta dokumentacja okazała się pomocna.

Instalacja

API licznika komentarzy

Instalacja widżetu licznika komentarzy

Podstawowa Instalacja

Opcje Konfiguracji

Zaawansowane Przyklady

Niestandardowy URL ID

Wyswietlanie Tylko Liczby

Aktualizacje na Zywo

Metody Widgetu

Przyklad Uzycia

Stylowanie

Masowa instalacja widżetów licznika komentarzy

Podstawowa Instalacja

Jak To Dziala

Opcje Konfiguracji

Przyklad z Rzeczywistego Swiata

Kwestie Wydajnosci

Wiele Elementow z Tym Samym URL ID

Lokalizacja

Kiedy Uzywac Widgetu Masowego vs Pojedynczego

API licznika komentarzy

Publiczne liczby komentarzy

Zachowanie publicznych punktow koncowych / Buforowanie

API po stronie serwera / SDK

Język 🇵🇱 Polski

Instalacja

API licznika komentarzy

Instalacja widżetu licznika komentarzy

Podstawowa Instalacja

Opcje Konfiguracji

Zaawansowane Przyklady

Niestandardowy URL ID

Wyswietlanie Tylko Liczby

Aktualizacje na Zywo

Metody Widgetu

Przyklad Uzycia

Stylowanie

Masowa instalacja widżetów licznika komentarzy

Podstawowa Instalacja

Jak To Dziala

Opcje Konfiguracji

Przyklad z Rzeczywistego Swiata

Kwestie Wydajnosci

Wiele Elementow z Tym Samym URL ID

Lokalizacja

Kiedy Uzywac Widgetu Masowego vs Pojedynczego

API licznika komentarzy

Publiczne liczby komentarzy

Zachowanie publicznych punktow koncowych / Buforowanie

API po stronie serwera / SDK