Propcore catalog
Projets, unités et disponibilité en direct depuis votre espace de travail Propcore, pour votre site EmDash.
Extension
Propcore catalog
Projets, unités et disponibilité en direct depuis votre espace de travail Propcore, pour votre site EmDash.
Description
Vos projets Propcore, vos unités et leur disponibilité en direct, au sein d’un site EmDash. Installez depuis le registre EmDash, saisissez le slug de votre site Propcore et la clé de source, et vos pages peuvent lire le catalogue via trois routes. projects renvoie jusqu’à 100 projets. units renvoie 100 unités par page ; passez cursor= pour la page suivante. availability effectue une requête en direct vers Propcore à chaque appel et ne fonctionne que pour les projets qui ont été synchronisés. La synchronisation lit tout le catalogue en une seule requête ; elle a été testée avec 119 unités, et des catalogues plus grands sont prévus.
Routes
GET /_emdash/api/plugins/propcore/projects GET /_emdash/api/plugins/propcore/units?project= GET /_emdash/api/plugins/propcore/availability?project= (live)
Les réponses sont “. Les champs sont exactement ceux que renvoie Propcore (snake_case).
Installation
- Dans Propcore Admin, allez dans Storefronts, puis New, puis AI Source. Choisissez les Views à exposer, créez-la, puis copiez le slug du site et la clé de source depuis le panneau latéral. Le slug est la partie avant
.propcore.page. Un site sous un sous-domaine d’espace de travail a un slug avec un point, par exempleastra-demo.demopourastra-demo.demo.propcore.page. - Dans l’administration d’EmDash, allez dans Plugins, puis Registry. Installez Propcore catalog et approuvez la capacité (accès réseau à
*.propcore.page). - Ouvrez Propcore dans la barre latérale de l’administration, saisissez le slug et la clé, Save, puis Sync now. Le plugin se synchronise ensuite toutes les heures.
FAQ
La clé est-elle exposée ? Non. Elle est stockée chiffrée, envoyée uniquement à votre site Propcore et jamais renvoyée par une route.
Une unité a disparu de Propcore mais est toujours sur mon site. La synchronisation horaire ajoute et met à jour des unités. Les unités supprimées dans Propcore ne sont pas encore supprimées du cache du site ; c’est prévu.
Quelle offre Propcore ? Tout espace de travail avec des storefronts.
« Sync now » diffère-t-il de la synchronisation horaire ? Non, il exécute la même synchronisation immédiatement.
Dépannage
L’enregistrement échoue, ou la clé n’est pas stockée. Le site a besoin de la variable d’environnement EMDASH_ENCRYPTION_KEY (format emdash_enc_v1_...) pour stocker les paramètres secrets. Définissez-la dans l’environnement du site. Avec astro dev, un fichier .env n’est pas chargé dans le processus, donc exportez-le d’abord : set -a; . ./.env; set +a; pnpm dev.
Le plugin en bac à sable ne démarre pas. Les plugins en bac à sable s’exécutent sur le paquet workerd. Avec pnpm, autorisez son script de build (allowBuilds: ) et installez-le.
Une installation locale pnpm add file: est obsolète. file: copie le plugin au lieu de le lier. Ajoutez-le à nouveau après chaque build.
Le statut affiche 401 .... La clé de source a été renouvelée ou révoquée. Collez la nouvelle clé et Save.
Quel slug dois-je saisir ? La partie avant .propcore.page, par exemple astra-demo.demo. Une adresse collée est raccourcie pour vous.