WebBlocks Polls

Cree encuestas multilingües de selección única o múltiple, colóquelas en su sitio con el bloque nativo Poll y consulte los resultados agregados. Esta guía documenta Polls 0.1.4.

Utilice PHP 8.3 o posterior y WebBlocks CMS ^1.92.1. Descargue el ZIP compatible desde la página de Polls en el catálogo. Instálelo en Sistema → Plugins, actívelo y compruebe que la configuración de la base de datos haya terminado correctamente. Abra Encuestas y seleccione el sitio al que pertenecerá la encuesta.

Elija Añadir encuesta e indique un nombre interno y un identificador estable, por ejemplo next-workshop. Los bloques guardan ese identificador; evite cambiarlo después de colocar la encuesta. Escriba la pregunta y al menos dos opciones no vacías. Una encuesta admite hasta veinte filas de opciones.

Seleccione Selección única para permitir una opción por votante o Selección múltiple para permitir varias. Mantenga pregunta, descripción opcional y etiquetas de opciones para cada idioma publicado. El plugin incluye traducciones de administración y votación para los seis idiomas del CMS; la pregunta y las opciones son contenido propio.

Por ejemplo, una encuesta sobre talleres podría preguntar «¿Qué taller deberíamos organizar a continuación?» con Fotografía, Cerámica e Ilustración. Guárdela como Borrador mientras revisa el texto y las traducciones.

La encuesta tiene tres estados: Borrador, Publicada y Cerrada. Los valores opcionales Inicio y Fin limitan el período de votación. Publique la encuesta cuando esté lista y revise el horario antes de invitar a votar.

En el constructor de páginas, añada el bloque nativo Poll del plugin y seleccione la encuesta de ese sitio. El identificador del tipo de bloque es webblocks-polls::poll; los bloques creados por API guardan el identificador estable de la encuesta en plugin_settings.poll. Previsualice la página, confirme pregunta y opciones y siga el proceso normal de publicación. Publicar una encuesta no publica la página que contiene su bloque.

Configure Mostrar resultados según la experiencia deseada:

• Siempre (always): muestra resultados agregados en lugar del formulario de votación.
• Después de votar (after_vote): muestra resultados cuando el visitante ha votado.
• Después del cierre (after_close): muestra resultados cuando la encuesta no está abierta.
• Nunca (never): no muestra resultados públicamente.

Estos ajustes controlan la visibilidad pública. Los operadores autorizados pueden seguir consultando resultados y exportando datos agregados en CSV. Ver encuestas, Administrar encuestas y Exportar resultados son permisos independientes del plugin.

En 0.1.4, Después del cierre utiliza el cálculo actual de apertura/cierre. También puede mostrar resultados de un borrador o de una encuesta cuya fecha de inicio aún no haya llegado. No coloque borradores en páginas publicadas; use Después de votar o Nunca al preparar una encuesta programada cuyos resultados deban permanecer ocultos antes de abrirse.

La votación utiliza protección CSRF, límites de frecuencia por ruta y una huella seudónima HMAC del votante. El plugin no guarda direcciones IP de visitantes en bruto. La protección contra votos repetidos es una barrera práctica; cambiar de sesión o red puede permitir otro voto. Utilice otro procedimiento de verificación cuando necesite un único voto verificado por persona.

El plugin habilitado añade sus rutas al descubrimiento del CMS y OpenAPI:

• GET /webadmin/api/polls y GET /webadmin/api/polls/{poll} requieren polls.read.
• POST /webadmin/api/polls y PATCH /webadmin/api/polls/{poll} requieren polls.write.
• GET /webadmin/api/polls/{poll}/results requiere polls.read.

Envíe el contexto de sitio autorizado y el idioma con la pregunta y las etiquetas traducidas. Consulte el contrato de datos de la versión instalada mediante descubrimiento. Las API de administración requieren autenticación por token y no sustituyen el flujo público de votación protegido contra CSRF.

Si el bloque no muestra la encuesta esperada, compruebe el identificador seleccionado, sitio propietario, activación del plugin, estado de publicación y horario. Si los resultados están ocultos, revise Mostrar resultados antes de modificar la encuesta. Si falla el guardado, compruebe que al menos dos opciones tengan etiqueta y que el fin sea posterior al inicio.

Vuelva a la descripción general de plugins, consulte la versión del catálogo o utilice la referencia de la Internal Content API.