Plugin de comentarios

El plugin de comentarios permite comentar contenido en tu sitio con tu cuenta de Facebook. Las personas pueden optar por compartir sus comentarios con amigos (y amigos de sus amigos) también en Facebook. Además, el plugin de comentarios incluye herramientas de moderación incorporadas y clasificación de relevancia social.

Configurador del plugin de comentariosModeraciónConfiguraciónAjustar idiomaPreguntas frecuentes

Paso a paso

1. Elegir una URL o una página

Elige la URL del sitio web con el que quieres usar el plugin de comentarios.

2. Configurador de código

Copia y pega la URL en el configurador de código que se incluye a continuación. Puedes ajustar las opciones de configuración, por ejemplo, el valor width del plugin de comentarios o cuántas publicaciones quieres mostrar de forma predeterminada (num_posts). Haz clic en el botón Obtener código para generar el código del plugin de comentarios.

3. Copiar y pegar el fragmento de código

Copia y pega el fragmento de código en el texto HTML del sitio o la página web en la que quieras implementar los comentarios.

Generador de códigos del plugin de comentarios

URL para comentar
Ancho
Número de publicaciones

Configuración

El configurador de código anterior no incluye todas las configuraciones posibles del plugin de comentarios. También puedes modificar las opciones siguientes:

Configuración Atributo HTML5 Descripción Valor predeterminado

colorscheme

data-colorscheme

El esquema de colores que usará el plugin de comentarios. Puede ser "light" o "dark".

"light"

href

data-href

La URL absoluta con la que se asociarán de forma permanente los comentarios que se publiquen en el plugin. Todas las historias que se compartan en Facebook sobre los comentarios que se publicaron con el plugin de comentarios tendrán un enlace a esta URL.

La URL actual

mobile

data-mobile

Un valor booleano que especifica si se debe mostrar o no la versión optimizada para celulares.

Detectados automáticamente

num_posts

data-numposts

El número de comentarios que deben mostrarse de forma predeterminada. El valor mínimo es 1.

10

order_by

data-order-by

El orden en el que deben mostrarse los comentarios. Puede ser "social", "reverse_time" o "time". Para obtener información sobre los distintos tipos de órdenes aplicables, consulta las preguntas frecuentes

"social"

width

data-width

El ancho del plugin de comentarios en la página web. Puede ser un valor expresado en píxeles o un porcentaje (como 100%) para un ancho fluido. La versión para celulares del plugin de comentarios ignora el parámetro "width" y, en su lugar, aplica el ancho fluido del 100%. El ancho mínimo admitido por el plugin de comentarios es de 320 píxeles.

550

Ordenar los comentarios

Los comentarios pueden ordenarse en función de la hora o la clasificación social con el menú de la esquina superior derecha del plugin de comentarios.

Puedes definir el orden predeterminado con el atributo data-order-by y uno de estos tres valores:

social (valor predeterminado)

También se lo conoce como "Superior". El plugin de comentarios usa señales sociales para destacar los comentarios de mayor calidad. Los comentarios se ordenan para mostrar primero los más relevantes de amigos, y de amigos de amigos, así como las conversaciones más activas o que más Me gusta reciben. Se ocultan los comentarios que se marcan como spam.

Nota: Las cadenas de comentarios (incluidas las que están asociadas con un objeto de Open Graph creado antes del lanzamiento original del plugin de comentarios) no se podrán ordenar según la relevancia social.

time

Los comentarios se muestran en el orden en que se publican: los más antiguos arriba y los más recientes abajo.

reverse_time

Los comentarios se muestran en el orden inverso al de su publicación: los más recientes arriba y los más antiguos abajo.

Ajustar idioma

Para ajustar el idioma del plugin de comentarios, carga una versión localizada del SDK de Facebook para JavaScript. Cuando lo hagas, ajusta el valor js.src para usar tu configuración regional. Por ejemplo, puedes reemplazar en_US por tu configuración regional, como fr_FR para Francés (Francia):

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

El archivo Facebook Locales XML contiene las configuraciones regionales que se admiten.

Posiblemente, deberás ajustar el ancho del plugin social para adaptarlo a los distintos idiomas. Obtén más información sobre Localización y traducción.

Moderación de comentarios

El plugin de comentarios incluye una herramienta de moderación muy eficaz con la que los equipos de administración de comunidades podrán moderar varios comentarios de forma simultánea, sencilla y rápida.

Configuración

Para usar la herramienta de moderación de comentarios, debes seguir las instrucciones de configuración de moderación.

Instrucciones de configuración de moderación

Ten en cuenta que no es posible usar la API Graph para responder comentarios realizados a través del plugin de comentarios.


Panel

Puedes acceder a la herramienta de moderación de dos formas:

1. Vista de moderación basada en la aplicación: ve a developers.facebook.com/tools/comments. Obtendrás una lista con todas tus aplicaciones de Facebook que te permitirá moderar todos los comentarios asociados con cada aplicación. Si no usas ninguna aplicación de Facebook con tu plugin de comentarios, no podrás usar esta vista.

2. Vista de moderación basada en la página: haz clic en el enlace Herramienta de moderación, junto al recuadro "Comentarios" (consulta la captura de pantalla siguiente). Esta vista solo muestra los comentarios publicados en esta página web (URL).

Vista de moderación

Las capturas de pantalla que se muestran a continuación reflejan las dos vistas de moderación. En la vista de moderación basada en la aplicación, puedes cambiar entre las distintas aplicaciones con el menú.

En la tabla de moderación, puedes aprobar u ocultar comentarios en función de su estado. Puedes cambiar el estado de varios comentarios con las casillas de verificación de la columna izquierda.

1. Vista de moderación basada en la página

En esta vista de moderación, se muestran todos los comentarios para una URL específica.

2. Vista de moderación basada en la aplicación

En esta vista de moderación, se muestran todos los comentarios para tu aplicación.

3. Cola marcada

Aquí se muestran los comentarios que fueron marcados por los usuarios o por Facebook. Los comentarios de esta lista pueden ser públicos o estar ocultos, según la configuración de la aplicación y de cómo se reportó el comentario.

4. Mi cola

Para dividir mejor el trabajo entre los desarrolladores, puedes usar esta función que te permite asignarte comentarios a ti mismo para la moderación. Los comentarios que se asignan aquí continúan disponibles para otros moderadores o administradores, pero los comentarios de tu cola no aparecen en otras colas.

Configuración

Puedes personalizar la configuración para cada aplicación. Abre el cuadro de diálogo de configuración con el botón Configuración (en la esquina superior derecha de la herramienta).


Moderadores

Puedes promocionar a otras personas para que actúen como moderadores de tus comentarios. Comienza a escribir el nombre de un amigo en el cuadro de entrada y aparecerá una sugerencia de búsqueda que te ayudará a seleccionar a la persona que quieras que actúe como moderador.


Ordenar comentarios por

También puedes controlar cómo deben ordenarse los comentarios. Obtén más información en Ordenar los comentarios.


Moderación

Puedes cambiar la visibilidad predeterminada de los nuevos comentarios. Por ejemplo, tal vez quieras aprobar todos los comentarios nuevos. Los comentarios no aprobados solo pueden verlos sus autores y permanecen en ese estado hasta que un moderador los apruebe.

Existen tres modos de moderación diferentes:

Público

Todos los comentarios serán públicos y también se mostrarán en la pestaña "Revisión".

Cerrado

Se ocultarán todos los comentarios y

Usuarios bloqueados

En la pestaña "Usuarios bloqueados", los moderadores pueden buscar a los usuarios bloqueados. Si un usuario bloqueado publica un comentario nuevo, automáticamente se le asignará visibilidad limitada y se mostrará en la pestaña "Revisión".


Reproducción de comentarios

Con la reproducción de comentarios, las personas pueden participar en una única conversación, independientemente de si los comentarios provienen de tu página web o de tu página de Facebook. Cuando compartes un enlace a tu sitio web en tu página de Facebook, los comentarios de tu página web también aparecerán como comentarios en tu publicación de Facebook y viceversa. Esto permite tener conversaciones más interesantes, tanto en tu página de Facebook como en tu sitio, porque los comentarios aparecen en ambos lugares.

Para activar la reproducción de comentarios en la herramienta de moderación, ve a la pestaña Configuración. Debes ser administrador de la página de Facebook en la que quieres utilizar la reproducción de comentarios.

Si quieres que las personas puedan incluir fotos en los comentarios con la reproducción de comentarios activada, debes activar Permitir que las personas que visitan la página publiquen en ella para tu página. Para que los comentarios se reproduzcan correctamente, tu página de Facebook debe ser pública.

La reproducción de comentarios se utilizará en las nuevas páginas web que se creen después de activar esta configuración. Una vez que se activa la reproducción de comentarios para una página web en particular, no es posible desactivar la función (solo la puedes desactivar para las futuras nuevas páginas). Por lo tanto, si está activada la función de cierre automático y se comparte con la página de Facebook, puedes continuar haciendo comentarios desde la publicación de la página de Facebook, pero no desde tu página web.

¿Las personas sabrán que estamos reproduciendo los comentarios? Cuando una persona comience a escribir un comentario en tu sitio web, verá un mensaje que le indica que su comentario también aparecerá en tu página de Facebook. Cuando una persona comience a escribir un comentario en un artículo que hayas publicado en tu página de Facebook, verá el mismo mensaje.


¿Cómo funciona la moderación? Todos los comentarios, ya sea los que se publicaron en la página de Facebook o en el artículo original de tu sitio, aparecerán en la herramienta de moderación de comentarios de Facebook. Por lo tanto, es posible moderar todos los comentarios que aparecen en la página del artículo. Si ocultas un comentario en la herramienta de moderación, también se ocultará automáticamente en la página de Facebook.

Configuración de la URL

Cerrar una cadena

Puedes cerrar una cadena de comentarios en cualquier URL en la que estés usando el plugin de comentarios. Esto significa que las personas no podrán agregar nuevos comentarios a la conversación en esa página web. Si deseas cerrar una cadena, utiliza el menú "Configuración" de la URL.

Reemplazar cierre automático

Si activaste el cierre automático, puedes reemplazar el cierre de una cadena para que esté disponible para realizar comentarios. Para hacerlo, ve a la configuración de la URL y activa Reemplazar cierre automático. A continuación, ajusta el estado del cierre deseado para la URL que estás moderando.

Configuración de moderación

Para usar la herramienta de moderación, deberás conectar una cuenta o una aplicación de Facebook a la implementación del plugin de comentarios.

Configuración con una aplicación de Facebook (recomendado)

Si tu sitio cuenta con varios recuadros de comentarios, te recomendamos especificar un identificador de la aplicación de Facebook como entidad de administración (todos los administradores de la aplicación podrán moderar los comentarios). De este modo, se activa una interfaz de moderador en Facebook que permite moderar, de forma conjunta y muy fácilmente, los comentarios de todos los plugins que se administran desde el identificador de la aplicación.

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

Además de las personas que agregues usando la configuración de Moderadores, todos los administradores de tu aplicación podrán también moderar los comentarios, pero solo los moderadores recibirán notificaciones de los nuevos comentarios si las activaste.

Si implementas varios recuadros de comentarios en tu sitio y los conectas a una aplicación especificando un identificador de la aplicación, la configuración de moderación que elijas se aplicará a todos estos recuadros.

Por ejemplo, si cambias la configuración de moderación a tiene visibilidad limitada, esto afectará a todos los recuadros de comentarios que dispongan del mismo identificador de la aplicación. Si necesitas aplicar parámetros de moderación distintos a diferentes áreas de un sitio, deberás usar dos o más identificadores de la aplicación. Así podrás aplicar configuraciones de moderación diferentes a los distintos grupos de recuadros de comentarios.

Puedes especificar fb:app_id o fb:admins, pero no ambos valores.

Asignar una cuenta de Facebook como administrador

Para asignar una cuenta de Facebook como administrador de la implementación del plugin de comentarios, solo tienes que incluir el siguiente metaelemento en la sección <head> de cada página web en la que vas a usar el plugin de comentarios:

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

Si deseas agregar más de un moderador, deberás incluir varios elementos, cada uno de ellos con un identificador de Facebook:

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

Número de comentarios

El valor fb:comments-count muestra la cantidad de comentarios de una URL determinada en un elemento <span> de tu página web. Puedes utilizar CSS para modificar el estilo del elemento <span> a fin de que coincida con el resto de tu sitio. Nota: Esta función no está disponible en HTML5.

Por ejemplo, para mostrar el número de comentarios en ejemplo.com, utiliza el siguiente código:

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

Así se mostrará lo siguiente:

69391 awesome comments

La cantidad de comentarios que se dejaron en una URL específica, a los que se puede acceder con la API Graph. Por ejemplo, el número de comentarios de ejemplo.com disponible mediante la propiedad comment_count del campo share del nodo "URL":

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

Webhooks

Puedes configurar webhooks para que un script en tu servidor reciba una notificación cuando se publique un nuevo comentario. Para empezar:

  1. Ve al panel de aplicaciones.
  2. Haz clic en "+ Agregar producto" en el menú de navegación de la izquierda.
  3. En la sección "Webhooks", haz clic en "Configurar".
  4. Elige "Aplicación" en el menú desplegable.
  5. Haz clic en el botón "Suscribirte a este tema".
  6. En el cuadro de diálogo, ingresa la URL del script que recibirá las notificaciones, por ejemplo https://example.org/mywebhook.php.
  7. Ingresa un token (cualquier cadena que elijas). Este se enviará a tu script para que lo verifique.
  8. El último paso de la configuración consiste en hacer clic en el botón "Verificar y guardar".

Sin embargo, antes de hacerlo, echa un vistazo a la documentación de Webhooks para obtener información detallada sobre cómo implementar el script.

A continuación, te ofrecemos un breve ejemplo sobre cómo un simple mywebhook.php se podría ver en PHP.

Comenzar con la verificación:

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

Este make-up-a-token es la misma cadena que ingresaste anteriormente en el paso 7.

Simplemente registra todos los comentarios a medida que se publiquen:

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

Ten en cuenta que, en PHP, $_POST no funcionará, ya que necesitas file_get_contents('php://input').

Luego de verificar tus webhooks, verás "plugin_comment" y "plugin_comment_reply" en la sección "Webhooks" de tu panel de aplicaciones.

Haz clic en "Probar" para verificar la implementación con un ejemplo de respuesta y, luego, "Suscribirte" para transmitir en vivo.

Obtén más información sobre la respuesta en la documentación de referencia de Webhooks.