Añada debates vinculados al contenido a WordPress y sitios estáticos

Los debates de Flow añaden un árbol de comentarios respaldado por el backend sin usar la base de datos de comentarios de WordPress. Funcionan en páginas normales de WordPress y en páginas exportadas por Static Publisher porque el navegador lee y escriba los datos del debate mediante el backend de Flow.

Un debate consta de dos bloques coordinados:

• el Formulario de Flow recopila comentarios raíz y respuestas y contiene la política autoritativa del backend;
• el bloque Debate de Flow enumera los elementos públicos y muestra las acciones de respuesta, edición y eliminación cuando el visitante actual tiene permiso.

Deben coincidir el ID de formulario, el destino del contenido y el canal del debate.

Añadir debates a todas las entradas​

Para un tipo de contenido, añade los bloques Formulario y Debate a su plantilla Individual en lugar de copiarlos en el cuerpo de cada entrada. Establezca como origen de destino Contenido actual de WordPress. En tiempo de ejecución, Flow identifica cada entrada de esta forma:

wordpress / <post type> / <numeric post ID>

Así, cada entrada recibe un hilo independiente y las entradas nuevas heredan automáticamente la misma presentación y política.

Guarde la plantilla o el origen del formulario y confirme que la Sincronización con el backend se complete correctamente antes de probar el frontend.

Configurar el Formulario de Flow​

Abra Vinculación de contenido y debate en el bloque Formulario y active Debate. Flow exigirá entonces la conservación permanente de los envíos, la vinculación de contenido y un destino de contenido obligatorio.

Configure la política del backend en el Formulario:

• Permitir respuestas: desactívalo si quiere comentarios raíz sin respuestas.
• Profundidad máxima de respuesta: de 1 a 5. Los comentarios raíz tienen profundidad 0, por lo que 1 permite un nivel de respuestas directas.
• Moderación: publicar automáticamente o retener los elementos nuevos para moderarlos.
• Acceso a comentarios: anónimo, inicio de sesión opcional o inicio de sesión obligatorio.
• Grupos de Cognito permitidos: limite opcionalmente las modificaciones a miembros de cualquiera de los grupos indicados.
• Origen del nombre público del autor: un campo del formulario o atributos verificados de Cognito.
• Campo de cuerpo público: el campo de texto que se expone como cuerpo del comentario.
• Campo de valoración del debate: elija opcionalmente un campo Valoración para las valoraciones de comentarios raíz y la agregación del debate. Las respuestas no contienen valoraciones.
• Ventana opcional de edición por el autor, eliminación por el autor y eliminación por el moderador.

La definición del Formulario es la fuente de verdad del backend. Mantenga alineados los ajustes de acceso y grupos del bloque Debate para que sus acciones del frontend representen fielmente esa política.

Configurar el bloque Debate​

ID de formulario​

El ID de formulario selecciona el formulario sincronizado con el backend. Si se deja vacío, el renderizador de WordPress intenta usar el ID sincronizado almacenado para el contenido actual. Use un valor explícito cuando un patrón o plantilla reutilizable no pueda heredar los metadatos correctos del formulario.

Origen de destino​

El Formulario debe enviar el mismo destino que lee el bloque Debate. Una discrepancia de destino suele aparecer como un debate válido pero vacío.

Canal del debate​

El canal conecta los eventos del navegador entre las instancias de Formulario y Debate de la página. Determina qué formulario se abre para responder y qué lista se actualiza después de un envío. Los canales vacíos se derivan del ID de formulario y del destino.

Un canal no es una clave de partición del backend. Cambiar solo el canal no crea un segundo hilo para el mismo ID de formulario y destino de contenido.

Acceso y grupos de Cognito​

• Visitantes anónimos: no se requiere identidad para las modificaciones.
• Visitantes o usuarios con sesión iniciada: se aceptan visitantes anónimos cuando no hay ninguna restricción de grupo; los visitantes con sesión iniciada reciben capacidades de propietario.
• Solo usuarios con sesión iniciada: las modificaciones para comentar, responder, editar y eliminar requieren un token de acceso de Cognito verificado según corresponda.

Los nombres de los grupos son exactos y distinguen entre mayúsculas y minúsculas; basta con coincidir con uno de los grupos indicados. Con autenticación opcional y una lista de grupos no vacía, solo pueden comentar los miembros autenticados de esos grupos.

La lectura del debate es una política independiente. La solicitud GET pública normal no valida ningún token por el mero hecho de que haya uno disponible. La autenticación solo se usa para enriquecer opcionalmente las capacidades o proteger modificaciones.

Paginación y vistas previas​

• Tamaño de página raíz controla los comentarios raíz obtenidos por página: 1–50, valor predeterminado 20.
• Tamaño de página de respuestas controla las respuestas directas obtenidas para el padre seleccionado: 1–50, valor predeterminado 10.
• Número de vistas previas de respuestas incluye entre 0 y 5 respuestas directas con cada raíz cargada inicialmente; 0 desactiva solo las vistas previas.

El recuento del encabezado se basa en las raíces cargadas y en sus totales de descendientes proporcionados por el backend. Si existe otra página raíz, Flow añade +, por lo que todavía no es un total exacto de todo el debate.

Valoraciones y filtros​

Seleccione un Campo de valoración del debate en el Formulario para publicar valoraciones con los comentarios raíz. Flow usa el número de estrellas y el ajuste de fracciones del bloque Valoración seleccionado, por lo que admite pasos de estrellas enteras, medias y tercios sin redondeo. Mientras el Formulario responde, oculta ese campo; el backend también impide que las respuestas proporcionen valoraciones.

El bloque Debate puede mostrar un resumen global con:

• el número de comentarios raíz valorados visibles actualmente;
• su media derivada;
• el recuento y el porcentaje de cada intervalo de valoración permitido.

También puede permitir que los visitantes muestren todos los comentarios raíz, una valoración exacta, valoraciones iguales o superiores a un valor elegido o valoraciones iguales o inferiores a él. El filtro solo se aplica a las raíces, mientras que las respuestas siguen asociadas a su padre. El resumen siempre describe el debate completo, no solo la página filtrada. Los autores pueden ocultar el resumen o el filtro y configurar el filtro inicial en el inspector.

El backend almacena recuentos por intervalos en lugar de una media redondeada. La publicación, moderación, ocultación o marcado como spam, republicación, edición de la valoración por el propietario, eliminación y purga de privacidad actualizan esos recuentos en la misma transacción que el cambio de estado del comentario. La media y los porcentajes se calculan al leer el debate.

Etiquetas y fechas​

El inspector puede anular el título; los textos de carga, vacío, error y reintento; las etiquetas del autor y del marcador de eliminación; las etiquetas de respuesta y paginación; las etiquetas de recuento; y los textos de confirmación de edición y eliminación. Las etiquetas de recuento admiten el marcador {count}. En los demás casos, Flow usa sus cadenas localizadas de AWS Amplify I18n y el idioma del almacén de Flow.

Las fechas se pueden ocultar o mostrar con formatos completo, largo, medio o corto. El navegador las formatea con la configuración regional seleccionada y su zona horaria local.

Requisitos del sitio estático​

Una página de debate exportada sigue necesitando:

• los recursos del frontend de Flow y la configuración codificada de los bloques;
• una URL accesible del backend de Flow;
• el origen exportado permitido en la configuración del backend y de CORS;
• un ID de formulario y una referencia de contenido estables.

No se requiere ningún punto de conexión de comentarios de WordPress. La lectura pública y las modificaciones autenticadas siguen separadas, lo que permite que una página estática muestre todos los comentarios públicos y exija el inicio de sesión con Cognito para añadirlos o gestionarlos.

Límites actuales​

• La profundidad de respuestas tiene un máximo de cinco.
• Desactive Permitir respuestas para no admitir respuestas; una profundidad máxima de 1 sigue permitiendo un nivel de respuestas.
• Actualmente, el inspector no expone controles para la dirección de ordenación ni la profundidad inicial de respuestas.
• Considere inmutables el número de estrellas y el ajuste de fracciones del campo de valoración seleccionado una vez publicadas las valoraciones. Los intervalos existentes requieren una conciliación explícita antes de cambiar esa configuración.
• Las respuestas públicas incluyen la política no confidencial de respuestas del Formulario. Por tanto, el frontend aplica los mismos límites de allowReplies y profundidad máxima a visitantes anónimos y autenticados.

Resolución de problemas​

1. Verifique el estado de sincronización del Formulario con el backend y el ID de formulario resuelto.
2. Compara el origen de destino del Formulario y del Debate y la referencia de contenido resuelta.
3. Alinea el canal, el acceso a comentarios y los grupos de Cognito.
4. Trata los errores de lectura pública de forma independiente a los errores de permiso para comentar.
5. Compruebe el estado de moderación de los comentarios enviados correctamente que no aparezcan.
6. En páginas exportadas, verifique los recursos de Flow, la URL del backend, el origen permitido y la estabilidad de la URL canónica.