Listora
Ein moderiertes lokales Verzeichnis: Suche, Karte, 10 Eintragstypen, Beiträge von Mitgliedern, Bewertungen, Inhaberansprüche und ein Dashboard.
Erweiterung
Listora
Ein moderiertes lokales Verzeichnis: Suche, Karte, 10 Eintragstypen, Beiträge von Mitgliedern, Bewertungen, Inhaberansprüche und ein Dashboard.
Beschreibung
Listora macht aus einer EmDash-Website ein lokales Verzeichnis. Besucher suchen und durchstöbern Einträge auf einer Karte. Mitglieder fügen Einträge hinzu, schreiben Bewertungen, speichern Favoriten und beanspruchen ein Unternehmen. Sie genehmigen alles im Admin, bevor es live geht.
Was Sie bekommen
- Verzeichnis und Suche. Stichwort- und Ortssuche, Filter nach Typ, Kategorie und Stadt, Raster- und Listenansicht, eine Reihe hervorgehobener Einträge und eine Karte.
- 10 Eintragstypen. Von Unternehmen und Restaurant bis zu Veranstaltung, Stelle und Immobilie, jeder mit eigenen Feldern und einem eigenen schema.org-Typ.
- Beiträge von Mitgliedern. Ein fünfstufiges Formular mit Duplikatprüfung, Liste gesperrter Wörter und Stundenlimit.
- Bewertungen und Inhaberansprüche. Eine Bewertung pro Mitglied und Eintrag, und ein Inhaber kann sein Unternehmen beanspruchen. Beides wartet auf Genehmigung.
- Werkzeuge für Inhaber. Inhaber bearbeiten ihren Eintrag, fügen Fotos hinzu, lesen Nachrichten von Besuchern, antworten auf Bewertungen und verlängern einen auslaufenden Eintrag. Änderungen, Fotos und Antworten warten auf Ihre Genehmigung.
- Fotos und Ablauf. Eine Galerie bei jedem Eintrag und eine optionale Anzahl von Tagen, die ein Eintrag live bleibt.
- Import und Export. Laden Sie Einträge als Tabelle herunter oder fügen Sie sie aus einer CSV-Datei als Entwürfe hinzu, jeweils 100 auf einmal.
- Moderation im Admin. Warteschlangen für alles, was wartet, eine Dashboard-Karte, die es zählt, und eine Seite Settings.
Wie alles zusammenpasst
Listora ist der Motor: Routen, Speicher und die Admin-Bildschirme. Ein EmDash-Plugin kann einer Website keine Seiten hinzufügen, daher werden die öffentlichen Seiten als Kit geliefert, das ein einziger Befehl hineinkopiert. Planen Sie zehn Minuten für einen Entwickler ein. Siehe Installation.
Gäste durchstöbern Einträge und schreiben Nachrichten an sie. Hinzufügen, Bewerten, Speichern und Beanspruchen erfordern ein Konto.
Angeforderte Berechtigungen
- Inhalte (lesen, schreiben, veröffentlichen) und Inhaltstypen (lesen): Einträge sind Inhalte Ihrer Website.
- Kategorien (lesen, zuweisen): Das Formular bietet Ihre eigenen Kategorien an.
- Medien (hinzufügen): Fotos der Inhaber.
- E-Mail (senden): eine kurze Mitteilung an einen Inhaber, wenn Nachrichten warten oder ein Eintrag bald ausläuft. Es wird kein Besuchertext per E-Mail gesendet, und jede Mitteilung lässt sich abschalten.
Installation
Vor der Installation
1. Ihre Website braucht einen Sandbox-Runner. Registry-Plugins laufen in einer Sandbox. Solange die Website keinen hat, zeigt Admin, Plugins „No plugins configured“ an, und im Menü gibt es kein Registry.
- Node: Führen Sie in Ihrer Website
npm install @emdash-cms/sandbox-workerd workerdaus und fügen Sie dannsandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",innerhalb vonemdash()inastro.config.mjshinzu. - Cloudflare: noch nicht unterstützt. Auf Cloudflare Workers gibt EmDash jedem Plugin-Aufruf 10 Anfragen an die Website, und mehrere Seiten und Aktionen dieses Plugins brauchen mehr, weshalb sie fehlschlagen. Eine passende Version ist in Arbeit. Node-Websites sind nicht betroffen.
Beenden Sie den Entwicklungsserver und starten Sie ihn neu. Registry erscheint jetzt im Admin-Menü.
2. Das Plugin ist der Motor. Die Besucherseiten stammen aus seinem Website-Kit. Ein Registry-Plugin kann Ihrer Website keine Seiten hinzufügen. Bis Sie das Kit kopieren, zeigen seine Adressen (zum Beispiel /listings/) die 404-Seite Ihrer Website. Das ist zu erwarten. Das Kopieren des Kits unten braucht einen Befehl.
3. Sie benötigen Node 22.16 oder neuer für den Schritt npx emdash seed.
Geprüft mit EmDash 1.3.1 und der Vorlage blog auf Node.
Installieren
-
Admin, Registry, suchen Sie Listora, Install, und akzeptieren Sie dann die Berechtigungen.
-
Aus dem Stammordner Ihrer Website:
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" . -
Führen Sie den ausgegebenen Seed-Befehl aus. Starten Sie den Entwicklungsserver neu.
-
Fügen Sie die ausgegebenen Menülinks unter Admin, Menus hinzu.
-
Öffnen Sie Listora, Get started.
Wiederholen Sie nach jedem Update Schritt 2 mit dem neuen Tag.
Vollständige Anleitung: https://github.com/wbcomdesigns/emdash-listora/blob/v0.6.3/docs/website/getting-started/install.md
FAQ
Warum ist /listings/ nach der Installation eine 404?
Ein EmDash-Plugin kann keine Seiten erstellen. Führen Sie den Einrichtungsbefehl aus der Installation aus, um sie Ihrer Website hinzuzufügen, und laden Sie dann neu.
Können Gäste Einträge oder Bewertungen hinzufügen? Nein. Gäste durchstöbern und können einem Eintrag eine Nachricht schreiben. Das Hinzufügen eines Eintrags, Bewerten, Speichern und Beanspruchen erfordert ein angemeldetes Konto, was Spam reduziert und jedem Eintrag einen Inhaber gibt.
Gehen neue Einträge sofort live? Nur, wenn Sie die Genehmigung in Settings abschalten. Bei aktivierter Genehmigung, dem Standard, wartet ein Eintrag in der Warteschlange, bis Sie ihn genehmigen. Änderungen, Fotos und Antworten auf Bewertungen von Inhabern warten immer auf Sie.
Funktioniert es im Dunkelmodus? Ja. Die Farben des Kits folgen dem Theme Ihrer Website.
Sendet es E-Mails? Zwei kurze Mitteilungen an Inhaber von Einträgen, wenn Ihre Website E-Mail eingerichtet hat: Nachrichten warten, und Ihr Eintrag läuft in sieben Tagen ab. Keine enthält Besuchertext, und jede lässt sich in Settings abschalten. Ohne E-Mail sehen Inhaber trotzdem alles in ihrem Konto.
Gibt es eine kostenpflichtige Version? Nein. Alles hier ist kostenlos.
Kann ich Einträge in einem Blogbeitrag anzeigen?
Ja, mit einem zusätzlichen Schritt. Das Kit enthält einen Listings-Block für Beitrags- und Seitentext, den Sie in astro.config.mjs einschalten. Die Installationsanleitung nennt die hinzuzufügenden Zeilen.
Kann ich Einträge aus einer Tabelle übernehmen?
Ja. Ein Website-Administrator kann unter /listings/import/ eine CSV-Datei importieren. Die Zeilen werden zuerst geprüft und kommen als Entwürfe an, bis zu 100 pro Datei.
Änderungsprotokoll
0.6.3
Kopieren Sie das Kit nach dem Update erneut, aus dem Stammordner Ihrer Website:
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" .
- Fehlerbehebung: Eine auf halbem Weg abgebrochene Genehmigung legt den Eintrag oder das Foto zurück in die Warteschlange; More reviews hat Abstand über dem Bewertungsformular; ein beschädigter Bewertungslink zeigt eine einfache Meldung.
- Verbesserung: Konto-Tabs brechen auf dem Smartphone um; das Konto nennt die vollständige Bewertungsanzahl über 10; Settings nennt /listings/import/ auf einer frischen Website.
0.6.2
Kopieren Sie das Kit nach dem Update erneut.
- Neu: Get started nennt den Kit-Befehl für die installierte Version und die Besucheradressen, die er hinzufügt.
- Fehlerbehebung: Listen enden auf einer großen Website nicht mehr bei 100 Zeilen; Beispieleinträge in der Warteschlange lassen sich genehmigen; eine veraltete zweite Entscheidung wird abgelehnt; ein leeres Verzeichnis sagt das; Schaltflächen im Dunkelmodus erreichen 4,5:1.
- Sicherheit: Ein neuer Eintrag speichert jedes Feld mit begrenzter Länge; der öffentliche Gesundheitscheck schreibt nichts.
- Verbesserung: Die Admin-Gruppe heißt Listora, die Bewertungsseite Listing reviews.
0.6.1
- Sicherheit: Karten-Popups zeigen Eintragstitel als einfachen Text; E-Mail-Adressen werden nur als einfache Adressen gespeichert. Kopieren Sie das Kit nach dem Update erneut.
- Fehlerbehebung: Verlängern und Bearbeiten folgen dem aktuellen Inhaber des Eintrags.
0.6.0
- Sicherheit: Website-Links müssen eine vollständige http- oder https-Adresse sein; serverseitige Aufrufe laufen innerhalb von EmDash ohne Web-Anfrage.
- Verbesserung: Einstellungen in Tabs, Find und Load more in jeder Admin-Liste, alle Besuchertexte in einer Datei. Kopieren Sie das Kit nach dem Update erneut.
Ältere Versionen: https://github.com/wbcomdesigns/emdash-listora/blob/main/CHANGELOG.md