Plugin de comentários

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

Mudanças nos Plugins Sociais na região europeia

Você pode começar a perceber alguns impactos nos Plugins Sociais devido a um aviso de consentimento sobre cookies atualizados que será exibido para as pessoas que usarem os produtos do Facebook na região europeia. Não daremos mais suporte aos Plugins Sociais "Curtir" e "Comentar" para usuários da região europeia, a menos que eles 1) estejam conectados à conta do Facebook e 2) tenham dado o consentimento ao controle de “Cookies do site e do aplicativo”. Se esses dois requisitos forem atendidos, o usuário poderá ver e interagir com plugins, como os botões "Curtir" ou "Comentar". Se um dos requisitos acima não for atendido, o usuário não poderá ver os plugins.

A região europeia abrange uma lista específica de países, incluindo os seguintes:

  • União Europeia (UE): Áustria, Bélgica, Bulgária, Croácia, República do Chipre, República Tcheca, Dinamarca, Estônia, Finlândia, França, Alemanha, Grécia, Hungria, Irlanda, Itália, Letônia, Lituânia, Luxemburgo, Malta, Países Baixos, Polônia, Portugal, Romênia, Eslováquia, Eslovênia, Espanha e Suécia

  • Não membros da União Europeia, mas incluídos no Espaço Econômico Europeu/Associação Europeia de Comércio Livre ou na união aduaneira: [somente Espaço Econômico Europeu/Associação Europeia de Comércio Livre] Islândia, Liechtenstein, Noruega e Suíça; [União aduaneira da União Europeia] todas as Ilhas do Canal, Ilha de Man, Mônaco; e bases soberanas do Reino Unido em Chipre; [União Aduaneira Europeia] Andorra, San Marino e Cidade do Vaticano.

  • Não membros da União Europeia, mas parte das Regiões Ultraperiféricas da União Europeia: Martinica, Maiote, Guadalupe, Guiana Francesa, Reunião, São Martinho, Madeira, Açores e Ilhas Canárias.
  • Reino Unido (todas as ilhas britânicas)

Passo a passo

1. Escolha a URL ou a Página

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

2. Configurador de código

Copie e cole a URL no configurador de código abaixo. É possível ajustar configurações como a width do plugin de comentários ou a quantidade de publicações que 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

A URL absoluta a que 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 essa URL.

URL atual.

lazy

data-lazy

true significa que o navegador usará o mecanismo de carregamento lento ao definir o atributo loading="lazy" do iframe. O efeito é que o navegador não renderizará o plugin se ele não estiver próximo ao visor. Isso pode fazer com que plugin nunca seja visto. Pode ser true ou false (padrão).

false

mobile

data-mobile

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

Detectado automaticamente

num_posts

data-numposts

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 "reverse_time" (tempo reverso) ou "time" (tempo). Os diferentes tipos de ordem são explicados na seção Classificação de comentários.

"reverse-time"

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 para dispositivos móveis do plugin de comentários ignora o parâmetro de largura. Para essa versão, a largura fluida é de 100%. A largura mínima aceita pelo plugin de comentários é de 320 pixels.

550

Classificação de comentários

As pessoas podem organizar os comentários por tempo 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:

reverse_time (padrão)

O conteúdo aparece na ordem contrária da publicação, com os comentários mais novos no topo e os mais antigos embaixo.

time

O conteúdo aparece na ordem de publicação, com os comentários mais antigos no topo e os mais novos embaixo.

Como mudar o idioma

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

src="https://connect.facebook.net/fr_FR/sdk.js#xfbml=1"

Talvez você tenha que ajustar a largura do Plugin Social para incluir idiomas diferentes. Saiba mais sobre os processos de localização e tradução.

Moderação de comentários

O plugin de comentários inclui uma ferramenta eficaz de moderação. Com essa ferramenta, fica mais fácil e rápido para a equipe de gerenciamento da comunidade moderar vários comentários de uma só vez.

Configuraçã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

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 acessar a ferramenta de moderação:

1. Visualização de moderação com base no aplicativo: acesse developers.facebook.com/tools/comments. Você verá uma lista com seus aplicativos do Facebook, o que permitirá moderar todos os comentários associados a cada aplicativo. Caso você não use um aplicativo do Facebook com o plugin de comentários, não será possível acessar 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 esteja usando a visualização de moderação com base no aplicativo, acesse o menu suspenso para alternar entre os aplicativos.

Na tabela de moderação, é possível aprovar ou ocultar comentários dependendo do status de cada um deles. Para mudar o status de vários comentários, use as caixas de seleção na coluna à 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 uma URL específica.

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

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

3. Fila sinalizada

Os comentários sinalizados por usuários ou pelo Facebook serão exibidos aqui. Os comentários dessa lista podem estar visíveis ou ocultos, dependendo das configurações dos aplicativos e de como o comentário foi denunciado.

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 o diálogo de configurações.


Moderadores

É possível promover outras pessoas a moderadores dos seus comentários. Comece a digitar o nome de um amigo na caixa de entrada de texto, e a digitação antecipada ajudará você a selecionar aquele que se tornará moderador.


Classificar comentários

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


Moderação

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

Há três opções de moderação diferentes:

Público

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

Fechado

Todos os comentários ficarão ocultos.

Usuários banidos

Na aba "Usuários banidos", os moderadores podem pesquisar usuários banidos. Se algum usuário banido publicar um comentário, o conteúdo terá a visibilidade limitada automaticamente e aparecerá na aba "Analisar".


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. Ao fazer isso, as pessoas não poderão adicionar novos comentários à discussão nessa página da web. Você pode fechar uma conversa no menu "Configurações de URL".

Desativar o fechamento automático

Caso você use o fechamento automático, será possível desativar o recurso em um tópico fechado. Se fizer isso, o tópico será reaberto para comentários. Para fazer isso, vá para "Configurações de URL" e ative a opção Desativar fechamento automático. Em seguida, defina o estado de fechamento desejado para a URL que você está moderando.

Configuração da moderação

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

Configuração com um aplicativo do Facebook (recomendado)

Caso seu site tenha muitas caixas de comentários, especifique um ID do aplicativo do Facebook como a entidade de gerenciamento. Isso significa que todos os administradores do aplicativo poderão moderar comentários. Dessa forma, uma interface de moderação será ativada no Facebook, onde os comentários de todos os plugins administrados pelo ID do aplicativo poderão ser moderados ao mesmo tempo com facilidade.

<meta property="fb:app_id" content="&#123;YOUR_APP_ID&#125;" />

Além das pessoas que você adicionar usando a configuração Moderadores, todos os administradores do seu aplicativo também poderão moderar comentários. No entanto, somente os moderadores receberão notificações de novos comentários, quando esses avisos estiverem ativos.

Se você implementar diversas caixas de comentários no seu site e as conectar a um aplicativo especificando o ID, as configurações de moderação selecionadas serão aplicadas 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 ID do aplicativo. Se você precisar aplicar diversas configurações de moderação a áreas diferentes do seu site, use dois ou mais IDs 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 seguinte metaelemento na seção <head> de cada página da web em que você usa o plugin de comentários:

<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID&#125;"/>

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

<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID_1&#125;"/>
<meta property="fb:admins" content="&#123;YOUR_FACEBOOK_USER_ID_2&#125;"/>

Contador de comentários

Ao usar o valor fb:comments-count, você verá o número de comentários de uma determinada URL em um elemento <span> da sua página da web. Em seguida, você pode usar CSS para personalizar esse elemento <span> de modo que corresponda ao resto do site. Nota: 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 uma determinada 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ó da 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. Primeiros passos:

  1. Acesse o Painel de Aplicativos.
  2. Clique em "+ Adicionar produto" no menu de navegação à esquerda.
  3. Na seção "Webhooks", clique em "Configurar".
  4. Escolha "Aplicativo" no menu suspenso.
  5. Clique no botão "Assinar este tópico"
  6. Na caixa de diálogo, insira a URL do script que receberá as notificações, por exemplo, https://example.org/mywebhook.php.
  7. Insira um token (qualquer cadeia de caracteres da sua preferência). O código será enviado ao script para verificação.
  8. Como última etapa da configuração, clique no botão "Verificar e salvar”.

Confira a documentação de Webhooks para ver informações completas sobre como implementar o script.

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

Comece com a verificação:

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

Esse 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 usar 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 um exemplo de resposta e clique em "Assinar" para ativá-la.

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