Plugin de comentários

O plugin de comentários permite que as pessoas comentem o conteúdo do seu site usando as respectivas contas do Facebook. As pessoas podem optar por compartilhar suas atividades de comentários com os amigos (e os amigos dos amigos) no Facebook também. O plugin de comentários também inclui ferramentas de moderação integradas e classificação de pertinência social.

Configurador do plugin de comentáriosModeraçãoConfiguraçõesAlterar idiomaPerguntas frequentes

Passo a passo

1. Escolha o URL ou a Página

Escolha o URL do site que você quiser usar com o plugin de comentários.

2. Configurador de código

Copie e cole o URL no configurador de código abaixo. Você pode ajustar configurações como a width do seu plugin de comentários ou quantas publicações você quer mostrar por padrão (num_posts). Clique no botão Obter código para gerar o código do plugin de comentários.

3. Copie e cole o trecho de código

Copie e cole o trecho de código no HTML do site ou da página da Web onde você quer implementar comentários.

Gerador de Códigos do plugin de comentários

URL para comentar
Largura
Número de publicações

Configurações

O configurador de código usa apenas um subconjunto de todas as configurações possíveis para o plugin de comentários. Também é possível alterar as seguintes configurações:

Configuração Atributo HTML5 Descrição Valor padrão

colorscheme

data-colorscheme

Esquema de cores usado pelo plugin de comentários. Pode ser "light" (claro) ou "dark" (escuro).

"light"

href

data-href

O URL absoluto ao qual os comentários publicados no plugin serão permanentemente associados. Todas as histórias compartilhadas no Facebook sobre os comentários publicados por meio do plugin de comentários serão vinculadas a esse URL.

URL atual.

mobile

data-mobile

Valor booleano que especifica se a versão otimizada para dispositivos móveis será mostrada ou não.

Detectado automaticamente

num_posts

data-numposts

O número de comentários exibidos por padrão. O valor mínimo é 1.

10

order_by

data-order-by

A ordem usada para mostrar os comentários. Pode ser "social", "reverse_time" (tempo reverso) ou "time" (tempo). Os tipos de pedido diferentes são explicados nas Perguntas frequentes

"social"

width

data-width

A largura do plugin de comentários na página da Web. Pode ser um valor em pixels ou uma porcentagem (por exemplo: 100%) para largura fluida. A versão móvel do plugin de comentários ignora o parâmetro de largura; em vez disso, ela tem a largura fluida de 100%. A largura mínima comportada pelo plugin de comentários é de 320px.

550

Classificação dos comentários

As pessoas podem organizar os comentários por tempo ou classificação social usando o menu no canto superior direito do plugin de comentários.

Você pode definir a ordem padrão usando o atributo data-order-by e um destes três valores:

social (padrão)

Isso também é conhecido como "Topo". O plugin de comentários usa sinais sociais para trazer à tona os comentários de qualidade mais alta. Os comentários são ordenados de forma a mostrar primeiro os comentários mais pertinentes de amigos e dos amigos de amigos, além dos tópicos de discussão mais curtidos ou ativos. Os comentários marcados como spam ficam ocultos.

Observação: Os tópicos de comentários antigos, incluindo aqueles associados a um objeto do Open Graph criado antes do lançamento original do plugin de comentários, não poderão ser organizados por social.

time

Os comentários aparecem na ordem de publicação, com os comentários mais antigos no topo e os mais novos embaixo.

reverse_time

Os comentários aparecem na ordem contrária de publicação, com os comentários mais novos no topo e os mais antigos embaixo.

Como mudar o idioma

É possível alterar o idioma do plugin de comentários carregando uma versão localizada do SDK do Facebook para JavaScript. Quando você carregar o SDK, altere o valor de js.src para usar sua localidade. Por exemplo, você pode substituir en_US pelo seu idioma, como fr_FR para o francês (França):

js.src = "https://connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.4";

Pode ser necessário alterar a largura do plugin social para acomodar idiomas diferentes. Saiba mais sobre localização e tradução.

Moderação dos comentários

Uma das partes do plugin de comentários é uma ferramenta potente de moderação. Com ela, é mais fácil e rápido para a equipe de gerenciamento da comunidade moderar vários comentários de uma só vez.

Instalação

Para usar a ferramenta de moderação de comentários, é preciso seguir as instruções para configuração da moderação.

Instruções para configuração da moderação

Observe que não é possível usar a Graph API para responder a comentários enviados por meio do plugin de comentários.


Painel

Existem duas maneiras de navegar até a ferramenta de moderação:

1. Visualização de moderação com base no aplicativo: Vá para developers.facebook.com/tools/comments. Você verá uma lista com todos os seus aplicativos do Facebook, que lhe permitirá moderar todos os comentários associados a cada aplicativo. Se você não usar um aplicativo do Facebook com o plugin de comentários, não será possível usar essa visualização.

2. Visualização de moderação com base na Página: Clique no link Ferramenta de moderação, próximo à caixa de comentários (veja a captura de tela abaixo). A visualização só mostrará os comentários publicados nessa página da Web (URL).

Visualização de moderação

Veja as duas visualizações de moderação nas capturas de tela abaixo. Caso você esteja usando a visualização de moderação com base no aplicativo, você poderá usar o menu suspenso para alternar entre os aplicativos.

Na tabela de moderação, é possível aprovar ou ocultar comentários dependendo do status deles. Para mudar o status de vários comentários, use as caixas de seleção na coluna da esquerda.

1. Visualização de moderação com base na Página

Nessa visualização de moderação serão exibidos todos os comentários para um URL específico.

2. Visualização de moderação com base no aplicativo

Nessa visualização de moderação serão exibidos todos os comentários para o seu aplicativo.

3. Fila sinalizada

Os comentários que tiverem sido sinalizados por usuários ou pelo Facebook serão exibidos aqui. Os comentários dessa lista podem ser públicos ou ocultos, dependendo das configurações dos aplicativos e de como o comentário foi denunciado.

4. Minha fila

Para dividir melhor o trabalho entre desenvolvedores, você pode usar esse recurso para atribuir comentários a si mesmo para moderação. Os comentários atribuídos aqui ainda estarão disponíveis para outros moderadores ou administradores, mas os comentários na sua fila não aparecerão nas filas dos outros.

Configurações

É possível definir configurações personalizadas para cada aplicativo. Use o botão Configurações (no canto superior direito da ferramenta) para abrir a caixa de diálogo de configurações.


Moderadores

É possível promover outras pessoas a moderadores dos seus comentários. Para começar, digite o nome de um amigo na caixa de entrada. Uma digitação antecipada o ajudará a selecionar a pessoa que você gostaria de transformar em moderador.


Classificar comentários por

Também é possível controlar como os comentários são classificados. Saiba mais em Classificação dos comentários.


Moderação

É possível alterar a visibilidade padrão para novos comentários. Por exemplo, você pode querer aprovar todos os novos comentários. Se um comentário não for aprovado, ele ficará visível apenas para o comentador até que algum moderador o aprove.

Há três modos de moderação diferentes:

Público

Todos os comentários serão públicos. Eles também aparecerão na guia Analisar.

Fechado

Todos os comentários ficarão ocultos.

Usuários banidos

Na guia Usuários banidos, os moderadores podem pesquisar usuários banidos. Se algum usuário banido publicar um comentário, a visibilidade desse comentário será automaticamente limitada e ele aparecerá na guia Analisar.


Com o lançamento da versão 4.28.0 do SDK do Facebook, o Espelhamento de comentários ficou obsoleto. Ele terá suporte até 5 de fevereiro de 2018.

Espelhamento de comentários

Com o Espelhamento de comentários, as pessoas podem participar de uma conversa simples, não importa se os comentários vêm da sua página da Web ou da sua Página do Facebook. Quando você compartilha um link para o seu site na sua Página do Facebook, os comentários dessa página da Web também aparecerão como comentários na sua Página do Facebook e vice-versa. Isso cria uma conversa mais completa, tanto na sua Página do Facebook quanto na sua página da Web, porque os comentários aparecerão nos dois lugares.

Você pode ativar o espelhamento de comentários na ferramenta de moderação situada na guia Configurações. Para ativar o espelhamento de comentários, você precisa ser um administrador de Página para a Página do Facebook na qual deseja ativar o espelhamento.

Se você desejar que as pessoas possam incluir fotos nos comentários com o espelhamento de comentários ativado, também deverá ativar Permitir que os visitantes da Página enviem publicações na sua Página. Para fazer os comentários serem espelhados corretamente, a sua Página do Facebook precisa ser pública para todos.

O espelhamento de comentários entra em vigor em novas páginas da Web criadas após a ativação dessa configuração. Uma vez ativado o espelhamento de comentários para uma página da Web específica, não há nenhuma maneira de desativar o espelhamento (só é possível desativar o espelhamento para novas páginas da Web). Portanto, se o recurso de fechamento automático estiver ativado e for compartilhado com a sua Página do Facebook, ainda assim poderão ser feitos novos comentários a partir da publicação da Página do Facebook, mas não da sua página da Web.

As pessoas saberão que estamos espelhando os comentários? Quando uma pessoa começar a escrever um comentário no seu site, ela verá uma mensagem informando que o comentário aparecerá também na sua Página do Facebook. A mesma mensagem aparece quando uma pessoa começa a escrever um comentário em um artigo publicado na sua Página do Facebook.


Como funciona a moderação? Todos os comentários, independente se foram deixados na publicação da Página do Facebook ou no artigo original no seu site, aparecerão na ferramenta principal de moderação de comentários do Facebook. Portanto, todos os comentários exibidos na página do artigo podem ser moderados. Se você ocultar um comentário na ferramenta de moderação, ele será automaticamente ocultado também na Página do Facebook.

Configurações de URL

Fechar um tópico

Você pode fechar um tópico de comentários em qualquer URL em que você estiver usando o plugin de comentários. Fazer isso significa que as pessoas não poderão adicionar novos comentários à discussão nessa página da Web. Você pode fechar um tópico no menu Configurações de URL.

Anular o fechamento automático

Se você ativou o fechamento automático, é possível anulá-lo para um tópico. Isso irá reabri-lo para comentários. Para fazer isso vá para Configurações de URL e ative a opção Anular fechamento automático. Em seguida, defina o estado de fechamento desejado para o URL que você estiver moderando.

Configuração da moderação

Para usar a ferramenta de moderação, você precisa conectar uma conta do Facebook ou um aplicativo do Facebook à sua implementação do plugin de comentários.

Configuração usando um aplicativo do Facebook (preferível)

Se o seu site tem muitas caixas de comentários, é recomendável especificar um número de identificação do aplicativo do Facebook como entidade de gerenciamento. Isso significa que todos os administradores do aplicativo poderão moderar comentários. Isso habilita uma interface de moderação no Facebook, em que os comentários de todos os plugins administrados pelo número de identificação do seu aplicativo podem ser moderados ao mesmo tempo com facilidade.

<meta property="fb:app_id" content="{YOUR_APP_ID}" />

Além das pessoas que você adicionar usando a definição Moderadores, todos os administradores do seu aplicativo também poderão moderar comentários, mas somente os moderadores receberão notificações de novos comentários, se você ativar as notificações.

Quando você implementa diversas caixas de comentários no seu site e as conecta a um aplicativo especificando o número de identificação do aplicativo, as configurações de moderação selecionadas se aplicarão a todas as caixas de comentários.

Por exemplo, mudar a configuração de moderação para tem visibilidade limitada afeta todas as caixas de comentários referentes ao mesmo número de identificação do aplicativo. Se você precisar aplicar várias configurações de moderação a diversas áreas do seu site, use dois ou mais números de identificação do aplicativo. Assim, você poderá aplicar configurações de moderação diferentes a cada grupo de caixas de comentários.

Você pode especificar fb:app_id ou fb:admins, mas não ambos.

Atribuir uma conta do Facebook como administrador

Para atribuir uma conta do Facebook como administrador de uma implementação do plugin de comentários, inclua o metaelemento seguinte na seção <head> de cada página da Web na qual você usa o plugin de comentários:

<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID}"/>

Para incluir vários moderadores, adicione mais de um elemento, cada um com o próprio ID do Facebook:

<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID_1}"/>
<meta property="fb:admins" content="{YOUR_FACEBOOK_USER_ID_2}"/>

Contador de comentários

O uso do valor fb:comments-count exibe o número de comentários em um determinado URL em um elemento <span> da sua página da Web. Em seguida, você pode usar CSS para personalizar esse elemento <span> para corresponder ao resto do seu site. Observação: no momento, esse recurso não está disponível para HTML5.

Por exemplo, para mostrar o número de comentários de example.com, use este código:

<span class="fb-comments-count" data-href="https://example.com/"></span>
awesome comments 

Isso mostrará o seguinte:

69391 awesome comments

o número de comentários em um determinado URL pode ser acessado por meio da Graph API. Por exemplo, o número de comentários em example.com está disponível por meio da propriedade comment_count no campo share do nó de URL:

https://graph.facebook.com/v2.4/?fields=share{comment_count}&amp;id=<YOUR_URL>

Webhooks

É possível configurar Webhooks para que um script no seu servidor seja notificado sempre que um novo comentário for publicado. Para começar a usar:

  1. Vá para o Painel de Aplicativos
  2. Clique em "+ Adicionar produto" no menu de navegação esquerdo
  3. Na seção Webhooks, clique em "Configurar"
  4. Escolha "Aplicativo" no menu suspenso
  5. Clique no botão "Inscrever-se neste tópico"
  6. Na caixa de diálogo, insira o URL do script que receberá notificações, por exemplo, https://example.org/mywebhook.php
  7. Insira um token – qualquer cadeia de caracteres à escolha. Ele será enviado ao script para verificação
  8. Como última etapa da configuração, clique no botão "Verificar e salvar"

Mas antes disso, dê uma olhada na documentação de Webhooks para ver informações completas sobre como implementar o script.

Veja a seguir um exemplo rápido de como seria a aparência de um mywebhook.php simples em PHP.

Iniciando com a verificação:

<?php
if ($_GET['hub_verify_token'] === 'make-up-a-token') {
  echo $_GET['hub_challenge'];
}

Este make-up-a-token representa a mesma cadeia de caracteres que você inseriu na etapa 7 acima.

Em seguida, basta registrar todos os componentes à medida que eles forem publicados:

file_put_contents(
  'log.txt',
  "\n" . file_get_contents('php://input'),
  FILE_APPEND
);
?>

Observe que $_POST não funcionará em PHP. Será necessário file_get_contents('php://input')

Depois de verificar o Webhook, você verá "plugin_comment" e "plugin_comment_reply", na seção Webhooks do Painel de Aplicativos.

Clique no botão "Testar" para confirmar a implementação com uma resposta de exemplo e clique em "Assinar" para ativá-la.

Para saber mais sobre a resposta, confira a documentação de referência para Webhooks.