WB Reviews
Valoraciones con estrellas y reseñas moderadas para artículos y páginas.
Extensión
WB Reviews
Valoraciones con estrellas y reseñas moderadas para artículos y páginas.
Descripción
WB Reviews añade valoraciones con estrellas y reseñas moderadas a artículos y páginas. Los visitantes leen la media, el desglose de estrellas y las reseñas escritas. Los miembros o los invitados dejan una reseña por página. Usted aprueba lo que se publica.
Qué obtiene
- Valoraciones en cualquier contenido. Marque por nombre los tipos de contenido propios de su sitio. Nada está ligado a las entradas.
- Reseñas escritas y solo estrellas. El texto es opcional. Una valoración solo con estrellas cuenta en la media y no aparece en la lista.
- Miembros o cualquiera. Los invitados indican un nombre (y un correo si usted lo pide). Las reseñas de invitados siempre esperan aprobación. Una reseña por visitante.
- Moderación. Páginas En espera y Publicadas, búsqueda por texto y eliminación de las reseñas de un invitado por correo.
- Respuesta del propietario. Una respuesta pública bajo una reseña, escrita en la administración.
- Motores de búsqueda. La valoración se añade a la página como datos estructurados.
- Una tarjeta del panel para lo que está en espera, más un correo por hora opcional sin texto de reseña y sin enlace.
Cómo encaja todo
El plugin es el motor: rutas, almacenamiento y las pantallas de administración. Un plugin de EmDash no puede añadir páginas a su sitio, así que las pantallas públicas se entregan como un kit de sitio que copia una sola vez. Véase Instalación.
Las reseñas no son los comentarios del núcleo. Los comentarios siguen para la conversación. Este plugin añade una valoración, una entrada por persona, una media, un desglose en barras y una respuesta del propietario.
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 { sandbox } 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/reviews/) 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 Reviews, Install y acepte los permisos.
-
Desde la carpeta raíz de su sitio:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.3.0 \ https://github.com/wbcomdesigns/emdash-reviews \ "$kit/emdash-reviews" && "$kit/emdash-reviews/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 Reviews, Waiting.
Tras cada actualización, ejecute el paso 2 con la nueva etiqueta.
Guía: https://github.com/wbcomdesigns/emdash-reviews/blob/v0.3.0/docs/website/getting-started/install.md
Preguntas frecuentes
¿Por qué no hay bloque de reseñas tras la instalación? El plugin no puede añadir páginas ni CSS. Copie los componentes del kit de sitio en sus plantillas y vuelva a cargar.
¿Por qué no hay formulario de reseña en una página? Ese tipo de contenido no está marcado en Admin → Reviews → Settings. Márquelo, o el formulario seguirá oculto.
¿Pueden los invitados escribir una reseña? Sí, cuando Settings indica que cualquiera puede reseñar. Un invitado indica un nombre, y un correo si usted lo pide. Las reseñas de invitados siempre esperan aprobación.
¿Las reseñas nuevas se publican al instante? Solo las de los miembros, y solo si desactiva la aprobación. Con ella activada, que es lo predeterminado, una reseña espera hasta que usted la apruebe. Un cambio en una reseña publicada también espera; el texto publicado permanece hasta que apruebe el cambio.
¿Qué es una valoración solo con estrellas? Estrellas sin texto. Cuenta en la media y en las barras, y no aparece en la lista de reseñas escritas.
¿Envía correo electrónico? Como máximo un aviso breve por hora cuando hay reseñas en espera, y solo si usted lo activa y el sitio tiene correo (el plugin oficial Resend). El aviso no incluye texto de reseña ni enlace.
¿Hay una versión de pago? No. Todo lo que hay aquí es gratis.
Registro de cambios
0.3.0
- Mejora: cada página, acción de administración y solicitud de visitante cabe en el límite de Cloudflare de 10 solicitudes por llamada de plugin. Los recuentos cambian con cada reseña en lugar de volver a leer todas las reseñas de la página.
- Mejora: las páginas En espera y Publicadas se dividen por fecha; Find busca unos cientos de reseñas por pulsación. Delete all my reviews y la eliminación por correo funcionan por pasos.
- Corrección: las reseñas enviadas en el mismo instante se cuentan cada una una vez. Las valoraciones que perdió la 0.2.0 se reconstruyen.
- Tras actualizar, abra Reviews en la administración: traslada los datos de la 0.2 en unos pocos pasos mientras usted sigue moderando. Sin permiso nuevo.
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.3.0 \
https://github.com/wbcomdesigns/emdash-reviews \
"$kit/emdash-reviews" &&
"$kit/emdash-reviews/scripts/add-to-site.sh" .
0.2.2
- Corrección: volver a ejecutar scripts/add-to-site.sh en un sitio cuya página de entrada y cuya tarjeta de entrada ya muestran WB Reviews indica que las líneas ya están en su sitio.
0.2.1
- Seguridad: los invitados reseñan solo donde el host pasa la dirección del visitante (Cloudflare o trustedProxyHeaders); en otros casos inician sesión. IPv6 se cuenta por /64.
- Novedad: Waiting muestra Set up visitor pages. scripts/add-to-site.sh copia el kit e imprime las líneas que hay que pegar.
- Corrección: las reseñas en espera ya no ocultan las publicadas ni rompen la valoración; las páginas no publicadas no muestran nada.
Versiones anteriores: https://github.com/wbcomdesigns/emdash-reviews/blob/main/CHANGELOG.md