Listora
モデレーション付きのローカルディレクトリ:検索、地図、10 種類のリスティング、会員の投稿、レビュー、所有権の申請、ダッシュボード。
プラグイン
Listora
モデレーション付きのローカルディレクトリ:検索、地図、10 種類のリスティング、会員の投稿、レビュー、所有権の申請、ダッシュボード。
説明
Listora は EmDash サイトをローカルディレクトリに変えます。訪問者は検索し、地図上でリスティングを閲覧できます。会員はリスティングを追加し、レビューを書き、お気に入りを保存し、自分のビジネスの所有権を申請できます。すべてのコンテンツは、公開前に管理画面であなたが承認します。
主な機能
- ディレクトリと検索。 キーワードと場所の検索、タイプ・カテゴリ・都市によるフィルター、グリッド表示とリスト表示、注目の行、地図。
- 10 種類のリスティングタイプ。 ビジネスやレストランから、イベント、求人、不動産まで。それぞれに独自のフィールドと schema.org のタイプがあります。
- 会員による投稿。 重複チェック、禁止語リスト、1 時間あたりの上限を備えた 5 ステップのフォーム。
- レビューと所有権の申請。 会員ごとにリスティング 1 件につきレビューは 1 件で、オーナーは自分のビジネスの所有権を申請できます。どちらも承認待ちになります。
- オーナー向けツール。 オーナーはリスティングの編集、写真の追加、訪問者からのメッセージの閲覧、レビューへの返信、期限が近づいたリスティングの更新ができます。編集、写真、返信はあなたの承認待ちになります。
- 写真と有効期限。 各リスティングにギャラリーがあり、リスティングが公開され続ける日数をオプションで設定できます。
- インポートとエクスポート。 リスティングをスプレッドシートとしてダウンロードするか、CSV ファイルから一度に 100 件まで下書きとして追加できます。
- 管理画面でのモデレーション。 待機中のすべてのものを入れるキュー、その件数を表示するダッシュボードカード、Settings ページ。
全体の仕組み
Listora はエンジンです。ルート、ストレージ、管理画面を担います。EmDash プラグインはサイトにページを追加できないため、公開ページはキットとして提供され、1 つのコマンドでコピーされます。開発者に 10 分ほどの時間を見込んでください。「インストール」を参照してください。
ゲストはリスティングを閲覧してメッセージを送れます。追加、レビュー、保存、所有権の申請にはアカウントが必要です。
要求する権限
- コンテンツ(読み取り、書き込み、公開)とコンテンツタイプ(読み取り):リスティングはサイト上のコンテンツです。
- カテゴリ(読み取り、割り当て):フォームにはあなた自身のカテゴリが表示されます。
- メディア(追加):オーナーの写真。
- メール(送信):メッセージが待機しているときやリスティングの期限が近づいたときに、オーナーへ送る短い通知。訪問者の文章はメールで送信されず、各通知はオフにできます。
インストール
インストールの前に
1. サイトにはサンドボックスランナーが必要です。 レジストリのプラグインはサンドボックスで実行されます。サイトにサンドボックスランナーがない間は、Admin、Plugins に「No plugins configured」と表示され、メニューに Registry もありません。
- Node: サイトで
npm install @emdash-cms/sandbox-workerd workerdを実行し、astro.config.mjsのemdash()の中にsandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",を追加します。 - Cloudflare:まだ非対応です。 Cloudflare Workers では、EmDash はプラグインの呼び出しごとにサイトへの 10 件のリクエストを許可しますが、このプラグインのいくつかのページと操作はそれ以上を必要とするため失敗します。対応するリリースを準備中です。Node のサイトには影響しません。
開発サーバーを停止して再度起動します。管理メニューに Registry が表示されるようになります。
2. プラグインはエンジンです。訪問者向けのページは、そのサイトキットから提供されます。 レジストリのプラグインはサイトにページを追加できません。キットをコピーするまでは、そのアドレス(たとえば /listings/)にはサイトの 404 ページが表示されます。これは想定どおりです。下のキットのコピーは 1 つのコマンドで済みます。
3. Node 22.16 以降が必要です。 npx emdash seed のステップのために必要です。
Node 上の blog テンプレートを使い、EmDash 1.3.1 で確認しています。
インストール手順
-
Admin、Registry で Listora を検索し、Install して、権限を承認します。
-
サイトのルートフォルダーで次を実行します。
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" . -
表示された seed コマンドを実行します。開発サーバーを再起動します。
-
Admin、Menus で、表示されたメニューのリンクを追加します。
-
Listora を開き、Get started を選びます。
更新のたびに、新しいタグを指定して手順 2 を再実行してください。
完全なガイド:https://github.com/wbcomdesigns/emdash-listora/blob/v0.6.3/docs/website/getting-started/install.md
よくある質問
インストール後に /listings/ が 404 になるのはなぜですか?
EmDash プラグインはページを作成できません。「インストール」にあるセットアップコマンドを実行してサイトにページを追加し、再読み込みしてください。
ゲストはリスティングやレビューを追加できますか? いいえ。ゲストは閲覧と、リスティングへのメッセージ送信ができます。リスティングの追加、レビュー、保存、所有権の申請にはログイン済みのアカウントが必要です。これによりスパムが減り、すべてのリスティングにオーナーが付きます。
新しいリスティングはすぐに公開されますか? Settings で承認をオフにした場合のみです。オンの場合(既定)、リスティングはあなたが承認するまでキューで待機します。オーナーによる編集、写真、レビューへの返信は、常にあなたの承認待ちになります。
ダークモードで動作しますか? はい。キットの色はサイトのテーマに従います。
メールを送信しますか? サイトにメールが設定されている場合、リスティングのオーナーへ短い通知を 2 種類送ります。メッセージが待機していることと、リスティングが 7 日後に期限切れになることです。どちらにも訪問者の文章は含まれず、それぞれ Settings でオフにできます。メールがなくても、オーナーは自分のアカウントですべてを確認できます。
有料版はありますか? いいえ。ここにあるものはすべて無料です。
ブログ記事の中にリスティングを表示できますか?
はい。1 つ追加の手順が必要です。キットには、記事やページの本文用の Listings ブロックが含まれており、astro.config.mjs で有効にします。追加する行はインストールガイドに記載されています。
スプレッドシートからリスティングを移行できますか?
はい。サイト管理者は /listings/import/ で CSV ファイルをインポートできます。行は最初にチェックされ、下書きとして取り込まれ、1 ファイルにつき最大 100 件です。
変更履歴
0.6.3
更新後に、サイトのルートフォルダーでもう一度キットをコピーしてください。
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" .
- 修正:途中で中断された承認は、リスティングまたは写真をキューに戻します。More reviews の上にレビューフォームとの余白を追加しました。壊れたレビューのリンクにはシンプルなメッセージを表示します。
- 改善:アカウントのタブがスマートフォンで折り返されます。レビューが 10 件を超えると、アカウントに全件数が表示されます。新しいサイトでは、Settings に /listings/import/ が示されます。
0.6.2
更新後にもう一度キットをコピーしてください。
- 新機能:Get started に、インストール済みバージョン用のキットのコマンドと、それが追加する訪問者向けアドレスが表示されます。
- 修正:大規模なサイトで一覧が 100 行で止まらなくなりました。キュー内のサンプルのリスティングを承認できます。古い 2 回目の判断は拒否されます。空のディレクトリはそう表示されます。ダークモードのボタンのコントラストが 4.5:1 を満たします。
- セキュリティ:新しいリスティングは各フィールドの保存を上限付きにします。公開のヘルスチェックは何も書き込みません。
- 改善:管理画面のグループ名を Listora に、レビューのページ名を Listing reviews にしました。
0.6.1
- セキュリティ:地図のポップアップはリスティングのタイトルをプレーンテキストで表示します。メールはプレーンなアドレスとしてのみ保存されます。更新後にもう一度キットをコピーしてください。
- 修正:更新と編集は、リスティングの現在のオーナーに従います。
0.6.0
- セキュリティ:ウェブサイトのリンクは完全な http または https のアドレスである必要があります。サーバー側の呼び出しは、ウェブリクエストなしで EmDash 内部で実行されます。
- 改善:設定がタブ化され、すべての管理リストに Find と Load more が付き、訪問者向けの文言がすべて 1 つのファイルにまとまりました。更新後にもう一度キットをコピーしてください。
以前のバージョン:https://github.com/wbcomdesigns/emdash-listora/blob/main/CHANGELOG.md