Ajouter des commentaires aux sites Shopify

Install from the Shopify App Store

1. Open the FastComments listing on the Shopify App Store.
2. Click Add app and pick the plan you want during the install flow.
3. Shopify redirects you back into the FastComments admin inside Shopify when the install completes.

That's the full install. There is nothing to paste into your theme files.

What gets set up for you

The install runs everything you would otherwise do by hand:

• A FastComments tenant is created for your store and linked to your shop domain.
• Your shop's store URL is added to the tenant's authorized domains, so comments load without a domain error.
• A fastcomments.tenant_id shop metafield is written so every block knows which tenant to render against.
• Single sign-on for your Shopify customers is enabled by default.
• Billing runs through Shopify Managed Pricing. Charges appear on your regular Shopify bill. Upgrade, downgrade, or cancel from Settings > Apps and sales channels > FastComments in your Shopify admin.

If your shop was already a FastComments customer before you installed the app, the install reuses the existing tenant instead of creating a new one.

The embedded admin

When you open the FastComments app from your Shopify admin, you land on a dashboard with one-click tiles into the full FastComments backend:

• Dashboard: account settings, usage, and subscription details.
• Moderation Queue: approve, reject, and reply to comments across your store.
• Customize: adjust widget colors, fonts, moderation rules, and configuration.
• Ratings & Reviews Helper: set up star ratings and review questions if you want to use the Reviews Summary block.

Each tile opens FastComments with a single-use login link, so you don't need a separate sign-in.

Next: add blocks to your store

Open your Shopify theme editor (Online Store > Themes > Customize), open the template you want to add commenting or reviews to, and click Add block. The FastComments blocks appear under Apps. The rest of this guide covers each one.

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

Ajouter le bloc

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 souhaitez 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 à saisir ; le tenant de votre boutique est configuré automatiquement lors de l'installation de l'application.

Paramètres

Comment l'identifiant de page est choisi

Chaque fil de commentaires est indexé par un URL ID. Le bloc en sélectionne un automatiquement :

• 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.

Si vous définissez Custom URL ID, cette valeur est utilisée à la place. Utilisez le même Custom URL ID sur plusieurs blocs (par exemple, sur une variante localisée d'une page produit) pour partager un même fil de commentaires.

Threaded vs Streaming

Threaded est le mode par défaut. Les visiteurs se répondent entre eux, votent, et les outils de modération fonctionnent comme prévu. Idéal pour les articles de blog et les avis produits.

Streaming supprime l'imbrication et affiche les nouveaux commentaires en temps réel au fur et à mesure de leur publication, comme un flux de chat. Idéal pour les lancements de produits, les événements en direct et les pages communautaires.

Plusieurs blocs sur la même page

Le bloc peut être ajouté plusieurs fois au même modèle. Par exemple, un résumé des avis en haut d'une page produit et un bloc FastComments en bas. Les blocs partagent un URL ID, donc le résumé reflète les commentaires ci-dessous.

Astuces

• Le bloc se cache dans l'aperçu de l'éditeur de thème avec un avis jaune s'il ne trouve pas de tenant. Si cela apparaît dans votre boutique en production, réinstallez l'application FastComments.
• Pour une page produit, le bloc FastComments fait aussi office de widget d'avis produit. Associez-le à FastComments - Reviews Summary pour un résumé par étoiles en haut de la page.

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 fiches produit, ou tout modèle qui renvoie à une page avec des commentaires, afin que les visiteurs puissent voir l'activité de chaque fil avant de cliquer.

Add the block

1. Ouvrez l'éditeur de thème Shopify.
2. Ouvrez le template où vous souhaitez que le compteur apparaisse. Par exemple, le Blog template (la liste d'articles) ou une section de listing produit.
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

How the count matches the comment thread

Le bloc Comment Count utilise la même logique d'auto-détection 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 tous les éléments 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 supplémentaire en allers-retours.
• Un bloc Comment Count par article ou produit dans une liste est l'utilisation attendue ; le bloc peut être ajouté autant de fois que nécessaire.

Le FastComments - Recent Comments block affiche les commentaires les plus récents dans 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 voulez le flux. Une section de barre latérale, la page d’accueil ou l’index du blog 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

Conseils

• Chaque commentaire contient un lien vers la page sur laquelle il a été posté, donc le bloc sert aussi d’indication de navigation "ce dont les gens parlent en ce moment".
• Le flux couvre toute la boutique. Pour afficher les commentaires récents d’une seule page, utilisez plutôt le bloc FastComments sur cette page.

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 lorsque vous voulez que les visiteurs découvrent des fils de discussion actifs plutôt que des commentaires individuels.

Ajouter le bloc

1. Ouvrez l'éditeur de thème Shopify.
2. Ouvrez le modèle où vous souhaitez afficher le flux, par exemple une barre latérale, le pied de page, l'index du blog ou une section de la page d'accueil.
3. Cliquez sur Ajouter un bloc dans la section qui doit le contenir.
4. Sous Applications, sélectionnez FastComments - Recent Discussions.
5. Cliquez sur Enregistrer.

Paramètres

Recent Discussions vs Recent Comments

Les deux blocs tirent des mêmes données, mais affichent des vues différentes :

• Recent Comments : une liste plate des derniers commentaires individuels. Idéal pour « ce qui vient d'être dit ».
• Recent Discussions : une entrée par page, ordonnée par activité la plus récente. Idéal pour « quels fils sont actifs en ce moment ».

Vous pouvez utiliser les deux sur la même boutique. Par exemple, Recent Comments dans la barre latérale du blog et Recent Discussions sur la page d'accueil.

Le bloc FastComments - Top Pages affiche les pages de votre boutique ayant le plus d'activité de commentaires au global. Utilisez-le pour mettre en avant vos articles ou produits les plus commentés.

Ajouter le bloc

1. Ouvrez l’éditeur de thème Shopify.
2. Ouvrez le modèle où vous voulez la liste, par exemple 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

Top Pages vs Recent Discussions

• Top Pages classe par 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 par activité la plus récente, donc la liste se renouvelle rapidement. Idéal pour un panneau "ce qui est populaire en ce moment".

Le bloc FastComments prend en charge l'authentification unique (SSO) afin que vos clients Shopify puissent commenter en leur nom sans créer un compte FastComments séparé.

Comment cela fonctionne

Lorsque un visiteur connecté à votre boutique ouvre une page contenant le bloc FastComments :

1. Le bloc détecte l'objet Shopify customer.
2. Il envoie le nom et l'email du client à FastComments via une requête d'app proxy signée.
3. FastComments crée ou associe un utilisateur identifié par shopify-{customerId}, de sorte que le même client corresponde toujours au même utilisateur FastComments entre les sessions et les réinstallations.
4. Le nom du visiteur apparaît sur ses commentaires. Il n'est pas invité à se connecter de nouveau.

Si le visiteur n'est pas connecté à la boutique, le bloc revient au commentaire anonyme (ou au flux de connexion FastComments, selon la configuration de votre widget).

Désactiver le SSO

Le SSO est activé par défaut pour chaque bloc FastComments. Pour le désactiver sur un bloc spécifique :

1. Ouvrez l'éditeur de thème Shopify.
2. Ouvrez le modèle qui contient le bloc et cliquez sur le bloc pour le sélectionner.
3. Décochez SSO.
4. Cliquez sur Enregistrer.

Désactivez le SSO si vous souhaitez 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

La charge utile SSO envoyée pour chaque client contient :

• Un identifiant d'utilisateur dérivé de l'ID client Shopify (shopify-{customerId}).
• L'email du client (utilisé pour identifier l'utilisateur ; non affiché publiquement).
• Le nom d'affichage du client (utilisé comme nom d'auteur de son commentaire).

Aucun historique de commandes, donnée de paiement ou adresse n'est envoyé. La charge utile est signée côté serveur ; le navigateur du client ne voit jamais de justificatif d'identité.

Liens de connexion et de déconnexion

Lorsque le SSO est activé, les liens de connexion et de déconnexion du widget de commentaires pointent vers /account/login et /account/logout, les routes standard de compte client Shopify. Il n'y a rien à configurer. Les liens fonctionnent pour toute boutique ayant les comptes clients activés.

Les couleurs, les polices, les règles de modération, le HTML autorisé et les commentaires anonymes peuvent tous être configurés pour correspondre à l'identité visuelle de votre boutique.

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

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