FastComments.com

Ajouter des commentaires aux sites Shopify

FastComments est disponible sur le Shopify App Store. Installez l'application et ajoutez des blocs FastComments à n'importe quel article de blogue, page produit ou page personnalisée depuis l'éditeur de thème Shopify. Aucune modification de code requise.

Lorsque vous installez l'application, Shopify provisionne votre compte FastComments, relie le domaine de votre boutique et configure la facturation automatiquement. Vous n'avez pas besoin de vous inscrire séparément sur fastcomments.com.

Les pages de ce guide expliquent chaque bloc FastComments fourni par l'application, le fonctionnement de l'authentification unique (single sign-on) pour vos clients Shopify, et comment importer les commentaires Shopify existants avant la migration.

Installer l'application FastComments Internal Link

Installer depuis la boutique d'applications Shopify

  1. Ouvrez la fiche FastComments sur la boutique d'applications Shopify.
  2. Cliquez sur Add app et choisissez le forfait que vous souhaitez pendant le flux d'installation.
  3. Shopify vous redirige vers l'administration FastComments intégrée à Shopify lorsque l'installation est terminée.

C'est toute l'installation. Il n'y a rien à coller dans les fichiers de votre thème.

Ce qui est configuré pour vous

L'installation exécute tout ce que vous feriez autrement manuellement :

  • Un tenant FastComments est créé pour votre boutique et lié à votre domaine de boutique.
  • L'URL de la boutique est ajoutée aux domaines autorisés du tenant, afin que les commentaires se chargent sans erreur de domaine.
  • Un metafield de boutique fastcomments.tenant_id est écrit afin que chaque bloc sache contre quel tenant s'afficher.
  • L'authentification unique pour vos clients Shopify est activée par défaut.
  • La facturation passe par Shopify Managed Pricing. Les frais apparaissent sur votre facture Shopify habituelle. Mettez à niveau, rétrogradez ou annulez depuis Paramètres > Applications et canaux de vente > FastComments dans votre administration Shopify.

Si votre boutique était déjà cliente de FastComments avant que vous n'installiez l'application, l'installation réutilise le tenant existant au lieu d'en créer un nouveau.

L'interface d'administration intégrée

Lorsque vous ouvrez l'application FastComments depuis votre administration Shopify, vous arrivez sur un tableau de bord avec des vignettes d'un clic vers l'interface complète de FastComments :

  • Dashboard : paramètres de compte, utilisation et détails de l'abonnement.
  • Moderation Queue : approuver, rejeter et répondre aux commentaires dans toute votre boutique.
  • Customize : ajuster les couleurs du widget, polices, règles de modération et configuration.
  • Ratings & Reviews Helper : configurer les évaluations par étoiles et les questions d'avis si vous souhaitez utiliser le bloc Reviews Summary.

Chaque tuile ouvre FastComments avec un lien de connexion à usage unique, vous n'avez donc pas besoin d'une connexion séparée.

Suivant : ajoutez des blocs à votre boutique

Ouvrez l'éditeur de thème Shopify (Boutique en ligne > Thèmes > Personnaliser), ouvrez le gabarit sur lequel vous souhaitez ajouter des commentaires ou des avis, et cliquez sur Add block. Les blocs FastComments apparaissent sous Applications. Le reste de ce guide couvre chacun d'entre eux.

Ajouter des commentaires aux articles de blog et aux produits Internal Link

Le bloc FastComments est le widget principal de commentaires. Ajoutez-le aux modèles d'articles de blog, aux modèles de produit ou à toute autre page où vous souhaitez un fil de discussion ou un clavardage en direct.

Add the block

  1. Ouvrez l'éditeur de thème Shopify (Online Store > Themes > Customize).
  2. Choisissez le modèle sur lequel vous voulez des commentaires : Blog post, Product, ou tout autre modèle de page ou de section.
  3. Dans la section où vous voulez que les commentaires apparaissent, cliquez sur Add block.
  4. Sous Apps, sélectionnez FastComments.
  5. Cliquez sur Save.

Le bloc apparaît immédiatement. Il n'y a pas de Tenant ID à entrer ; le tenant de votre boutique est configuré automatiquement lors de l'installation de l'application.

Settings

SettingWhat it doesDefault
Tenant ID (optional)Override which FastComments tenant the block renders against. Leave blank to use the store's automatically-configured tenant. Find a manual tenant ID at fastcomments.com/auth/my-account/api-secret.(blank)
SSOAuto-logs the visitor in as their Shopify customer account before commenting. See Auto-Login Shopify Customers.On
Commenting StyleThreaded for nested replies and votes, or Streaming for a real-time chat feed.Threaded
Custom URL IDOverride the auto-detected page identifier. Use this when you want two URLs to share one comment thread.(auto-detected)

How the page identifier is chosen

Each comment thread is keyed by a URL ID. The block picks one automatically:

  • Blog post template: shopify-article-{article.id}, which is stable across slug and title changes.
  • Product template: shopify-product-{product.id}, which is stable across slug and title changes.
  • Other templates: the request path.

If you set Custom URL ID, that value is used instead. Use the same Custom URL ID across multiple blocks (for example, on a localized variant of a product page) to share one comment thread.

Threaded vs Streaming

Threaded is the default. Visitors reply to each other, vote, and moderation tools work as expected. Best for blog posts and product reviews.

Streaming drops the threading and shows new comments in real time as they're posted, like a chat feed. Best for product launches, live events, and community pages.

Multiple blocks on the same page

The block can be added more than once to the same template. For example, a Reviews Summary at the top of a product page and a FastComments block at the bottom. The blocks share a URL ID, so the summary reflects the comments below.

Tips

  • The block hides itself in the theme editor preview with a yellow notice if it can't find a tenant. If that appears in your live store, reinstall the FastComments app.
  • For a product page, the FastComments block doubles as your product reviews widget. Pair it with FastComments - Reviews Summary for a star-rating summary at the top of the page.

Ajouter un badge affichant le nombre de commentaires Internal Link

Le bloc FastComments - Comment Count affiche un petit compteur de commentaires pour une seule page. Utilisez-le dans les listes d’articles de blog, les cartes de produits ou tout modèle qui contient un lien vers une page avec des commentaires, afin que les visiteurs puissent voir à quel point chaque fil est actif avant de cliquer.

Add the block

  1. Ouvrez l’éditeur de thème Shopify.
  2. Ouvrez le modèle où vous souhaitez que le compteur apparaisse. Par exemple, le modèle Blog (la liste d’articles) ou une section de liste de produits.
  3. Cliquez sur Add block dans la section qui affiche chaque élément.
  4. Sous Apps, sélectionnez FastComments - Comment Count.
  5. Cliquez sur Save.

Settings

SettingWhat it doesDefault
Tenant ID (optional)Remplace le tenant FastComments à partir duquel le compteur lit les données. Laissez vide pour utiliser le tenant automatiquement configuré pour la boutique.(vide)
Custom URL IDRemplace l’identifiant de page que le compteur recherche. Utilisez ceci lorsque le compteur se trouve sur une page différente du bloc FastComments qu’il suit.(détecté automatiquement)

How the count matches the comment thread

Le bloc Comment Count utilise la même logique de détection automatique que le bloc FastComments :

  • Blog post template: shopify-article-{article.id}
  • Product template: shopify-product-{product.id}
  • Other templates: the request path

Si vous définissez un Custom URL ID sur le bloc FastComments d’une page, définissez le même Custom URL ID sur le bloc Comment Count afin qu’ils pointent vers le même fil.

Tips

  • Les compteurs pour chaque élément de la page sont récupérés en une seule requête, donc ajouter le bloc à chaque élément d’une longue liste n’entraîne pas de coût de tour supplémentaire.
  • Un bloc Comment Count par article ou produit dans une liste est l’utilisation prévue ; le bloc peut être ajouté autant de fois que nécessaire.

Ajouter un flux de commentaires récents Internal Link

Le bloc FastComments - Recent Comments affiche les commentaires les plus récents de l'ensemble de votre boutique. Utilisez-le pour montrer une activité récente dans une barre latérale, le pied de page ou une section de la page d'accueil.

Ajouter le bloc

  1. Ouvrez l'éditeur de thème Shopify.
  2. Ouvrez le gabarit où vous souhaitez afficher le fil. Une section de barre latérale, la page d'accueil ou l'index du blogue conviennent bien.
  3. Cliquez sur Ajouter un bloc dans la section qui doit le contenir.
  4. Sous Applications, sélectionnez FastComments - Recent Comments.
  5. Cliquez sur Enregistrer.

Paramètres

ParamètreFonctionValeur par défaut
Tenant ID (optionnel)Remplace le tenant FastComments à partir duquel le fil est lu. Laissez vide pour utiliser le tenant automatiquement configuré de la boutique.(vide)
Nombre de commentairesNombre de commentaires récents à afficher. Plage : 1 à 50.5

Conseils

  • Chaque commentaire renvoie à la page où il a été publié, donc le bloc sert aussi d'indice de navigation « ce dont les gens parlent en ce moment ».
  • Le fil couvre l'ensemble de la boutique. Pour afficher les commentaires récents d'une seule page, utilisez plutôt le bloc FastComments sur cette page.

Ajouter un flux de discussions récentes Internal Link

Le bloc FastComments - Recent Discussions répertorie les pages de votre boutique ayant l'activité de commentaires la plus récente, une entrée par page. Utilisez-le quand vous voulez que les visiteurs découvrent des fils de discussion actifs plutôt que des commentaires individuels.

Add the block

  1. Ouvrez l'éditeur de thème Shopify.
  2. Ouvrez le modèle où vous voulez le flux, comme une barre latérale, le pied de page, l'index du blogue ou une section de la page d'accueil.
  3. Cliquez sur Add block dans la section qui doit le contenir.
  4. Sous Apps, sélectionnez FastComments - Recent Discussions.
  5. Cliquez sur Save.

Settings

SettingWhat it doesDefault
ID du locataire (facultatif)Remplace le locataire FastComments dont le flux lit les données. Laissez vide pour utiliser le locataire configuré automatiquement pour la boutique.(vide)
Nombre de commentairesCombien de discussions récentes à afficher. Plage de 1 à 50.20

Recent Discussions vs Recent Comments

Both blocks pull from the same data, but they show different views:

  • Recent Comments: a flat list of the latest individual comments. Best for "what was just said".
  • Recent Discussions: one entry per page, ordered by most recent activity. Best for "which threads are alive right now".

You can use both on the same store. For example, Recent Comments in the blog sidebar and Recent Discussions on the home page.

Ajouter une liste des pages populaires Internal Link

Le bloc FastComments - Top Pages répertorie les pages de votre boutique qui ont la plus forte activité de commentaires en général. Utilisez-le pour mettre en avant vos publications ou produits les plus discutés.

Ajouter le bloc

  1. Ouvrez l'éditeur de thème Shopify.
  2. Ouvrez le modèle où vous voulez la liste, comme une barre latérale, le pied de page ou la section d'index du blog.
  3. Cliquez sur Ajouter un bloc dans la section qui doit le contenir.
  4. Sous Applications, sélectionnez FastComments - Top Pages.
  5. Cliquez sur Enregistrer.

Paramètres

ParamètreCe que ça faitValeur par défaut
Tenant ID (optional)Remplace le tenant FastComments à partir duquel la liste est lue. Laissez vide pour utiliser le tenant automatiquement configuré pour la boutique.(vide)

Top Pages vs Recent Discussions

  • Top Pages classe selon l'engagement total, donc les mêmes publications ont tendance à rester en haut pendant un certain temps. Idéal pour une barre latérale "articles populaires".
  • Recent Discussions classe selon l'activité la plus récente, donc la liste change souvent. Idéal pour un panneau "ce qui est populaire en ce moment".

Connexion automatique des clients Shopify Internal Link

Le FastComments block prend en charge l'authentification unique (SSO) afin que vos clients Shopify puissent commenter en leur nom sans créer de compte FastComments distinct.

Comment ça fonctionne

When a visitor who is logged into your store opens a page with the FastComments block:

  1. The block detects the Shopify customer object.
  2. It sends the customer's name and email to FastComments through a signed app proxy request.
  3. FastComments creates or matches a user keyed by shopify-{customerId}, so the same customer always maps to the same FastComments user across sessions and re-installs.
  4. The visitor's name shows up on their comments. They are not prompted to log in again.

If the visitor is not logged into the store, the block falls back to anonymous commenting (or the FastComments sign-in flow, depending on your widget configuration).

Désactiver SSO

SSO is on by default for every FastComments block. To turn it off on a specific block:

  1. Open the Shopify theme editor.
  2. Open the template that contains the block and click the block to select it.
  3. Uncheck SSO.
  4. Click Save.

Désactivez SSO si vous voulez que les commentateurs choisissent une identité distincte pour la conversation. Par exemple, une page communautaire interne où le personnel commente sous un autre nom d'affichage.

Ce que FastComments reçoit

The SSO payload sent for each customer contains:

  • A user ID derived from the Shopify customer ID (shopify-{customerId}).
  • The customer's email (used to identify the user; not displayed publicly).
  • The customer's display name (used as their comment author name).

No order history, payment, or address data is sent. The payload is signed server-side; the customer's browser never sees a credential.

Liens de connexion et de déconnexion

When SSO is on, the comment widget's sign-in and sign-out links point at /account/login and /account/logout, the standard Shopify customer account routes. There is nothing to configure. The links work for any store with customer accounts enabled.

Personnalisation Internal Link

Les couleurs, les polices, les règles de modération, le HTML autorisé et les commentaires anonymes sont tous configurables pour correspondre à l'image de marque de votre boutique.

Ouvrez l'application FastComments dans l'interface d'administration Shopify et cliquez sur la vignette Personnaliser pour ouvrir l'écran de personnalisation du widget. Elle utilise un lien de connexion à usage unique, donc vous n'avez pas besoin d'une connexion séparée.

Pour la liste complète des options de personnalisation, consultez le Guide de personnalisation et de configuration.