WB Polls
Cree encuestas, deje que visitantes o miembros voten una vez y muestre resultados en vivo en cualquier lugar de su sitio.
Extensión
WB Polls
Cree encuestas, deje que visitantes o miembros voten una vez y muestre resultados en vivo en cualquier lugar de su sitio.
Descripción
WB Polls permite al propietario de un sitio plantear una pregunta y mostrar resultados en vivo en cualquier página de EmDash.
Qué obtiene
- Cree una encuesta con de dos a diez respuestas, de opción única o múltiple.
- Ábrala cuando esté listo, ciérrela cuando deba terminar la votación o establezca una hora de cierre.
- Elija quién puede votar: cualquiera o solo los miembros que hayan iniciado sesión.
- Elija cuándo se muestran los resultados: siempre, tras votar o cuando la encuesta se cierre.
- Elija totales anónimos o resultados con nombre que el propietario del sitio puede ver.
- Asocie una encuesta a una página, a cada entrada de un tipo de contenido o a todo el sitio. Un desarrollador también puede colocar una encuesta concreta por su id.
- Copie una encuesta en un nuevo borrador sin votos.
Cómo encaja todo
El plugin es el motor: almacenamiento, rutas de votación y las pantallas de administración. Un plugin de EmDash no puede añadir páginas, así que la encuesta visible se entrega como un kit de sitio que copia una sola vez. Véase Instalación.
Los invitados pueden votar cuando permite que vote cualquiera y su host da a EmDash la dirección del visitante (Cloudflare, o trustedProxyHeaders). Los miembros votan con su cuenta iniciada. Solo usted crea y gestiona las encuestas.
Instalación
Antes de instalar
1. Su sitio necesita un ejecutor de sandbox. Los plugins del registro se ejecutan en un sandbox. Mientras el sitio no tenga uno, Admin, Plugins muestra «No plugins configured» y no hay Registry en el menú.
- Node: en su sitio, ejecute
npm install @emdash-cms/sandbox-workerd workerdy luego añadasandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",dentro deemdash()enastro.config.mjs. - Cloudflare: añada
import from "@emdash-cms/cloudflare";ysandboxRunner: sandbox(),. Necesita el plan Workers Paid, el enlaceworker_loadersllamadoLOADER(descomente en su configuración de Wrangler) y un bucket R2 comostorage: r2(...), o la instalación se detiene con «Storage error while installing plugin». Luego ejecutenpm run deploy.
Detenga el servidor de desarrollo y vuelva a iniciarlo. Registry aparece ahora en el menú de administración.
2. El plugin es el motor. Las páginas para visitantes provienen de su kit de sitio. Un plugin del registro no puede añadir páginas a su sitio. Hasta que copie el kit, sus direcciones (por ejemplo /account/votes) muestran la página 404 de su sitio. Es lo esperado. La copia del kit que sigue requiere un solo comando.
Comprobado en EmDash 1.3.1 con la plantilla blog, en Node y en Cloudflare Workers (instalación desde el registro).
Instalar
-
Admin, Registry, busque WB Polls, Install y acepte los permisos.
-
Desde la carpeta raíz de su sitio:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.5.0 \ https://github.com/wbcomdesigns/emdash-polls \ "$kit/emdash-polls" && "$kit/emdash-polls/scripts/add-to-site.sh" . -
Pegue las líneas que imprimió. Reinicie el servidor de desarrollo.
-
Añada el enlace de menú que imprimió en Admin, Menus.
-
Abra Polls en la administración.
Tras una actualización, ejecute el paso 2 con la nueva etiqueta.
Guía: https://github.com/wbcomdesigns/emdash-polls/blob/v0.5.0/docs/website/getting-started/install.md
Preguntas frecuentes
Actualicé el plugin y la votación dejó de funcionar.
Vuelva a copiar el kit de sitio. Una instalación desde el registro responde en un id, no en /polls/. El kit actual encuentra ese id.
¿Por qué no hay ninguna encuesta en la página después de crear una? Una encuesta recién creada es un borrador. Abra la encuesta desde la lista. Luego asóciela a una página, a un tipo de contenido o a todo el sitio, y coloque un espacio de encuesta en esa plantilla.
¿Pueden votar los invitados?
Sí, cuando establece Who can vote en Anyone y el host da a EmDash la dirección del visitante: en Cloudflare, o con trustedProxyHeaders establecido en una cabecera que su proxy escribe y reemplaza por sí mismo (detrás de nginx, x-real-ip; nunca un X-Forwarded-For añadido al final). Sin eso, se pide a los invitados que inicien sesión, y la pantalla Polls lo indica. Un voto por visitante. Los miembros con sesión iniciada votan como ellos mismos.
¿Es un problema un 401 en la consola del navegador? No. Un invitado recibe un 401 por encuesta de la comprobación de la papeleta de miembro, y otro en My votes. Así es como la encuesta se entera de que el visitante no ha iniciado sesión. Entonces muestra la vista de invitado.
¿Quién ve los nombres de los votantes? Solo usted, y solo en una encuesta con nombre. Los invitados siguen siendo anónimos. Las encuestas anónimas nunca guardan un nombre.
¿Funciona en modo oscuro? Sí. El kit sigue el ajuste del sistema del visitante.
¿Puedo poner una encuesta en medio de un artículo? No con la instalación desde el registro. Asóciela por encima o por debajo del contenido, o coloque “ en una plantilla. Un bloque dentro del texto necesita una instalación de confianza; esa vía es opcional y no cambia el producto del registro.
¿Hay una versión de pago? No. Todo lo que hay aquí es gratis.
¿Por qué pide leer mi contenido? Para que una encuesta asociada a un borrador siga oculta hasta que publique esa página. WB Polls solo comprueba si una página está publicada y enumera sus tipos de contenido por nombre.
Registro de cambios
0.5.0
Cada página de encuesta, voto y pantalla de administración cabe ahora en el límite de Cloudflare de 10 solicitudes por llamada de plugin.
- Novedad - Cada encuesta mantiene un total acumulado, de modo que los resultados se muestran con una sola lectura en una encuesta de cualquier tamaño.
- Novedad - Results incluye Recount votes, que vuelve a contar una encuesta a partir de los votos guardados.
- Mejora - Al eliminar una encuesta se oculta al instante; sus votos, nombres incluidos, se eliminan al abrir las pantallas de administración.
- Mejora - Las horas de apertura y cierre se leen de las fechas de la encuesta en cada vista.
- Corrección - En Cloudflare, un voto de invitado ya no muestra «Something went wrong» después de haberse guardado.
- Corrección - En Cloudflare, la pantalla Polls, Results, My votes y el panel Poll ya no fallan en un sitio con mucho tráfico.
Una encuesta de una versión anterior se cuenta la primera vez que se abre. Vuelva a copiar el kit después de actualizar, desde la carpeta raíz de su sitio:
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.5.0 \
https://github.com/wbcomdesigns/emdash-polls \
"$kit/emdash-polls" &&
"$kit/emdash-polls/scripts/add-to-site.sh" .
0.4.0
- Novedad: el permiso Read your content, para que una encuesta en una página en borrador siga oculta hasta que la publique.
- Novedad: una tarjeta Set up visitor pages y
scripts/add-to-site.shcopian el kit con un solo comando. - Seguridad: los invitados votan solo donde el host da la dirección del visitante. Dos votos enviados a la vez por un mismo votante cuentan una vez.
0.3.0
- Novedad: estadísticas de las encuestas en la lista, un gráfico de barras de los resultados y un bloque opcional This page’s poll para el texto de las entradas.
Versiones anteriores: https://github.com/wbcomdesigns/emdash-polls/blob/main/CHANGELOG.md