Listora
Un annuaire local modéré : recherche, carte, 10 types de fiches, contributions des membres, avis, revendications et tableau de bord.
Extension
Listora
Un annuaire local modéré : recherche, carte, 10 types de fiches, contributions des membres, avis, revendications et tableau de bord.
Description
Listora transforme un site EmDash en annuaire local. Les visiteurs recherchent et parcourent les fiches sur une carte. Les membres ajoutent des fiches, rédigent des avis, enregistrent leurs favoris et revendiquent un établissement. Vous approuvez tout dans l’administration avant la mise en ligne.
Ce que vous obtenez
- Annuaire et recherche. Recherche par mot-clé et par lieu, filtres par type, catégorie et ville, vues en grille et en liste, une rangée de fiches à la une et une carte.
- 10 types de fiches. De l’entreprise et du restaurant à l’événement, à l’offre d’emploi et à l’immobilier, chacun avec ses propres champs et son type schema.org.
- Contributions des membres. Un formulaire en cinq étapes avec vérification des doublons, liste de mots interdits et limite horaire.
- Avis et revendications. Un avis par membre et par fiche, et un propriétaire peut revendiquer son établissement. Les deux attendent d’être approuvés.
- Outils pour les propriétaires. Les propriétaires modifient leur fiche, ajoutent des photos, lisent les messages des visiteurs, répondent aux avis et renouvellent une fiche qui arrive à échéance. Les modifications, photos et réponses attendent votre approbation.
- Photos et expiration. Une galerie sur chaque fiche, et un nombre de jours facultatif pendant lequel une fiche reste en ligne.
- Import et export. Téléchargez les fiches sous forme de tableur, ou ajoutez-les depuis un fichier CSV sous forme de brouillons, 100 à la fois.
- Modération dans l’administration. Des files pour tout ce qui attend, une carte de tableau de bord qui les compte et une page Settings.
Comment tout s’articule
Listora est le moteur : routes, stockage et écrans d’administration. Un plugin EmDash ne peut pas ajouter de pages à un site ; les pages publiques sont donc fournies sous forme de kit qu’une seule commande copie. Prévoyez dix minutes pour un développeur. Voir Installation.
Les invités parcourent les fiches et leur envoient des messages. Ajouter, évaluer, enregistrer et revendiquer nécessitent un compte.
Autorisations demandées
- Contenu (lire, écrire, publier) et types de contenu (lire) : les fiches sont du contenu de votre site.
- Catégories (lire, attribuer) : le formulaire propose vos propres catégories.
- Médias (ajouter) : les photos des propriétaires.
- E-mail (envoyer) : un bref avis à un propriétaire lorsque des messages attendent ou qu’une fiche est sur le point d’expirer. Aucun texte de visiteur n’est envoyé par e-mail, et chaque avis peut être désactivé.
Installation
Avant d’installer
1. Votre site a besoin d’un exécuteur de bac à sable. Les plugins du registre s’exécutent dans un bac à sable. Tant que le site n’en a pas, Admin, Plugins affiche « No plugins configured » et il n’y a pas de Registry dans le menu.
- Node : dans votre site, exécutez
npm install @emdash-cms/sandbox-workerd workerd, puis ajoutezsandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",dansemdash()au sein deastro.config.mjs. - Cloudflare : pas encore pris en charge. Sur Cloudflare Workers, EmDash accorde à chaque appel de plugin 10 requêtes vers le site, et plusieurs pages et actions de ce plugin en nécessitent davantage, elles échouent donc. Une version adaptée est en cours. Les sites Node ne sont pas concernés.
Arrêtez le serveur de développement et relancez-le. Registry apparaît désormais dans le menu d’administration.
2. Le plugin est le moteur. Les pages visiteurs viennent de son kit de site. Un plugin du registre ne peut pas ajouter de pages à votre site. Tant que vous n’avez pas copié le kit, ses adresses (par exemple /listings/) affichent la page 404 de votre site. C’est normal. La copie du kit ci-dessous tient en une commande.
3. Il vous faut Node 22.16 ou ultérieur pour l’étape npx emdash seed.
Vérifié sur EmDash 1.3.1 avec le modèle blog sur Node.
Installer
-
Admin, Registry, recherchez Listora, Install, puis acceptez les autorisations.
-
Depuis le dossier racine de votre site :
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" . -
Exécutez la commande seed affichée. Redémarrez le serveur de développement.
-
Ajoutez les liens de menu affichés dans Admin, Menus.
-
Ouvrez Listora, Get started.
Après chaque mise à jour, relancez l’étape 2 avec la nouvelle étiquette.
Guide complet : https://github.com/wbcomdesigns/emdash-listora/blob/v0.6.3/docs/website/getting-started/install.md
FAQ
Pourquoi /listings/ renvoie-t-il une 404 après l’installation ?
Un plugin EmDash ne peut pas créer de pages. Exécutez la commande de configuration de la section Installation pour les ajouter à votre site, puis rechargez.
Les invités peuvent-ils ajouter des fiches ou des avis ? Non. Les invités parcourent et peuvent envoyer un message à une fiche. Ajouter une fiche, évaluer, enregistrer et revendiquer nécessitent un compte connecté, ce qui limite le spam et donne un propriétaire à chaque fiche.
Les nouvelles fiches sont-elles mises en ligne tout de suite ? Seulement si vous désactivez l’approbation dans Settings. Avec l’approbation activée, ce qui est le réglage par défaut, une fiche attend dans la file jusqu’à ce que vous l’approuviez. Les modifications, photos et réponses aux avis des propriétaires attendent toujours votre approbation.
Fonctionne-t-il en mode sombre ? Oui. Les couleurs du kit suivent le thème de votre site.
Envoie-t-il des e-mails ? Deux brefs avis aux propriétaires de fiches, si votre site a un e-mail configuré : des messages attendent, et votre fiche expire dans sept jours. Aucun ne contient de texte de visiteur, et chacun peut être désactivé dans Settings. Sans e-mail, les propriétaires voient quand même tout dans leur compte.
Existe-t-il une version payante ? Non. Tout ce qui est ici est gratuit.
Puis-je afficher des fiches dans un article de blog ?
Oui, avec une étape de plus. Le kit comprend un bloc Listings pour le texte des articles et des pages, que vous activez dans astro.config.mjs. Le guide d’installation indique les lignes à ajouter.
Puis-je importer des fiches depuis un tableur ?
Oui. Un administrateur du site peut importer un fichier CSV à l’adresse /listings/import/. Les lignes sont d’abord vérifiées et arrivent sous forme de brouillons, jusqu’à 100 par fichier.
Journal des modifications
0.6.3
Copiez à nouveau le kit après la mise à jour, depuis le dossier racine de votre site :
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" .
- Correctif : une approbation interrompue en cours de route remet la fiche ou la photo dans la file ; More reviews a un espace au-dessus du formulaire d’avis ; un lien d’avis endommagé affiche un message simple.
- Amélioration : les onglets du compte passent à la ligne sur téléphone ; le compte indique le nombre total d’avis au-delà de 10 ; Settings mentionne /listings/import/ sur un site neuf.
0.6.2
Copiez à nouveau le kit après la mise à jour.
- Nouveau : Get started donne la commande du kit pour la version installée et les adresses visiteurs qu’il ajoute.
- Correctif : les listes ne s’arrêtent plus à 100 lignes sur un grand site ; les fiches d’exemple dans la file peuvent être approuvées ; une seconde décision périmée est refusée ; un annuaire vide l’indique ; les boutons du mode sombre atteignent 4,5:1.
- Sécurité : une nouvelle fiche stocke chaque champ avec une taille plafonnée ; le contrôle d’état public n’écrit rien.
- Amélioration : le groupe d’administration s’appelle Listora, la page des avis s’appelle Listing reviews.
0.6.1
- Sécurité : les fenêtres contextuelles de la carte affichent les titres des fiches en texte brut ; les e-mails ne sont stockés que sous forme d’adresses simples. Copiez à nouveau le kit après la mise à jour.
- Correctif : le renouvellement et la modification suivent le propriétaire actuel de la fiche.
0.6.0
- Sécurité : les liens de site web doivent être une adresse http ou https complète ; les appels côté serveur s’exécutent à l’intérieur d’EmDash, sans requête web.
- Amélioration : réglages en onglets, Find et Load more sur chaque liste d’administration, tous les textes destinés aux visiteurs dans un seul fichier. Copiez à nouveau le kit après la mise à jour.
Versions antérieures : https://github.com/wbcomdesigns/emdash-listora/blob/main/CHANGELOG.md