Adicionar comentários a sites do Shopify

Instalar pela Shopify App Store

1. Abra a listagem do FastComments na Shopify App Store.
2. Clique em Adicionar app e escolha o plano que você deseja durante o fluxo de instalação.
3. O Shopify redireciona você de volta para o admin do FastComments dentro do Shopify quando a instalação for concluída.

Isso conclui a instalação. Não há nada para colar nos arquivos do seu tema.

O que é configurado para você

A instalação executa tudo o que você faria manualmente:

• Um tenant do FastComments é criado para sua loja e vinculado ao domínio da sua loja.
• A URL da sua loja é adicionada aos domínios autorizados do tenant, para que os comentários carreguem sem erro de domínio.
• Um metafield de loja fastcomments.tenant_id é escrito para que cada bloco saiba contra qual tenant renderizar.
• O login único (single sign-on) para seus clientes da Shopify é ativado por padrão.
• A cobrança é feita pelo Shopify Managed Pricing. As cobranças aparecem na sua fatura regular do Shopify. Faça upgrade, downgrade ou cancele em Settings > Apps and sales channels > FastComments no admin do Shopify.

Se sua loja já era cliente do FastComments antes de você instalar o app, a instalação reutiliza o tenant existente em vez de criar um novo.

O painel administrativo incorporado

Ao abrir o app FastComments a partir do seu admin do Shopify, você chega a um painel com blocos de um clique que levam ao backend completo do FastComments:

• Painel: configurações da conta, uso e detalhes da assinatura.
• Fila de moderação: aprovar, rejeitar e responder comentários em toda a sua loja.
• Personalizar: ajustar cores do widget, fontes, regras de moderação e configuração.
• Ratings & Reviews Helper: configurar avaliações por estrelas e perguntas de review se desejar usar o bloco Reviews Summary.

Cada bloco abre o FastComments com um link de login de uso único, portanto você não precisa de um login separado.

Próximo: adicione blocos à sua loja

Abra o editor de temas do Shopify (Online Store > Themes > Customize), abra o template ao qual você quer adicionar comentários ou avaliações, e clique em Adicionar bloco. Os blocos do FastComments aparecem em Apps. O restante deste guia aborda cada um deles.

O bloco FastComments é o widget principal de comentários. Adicione-o aos templates de post de blog, templates de produto ou qualquer outra página onde você queira um tópico de discussão ou um chat ao vivo.

Add the block

1. Open the Shopify theme editor (Online Store > Themes > Customize).
2. Pick the template you want comments on: Blog post, Product, or any other page or section template.
3. In the section where you want comments to appear, click Add block.
4. Under Apps, select FastComments.
5. Click Save.

The block appears immediately. There is no Tenant ID to enter; your store's tenant is wired up automatically when you install the app.

Settings

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.

The FastComments - Comment Count block renders a small comment count for a single page. Use it in blog post lists, product cards, or any template that links to a page with comments, so visitors can see how active each thread is before clicking through.

Add the block

1. Abra o editor de temas do Shopify.
2. Abra o template onde você quer que a contagem apareça. Por exemplo, o template Blog (a lista de posts) ou uma seção de listagem de produtos.
3. Clique em Adicionar bloco na seção que renderiza cada item.
4. Em Apps, selecione FastComments - Comment Count.
5. Clique em Salvar.

Settings

How the count matches the comment thread

The Comment Count block uses the same auto-detection logic as the FastComments block:

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

If you set a Custom URL ID on the FastComments block on a page, set the same Custom URL ID on the Comment Count block so they point at the same thread.

Tips

• Counts for every item on the page are fetched in one request, so adding the block to every item in a long list has no extra round-trip cost.
• One Comment Count block per article or product in a listing is the expected usage; the block can be added as many times as you need.

A FastComments - Recent Comments block mostra os comentários mais recentes de toda a sua loja. Use-o para mostrar atividade recente em uma barra lateral, rodapé ou seção da página inicial.

Add the block

1. Abra o editor de temas do Shopify.
2. Abra o template onde você quer o feed. Uma seção da barra lateral, a página inicial ou o índice do blog funcionam bem.
3. Clique em Add block na seção que deve contê-lo.
4. Em Apps, selecione FastComments - Recent Comments.
5. Clique em Save.

Settings

Tips

• Cada comentário faz link para a página onde foi publicado, então o bloco funciona também como uma dica de navegação de “sobre o que as pessoas estão falando agora”.
• O feed abrange toda a loja. Para mostrar comentários recentes de uma única página, use o bloco FastComments nessa página em vez disso.

O bloco FastComments - Discussões Recentes lista as páginas da sua loja com a atividade de comentários mais recente, uma entrada por página. Use-o quando quiser que os visitantes descubram tópicos ativos em vez de comentários individuais.

Adicionar o bloco

1. Abra o editor de temas do Shopify.
2. Abra o template onde você quer o feed, como uma barra lateral, rodapé, índice de blog ou seção da página inicial.
3. Clique em Adicionar bloco na seção que deve contê-lo.
4. Em Apps, selecione FastComments - Discussões Recentes.
5. Clique em Salvar.

Configurações

Discussões Recentes vs Comentários Recentes

Ambos os blocos puxam dos mesmos dados, mas mostram visões diferentes:

• Comentários Recentes: uma lista plana dos comentários individuais mais recentes. Melhor para "o que foi dito agora".
• Discussões Recentes: uma entrada por página, ordenada pela atividade mais recente. Melhor para "quais tópicos estão vivos agora".

Você pode usar os dois na mesma loja. Por exemplo, Comentários Recentes na barra lateral do blog e Discussões Recentes na página inicial.

O bloco FastComments - Top Pages lista as páginas da sua loja com mais atividade de comentários no geral. Use-o para destacar seus posts ou produtos mais comentados.

Add the block

1. Abra o editor de temas do Shopify.
2. Abra o template onde você quer a lista, como uma barra lateral, rodapé ou seção de índice de blog.
3. Clique em Add block na seção que deve contê-la.
4. Em Apps, selecione FastComments - Top Pages.
5. Clique em Save.

Settings

Top Pages vs Recent Discussions

• Top Pages classifica por engajamento total, então os mesmos posts tendem a permanecer perto do topo por um tempo. Bom para uma barra lateral de "posts populares".
• Recent Discussions classifica pela atividade mais recente, então a lista muda constantemente. Bom para um painel de "o que está em alta agora".

O bloco FastComments oferece single sign-on para que seus clientes do Shopify possam comentar como eles mesmos sem criar uma conta separada no FastComments.

Como funciona

Quando um visitante que está logado na sua loja abre uma página com o bloco FastComments:

1. O bloco detecta o objeto Shopify customer.
2. Ele envia o nome e o e-mail do cliente para o FastComments através de uma requisição proxy do aplicativo assinada.
3. O FastComments cria ou associa um usuário identificado por shopify-{customerId}, assim o mesmo cliente sempre corresponde ao mesmo usuário do FastComments entre sessões e reinstalações.
4. O nome do visitante aparece em seus comentários. Eles não precisam fazer login novamente.

Se o visitante não estiver logado na loja, o bloco volta para comentários anônimos (ou para o fluxo de login do FastComments, dependendo da configuração do seu widget).

Desativando o SSO

O SSO está ativado por padrão em cada bloco FastComments. Para desativá-lo em um bloco específico:

1. Abra o editor de tema do Shopify.
2. Abra o template que contém o bloco e clique no bloco para selecioná-lo.
3. Desmarque SSO.
4. Clique em Salvar.

Desative o SSO se você quiser que os comentaristas escolham uma identidade separada para a conversa. Por exemplo, uma página de comunidade interna onde a equipe comenta com um nome de exibição diferente.

O que o FastComments recebe

A carga útil SSO enviada para cada cliente contém:

• Um ID de usuário derivado do ID do cliente do Shopify (shopify-{customerId}).
• O e-mail do cliente (usado para identificar o usuário; não é exibido publicamente).
• O nome de exibição do cliente (usado como nome do autor do comentário).

Nenhum histórico de pedidos, pagamento ou dados de endereço é enviado. A carga útil é assinada no servidor; o navegador do cliente nunca vê uma credencial.

Links de login e logout

Quando o SSO está ativado, os links de entrar e sair do widget de comentários apontam para /account/login e /account/logout, as rotas padrão de conta de cliente do Shopify. Não há nada a configurar. Os links funcionam para qualquer loja com contas de cliente habilitadas.

Cores, fontes, regras de moderação, HTML permitido e comentários anônimos podem ser configurados para combinar com a identidade visual da sua loja.

Abra o aplicativo FastComments no administrador do Shopify e clique no bloco Personalizar para abrir a tela de personalização do widget. Ele usa um link de login de uso único, então você não precisa de um login separado.

Para a lista completa de opções de personalização, veja o Guia de Personalizações e Configuração.