Listora
Un directorio local moderado: búsqueda, mapa, 10 tipos de fichas, envíos de miembros, reseñas, reclamaciones y un panel.
Extensión
Listora
Un directorio local moderado: búsqueda, mapa, 10 tipos de fichas, envíos de miembros, reseñas, reclamaciones y un panel.
Descripción
Listora convierte un sitio EmDash en un directorio local. Los visitantes buscan y exploran fichas en un mapa. Los miembros añaden fichas, escriben reseñas, guardan favoritos y reclaman un negocio. Usted aprueba todo en la administración antes de que salga en vivo.
Qué obtiene
- Directorio y búsqueda. Búsqueda por palabra clave y ubicación, filtros por tipo, categoría y ciudad, vistas de cuadrícula y de lista, una fila destacada y un mapa.
- 10 tipos de fichas. Desde negocio y restaurante hasta evento, empleo e inmueble, cada uno con sus propios campos y su propio tipo de schema.org.
- Envíos de miembros. Un formulario de cinco pasos con comprobación de duplicados, lista de palabras bloqueadas y límite por hora.
- Reseñas y reclamaciones. Una reseña por miembro y por ficha, y un propietario puede reclamar su negocio. Ambas esperan aprobación.
- Herramientas para propietarios. Los propietarios editan su ficha, añaden fotos, leen los mensajes de los visitantes, responden a las reseñas y renuevan una ficha que está a punto de caducar. Las ediciones, fotos y respuestas esperan su aprobación.
- Fotos y caducidad. Una galería en cada ficha y un número opcional de días que una ficha permanece en vivo.
- Importación y exportación. Descargue las fichas como hoja de cálculo o añádalas desde un archivo CSV como borradores, de 100 en 100.
- Moderación en la administración. Colas para todo lo que espera, una tarjeta del panel que lo cuenta y una página de Settings.
Cómo encaja todo
Listora es el motor: rutas, almacenamiento y las pantallas de administración. Un plugin de EmDash no puede añadir páginas a un sitio, así que las páginas públicas se entregan como un kit que un solo comando copia. Calcule diez minutos para un desarrollador. Véase Instalación.
Los invitados exploran y envían mensajes a una ficha. Añadir, reseñar, guardar y reclamar requieren una cuenta.
Permisos que solicita
- Contenido (leer, escribir, publicar) y tipos de contenido (leer): las fichas son contenido de su sitio.
- Categorías (leer, asignar): el formulario ofrece sus propias categorías.
- Medios (añadir): las fotos de los propietarios.
- Correo electrónico (enviar): un breve aviso a un propietario cuando hay mensajes esperando o una ficha está a punto de caducar. No se envía por correo ningún texto de visitantes, y cada aviso puede desactivarse.
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ún no es compatible. En Cloudflare Workers, EmDash concede a cada llamada de plugin 10 solicitudes al sitio, y varias páginas y acciones de este plugin necesitan más, por lo que fallan. Hay una versión que se ajusta en curso. Los sitios Node no se ven afectados.
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 /listings/) muestran la página 404 de su sitio. Es lo esperado. La copia del kit que sigue requiere un solo comando.
3. Necesita Node 22.16 o posterior para el paso npx emdash seed.
Comprobado en EmDash 1.3.1 con la plantilla blog en Node.
Instalar
-
Admin, Registry, busque Listora, Install y acepte los permisos.
-
Desde la carpeta raíz de su sitio:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.6.3 \ https://github.com/wbcomdesigns/emdash-listora \ "$kit/emdash-listora" && "$kit/emdash-listora/scripts/add-to-site.sh" . -
Ejecute el comando seed que se muestra. Reinicie el servidor de desarrollo.
-
Añada los enlaces de menú que se muestran en Admin, Menus.
-
Abra Listora, Get started.
Tras cada actualización, repita el paso 2 con la nueva etiqueta.
Guía completa: https://github.com/wbcomdesigns/emdash-listora/blob/v0.6.3/docs/website/getting-started/install.md
Preguntas frecuentes
¿Por qué /listings/ da un 404 tras la instalación?
Un plugin de EmDash no puede crear páginas. Ejecute el comando de configuración de la Instalación para añadirlas a su sitio y luego recargue.
¿Pueden los invitados añadir fichas o reseñas? No. Los invitados exploran y pueden enviar un mensaje a una ficha. Añadir una ficha, reseñar, guardar y reclamar requieren una cuenta con sesión iniciada, lo que reduce el spam y da a cada ficha un propietario.
¿Las fichas nuevas salen en vivo de inmediato? Solo si desactiva la aprobación en Settings. Con la aprobación activada, que es lo predeterminado, una ficha espera en la cola hasta que usted la apruebe. Las ediciones, fotos y respuestas a reseñas de los propietarios siempre esperan su aprobación.
¿Funciona en modo oscuro? Sí. Los colores del kit siguen el tema de su sitio.
¿Envía correo electrónico? Dos breves avisos a los propietarios de fichas, si su sitio tiene el correo configurado: hay mensajes esperando y su ficha caduca en siete días. Ninguno contiene texto de visitantes, y cada uno puede desactivarse en Settings. Sin correo, los propietarios siguen viéndolo todo en su cuenta.
¿Hay una versión de pago? No. Todo lo que hay aquí es gratis.
¿Puedo mostrar fichas dentro de una entrada del blog?
Sí, con un paso más. El kit incluye un bloque Listings para el texto de entradas y páginas, que se activa en astro.config.mjs. La guía de instalación indica las líneas que hay que añadir.
¿Puedo traer fichas desde una hoja de cálculo?
Sí. Un administrador del sitio puede importar un archivo CSV en /listings/import/. Las filas se comprueban primero y llegan como borradores, hasta 100 por archivo.
Registro de cambios
0.6.3
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.6.3 \
https://github.com/wbcomdesigns/emdash-listora \
"$kit/emdash-listora" &&
"$kit/emdash-listora/scripts/add-to-site.sh" .
- Corrección: una aprobación interrumpida a medias devuelve la ficha o la foto a la cola; More reviews tiene espacio sobre el formulario de reseña; un enlace de reseñas dañado muestra un mensaje sencillo.
- Mejora: las pestañas de la cuenta se ajustan en el teléfono; la cuenta indica el número completo de reseñas a partir de 10; Settings menciona /listings/import/ en un sitio nuevo.
0.6.2
Vuelva a copiar el kit después de actualizar.
- Novedad: Get started da el comando del kit para la versión instalada y las direcciones para visitantes que añade.
- Corrección: las listas ya no se detienen en 100 filas en un sitio grande; las fichas de ejemplo en la cola se pueden aprobar; se rechaza una segunda decisión obsoleta; un directorio vacío lo indica; los botones del modo oscuro alcanzan 4,5:1.
- Seguridad: una ficha nueva almacena cada campo con longitud limitada; la comprobación de estado pública no escribe nada.
- Mejora: el grupo de administración se llama Listora, la página de reseñas se llama Listing reviews.
0.6.1
- Seguridad: las ventanas emergentes del mapa muestran los títulos de las fichas como texto sin formato; los correos se almacenan solo como direcciones sin formato. Vuelva a copiar el kit después de actualizar.
- Corrección: renovar y editar siguen al propietario actual de la ficha.
0.6.0
- Seguridad: los enlaces a sitios web deben ser una dirección http o https completa; las llamadas del lado del servidor se ejecutan dentro de EmDash sin solicitud web.
- Mejora: ajustes en pestañas, Find y Load more en cada lista de administración, todo el texto para visitantes en un único archivo. Vuelva a copiar el kit después de actualizar.
Versiones anteriores: https://github.com/wbcomdesigns/emdash-listora/blob/main/CHANGELOG.md