Propcore catalog
Propcore ワークスペースのプロジェクト、ユニット、リアルタイムの空き状況を、EmDash サイトで利用できます。
プラグイン
Propcore catalog
Propcore ワークスペースのプロジェクト、ユニット、リアルタイムの空き状況を、EmDash サイトで利用できます。
説明
Propcore のプロジェクト、ユニット、リアルタイムの空き状況を、EmDash サイトの中で扱えます。EmDash レジストリからインストールし、Propcore のサイトスラッグとソースキーを入力すると、ページから 3 つのルートを通じてカタログを読み取れます。projects は最大 100 件のプロジェクトを返します。units は 1 ページあたり 100 件のユニットを返し、次のページには cursor= を渡します。availability は呼び出しごとに Propcore へリアルタイムのリクエストを 1 回行い、同期済みのプロジェクトでのみ機能します。同期はカタログ全体を 1 回のリクエストで読み取ります。119 ユニットでテスト済みで、より大きなカタログへの対応は計画中です。
ルート
GET /_emdash/api/plugins/propcore/projects GET /_emdash/api/plugins/propcore/units?project= GET /_emdash/api/plugins/propcore/availability?project= (live)
レスポンスは “ です。フィールドは Propcore が返すものそのまま（snake_case）です。
インストール
- Propcore Admin で Storefronts、New の順に進み、AI Source を選びます。公開する Views を選んで作成し、ドロワーからサイトスラッグとソースキーをコピーします。スラッグは
.propcore.pageの前の部分です。ワークスペースのサブドメイン配下のサイトでは、スラッグにドットが含まれます。たとえばastra-demo.demo.propcore.pageの場合はastra-demo.demoです。 - EmDash 管理画面で Plugins、続いて Registry に進みます。Propcore catalog をインストールし、その権限（
*.propcore.pageへのネットワークアクセス）を承認します。 - 管理画面のサイドバーで Propcore を開き、スラッグとキーを入力して Save し、Sync now をクリックします。その後、プラグインは 1 時間ごとに同期します。
よくある質問
キーは公開されますか？ いいえ。暗号化されて保存され、Propcore のサイトにのみ送信され、ルートから返されることはありません。
ユニットが Propcore から消えたのに、サイトにはまだ残っています。 1 時間ごとの同期は、ユニットの追加と更新を行います。Propcore で削除されたユニットは、まだサイトのキャッシュから削除されません。これは計画中です。
どの Propcore プランが必要ですか？ storefronts のある任意のワークスペースです。
“Sync now” は 1 時間ごとの同期と違いますか？ いいえ。同じ同期を直ちに実行します。
トラブルシューティング
保存に失敗する、またはキーが保存されない。 秘密の設定を保存するには、サイトに EMDASH_ENCRYPTION_KEY 環境変数（形式は emdash_enc_v1_...）が必要です。サイトの環境に設定してください。astro dev では .env ファイルがプロセスに読み込まれないため、先にエクスポートしてください：set -a; . ./.env; set +a; pnpm dev。
サンドボックス化されたプラグインが起動しない。 サンドボックス化されたプラグインは workerd パッケージ上で動作します。pnpm では、そのビルドスクリプトを許可し（allowBuilds: ）、インストールしてください。
ローカルの pnpm add file: によるインストールが古くなっている。 file: はプラグインをリンクせずにコピーします。ビルドのたびに再度追加してください。
ステータスに 401 ... と表示される。 ソースキーがローテーションまたは失効されました。新しいキーを貼り付けて Save してください。
どのスラッグを入力しますか？ .propcore.page の前の部分です。たとえば astra-demo.demo です。貼り付けたアドレスは自動的に短縮されます。