Propcore catalog
Projekte, Einheiten und Live-Verfügbarkeit aus Ihrem Propcore-Workspace, für Ihre EmDash-Website.
Erweiterung
Propcore catalog
Projekte, Einheiten und Live-Verfügbarkeit aus Ihrem Propcore-Workspace, für Ihre EmDash-Website.
Beschreibung
Ihre Propcore-Projekte, Einheiten und die Live-Verfügbarkeit, direkt in einer EmDash-Website. Installieren Sie aus der EmDash-Registry, geben Sie Ihren Propcore-Site-Slug und den Quellschlüssel ein, und Ihre Seiten können den Katalog über drei Routen lesen. projects liefert bis zu 100 Projekte. units liefert 100 Einheiten pro Seite; übergeben Sie cursor= für die nächste Seite. availability stellt pro Aufruf eine Live-Anfrage an Propcore und funktioniert nur für Projekte, die synchronisiert wurden. Die Synchronisierung liest den gesamten Katalog in einer Anfrage; sie wurde mit 119 Einheiten getestet, größere Kataloge sind geplant.
Routen
GET /_emdash/api/plugins/propcore/projects GET /_emdash/api/plugins/propcore/units?project= GET /_emdash/api/plugins/propcore/availability?project= (live)
Die Antworten sind “. Die Felder sind genau das, was Propcore zurückgibt (snake_case).
Installation
- Gehen Sie in Propcore Admin zu Storefronts, dann New, dann AI Source. Wählen Sie die freizugebenden Views aus, erstellen Sie sie und kopieren Sie den Site-Slug und den Quellschlüssel aus der Seitenleiste. Der Slug ist der Teil vor
.propcore.page. Eine Website unter einer Workspace-Subdomain hat einen Slug mit Punkt, zum Beispielastra-demo.demofürastra-demo.demo.propcore.page. - Gehen Sie in der EmDash-Administration zu Plugins, dann Registry. Installieren Sie Propcore catalog und genehmigen Sie die Berechtigung (Netzwerkzugriff auf
*.propcore.page). - Öffnen Sie Propcore in der Seitenleiste der Administration, geben Sie den Slug und den Schlüssel ein, Save, dann Sync now. Danach synchronisiert das Plugin stündlich.
FAQ
Wird der Schlüssel offengelegt? Nein. Er wird verschlüsselt gespeichert, nur an Ihre Propcore-Website gesendet und nie von einer Route zurückgegeben.
Eine Einheit ist in Propcore verschwunden, steht aber noch auf meiner Website. Die stündliche Synchronisierung fügt Einheiten hinzu und aktualisiert sie. In Propcore entfernte Einheiten werden noch nicht aus dem Cache der Website gelöscht; das ist geplant.
Welcher Propcore-Tarif? Jeder Workspace mit Storefronts.
Unterscheidet sich „Sync now“ von der stündlichen Synchronisierung? Nein, es führt dieselbe Synchronisierung sofort aus.
Fehlerbehebung
Speichern schlägt fehl, oder der Schlüssel wird nicht gespeichert. Die Website benötigt die Umgebungsvariable EMDASH_ENCRYPTION_KEY (Format emdash_enc_v1_...), um geheime Einstellungen zu speichern. Setzen Sie sie in der Umgebung der Website. Mit astro dev wird eine .env-Datei nicht in den Prozess geladen, exportieren Sie sie daher zuerst: set -a; . ./.env; set +a; pnpm dev.
Das Sandbox-Plugin startet nicht. Sandbox-Plugins laufen auf dem Paket workerd. Erlauben Sie mit pnpm dessen Build-Skript (allowBuilds: ) und installieren Sie es.
Eine lokale Installation mit pnpm add file: ist veraltet. file: kopiert das Plugin, statt es zu verlinken. Fügen Sie es nach jedem Build erneut hinzu.
Der Status zeigt 401 .... Der Quellschlüssel wurde rotiert oder widerrufen. Fügen Sie den neuen Schlüssel ein und Save.
Welchen Slug gebe ich ein? Den Teil vor .propcore.page, zum Beispiel astra-demo.demo. Eine eingefügte Adresse wird für Sie gekürzt.