FastComments.com


FastComments zagotavlja lahke, samostojne pripomočke za štetje komentarjev, ki lahko prikažejo število komentarjev za določene strani ali objave. Ti pripomočki so ločeni od glavnega pripomočka za komentiranje in so zasnovani za uporabo kjerkoli, kjer želite prikazati število komentarjev brez celotnega vmesnika za komentiranje.

Na voljo sta dve vrsti pripomočkov za štetje komentarjev:

  1. Pripomoček za štetje komentarjev - Za prikaz števila komentarjev na posamezni strani
  2. Pripomoček za množično štetje komentarjev - Za učinkovito prikazovanje števila komentarjev na več straneh na isti strani

Ta članek pokriva VanillaJS pripomočke. Naše knjižnice za React/Angular/ipd. imajo tudi svoje pripomočke.

Namestitev gradnika za štetje komentarjev Internal Link

Pripomoček za štetje komentarjev je zasnovan za prikaz števila komentarjev posamezne strani. Je lahek in zagotavlja posodobitve v realnem času, če je konfiguriran.

Osnovna namestitev

Comment Count Widget Installation
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
3<div id="comment-count"></div>
4<script>
5 window.FastCommentsCommentCount(document.getElementById('comment-count'), {
6 tenantId: 'demo'
7 });
8</script>
9

Možnosti konfiguracije

Funkcija FastCommentsCommentCount sprejema naslednje možnosti konfiguracije:

  • tenantId (obvezno): Vaš FastComments ID najemnika
  • urlId (neobvezno): Identifikator strani. Privzeto je window.location.href, če ni določeno
  • numberOnly (neobvezno): Če je true, prikaže samo število brez besedila. Privzeto je false
  • isLive (neobvezno): Če je true, se bo število samodejno posodabljalo. Privzeto je false

Napredni primeri

Prilagojen URL ID

Comment Count with Custom URL ID
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
3<div id="comment-count-custom"></div>
4<script>
5 window.FastCommentsCommentCount(document.getElementById('comment-count-custom'), {
6 tenantId: 'demo',
7 urlId: 'my-custom-page-id'
8 });
9</script>
10

Prikaz samo števila

Comment Count Number Only
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
3<div id="comment-count-number"></div>
4<script>
5 window.FastCommentsCommentCount(document.getElementById('comment-count-number'), {
6 tenantId: 'demo',
7 numberOnly: true
8 });
9</script>
10

Posodobitve v živo

Live Comment Count Updates
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
3<div id="comment-count-live"></div>
4<script>
5 window.FastCommentsCommentCount(document.getElementById('comment-count-live'), {
6 tenantId: 'demo',
7 isLive: true
8 });
9</script>
10

Metode pripomočka

Pripomoček vrne objekt z naslednjimi metodami:

  • destroy(): Odstrani pripomoček in počisti vse časovnike
  • update(config): Posodobi pripomoček z novo konfiguracijo

Primer uporabe

Widget Methods Example
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
3<div id="comment-count-methods"></div>
4<script>
5 const widget = window.FastCommentsCommentCount(document.getElementById('comment-count-methods'), {
6 tenantId: 'demo'
7 });
8
9 // Update the widget to show a different page's count
10 setTimeout(() => {
11 widget.update({
12 tenantId: 'demo',
13 urlId: 'different-page-id'
14 });
15 }, 5000);
16
17 // Destroy the widget after 10 seconds
18 setTimeout(() => {
19 widget.destroy();
20 }, 10000);
21</script>
22

Oblikovanje

Pripomoček prikaže navaden HTML s številom komentarjev in ima minimalno oblikovanje. Videz lahko prilagodite s CSS:

Custom Styling
Copy CopyRun External Link
1
2<style>
3 .comment-count-styled {
4 background: #f0f0f0;
5 padding: 5px 10px;
6 border-radius: 15px;
7 font-size: 14px;
8 color: #666;
9 display: inline-block;
10 }
11</style>
12<script src="https://cdn.fastcomments.com/js/widget-comment-count.min.js"></script>
13<div id="comment-count-styled" class="comment-count-styled"></div>
14<script>
15 window.FastCommentsCommentCount(document.getElementById('comment-count-styled'), {
16 tenantId: 'demo'
17 });
18</script>
19

Množična namestitev gradnikov za štetje komentarjev Internal Link

Pripomoček za množično štetje komentarjev je zasnovan za učinkovito prikazovanje števila komentarjev za več strani na isti strani. Namesto posameznih API klicev za vsako število komentarjev, ta pripomoček združuje zahteve za optimalno zmogljivost.

Osnovna namestitev

Bulk Comment Count Widget Installation
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/embed-widget-comment-count-bulk.min.js"></script>
3
4<!-- Multiple elements with comment counts -->
5<div class="fast-comments-count" data-fast-comments-url-id="page-1"></div>
6<div class="fast-comments-count" data-fast-comments-url-id="page-2"></div>
7<div class="fast-comments-count" data-fast-comments-url-id="page-3"></div>
8
9<script>
10 window.FastCommentsBulkCountConfig = {
11 tenantId: 'demo'
12 };
13</script>
14

Kako deluje

Množični pripomoček deluje tako, da:

  1. Pregleda stran za elemente z razredom fast-comments-count
  2. Prebere atribut data-fast-comments-url-id iz vsakega elementa
  3. Združi API zahteve za učinkovito pridobivanje več števil komentarjev
  4. Posodobi vsak element z ustreznim številom komentarjev

Možnosti konfiguracije

Funkcija FastCommentsCommentCountBulk sprejema naslednje možnosti konfiguracije:

  • tenantId (obvezno): Vaš FastComments ID najemnika
  • apiHost (neobvezno): Prilagojen API gostitelj, če uporabljate lastno gostovano instanco

Primer iz resničnega sveta

Tukaj je praktičen primer, ki prikazuje, kako lahko uporabite množični pripomoček v seznamu objav na blogu:

Blog Post Listing with Comment Counts
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/embed-widget-comment-count-bulk.min.js"></script>
3
4<style>
5 .blog-post {
6 border: 1px solid #ddd;
7 margin: 10px 0;
8 padding: 15px;
9 border-radius: 5px;
10 }
11 .post-meta {
12 color: #666;
13 font-size: 14px;
14 margin-top: 10px;
15 }
16 .comment-count {
17 background: #e7f3ff;
18 padding: 2px 8px;
19 border-radius: 12px;
20 font-size: 12px;
21 display: inline-block;
22 }
23</style>
24
25<div class="blog-post">
26 <h3>How to Install FastComments</h3>
27 <p>Learn how to add FastComments to your website in just a few minutes...</p>
28 <div class="post-meta">
29 Published: March 15, 2024 |
30 <span class="fast-comments-count comment-count" data-fast-comments-url-id="how-to-install-fastcomments"></span>
31 </div>
32</div>
33
34<div class="blog-post">
35 <h3>Advanced FastComments Configuration</h3>
36 <p>Dive deep into the advanced configuration options for FastComments...</p>
37 <div class="post-meta">
38 Published: March 10, 2024 |
39 <span class="fast-comments-count comment-count" data-fast-comments-url-id="advanced-fastcomments-config"></span>
40 </div>
41</div>
42
43<div class="blog-post">
44 <h3>FastComments vs Other Solutions</h3>
45 <p>See how FastComments compares to other commenting solutions...</p>
46 <div class="post-meta">
47 Published: March 5, 2024 |
48 <span class="fast-comments-count comment-count" data-fast-comments-url-id="fastcomments-comparison"></span>
49 </div>
50</div>
51
52<script>
53 window.FastCommentsBulkCountConfig = {
54 tenantId: 'demo'
55 };
56</script>
57

Premisleki o zmogljivosti

Množični pripomoček samodejno optimizira zmogljivost z:

  • Združevanjem zahtev: Več števil komentarjev se pridobi z enim samim API klicem
  • Omejitvami velikosti zahtev: Zahteve se samodejno razdelijo, če seznam URL-jev postane predolg (več kot 1.000 znakov)
  • Deduplikacijo: Več elementov z istim data-fast-comments-url-id si deli isto število

Več elementov z istim URL ID

Na strani lahko imate več elementov z istim data-fast-comments-url-id. Vsi bodo posodobljeni z istim številom:

Multiple Elements Same URL ID
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/embed-widget-comment-count-bulk.min.js"></script>
3
4<style>
5 .count-example {
6 margin: 10px 0;
7 padding: 10px;
8 background: #f9f9f9;
9 border-radius: 5px;
10 }
11</style>
12
13<div class="count-example">
14 Header Count: <span class="fast-comments-count" data-fast-comments-url-id="shared-article"></span>
15</div>
16
17<div class="count-example">
18 Sidebar Count: <span class="fast-comments-count" data-fast-comments-url-id="shared-article"></span>
19</div>
20
21<div class="count-example">
22 Footer Count: <span class="fast-comments-count" data-fast-comments-url-id="shared-article"></span>
23</div>
24
25<script>
26 window.FastCommentsBulkCountConfig = {
27 tenantId: 'demo'
28 };
29</script>
30

Lokalizacija

Množični pripomoček samodejno oblikuje števila komentarjev glede na vaše jezikovne nastavitve FastComments. Zagotavlja ustrezno besedilo za:

  • Nič komentarjev
  • En komentar
  • Več komentarjev

Kdaj uporabiti množični ali posamični pripomoček

Uporabite množični pripomoček, ko:

  • Imate več števil komentarjev na isti strani
  • Prikazujete seznam objav/člankov s števili komentarjev
  • Je zmogljivost pomembna (zmanjšuje API klice)

Uporabite posamični pripomoček, ko:

  • Potrebujete le eno število komentarjev na strani
  • Potrebujete posodobitve v živo (posamični pripomoček podpira posodobitve v realnem času)
  • Želite več nadzora nad vedenjem posameznega pripomočka

Vtičniki za štetje komentarjev FastComments zagotavljajo preprost in učinkovit način za prikaz števila komentarjev na vašem spletnem mestu.

Upamo, da vam je bila ta dokumentacija v pomoč.