Plugin de comentarios

Con este plugin las personas pueden comentar contenido en tu sitio web con su cuenta de Facebook. También pueden decidir si quieren compartir en Facebook su actividad de comentarios con los amigos (y con los amigos de sus amigos). Además, el plugin de comentarios incluye una clasificación de relevancia social y herramientas de moderación integradas.

Configurador del plugin de comentariosModeraciónAjustesAjustes de idiomaPreguntas frecuentes

Paso a paso

1. Elige 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 figura a continuación. Puedes ajustar la configuración de opciones, como el valor width del plugin de comentarios, o cuántas publicaciones deseas 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. Copia y pega el fragmento de código

Copia y pega el fragmento de código en el HTML del sitio o la página web donde quieres implementar comentarios.

Generador de códigos del plugin de comentarios

URL que comentar
Anchura
Número de publicaciones

Ajustes

El configurador de código anterior utiliza solo parte de todas las configuraciones posibles del plugin de comentarios. También puedes modificar los ajustes siguientes:

Ajuste Atributo HTML5 Descripción Valor predeterminado

colorscheme

data-colorscheme

Esquema de colores que usará el plugin de comentarios. Puede ser “light” o “dark”.

“light”

href

data-href

URL absoluta con la que se asociarán de forma permanente los comentarios que se publiquen en el plugin. Todas las historias compartidas en Facebook sobre comentarios publicados con el plugin de comentarios enlazarán a esta URL.

La URL actual

mobile

data-mobile

Valor booleano que especifica si se debe mostrar o no la versión optimizada para móviles.

Se detecta automáticamente

num_posts

data-numposts

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

10

order_by

data-order-by

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

Ancho del plugin de comentarios en la página web. Puede ser un valor en píxeles o un porcentaje (como 100 %), en caso de un ancho variable. La versión para móviles del plugin de comentarios ignora el parámetro “width” y aplica un ancho variable del 100 %. El ancho mínimo que admite el plugin de comentarios es de 320 píxeles.

550

Orden de 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)

Este orden también se conoce como “Destacados”. 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 están marcados como spam.

Nota: Las conversaciones antiguas, incluidas las asociadas a un objeto de Open Graph creado antes de la publicación original del plugin de comentarios, no se pueden ordenar por clasificación 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.

Ajustes de 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 idioma. Por ejemplo, puedes sustituir en_US por tu código de idioma, por ejemplo, fr_FR para francés (Francia):

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

Puedes consultar los idiomas que se admiten en el archivo FacebookLocales.xml.

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 responsables de la gestión de comunidades pueden moderar varios comentarios de forma simultánea, fácil y rápida.

Configuración

Para usar la herramienta de moderación de comentarios, deberás seguir las instrucciones de configuración de la moderación.

Instrucciones de configuración de la moderación

Ten en cuenta que no puedes usar la API Graph para responder a comentarios que se hayan realizado mediante el 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 una. Si no usas ninguna aplicación de Facebook con el 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 de comentarios (en la captura de pantalla siguiente). Esta vista solo muestra los comentarios publicados en esta página (URL).

Vista de moderación

Las capturas de pantalla que se muestran a continuación reflejan las dos vistas de moderación. Si usas 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 la columna izquierda.

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

En esta vista de moderación se muestran todos los comentarios de 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 de tu aplicación.

3. Cola de marcados

Los comentarios que marcan los usuarios o Facebook se muestran aquí. Los comentarios en esta lista pueden ser públicos u ocultos, dependiendo de la configuración de las aplicaciones y de cómo se informó de los comentarios.

4. Mi cola

Para dividir mejor el trabajo entre desarrolladores, puedes usar esta función para asignarte comentarios para su moderación. Los comentarios aquí asignados siguen estando disponibles para los demás moderadores o administradores, pero solo tú podrás ver los que te has asignado.

Ajustes

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 designar 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 selecciona a la persona con ayuda de las sugerencias de búsqueda.


Ordenar comentarios por

También puedes controlar cómo se ordenan los comentarios. Consulta la sección Orden de los comentarios para obtener más información.


Moderación

Puedes cambiar la visibilidad predeterminada de los nuevos comentarios. Por ejemplo, puedes decidir que los nuevos comentarios deben aprobarse. Los comentarios no aprobados solo podrán verlos los comentaristas y permanecerán 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.

Usuarios bloqueados

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


Creación de reflejos de comentarios

Con la creación de reflejos de comentarios se puede participar en una misma conversación, independientemente de que los comentarios procedan de tu página web o de tu página de Facebook. Cuando compartas un enlace a tu sitio web en tu página de Facebook, los comentarios de la página web aparecerán también como comentarios en tu publicación de Facebook y viceversa. Esto enriquece la conversación tanto en la página de Facebook como en el sitio web, ya que los comentarios aparecen en ambos sitios.

Puedes activar la creación de reflejos de comentarios en la pestaña Configuración de la herramienta de moderación. Para poder hacerlo, debes ser administrador de la página de Facebook en la que quieras habilitar esta funcionalidad.

Si quieres que los demás puedan incluir fotos en los comentarios con la creación de reflejos activada, debes habilitar para tu página la opción Permitir que las personas que visiten la página publiquen en ella. Para que los comentarios se reflejen correctamente, tu página de Facebook debe ser pública para todo el mundo.

La creación de reflejos de comentarios tendrá efecto en las nuevas páginas web que se creen a partir de entonces. Una vez que se active la creación de reflejos de comentarios para una página web particular, no hay modo de deshabilitarla (solo puedes desactivar esta funcionalidad para las páginas web creadas en adelante). Por tanto, si la función de cierre automático está habilitada y se comparte en tu página de Facebook, se podrán seguir haciendo nuevos comentarios desde la publicación en la página de Facebook, pero no desde tu página web.

¿Las personas sabrán que sus comentarios se reflejan? Cuando una persona comience a escribir un comentario en tu sitio web, verá un mensaje que indica que el comentario también aparecerá en tu página de Facebook. El mismo mensaje aparece cuando se empieza a escribir un comentario en un artículo publicado en tu página de Facebook.


¿Cómo funciona la moderación? Todos los comentarios, ya se dejen en la publicación en la página de Facebook o en el artículo original en tu sitio web, aparecerán en la herramienta de moderación de comentarios principal de Facebook, de modo que 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, este también se ocultará automáticamente en la página de Facebook.

Configuración de URL

Cerrar una conversación

Puedes cerrar una conversación en cualquier URL en la que uses el plugin de comentarios. Esto significa que no se podrán añadir nuevos comentarios a la discusión en esa página web. Puedes cerrar una conversación desde el menú “Configuración de URL”.

Invalidación del cierre automático

Si has habilitado el cierre automático, puedes invalidarlo en una conversación cerrada para abrirla a nuevos comentarios. Para ello, ve a “Configuración de URL” y activa Invalidar cierre automático. Después, establece el estado de cierre que desees para la URL moderada.

Configuración de la 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 (preferido)

Si el sitio web cuenta con muchos recuadros de comentarios, te recomendamos especificar un identificador de la aplicación de Facebook como entidad de gestión, lo que significa que 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 añadas mediante la opción Moderadores, todos los administradores de la aplicación podrán moderar comentarios. Sin embargo, cuando actives las notificaciones de nuevos comentarios, los moderadores serán los únicos que las reciban.

Si implementas varios recuadros de comentarios en un 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 esos recuadros.

Por ejemplo, cambiar la configuración de moderación a tiene visibilidad limitada afecta a todos los recuadros de comentarios que dispongan del mismo identificador de la aplicación. Si necesitas aplicar configuraciones de moderación distintas a diferentes áreas de un sitio, deberás usar dos o más identificadores de la aplicación. De este modo puedes 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.

Asignación de una cuenta de Facebook como administrador

Para asignar una cuenta de Facebook como administrador de la implementación del plugin de comentarios, incluye el siguiente metaelemento en la sección <head> de todas las páginas web en las que vas a usar el plugin de comentarios:

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

Si deseas añadir 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

fb:comments-count toma el número de comentarios de una URL dada y lo muestra en un elemento <span> de tu página web. Puedes usar CSS para aplicar formato a este elemento <span>, de modo que su aspecto encaje con el resto del sitio web. Nota: Esta función no está disponible en este momento en HTML5.

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

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

Se mostrará:

69391 awesome comments

Con la API Graph puedes acceder al número de comentarios que se han dejado en una URL dada. Por ejemplo, se puede acceder al número de comentarios de example.com mediante la propiedad comment_count del campo share del nodo de URL:

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

Webhooks

Puedes configurar webhooks para que se notifique a un script en tu servidor cuando se publique un nuevo comentario. Para comenzar:

  1. Ve al panel de aplicaciones.
  2. Haz clic en “+ Añadir producto” en la barra 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, introduce la URL del script que recibirá las notificaciones (por ejemplo, https://example.org/mywebhook.php).
  7. Introduce un identificador, que puede ser cualquier cadena que elijas. Se enviará a tu script a efectos de verificación.
  8. El último paso en el proceso de configuración consiste en hacer clic en el botón “Verificar y guardar”.

Antes de hacerlo, consulta la documentación sobre webhooks para obtener información detallada sobre cómo implementar el script.

A continuación incluimos un breve ejemplo del aspecto que puede presentar un archivo mywebhook.php sencillo en PHP.

Empezamos con la verificación:

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

El elemento make-up-a-token es la misma cadena que has introducido antes en el paso 7.

A continuación solo tienes que registrar 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 el elemento $_POST no funcionará en PHP, necesitas file_get_contents('php://input').

Cuando hayas verificado el webhook, verás los elementos “plugin_comment” y “plugin_comment_reply” en la sección “Webhooks” del panel de aplicaciones.

Haz clic en “Probar” para comprobar la implementación con una respuesta de ejemplo. A continuación, haz clic en “Suscribirte” para activar la suscripción.

Consulta la documentación de referencia sobre webhooks para obtener más información sobre la respuesta.