Você pode notar que o widget de comentários pode ser usado com um Tenant ID de "demo", por exemplo:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

Isto serve apenas para experimentar e brincar com o widget de comentários. Em produção, você passaria seu Tenant ID, assim:

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

Seu Tenant ID já pode ser encontrado aplicado no widget de comentários snippet de código na sua conta.

Você também pode encontrar seu Tenant ID e gerenciar suas chaves de API na página de credenciais da API.

A partir deste ponto, se você estiver logado no FastComments, os exemplos de código usarão seu Tenant ID real (se você estiver logado em https://fastcomments.com).

Ao renderizar um tópico de comentários, ou ao deixar um comentário, o FastComments precisa saber a que página, artigo ou produto esses comentários pertencem.

Para isso, usamos algo que chamamos de "URL ID". É ou um identificador, como uma string ou um número, ou uma URL.

Por padrão, se você não especificar o urlId, ele se tornará a URL da página. Nós pegaremos a URL atual da página e a limparemos para remover quaisquer parâmetros comuns de marketing ou identificadores de rastreamento.

No caso de integrações de terceiros, como WordPress, nosso plugin geralmente usará o identificador que representa a informação atual sendo visualizada como o URL ID, por exemplo o id do artigo/página.

Defining a Custom URL ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

Uma coisa que frequentemente mencionaremos neste documento é a Widget Customization UI.

Essa interface pode ser usada para fazer muitas alterações no widget de comentários sem usar código.

Ao criar uma regra de personalização, frequentemente queremos que ela se aplique a todas as páginas do nosso site. No entanto, em alguns casos queremos personalizar o widget de comentários em uma página específica, seja para aplicar estilos personalizados, ou talvez tornar os comentários daquela página anônimos. Você também poderia, por exemplo, fazer com que comentários ao vivo apareçam imediatamente em algumas páginas, enquanto em outras fiquem ocultos sob botões de notificação.

Tudo isso é possível através do campo de entrada URL ID nesta página, que se parece com o seguinte:

URL ID Input in The Widget Customization Page

O valor neste campo deve corresponder ao parâmetro urlId passado para o widget de comentários. Se você quiser que sua regra de personalização seja agnóstica ao urlId, deixe este campo vazio ou insira *.

A partir de 2023 o campo URL ID na customização do widget também aceita padrões! Por exemplo você pode usar */blog/* para adicionar estilos específicos ao seu blog e */store/* para ter estilos específicos para sua loja, tudo isso usando o mesmo domínio.

Observações

1. Se sua página tem parâmetros de hash (como example.com#page-1) - isso se tornará parte do URL ID por padrão.
2. Durante migrações, por exemplo de WordPress para Gatsby, você pode ter que migrar os valores de comentário do URL ID após a migração inicial. Para isso, entre em contato conosco.

FastComments foi projetado para ser customizado. O próprio widget de comentários roda dentro de um iframe por razões de segurança, então para aplicar estilos personalizados você precisa seguir uma de duas abordagens.

A primeira, a mais fácil, e a preferida por nós, é usar a página de personalização do widget.

Na página de personalização do widget, veja a seção "Show Advanced Options", sob a qual há uma área rotulada "Custom CSS":

Custom CSS Input Area

Esta abordagem tem alguns benefícios:

1. O CSS inserido é minificado antes de ser enviado ao usuário, e a formatação é mantida consistente na interface de edição.
2. Você obtém todos os benefícios da interface de personalização do widget, por exemplo personalizar facilmente o widget de comentários de forma diferente para sites diferentes.
3. Quando fazemos alterações no widget de comentários, seu estilo customizado será testado como parte do nosso processo de liberação.

A segunda abordagem é especificar o parâmetro customCSS na configuração do widget, como segue:

Passing Custom CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

No entanto, isso tem limitações:

1. Há um limite de quanto CSS personalizado pode ser enviado antes que nossos servidores rejeitem a requisição, devido ao tamanho dos cabeçalhos.
2. Você deve gerenciar o CSS personalizado na sua infraestrutura e sistema de build. Isso pode ser uma vantagem em vez de uma desvantagem, também.
3. Há um overhead adicional de enviar o CSS personalizado pela rede duas vezes neste caso de uso, já que ele precisa ser enviado aos nossos servidores e então enviado de volta no conteúdo do iframe. Contudo, para a maioria dos tamanhos de payload, isso não é perceptível.
4. Uma otimização comum é minificar o CSS para reduzir seu tamanho na rede, porém com esta abordagem você terá que lidar com isso.
5. Seu CSS customizado não será testado quando fizermos alterações.

External CSS Files

Você pode instruir o widget a buscar um arquivo externo usando @import!

É recomendado colocar o @import em uma regra de customização. Desta forma, se algum dia precisarmos fazer uma alteração no widget de comentários, podemos usar nossas ferramentas de automação para verificar sua configuração. Então, por exemplo, você criaria uma regra de customização na UI de Personalização do Widget, clicaria em Advanced, e entraria em Custom CSS:

@import url(https://example.com/styles.css);

In Code - Not Recommended

Você também pode carregar um arquivo CSS externo via a propriedade customCSS:

External CSS File

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

No entanto, lembre-se que seu CSS não poderá ser testado por nós se você fizer isso.

User Profile Modal Styling

Os modais de perfil do usuário também podem ser estilizados com CSS customizado. Porém, para garantir que o estilo personalizado seja aplicado aos perfis de usuário, todos os seletores CSS devem ser prefixados com .user-profile. Sem esse prefixo, o estilo personalizado será ignorado para os modais de perfil do usuário.

Por exemplo:

User Profile CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Backwards Compatibility

Na FastComments, sabemos que nossos clientes personalizam o widget de comentários. Isso é intencional — a última coisa que queremos é que nosso produto cause inconsistências de design no seu produto.

Como esta é uma parte importante do nosso produto, temos um pipeline de build que nos permite revisar alterações no widget de comentários, por cliente, a cada release.

Se encontrarmos problemas menores, atualizaremos sua conta para garantir que nossa liberação aconteça sem problemas. Se virmos mudanças significativas que quebrem, isso nos permite interromper a liberação.

Para clientes com contas Pro ou Enterprise, a personalização de marca (white-label) é permitida. Basta entrar em contato conosco e ficaremos felizes em ajudar.

Se você apenas quiser remover nosso logo do widget de comentários, isso é habilitado automaticamente nos planos Flex e Pro.

Esses planos também oferecem a mesma funcionalidade para e-mails enviados pela nossa plataforma.

Para sites que permitem alternar o modo escuro após o carregamento inicial da página, isso é um pouco mais complexo.

Primeiro, todas as versões atuais da biblioteca do widget de Comentários (React, Vue) têm exemplos de alternância do modo escuro em seus respectivos repositórios.

Para o widget VanillaJS, precisaremos fazer um trabalho extra. Primeiro, o FastCommentsUI retorna um objeto com as funções "destroy" e "update".

Podemos simplesmente chamar a função update toda vez que quisermos atualizar a configuração do widget de comentários, como a seguir. Aqui está um exemplo completo funcionando de alternância do modo escuro com o widget VanillaJS.

Exemplo Completo de Alternância do Modo Escuro

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

Com o FastComments, todo o texto no widget de comentários é personalizável.

Você pode substituir uma única parte do texto, como o botão de envio, ou todo o texto em todo o widget de comentários.

Por padrão, o texto no widget de comentários é traduzido com base na localidade do usuário. No entanto, podemos substituir o texto se estivermos confiantes de que nossa base de usuários está usando a mesma localidade/idioma, por exemplo:

Custom Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Todas as traduções personalizáveis podem ser encontradas aqui na aba "opções avançadas".

No entanto, há uma maneira mais fácil, via a interface de personalização do widget. Lá, podemos simplesmente encontrar o texto que aparece no widget de comentários na localidade EN_US e especificar uma substituição.

Custom Text

Todas as substituições de tradução afetam atualmente todas as localidades.

Quando um usuário comenta no FastComments pela primeira vez, tentaremos buscar o avatar dele em http://gravatar.com/.

No entanto, se não encontrarmos um avatar, ou se o usuário nunca definir um em sua conta, exibimos uma imagem estática de avatar padrão.

Para especificar sua própria imagem de avatar estática, podemos usar a configuração defaultAvatarSrc.

Substituir o Avatar Padrão

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a seção "Avatar Padrão".

Personalizando o Avatar Padrão

Observe que definir o avatar para um usuário específico, por exemplo com SSO, é abordado em sua própria seção.

Avatares podem ser completamente removidos do widget de comentários, mesmo se os usuários tiverem definido seu próprio avatar.

Hiding Avatars

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget:

Hiding Avatars

Para projetos maiores de estilização personalizada, pode ser desejável começar do zero e não usar o estilo padrão.

Todo o estilo padrão pode ser removido definindo o parâmetro noStyles como true, da seguinte forma:

Disabling All Default Styles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget, em Opções Avançadas:

Disabling All Default Styles

Por padrão, as respostas aos comentários de nível superior são exibidas.

Isso pode ser configurado para que o usuário precise clicar em "Mostrar respostas" nos comentários de nível superior para ver os comentários filhos.

Collapse Replies to Top Level Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget:

Collapse Replies

Essa configuração não afetará o número de comentários de nível superior carregados inicialmente. Se você tiver um comentário de nível superior e 29 comentários filhos, com essa configuração ativada você irá:

• Ver o comentário de nível superior.
• Ver 'Mostrar respostas (29)' abaixo deste comentário.

Se você desejar exibir todos os comentários de nível superior em combinação com esta opção, defina a página inicial para -1.

Por padrão, as funcionalidades de formatação no FastComments são feitas adicionando tags visíveis como <b></b> ao redor do seu texto. Clicar na barra de ferramentas ou usar atalhos faz isso por você. No entanto, algumas comunidades podem querer optar por usar formatação sem tags visíveis. Isso é chamado de habilitar o editor WYSIWYG (o que você vê é o que você obtém). Este editor parece exatamente igual ao padrão, exceto que carrega um código extra que permite aos usuários colocar em negrito, sublinhar, etc., o texto deles sem tags visíveis.

Enabling WYSIWYG Editing

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a opção "Ativar Formatação Avançada".

Enable WYSIWYG

Por padrão, o FastComments exibirá uma barra de ferramentas ao escrever um comentário para fornecer atalhos para formatar o texto e enviar imagens.

Esta barra de ferramentas pode ser desativada no código ou pela interface de personalização.

Disabling The Toolbar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a opção "Desativar a barra de ferramentas de resposta".

Disabling The Toolbar

Por padrão, o FastComments permite que usuários bloqueiem outros usuários. Bloquear um usuário fará com que seus comentários sejam mascarados, impedirá notificações entre os usuários e assim por diante.

Pode ser desejável desativar essa funcionalidade. Isso pode ser feito da seguinte forma:

Disable Blocking

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

Isso também pode ser feito sem código, o que também habilita a validação adequada no lado do servidor, pela Interface de Personalização do Widget:

Disable Blocking

Por padrão, são usadas datas relativas localizadas. Por exemplo, ao lado de um comentário deixado recentemente você pode ver "há 11 minutos".

Pode ser necessário ou desejável usar datas absolutas, caso em que você define este parâmetro como true.

Use Absolute Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

Isto pode ser personalizado sem código, na página de personalização do widget, em Opções Avançadas:

Use Absolute Dates

Por padrão, são usadas datas relativas localizadas. Por exemplo, ao lado de um comentário deixado recentemente você pode ver "há 11 minutos".

Pode ser necessário ou desejável manter esse formato de data relativa, mas também exibir a data completa ao lado dele, caso em que você define este parâmetro como true.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

Isso pode ser customizado sem código, na página de personalização do widget, em Opções Avançadas. Primeiro você terá que ativar Absolute Dates para ver esta opção na UI.

Use Both Absolute and Relative Dates

Algum texto, como um cabeçalho ou mensagem, pode ser exibido abaixo da contagem de comentários, mas acima do texto de status de login.

Chamamos isso de cabeçalho, e por padrão ele está oculto.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Isto pode ser personalizado sem código, na página de personalização do widget, em Opções Avançadas:

Specifying Header HTML

Por padrão, o FastComments renderizará links assim: https://exmaple.com - onde a URL do link se torna uma tag âncora HTML clicável.

Alguns sites podem querer desativar isso, por exemplo para desencorajar golpistas. Fornecemos isso definindo a Comment HTML Rendering Option para Links as Text.

Isto pode ser personalizado sem código, na página de personalização do widget, para todo um domínio, ou página:

Render Links as Text

Por padrão, o FastComments renderiza a caixa de entrada de comentários e o thread de comentários ao mesmo tempo. Para economizar um pouco de espaço vertical, ele também ocultará quaisquer outros campos obrigatórios até que haja interação com o widget.

No entanto, o widget de comentários pode ser ocultado atrás de um botão, por exemplo:

Click to Show Comments

O botão usa textos traduzidos diferentes dependendo se os comentários estão atualmente mostrados ou não. Se os comentários estiverem ocultos, ele usa translations.SHOW_COMMENTS_BUTTON_TEXT. Se os comentários estiverem mostrados, ele usa translations.HIDE_COMMENTS_BUTTON_TEXT. As traduções podem conter o texto [count] que será substituído pela contagem localizada.

Click to Show or Hide Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

Isto foi projetado para substituir a configuração hideCommentsUnderCountTextFormat.

A contagem é atualizada ao vivo com o thread de comentários. O botão não é exibido se não houver comentários.

Isto pode ser ativado sem código criando uma regra de personalização e habilitando "Click to Show Comments":

Enable Click to Show Comments

A contagem de comentários exibida no topo do widget de comentários pode ser personalizada.

Isso pode ser substituído por qualquer string, e o valor [count] será substituído pelo valor da contagem, localizado para o usuário.

Customizing The Comment Count Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget:

Customizing The Comment Count Text

Quando os usuários inserem hashtags, na forma #someexampletag, o FastComments criará automaticamente essa HashTag e a destacará em seu comentário.

Em alguns casos, pode ser desejável desativar esse recurso ou controlar quais hashtags podem ser usadas pela API.

Para isso, basta ativar Disable Automatic #hashtag Creation através da interface de Personalização do Widget.

Disabling Automatic HashTag Creation

Por padrão, o FastComments exibirá um sino de notificações no canto superior direito da área de comentários.

Esse sino ficará vermelho e mostrará uma contagem do número de notificações que o usuário possui. Alguns exemplos de notificações são:

• Um usuário respondeu para você.
• Um usuário respondeu em um tópico no qual você comentou.
• Um usuário votou positivamente no seu comentário.
• Um usuário respondeu em uma página à qual você está inscrito.

O sino de notificações também fornece um mecanismo para se inscrever em uma página inteira.

No entanto, podemos desativar o sino de notificações inteiramente:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a seção "Desativar sino de notificações".

Disable Notification Bell

Por padrão, o FastComments exibirá o perfil do usuário quando você clicar no avatar dele.

No entanto, podemos desativar essa funcionalidade:

Disable Profiles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a seção "Desativar Perfis".

Disable Profiles

Por padrão, o FastComments exibirá uma mensagem de sucesso após o envio de um comentário. Isso pode ser desativado da seguinte forma:

Disable Success Message

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget:

Disable Success Message

Por padrão, o widget de comentários FastComments definirá um gif rating de pg.

As opções disponíveis são g, pg, pg-13 e r.

Isso pode ser configurado no código ou via a UI. No código, podemos fazê-lo da seguinte forma:

Set Gif Rating

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

Na UI, você encontrará isso em Gif Picker Rating, desde que Disable Image Uploads? não esteja marcado.

Setting The Gif Rating

Por padrão, o widget de comentários do FastComments tem a moderação de conteúdo de imagens definida como off.

As opções disponíveis são off, low, medium e high.

Na interface de personalização do widget, você encontrará isso em Image Content Moderation Level, desde que Disable Image Uploads? não esteja marcado.

Setting The Image Content Moderation Level

Por padrão, o FastComments exibirá opções de votação como setas para cima e para baixo, permitindo que os usuários votem a favor ou contra um comentário.

No entanto, é possível alterar o estilo da barra de votação. As opções atuais são os botões padrão Up/Down, ou utilizar um mecanismo de votação no estilo Coração.

Usamos a flag voteStyle da seguinte forma:

Enable Heart Button

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

Recomendamos fortemente que você faça isso sem código, pois também habilita validações no lado do servidor. Na página de personalização do widget, veja a seção "Estilo de Votação".

Change Voting Style

A votação também pode ser desativada, veja Disable Voting acima das opções de estilo.

Por padrão, o FastComments permite que os usuários excluam seus comentários.

No entanto, é possível impedir isso.

Na página de personalização do widget, veja a opção "Desativar exclusão".

Disable Comment Deleting

• Isso afeta apenas Comentadores regulares e não moderadores ou administradores, que ainda poderão excluir.
• Isso também afetará integrações de API quando contextUserId for passado.

Por padrão, o FastComments permitirá que os usuários editem seus comentários.

No entanto, é possível impedir isso.

Na página de personalização do widget, veja a opção "Desativar edição".

Disable Comment Editing

• Isso afeta apenas comentaristas regulares e não moderadores ou administradores, que ainda poderão editar.
• Isso também afetará integrações da API quando contextUserId for passado.

Por padrão, o tamanho da página do FastComments é 30. Isso inclui respostas em threads.

O tamanho da página pode ser personalizado na Interface de Configuração do Widget em tamanhos que variam de 10 a 200.

Observe que alterar o tamanho da página requer recalcular todos os threads de comentários na sua conta. Isso pode levar alguns minutos.

Isso não pode ser configurado no widget do lado do cliente, pois as páginas são calculadas no servidor.

Exemplo de configuração mostrado abaixo:

Custom Page Sizes

Os tamanhos de página podem ser personalizados globalmente, por domínio ou por página, criando regras de personalização diferentes.

Isso afetará todos os clientes, integrações e frameworks que você possa estar usando para exibir comentários através da nossa plataforma.

Por padrão, FastComments exibirá o nome do usuário como ele o inseriu, ou como foi nos fornecido via SSO.

No entanto, pode ser desejável mascarar ou exibir o nome do usuário de uma forma diferente. Por exemplo, se o nome do usuário for Allen Rex, talvez você queira mostrar apenas "Allen R.".

Isso pode ser feito sem código na Interface de Personalização do Widget, na configuração chamada Commenter Name Format:

Change Name Format

The available formats are:

• Capitalize (exibe example user como Example User)
• Last Initial (exibe Example User como Example U.)
• All Initials (exibe Example User como E. U.)
• Show "Anonymous"

O efeito dessa alteração é imediato. Os usuários ainda verão seu nome de usuário completo no topo da área de comentários, para si mesmos, mas seus comentários exibirão o nome de usuário modificado.

Os nomes de usuário são mascarados no servidor para proteger os usuários.

Por padrão, o FastComments permite uploads de imagens. Isso pode ser desativado definindo a flag noImageUploads como true.

Disabling Image Uploads

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

Isto pode ser personalizado sem código, na página de personalização do widget:

Disabling Image Uploads

Por padrão, não há caixa de pesquisa exibida no widget de comentários.

No entanto, podemos ativar isso definindo a flag enableSearch como true:

Enabling Search

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a opção "Enable Search Box".

Enable Search Box

Podemos ativar o suporte a spoilers definindo a flag enableSpoilers como true:

Enabling Spoilers

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a opção "Enable Spoilers".

Enable Spoilers

Quando o texto for destacado e o botão SPOILER, agora visível, for clicado, o texto será mascarado até que o usuário passe o mouse sobre ele. No modo escuro fazemos a mesma coisa, com cores diferentes que combinam melhor com o modo escuro.

Isso também é compatível com o editor WYSIWYG.

Por padrão, o FastComments não rastreia quem visualizou cada comentário nem fornece estatísticas sobre isso.

No entanto, podemos ativar esse recurso, e então o sistema começará a rastrear quando cada usuário rolar até um comentário.

Quando isso acontecer, uma contagem ao lado de um ícone de olho exibido em cada comentário será incrementada. A contagem é atualizada ao vivo e abreviada de acordo com a localidade do usuário.

Podemos ativar isso definindo a flag enableViewCounts como true:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

Isto pode ser customizado sem código, na página de personalização do widget:

Enabling Comment View Counts

Rastreamos o id do usuário* que visualizou o comentário, para que, se você visualizar o comentário novamente, ele não seja incrementado. Se você visualizar o comentário novamente após dois anos, a contagem será incrementada novamente.

• *Nota: ou o id de sessão anônima, ou o IP do usuário como um valor hash.

Por padrão, os comentários ao vivo estão habilitados. Isso significa que se quaisquer comentários forem adicionados, excluídos, editados ou fixados, as alterações devem aparecer para todos os usuários visualizando o fio de comentários ao mesmo tempo.

No entanto, por padrão esses novos comentários aparecerão sob um botão exibido dinamicamente com um texto similar a "Mostrar 2 novos comentários".

Se os novos comentários forem respostas diretamente à página, o botão será exibido na parte superior do fio de comentários. Se forem respostas a um comentário em particular, o botão será exibido sob esse comentário.

Isso é para evitar que o tamanho da página mude constantemente para o usuário, potencialmente causando frustração ao tentar pegar a barra de rolagem.

Para alguns casos de uso, como leilões ao vivo ou eventos online, esse não é o comportamento desejado - você pode querer que o widget de comentários seja mais como uma "caixa de chat" onde os novos comentários "apareçam imediatamente".

Daí o nome da flag que habilita esse recurso: showLiveRightAway.

Podemos ativá-la da seguinte forma:

Show Live Comments Right Away

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget:

Show Live Comments Right Away

Por padrão, o FastComments terá comentários em tempo real ativados.

Isso significa que todo visualizador do tópico de comentários deve ver o mesmo conteúdo.

Por exemplo, se um comentário for adicionado, esse comentário deverá aparecer. Se um comentário for editado ou removido, então esses comentários serão editados ou removidos para todos os visualizadores do tópico. O mesmo vale para votos e todas as ações de moderação.

No entanto, podemos desativar isso:

Disable Live Commenting

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a seção "Desativar comentários em tempo real".

Disable Live Commenting

Por padrão, o FastComments ordenará os comentários pela direção de ordenação "Most Relevant".

A ordenação "Most Relevant" leva em conta o horário em que o comentário foi deixado e o número de votos para fins de ordenação.

O usuário pode então alterar a direção de ordenação para "Antigos primeiro" ou "Novos primeiro" na interface do widget de comentários.

No entanto, podemos alterar o padrão para qualquer um dos três. Por exemplo, se você quiser mostrar os comentários mais antigos primeiro:

Changing The Default Sort To Oldest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

Definimos o valor de defaultSortDirection para "OF" para definir a direção para "OF".

Para a direção de ordenação "Novos primeiro", faríamos o seguinte:

Changing The Default Sort To Newest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

Os valores válidos para defaultSortDirection são:

• MR: "Mais recentes"
• NF: "Novos primeiro"
• OF: "Antigos primeiro"

Isso também pode ser feito sem código. Na página de customização do widget, veja a seção "Direção de ordenação padrão".

Changing The Default Sort Direction

Observe que os comentários em cada página para cada direção de ordenação são pré-computados, portanto todas as direções de ordenação têm o mesmo desempenho.

Por padrão a área de entrada de comentários fica antes do encadeamento de comentários. No entanto, ao definir este parâmetro de configuração para true podemos movê-la para depois.

Moving The Reply Box to The Bottom

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget:

Moving The Reply Box to The Bottom

O número máximo de caracteres permitidos no campo de entrada de comentário pode ser limitado pelo parâmetro maxCommentCharacterLength.

O padrão é 2000.

Itens como URLs de imagens não são incluídos no cálculo do comprimento.

Limit Comment Length

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget:

Limit Comment Length

Por padrão, o FastComments permitirá que o usuário insira um comentário com quantas linhas desejar, até o limite de caracteres padrão.

No entanto, pode ser desejável limitar o usuário a inserir apenas uma única linha de texto. Alguns casos de uso incluem leilões online, ou chat ao vivo, para os quais o FastComments pode ser utilizado.

Ativamos a flag useSingleLineCommentInput da seguinte forma:

Enable Single-Line Comment Input

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Isso também pode ser feito sem código. Na página de personalização do widget, veja a seção "Ativar entrada de comentário de linha única".

Enable Single-Line Comment Input

Observe que os comentários em cada página para cada direção de ordenação são pré-computados, portanto todas as direções de ordenação têm o mesmo desempenho.

Por padrão, cada usuário pode enviar até 5 comments no mesmo minuto.

Isso é rastreado por user id, anon user id, e ip address (hashed).

Isso pode ser personalizado sem código, na página de personalização do widget:

Limiting Comment Volume Per User

Observe que, se você estiver usando a comment creation API, pode querer enviar o ip original do usuário na requisição para o nosso backend para que a limitação de taxa seja aplicada por usuário e não globalmente à sua conta.

FastComments Secure SSO usa criptografia HMAC-SHA256 como mecanismo para implementar SSO. Primeiro vamos abordar a arquitetura geral, fornecer exemplos e passos detalhados.

There is also some documentation regarding migrating from other providers with similar SSO mechanisms, and the differences.

The flow looks like this:

Fluxo de SSO Seguro

Since Secure SSO involves full-stack development, full working code examples in Java/Spring, NodeJS/Express, and vanilla PHP are currently on GitHub.

Although we use ExpressJS in the NodeJS example and Spring in the Java example there are no frameworks/libraries required in these run-times to implement FastComments SSO - the native crypto packages work.

You don't have to write any new API endpoints with FastComments SSO. Simply encrypt the user's info using your secret key and pass the payload to the comment widget.

Obtenha sua Chave Secreta da API

Your API Secret can be retrieved from this page. You can find this page also by going to My Account, clicking the API/SSO tile, and then clicking "Get API Secret Key".

Parâmetros do Widget de Comentários

High-level API documentation for the comment widget can be found here.

Let's go into more detail of what these parameters mean.

The comment widget takes a configuration object - you already pass this if you're using FastComments to pass your customer id (called tenantId).

To enable SSO, pass a new "sso" object, which must have the following parameters. The values should be generated server side.

• userDataJSONBase64: The user's data in JSON format, which is then Base64 encoded.
• verificationHash: The HMAC-SHA256 hash created from UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Epoch timestamp, in milliseconds. Must not be in the future, or more than two days in the past.
• loginURL: A URL that the comment widget can show to log the user in.
• logoutURL: A URL that the comment widget can show to log the user out.
• loginCallback: When provided instead of the login URL, a function that the comment widget will invoke when clicking the login button.
• logoutCallback: When provided instead of the logout URL, a function that the comment widget will invoke when clicking the logout button.

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1768890093705,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout"

13 }

14}];

15</script>

16

O objeto do usuário

The User object contains the following schema:

O objeto do usuário

Copy

1

2interface SSOUser {

3 /** Obrigatório. Máx. 1k caracteres. **/

4 id: string;

5 /** Obrigatório. Máx. 1k caracteres. Observação: Deve ser único. **/

6 email: string;

7 /** Obrigatório. Máx. 1k caracteres. Observação: O nome de usuário não pode ser um email. Não precisa ser único. **/

8 username: string;

9 /** Opcional. Máx. 3k caracteres para URLs. O padrão vem do gravatar baseado no email. Suporta imagens codificadas em base64, caso em que o limite é 50k caracteres. **/

10 avatar?: string;

11 /** Opcional. Padrão: false. **/

12 optedInNotifications?: boolean;

13 /** Opcional. Padrão: false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Opcional. Máx. 100 caracteres. Este rótulo será mostrado ao lado do nome. Padrão: Administrador/Moderador quando aplicável. **/

16 displayLabel?: string;

17 /** Opcional. Máx. 500 caracteres. Isso será mostrado em vez do nome de usuário. **/

18 displayName?: string;

19 /** Opcional. Máx. 2k caracteres. O nome do usuário será vinculado a este URL. **/

20 websiteUrl?: string;

21 /** Opcional. Até 100 grupos por usuário. Um id de grupo não pode ter mais de 50 caracteres. **/

22 groupIds?: string[];

23 /** Opcional. Indica o usuário como administrador. **/

24 isAdmin?: boolean;

25 /** Opcional. Indica o usuário como moderador. **/

26 isModerator?: boolean;

27 /** Opcional, padrão true. Defina como false para habilitar a aba "activity" no perfil do usuário. **/

28 isProfileActivityPrivate?: boolean;

29 /** Opcional, padrão false. Defina como true para desativar comentários no perfil. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Opcional, padrão false. Defina como true para desativar mensagens diretas para este usuário. **/

32 isProfileDMDisabled?: boolean;

33}

34

Moderators and Administrators

For admins and moderators, pass the respective isAdmin or isModerator flags in the SSOUser object.

Notificações

To enable or disable notifications, set the value of optedInNotifications to true or false respectively. The first time the user loads the page with this value in the SSO payload, their notification settings will be updated.

Additionally, if you want users to receive notification emails for activity on pages they subscribed to (as opposed to just in-app notifications), then set optedInSubscriptionNotifications to true.

Usuários VIP e Rótulos Especiais

You can display a special label next to the user's name by using the optional "displayLabel" field.

Usuários não autenticados

To represent an unauthenticated user, simply do not populate userDataJSONBase64, verificationHash, or timestamp. Provide a loginURL.

These users will not be able to comment, and instead will be presented with a login message (message, link, or button, depending on configuration).

Exemplos diretos para Serializar e Gerar Hash dos Dados do Usuário

More details as an examples here (js), here (java) and here (php).

We understand that any integration can be a complicated and painful process. Don't hesitate to reach out to your representative or use the support page.

FastComments SSO (detalhes aqui) fornece aos seus usuários uma maneira de comentar sem precisar fazer login em outra plataforma.

No entanto, isso por si só não protege seus tópicos de comentários, já que por padrão os dados dos comentários são informação pública - qualquer pessoa que possa ver a página pode ver os comentários.

Ao alterar uma configuração, podemos restringir o acesso aos comentários para que só possam ser recuperados por um administrador ou por um usuário SSO válido.

No-Code Setup

Podemos impedir a visualização e interação com nossos tópicos de comentários, quando o SSO estiver configurado, criando uma regra de personalização.

Ao fazer isso, pesquise por SSO, e você encontrará esta opção:

Require SSO To View Comments

Ative-a e salve a regra de personalização.

Only Protect a Certain Domain or Page

Para proteger apenas um determinado domínio ou página, nós simplesmente configuraremos a regra de personalização para isso.

No topo da interface de personalização, encontraremos dois campos, Domain e URL ID.

Para proteger apenas um domínio específico, insira o domínio em questão no campo "domain".

Para proteger uma página em particular, insira a URL da página no campo "URL ID". Se você tiver uma integração personalizada com o FastComments, você pode inserir um tipo de ID aqui em vez de uma URL.

Security Levels

Ao exigir SSO, você deverá decidir se exige Simple SSO ou Secure SSO. Se você exigir Simple SSO, então ambos são permitidos, mas se você exigir Secure SSO então o conteúdo deve ser buscado com um payload Secure SSO hashed com sua API key para que possa ser visualizado.

A opção de nível de segurança aparecerá quando você selecionar "Require SSO To View Comments".

Protection Beyond Reading

Habilitar essa opção protegerá a página ou domínio de receber comentários, a menos que o usuário esteja logado via SSO.

Observações

Quaisquer usuários que criaram comentários antes da sua integração SSO não poderão vê-los, a menos que façam login através da sua integração SSO.

Por padrão, o FastComments exigirá um e-mail para comentar. Não precisa ser um e-mail válido, no entanto até o usuário clicar em um link enviado a ele, seu comentário exibirá um rótulo "Comentário não verificado".

No entanto, podemos remover a exigência do e-mail. O campo de e-mail continuará sendo exibido, mas não será mais obrigatório.

Isso pode ser configurado pela interface de personalização do widget:

Enabling Anonymous Comments

FastComments pode ser configurado para remover comentários não verificados após um número desejado de dias. Isso ajuda a combater spam.

Por padrão, não o faz.

Isso pode ser configurado, ou desativado, através da página Configurações de Moderação.

Moderation Settings

Quando usuários comentam e não estão logados, será solicitado que forneçam seu email.

Isso criará uma "sessão não verificada" para esse usuário, e pediremos que verifiquem essa sessão por email.

Para alguns sites ou aplicações, pode ser desejável não solicitar o email do usuário ao comentar ou votar.

Ativar comentários anônimos torna o campo de email opcional. Porém, podemos desativá-lo completamente. Primeiro, ative comentários anônimos e então a opção para desabilitar os campos de email aparecerá.

Disable Email Inputs

Com isso ativado, os campos de email não serão exibidos em nenhum de nossos produtos de comentários.

Observe que, com essa configuração, todos os comentários serão não verificados a menos que o usuário crie uma conta e faça login em https://fastcomments.com.

Você pode querer considerar desativar o rótulo "não verificado".

Por padrão, o FastComments exibirá um rótulo "Comentário Não Verificado" para comentários que foram deixados para um usuário que tem uma sessão de navegador não verificada. Leia mais sobre comentários não verificados aqui.

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

Além disso, esse recurso pode ser usado, sem escrever código, na interface de Personalização:

Disable The Unverified Label

Quando os usuários tentam votar em um comentário e não estão logados, será solicitado que forneçam seu nome de usuário e e-mail.

Podemos remover esse requisito, permitindo que qualquer pessoa vote em um comentário sem deixar nenhuma informação.

Allow Anonymous Votes

Quando os usuários comentam ou votam, e não estão logados, será solicitado que forneçam seu e-mail e nome de usuário.

No caso de comentários anônimos, às vezes é desejável definir um nome de usuário padrão para reduzir o atrito ao comentar. Isso pode ser feito pela interface de personalização. Os comentários anônimos devem ser habilitados primeiro.

Setting The Default Username

Por padrão, o FastComments renderizará o widget de comentários no locale determinado pelo sistema e navegador do usuário.

Quando um usuário comenta ou faz login, atualizamos seu último locale utilizado e também o usamos para o envio de e-mails.

Isso impacta como o widget de comentários é traduzido para o usuário. Locale consiste na língua e região do usuário, portanto configurar o locale irá normalmente alterar o idioma usado para mostrar texto ao usuário.

Via a interface do usuário

Isto pode ser definido usando a UI de personalização do widget. Veja a opção "Locale / Language":

Changing The Locale / Language

Via Código

Isto pode ser sobrescrito com um locale desejado.

Manually Defining the User's Locale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Idiomas suportados e códigos de locale

Você pode encontrar a lista completa de idiomas suportados e os códigos de locale correspondentes aqui.

Observação sobre SSO

Se você estiver usando SSO, talvez queira passar o locale do usuário no user object, para que e-mails e outras coisas sejam localizados corretamente para eles.

Por padrão, o FastComments não limita os idiomas usados para comentar.

Pode ser desejável limitar os idiomas que uma comunidade usa.

Isso pode ser configurado sem código, na página de personalização do widget:

Allowed Languages

O sistema irá analisar o comentário e determinar seu idioma, e então compará-lo com a lista permitida.

Se o comentário for escrito em um idioma que não é permitido, uma mensagem de erro localizada será exibida.

Os comentários podem ser bloqueados para que nenhum novo comentário ou voto possa ser feito definindo a flag readonly como true.

Os comentários também não poderão ser editados ou excluídos.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Isso pode ser personalizado sem código, na página de personalização do widget, para um domínio inteiro ou página:

Making The Comment Thread Readonly

Atualização!

A partir de novembro de 2022, os tópicos podem ser travados ou destravados ao vivo por administradores e moderadores através do menu de três pontos acima da área de resposta.

Isso impedirá novos comentários, ao mesmo tempo em que ainda permite votação e que os usuários excluam seus comentários, se desejarem, enquanto readonly não permite essas ações.

Isso corresponde ao campo isClosed na API Page.

Por padrão, o FastComments permite vincular a qualquer site externo.

Isso pode ser restringido para, em vez disso, uma lista desejada de sites ou domínios. Tentar postar um link para um site ou domínio, que não esteja na lista definida fará com que um erro seja exibido ao usuário.

Essa validação é apenas para o Widget de Comentários e para a API. Importações não são afetadas.

Isso é feito sem código, na página de customização do widget:

Restrict External Link Domains

Por padrão, o FastComments pedirá apenas o comentário do usuário, o nome do usuário e o e-mail.

No entanto, em algumas situações você pode querer que o usuário deixe um link para seu próprio blog ou site.

Podemos habilitar a exibição de um campo de entrada extra para o URL do site do usuário definindo a flag enableCommenterLinks como true:

Enabling Commenter Links

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Quando esse URL for fornecido, a conta do usuário será atualizada e o nome do usuário em todos os comentários, passados e futuros, será vinculado a esse URL.

Isso pode ser personalizado sem código, na página de personalização do widget:

Enabling Commenter Links

Uma lista de ids gerados a partir da página Grupos de Moderação.

Quando especificado, os comentários deixados usando a configuração especificada conterão o mesmo conjunto de moderationGroupIds.

Se um Moderator tiver um ou mais Grupos de Moderação definidos, ele(a) verá apenas os comentários na página Moderate Comments associados ao(s) seu(s) grupo(s).

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

Para autenticação, o FastComments depende de cookies de terceiros habilitados no seu navegador. Sem eles, os usuários sempre terão que deixar o e-mail para comentar (a menos que o campo de entrada de e-mail esteja oculto), e seus comentários sempre aparecerão como não verificados (por padrão).

Para contornar isso, você pode ativar o bypass de cookies de terceiros.

Quando essa configuração estiver ativada, ela exibirá um pequeno popup com uma mensagem informando que o usuário está sendo autenticado. Esse popup aparece sempre que o usuário interage com o widget de comentários; por exemplo, se ele deixar um comentário.

Podemos fazer isso no código definindo a flag enableThirdPartyCookieBypass como true:

Enabling Third-Party Cookie Bypass

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

Também podemos configurar isso via a UI de Personalização do Widget, em Enable Third-Party Cookie Popup:

Enabling Third-Party Cookie Bypass

Por padrão, os usuários podem excluir seus próprios comentários. Além disso, excluir o comentário deles exclui automaticamente todos os comentários filhos e transitórios na thread. Esse comportamento também é em tempo real.

Você pode restringir isso das seguintes maneiras:

• Em vez disso, anonimize o comentário excluído (defina name e text como [deleted] ou um valor personalizado).
• Não permitir excluir comentários quando houver respostas. Uma mensagem de erro personalizável é exibida.
• Restringir a exclusão quando um comentário tiver respostas apenas para administradores e moderadores.

Isso pode ser configurado via a seção Comment Thread Deletion na interface de personalização do widget.

Customize Delete Behavior for Replies

Por padrão, o FastComments exibirá os distintivos dos usuários apenas em seus comentários dentro do thread de comentários.

No entanto, podemos mostrar os distintivos dos usuários ao lado do nome deles acima do formulário de comentário ativando esse recurso na página de personalização do widget:

Show Badges in Top Bar Option

Isso exibirá os distintivos do usuário ao lado do nome na área da barra superior, tornando suas conquistas e status mais evidentes enquanto ele está compondo um comentário.

Observe que esse recurso precisa ser habilitado na interface de personalização do widget para funcionar. Você pode opcionalmente definir a flag showBadgesInTopBar como false na sua configuração de código para desativá‑lo seletivamente mesmo quando estiver ativado no nível do servidor:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10