Le Widget de Comptage de Commentaires est concu pour afficher le nombre de commentaires d'une seule page. Il est leger et fournit des mises a jour en temps reel si configure.

Installation de Base

Comment Count Widget Installation

Copy Run

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

Options de Configuration

La fonction FastCommentsCommentCount accepte les options de configuration suivantes:

• tenantId (requis): Votre ID de tenant FastComments
• urlId (optionnel): L'identifiant de la page. Par defaut window.location.href si non specifie
• numberOnly (optionnel): Si true, affiche uniquement le nombre sans texte. Par defaut false
• isLive (optionnel): Si true, le comptage sera mis a jour automatiquement. Par defaut false

Exemples Avances

URL ID Personnalise

Comment Count with Custom URL ID

Copy Run

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

Affichage du Nombre Seul

Comment Count Number Only

Copy Run

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

Mises a Jour en Direct

Live Comment Count Updates

Copy Run

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

Methodes du Widget

Le widget retourne un objet avec les methodes suivantes:

• destroy(): Supprime le widget et nettoie tous les minuteurs
• update(config): Met a jour le widget avec une nouvelle configuration

Exemple d'Utilisation

Widget Methods Example

Copy Run

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

Style

Le widget genere du HTML simple avec le nombre de commentaires et vient avec un style minimal. Vous pouvez personnaliser l'apparence avec CSS:

Custom Styling

Copy Run

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

Le Widget de Comptage de Commentaires en Masse est concu pour afficher efficacement le nombre de commentaires pour plusieurs pages sur la meme page. Au lieu de faire des appels API individuels pour chaque comptage de commentaires, ce widget regroupe les requetes pour une performance optimale.

Installation de Base

Bulk Comment Count Widget Installation

Copy Run

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

Comment ca Fonctionne

Le widget en masse fonctionne en:

1. Scannant la page pour les elements avec la classe fast-comments-count
2. Lisant l'attribut data-fast-comments-url-id de chaque element
3. Regroupant les requetes API pour recuperer efficacement plusieurs comptages de commentaires
4. Mettant a jour chaque element avec le comptage de commentaires approprie

Options de Configuration

La fonction FastCommentsCommentCountBulk accepte les options de configuration suivantes:

• tenantId (requis): Votre ID de tenant FastComments
• apiHost (optionnel): Hote API personnalise si vous utilisez une instance auto-hebergee

Exemple Concret

Voici un exemple pratique montrant comment vous pourriez utiliser le widget en masse dans une liste d'articles de blog:

Blog Post Listing with Comment Counts

Copy Run

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

Considerations de Performance

Le widget en masse optimise automatiquement la performance par:

• Regroupement des requetes: Plusieurs comptages de commentaires sont recuperes en un seul appel API
• Limites de taille des requetes: Les requetes sont automatiquement divisees si la liste d'URLs devient trop grande (plus de 1 000 caracteres)
• Deduplication: Plusieurs elements avec le meme data-fast-comments-url-id partagent le meme comptage

Plusieurs Elements avec le Meme URL ID

Vous pouvez avoir plusieurs elements sur la page avec le meme data-fast-comments-url-id. Ils seront tous mis a jour avec le meme comptage:

Multiple Elements Same URL ID

Copy Run

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

Localisation

Le widget en masse formate automatiquement les comptages de commentaires selon vos parametres de langue FastComments. Il fournit un texte approprie pour:

• Zero commentaires
• Un commentaire
• Plusieurs commentaires

Quand Utiliser le Widget en Masse vs le Widget Individuel

Utilisez le Widget en Masse quand:

• Vous avez plusieurs comptages de commentaires sur la meme page
• Vous affichez une liste d'articles/publications avec des comptages de commentaires
• La performance est importante (reduit les appels API)

Utilisez le Widget Individuel quand:

• Vous n'avez besoin que d'un seul comptage de commentaires sur la page
• Vous avez besoin de mises a jour en direct (le widget individuel prend en charge les mises a jour en temps reel)
• Vous voulez plus de controle sur le comportement individuel du widget