Plugin de comentarios
El plugin de comentarios permite que las personas hagan comentarios en el contenido de tu sitio con sus cuentas de Facebook. Las personas pueden optar por compartir sus comentarios con amigos (y 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 veas cambios en los plugins sociales debido a la actualización de la solicitud de consentimiento para cookies, que se mostrará a las personas que usen productos de Facebook en la región europea. Dejaremos de ofrecer compatibilidad con los plugins sociales “Me gusta” y “Comentar” para usuarios de la región europea, a menos que 1) las sesiones de sus cuentas de Facebook se hayan iniciado y 2) hayan aceptado el control de las “cookies de apps y sitios web”. Si se cumplen estos requisitos, el usuario podrá ver plugins como los botones “Me gusta” o “Comentar” e interactuar con ellos. Si alguno de los requisitos anteriores no se cumple, el usuario no podrá ver los plugins.
La región europea está compuesta por una lista específica de países, entre los que se incluyen los siguientes:
La 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 Checa, República de Chipre, Rumania y Suecia.
Países que no son miembros de la UE, pero pertenecen al Espacio Económico Europeo (EEE) exclusivamente, la Asociación Europea de Libre Comercio (AELC) u otra unión aduanera: [EEE exclusivamente/AELC] Islandia, Liechtenstein y Noruega; Suiza; [Unión aduanera de la UE] todas las islas del Canal, isla de Man, Mónaco; Bases Soberanas Británicas en Chipre; [Unión aduanera de la UE] Andorra, San Marino, Ciudad del Vaticano.
- Países que no son miembros de la UE, pero son parte de las regiones ultraperiféricas de la UE (RUP):Martinica, Mayotte, Guadalupe, Guayana Francesa, Reunión, San Martín, Madeira, Las Azores, Islas Canarias.
- Reino Unido (todas las islas británicas)
Paso a paso
1. Elegir una URL o 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 la cantidad publicaciones que 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ódigo del plugin de comentarios
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 |
|---|---|---|---|
|
| El esquema de colores que usará el plugin de comentarios. Puede ser "light" o "dark". | "light" |
|
| 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. |
|
|
|
|
|
| Un valor booleano que especifica si se debe mostrar o no la versión optimizada para celulares. | Detectado automáticamente |
|
| El número de comentarios que deben mostrarse de forma predeterminada. El valor mínimo es 1. | 10 |
|
| El orden en el que deben mostrarse los comentarios. Puede ser "reverse_time" o "time". Para obtener información sobre los distintos tipos de órdenes aplicables, consulta la sección Ordenar los comentarios. | "reverse-time" |
|
| 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 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 valores:
reverse_time (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 del SDK de Facebook para JavaScript. Cuando lo hagas, cambia el valor de src para usar la configuración regional. Por ejemplo, puedes reemplazar en_US por tu configuración regional, como fr_FR para usar el francés (Francia):
src="https://connect.facebook.net/fr_FR/sdk.js#xfbml=1"
Quizá debas ajustar el ancho del plugin social para adaptarlo a diferentes 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. Esta herramienta le permite a tu equipo de administración de la comunidad moderar simultáneamente varios comentarios de manera fácil y rápida.
Configuración
Para usar 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 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 app: ve a developers.facebook.com/tools/comments. Obtendrás una lista con todas tus apps de Facebook que te permitirá moderar todos los comentarios asociados con cada app. Si no usas ninguna app 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 app, puedes cambiar entre las distintas apps con el menú.
En la tabla de moderación, puedes aprobar u ocultar comentarios según 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
2. Vista de moderación basada en la app
3. Lista de comentarios marcados
Configuración
Puedes personalizar la configuración para cada app. 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. 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 la forma en que 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. Solo los autores de los comentarios pueden verlos y estos últimos permanecen en ese estado hasta que un moderador los aprueba.
Existen tres modos de moderación diferentes:
Público
Todos los comentarios serán públicos. 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 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”.
Configuración de la URL
Cerrar un hilo
Puedes cerrar un hilo 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 un hilo, utiliza el menú “Configuración” de la URL.
Anular el cierre automático
Si activaste el cierre automático, puedes anular el cierre de una cadena, a fin de que esté disponible para realizar comentarios. Para hacerlo, ve a la configuración de la URL y activa Anular 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 app de Facebook a la implementación del plugin de comentarios.
Configuración con una app de Facebook (recomendado)
Si tu sitio cuenta con varios cuadros de comentarios, te recomendamos especificar un identificador de la app de Facebook como entidad de administración (todos los administradores de la app 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 app.
<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 app podrán también moderar los comentarios, pero solo los moderadores recibirán notificaciones de los nuevos comentarios si las activaste.
Si implementas varios cuadros de comentarios en tu sitio y los conectas a una app especificando un identificador de esta, 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 bajo el mismo identificador de la app. 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 app. 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 uses 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 web. Nota: Esta función no está disponible en HTML5.
Por ejemplo, para mostrar el número de comentarios en example.com, utiliza el siguiente código:
<span class="fb-comments-count" data-href="https://example.com/"></span> awesome comments
Con esto, 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 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 un script en tu servidor reciba una notificación cuando se publique un nuevo comentario. Para empezar:
- Ve al panel de apps.
- Haz clic en “+ Agregar producto” en el menú de navegación de la izquierda.
- En la sección “Webhooks”, haz clic en “Configurar”.
- Elige “App” en el menú desplegable.
- Haz clic en el botón “Suscribirte a este tema”.
- En el cuadro de diálogo, ingresa la URL del script que recibirá las notificaciones; por ejemplo,
https://example.org/mywebhook.php. - Ingresa un token (cualquier cadena que elijas). Este se enviará a tu script para su verificación.
- 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 de un mywebhook.php simple 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á. En su lugar, deberás usar 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 apps.
Haz clic en “Probar” para verificar la implementación con un ejemplo de respuesta y, luego, en “Suscribirse” para hacer la activación.
Obtendrás más información sobre la respuesta en la documentación de referencia de Webhooks.