Plugin de comentarios
El plugin de comentarios permite a las personas comentar contenido en tu sitio con su cuenta de Facebook. Las personas pueden optar por compartir la actividad de comentarios con sus amigos (y los amigos de sus amigos) también en Facebook. El plugin de comentarios también incluye herramientas de moderación integradas.
Cambios en los plugins sociales en la región europea
Es posible que observes algún efecto en los plugins sociales debido a un mensaje de consentimiento de cookies actualizado que se mostrará a las personas que utilizan productos de Facebook en la región europea. Ya no admitiremos los plugins sociales “Me gusta” y “Comentar” para los usuarios de la región europea, salvo que hayan 1) iniciado sesión en su cuenta de Facebook y 2) hayan proporcionado su consentimiento para el control de “cookies de aplicaciones y sitios web”. Si se cumplen ambos requisitos, el usuario podrá ver los plugins, como el botón “Me gusta” o “Comentar”, e interactuar con ellos. Si no se cumple alguno de los requisitos anteriores, el usuario no podrá ver los plugins.
La región europea está formada por una lista específica de países, entre los que se incluyen los siguientes:
Unión Europea (UE): Alemania, Austria, Bélgica, Bulgaria, Croacia, Dinamarca, Eslovaquia, Eslovenia, España, Estonia, Finlandia, Francia, Grecia, Hungría, Irlanda, Italia, Letonia, Lituania, Luxemburgo, Malta, Países Bajos, Polonia, Portugal, República de Chipre, República Checa, Rumanía y Suecia.
Países no miembros de la UE, pero del EEE, la AELC o la Unión Aduanera: [EEE/AELC] Islandia, Liechtenstein y Noruega; Suiza: [Unión Aduanera de la UE] todas las islas del Canal, Isla de Man, Mónaco; bases soberanas del Reino Unido en Chipre; [Unión Aduanera Europea] Andorra, Ciudad del Vaticano y San Marino.
- Países que no son miembros de la UE, pero que forman parte de las Regiones Ultraperiféricas Europeas: Azores, Canarias, Guadalupe, Guayana Francesa, Madeira, Martinica, Mayotte, Reunión y San Martín.
- Reino Unido (todas las islas británicas).
Paso a paso
1. Elige una URL o una página
Elige la URL de un sitio web que quieras utilizar con el plugin de comentarios.
2. Configurador de código
Copia y pega la URL en el configurador de código a continuación. Puedes ajustar opciones de configuración, como width del plugin de comentarios o el número de publicaciones que quieres que se muestren de manera 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 código HTML del sitio web o la página web donde quieres implementar comentarios.
Generador de código del plugin de comentarios
Configuración
El configurador de código anterior solo utiliza un subconjunto de todos los ajustes posibles para el plugin de comentarios. También puedes modificar los ajustes siguientes:
| Ajuste | Atributo HTML5 | Descripción | Valor predeterminado |
|---|---|---|---|
|
| Esquema de colores que utilizará el plugin de comentarios. Puede ser “light” o “dark”. | “light” |
|
| 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 los comentarios publicados mediante el plugin de comentarios presentarán un enlace a esta URL. | URL actual. |
|
|
|
|
|
| Valor booleano que especifica si se debe mostrar o no la versión optimizada para móviles. | Auto-detected |
|
| Número de comentarios que deben mostrarse de forma predeterminada. El valor mínimo es 1. | 10 |
|
| Orden en el que deben mostrarse los comentarios. Puede ser "reverse_time" o "time". Los distintos tipos de orden se explican en la sección Ordenación de comentarios. | "reverse-time" |
|
| Ancho del plugin de comentarios en la página web. Puede ser un valor de píxeles o un porcentaje (como 100 %) para el ancho variable. La versión para móviles del plugin de comentarios ignora el parámetro de ancho y, en su lugar, presenta un ancho variable del 100 %. El ancho mínimo que admite el plugin de comentarios es de 320 px. | 550 |
Ordenación de comentarios
Los comentarios pueden ordenarse en función de la hora con el menú de la esquina superior derecha del plugin de comentarios.
Para definir la ordenación predeterminada, utiliza el atributo data-order-by y uno de estos tres valores:
reverse_time (valor predeterminado)
Los comentarios se muestran en el orden inverso al de su publicación: los más recientes arriba y los más antiguos abajo.
time
Los comentarios se muestran en el orden en que se publican: los más antiguos arriba y los más recientes abajo.
Cambiar el idioma
Para cambiar el idioma del plugin de comentarios, carga una versión localizada de Facebook SDK for Javascript. Cuando lo hagas, cambia el valor de src para utilizar tu configuración regional. Por ejemplo, puedes reemplazar en_US por tu configuración regional, como fr_FR para Francés (Francia):
src="https://connect.facebook.net/fr_FR/sdk.js#xfbml=1"
Posiblemente, deberás ajustar el ancho del plugin social para adaptarlo a los distintos idiomas. Obtén más información sobre las tareas de localización y traducción.
Moderación de comentarios
Aparte del plugin de comentarios, existe una potente herramienta de moderación. Esta herramienta permite al equipo de administración de comunidades moderar varios comentarios a la vez de manera fácil y rápida.
Configuración
Para utilizar la herramienta de moderación de comentarios, debes seguir las instrucciones de configuración de la moderación.
Instrucciones de configuración de la moderaciónTen en cuenta que no puedes utilizar la API Graph para responder a comentarios realizados 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: dirígete 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 de ellas. Si no utilizas 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 de la herramienta de moderación junto al cuadro de comentarios (consulta la captura de pantalla siguiente). Esta vista solo muestra los comentarios publicados en esta página web (URL).
Vista de moderación
En la captura de pantalla siguiente se muestran las dos vistas de moderación. Si utilizas la vista de moderación basada en la aplicación, puedes utilizar el menú para cambiar entre aplicaciones.
En la tabla de moderación, puedes aprobar u ocultar los comentarios según 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
2. Vista de moderación basada en la aplicación
3. Cola marcada
Configuración
Puedes personalizar la configuración para cada aplicación. Utiliza el botón Configuración (en la parte superior derecha de la herramienta) para abrir el cuadro de diálogo de configuración.
Moderadores
Puedes promocionar a otras personas para que sean moderadoras de tus comentarios. Comienza a escribir el nombre de un amigo en el cuadro de entrada y selecciona a la persona correspondiente con ayuda de las sugerencias de búsqueda.
Ordenar comentarios por
También puedes controlar cómo se ordenan los comentarios. Obtén información en Ordenación de comentarios.
Moderación
Puedes cambiar la visibilidad predeterminada de los comentarios nuevos. Por ejemplo, puedes aprobar todos los comentarios nuevos. Si un comentario no se aprueba, solo será visible para su autor hasta que un moderador lo apruebe.
Existen tres modos de moderación diferentes:
Público
Todos los comentarios serán públicos. También aparecerá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 este tipo de usuarios. Si un usuario bloqueado publica un comentario nuevo, automáticamente se asignará al comentario visibilidad limitada y se mostrará en la pestaña “Revisión”.
Configuración de URL
Cierre de una conversación
Puedes cerrar un hilo de comentarios en cualquier URL donde utilices el plugin de comentarios. Al hacerlo, las personas no podrán añadir nuevos comentarios a la conversación en esa página web. Puedes cerrar una conversación en 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 hacerlo, dirígete a Configuración de URL y activa Invalidar cierre automático. Después, establece el estado de cierre que quieras para la URL moderada.
Configuración de la moderación
Para utilizar la herramienta de moderación, debes conectar una cuenta de Facebook o una aplicación de Facebook a tu implementación del plugin de comentarios.
Configuración con una cuenta de Facebook (método preferido)
Si tu sitio tiene muchos cuadros de comentarios, te recomendamos que especifiques un identificador de la aplicación de Facebook como entidad de administración, lo que significa que todos los administradores de aplicaciones pueden 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 con el ajuste Moderadores, todos los administradores de tu aplicación también podrán moderar comentarios, pero solo los moderadores recibirán notificaciones de nuevos comentarios si las has habilitado.
Si implementas varios cuadros de comentarios en el 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 cuadros.
Por ejemplo, el cambio de la configuración de moderación a tiene visibilidad limitada afecta a todos los cuadros de comentarios con el mismo identificador de la aplicación. Si necesitas aplicar configuraciones de moderación distintas a diferentes áreas del sitio, deberás utilizar dos o más identificadores de la aplicación. De este modo, puedes aplicar configuraciones de moderación diferentes a los distintos grupos de cuadros de comentarios.
Puedes especificar fb:app_id o fb:admins, pero no ambas opciones.
Asignación de una cuenta de Facebook como administrador
Para asignar una cuenta de Facebook como administradora de una implementación de plugin de comentarios, incluye el metaelemento siguiente en la sección <head> de cada página web donde utilices dicho plugin:
<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
Si se utiliza el valor fb:comments-count, se muestra el número de comentarios en una URL especificada en un elemento <span> en tu página web. A continuación, puedes utilizar CSS para ajustar el estilo de este elemento <span> al 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, utiliza este código:
<span class="fb-comments-count" data-href="https://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, el número de comentarios en example.com está disponible mediante la propiedad comment_count del campo share del nodo URL:
https://graph.facebook.com/v2.4/?fields=share{comment_count}&id=<YOUR_URL>Webhooks
Puedes configurar webhooks para que se envíe una notificación a un script en tu servidor cuando se publique un comentario nuevo. Para empezar:
- Ve al panel de aplicaciones.
- Haz clic en “+ Añadir producto” en la barra de navegación de la izquierda.
- En la sección Webhooks, haz clic en “Configurar”.
- Elige “Aplicación” en el menú desplegable.
- Haz clic en el botón “Suscribirte a este tema”.
- En el cuadro de diálogo, introduce la URL del script que recibirá notificaciones, como
https://example.org/mywebhook.php. - Introduce un identificador, que puede ser cualquier cadena que elijas. Se enviará a tu script para verificarse.
- El último paso en el proceso de configuración consiste en hacer clic en el botón “Verificar y guardar”.
Antes de hacerlo, echa un vistazo a la documentación de Webhooks para obtener información completa sobre la implementación del script.
Aquí tienes un ejemplo rápido del aspecto que puede tener un elemento mywebhook.php simple 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 introducida en el paso 7 anterior.
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 método $_POST de PHP no funcionará; necesitas file_get_contents('php://input').
Cuando verifiques el Webhook, verás "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.
Existen más detalles disponibles sobre la respuesta en la documentación de Referencia de Webhooks.