動的コンテンツを使うと、プロジェクト、チームメンバー、イベント、リリース、WooCommerce で販売しない商品など、独自のコンテンツタイプ、タクソノミー、フィールドをコードなしで WordPress に追加できます。Vendix フィールド の動的タグでフィールドを Elementor に表示し、ARN Listing ウィジェットでレコードをカード、リスト、タブ、スライダーとして一覧表示します。
場所: ARN Vendix → スマート機能 → 動的コンテンツ でモジュールを有効にし、ARN Vendix → コンテンツ の タイプ、タクソノミー、フィールドグループ、インポート / エクスポート の各タブで作業します。動的コンテンツは Vendix Pro (Vendix 3.0.0 以降) の機能で、デフォルトではオフになっており、その画面にはオプションを管理する権限が必要です。Vendix Free には動的コンテンツはありません。
モジュールを有効にする
- ARN Vendix → スマート機能 を開き、動的コンテンツ タブを選択します。
- 動的コンテンツを有効化 をオンにし、Vendix 設定を保存 をクリックします。
- Vendix → コンテンツを開く をクリックします。
モジュールがオフの間は何も読み込まれず、コンテンツタイプも登録されません。レコードはデータベースに残り、モジュールを再びオンにすると元に戻ります。
コンテンツタイプを追加する
- ARN Vendix → コンテンツ → タイプ で コンテンツタイプを追加 をクリックします。
- 複数形の名前、単数形の名前、キー を入力します。キーには小文字の英字、数字、- と _ を使い、最大 20 文字です。レコードはキーの下に保存されるため、後から変更できません。
- アドレスのベース、メニューアイコン、管理メニューに表示 を確認します。
- 動作を設定し (表を参照)、タイプを保存 をクリックします。管理メニューにそのタイプ専用のレコード一覧が追加されます。
| 設定 | 内容 | 初期値 |
|---|---|---|
| アドレスのベース | レコードのアドレスの最初の部分 (例: /projects/record-name/) | キー (_ を - に置き換えたもの) |
| 管理メニューに表示 | 独自のメニュー項目、または別のコンテンツタイプの下 | 独自のメニュー項目 |
| ページ | 各レコードに個別ページを持たせる と アーカイブページ (全レコードの一覧) | 個別ページはオン、アーカイブはオフ |
| エディターのサポート | タイトル、コンテンツエディター、アイキャッチ画像、抜粋、ページ順、リビジョン | ページ順以外すべて |
| Elementor | レコードを Elementor で編集可能にする | オン |
| REST API | ブロックエディターと REST API で利用可能にする | オン |
| Schema タイプ | CreativeWork、SoftwareApplication、商品 (WooCommerce 以外)、イベント、組織、Person (プロパティはレコードとそのフィールドから入力) | なし |
| 有効 | 有効: Vendix がこのコンテンツタイプを登録しています | オン |
タイプの編集画面には、そのフィールドグループと、シングルページおよびアーカイブページをデザインする Vendix Templates も表示されます。Vendix Templates で投稿・ページ・アーカイブのテンプレートをデザインする を参照してください。
タクソノミーを追加する
- タクソノミー で タクソノミーを追加 をクリックします。
- 複数形の名前、単数形の名前、キー を入力します (キーは後から変更できません)。
- 種類 として 階層あり (カテゴリーのように) (デフォルト) または 階層なし (タグのように) を選び、所属する コンテンツタイプ にチェックを入れます。
- 各タームにレコードの個別ページを持たせる と レコード一覧にタームを列として表示 (どちらもデフォルトでオン) をそのままにするかオフにして、タクソノミーを保存 をクリックします。
フィールドを追加する
- フィールドグループ で フィールドグループを追加 をクリックし、グループ名 を入力して、グループの 表示先 (独自のコンテンツタイプ、または投稿や固定ページなど他のコンテンツタイプ) にチェックを入れます。
- フィールドごとに + フィールドを追加 をクリックし、ラベル、キー (値を保存するメタキー)、タイプ を設定します。タイプに応じて、選択肢 (1 行に 1 つ。
value : Labelと書くと値を保存してラベルを表示します)、リレーションの場合は レコードの種類、デフォルト、ヘルプテキスト も入力します。 - 選択肢 で、必要に応じて 必須 (空の間はレコード画面に警告を表示) や レコード一覧の列 にチェックを入れます。
- フィールドをドラッグして並べ替え、フィールドグループを保存 をクリックします。
フィールドは、選択したタイプの編集画面のボックスに表示されます。必須フィールドは空の間は警告を表示しますが、公開を妨げることはありません。レコード一覧では、数値と日付の列を並べ替えできます。
| フィールドタイプ | 内容 |
|---|---|
| テキスト、長いテキスト、リッチテキスト | 1 行のテキスト、複数行のテキスト、または書式付きテキスト |
| 数値、日付 | 数値または日付 |
| URL、メール、電話 | Web アドレス、メールアドレス、電話番号 |
| 選択 (1 つ)、選択 (複数)、はい/いいえ | リストからの 1 つまたは複数の値、またはスイッチ |
| 画像、ギャラリー、ファイル | メディアライブラリのアイテム |
| カラー | 色 |
| リレーション | 選択したコンテンツタイプのレコード 1 件、または 複数のレコード で複数件 |
| 行リスト | 1 行に 1 項目のリスト |
Elementor でフィールドを表示する
動的コンテンツがオンの間、Elementor には Vendix フィールド という動的タグのグループがあります: フィールド、フィールドリスト、フィールド数値、フィールドリンク、フィールド画像、フィールドギャラリー、フィールドカラー。
- Elementor ウィジェットで、テキスト、リンク、画像、ギャラリー、カラーの各フィールドの動的タグアイコンをクリックします。
- Vendix フィールドのタグを選択します。
- フィールド で、動的コンテンツのフィールド、Advanced Custom Fields または Meta Box のフィールド、あるいは カスタムフィールド(メタキー) を選び、メタキー を入力します。
タグは表示中のレコードを読み取ります。ページのレコード、ARN Listing の各レコード、またはテンプレートエディターのサンプルコンテンツです。ACF と Meta Box のフィールドは読み取り専用です。
ARN Listing でレコードを一覧表示する
動的コンテンツがオンの間、ARN Listing ウィジェットは ARN Smart ウィジェット カテゴリーにあります。
- ARN Listing をページまたはテンプレートにドラッグします。
- レコードで、表示する対象、フィルター、順序を選択します。
- 項目で既定のカードまたはリスティングアイテムテンプレートを選択し、クリックで項目をクリックしたときに開くものを選択します。
- レイアウトで、レイアウトと追加のレコードの読み込み方法を選択します。
| 設定 | 選択肢 | 初期値 |
|---|---|---|
| 表示 | コンテンツタイプのレコード、選択したレコード、または表示中のレコードの関連レコード(関連フィールドで指定されたレコード) | コンテンツタイプのレコード |
| これらのタームを持つもののみ、レコードの条件 | 含めるターム。これらのタームのいずれかまたはこれらのタームすべて | いずれか |
| これらのタームを除外 | 除外するターム | なし |
| フィールドフィルター | フィールドがすべてのフィルターに一致するレコード。最初の5つのフィルターが使用されます | なし |
| 並び順、順序 | 日付、最終更新日、タイトル、ページ順、フィールドまたはランダム。降順または昇順 | 日付、降順 |
| 1ページあたりのレコード数 | 1〜48 | 6 |
| 表示中のレコードを除外 | レコード自身のページに置くリスト向け | オフ |
| 項目 | 既定のカード(画像、上部の行、短いテキスト、最大4行のフィールド、レコードのページへのボタン)またはリスティングアイテムテンプレート | 既定のカード |
| アイテムをクリックすると開くもの | レコードのページ、フィールドのアドレス、詳細ウィンドウまたはなし | レコードのページ |
| レイアウト | グリッド(メイソンリーあり)、リスト、タブ(ターム/フィールド値ごとに1つのタブ)またはスライダー | グリッド、3列 |
| フィルターバー | すべてと表示中のレコードのターム。ページを再読み込みせずに絞り込みます | オフ |
| さらにレコードを表示 | なし、ページ番号または「さらに読み込む」ボタン | なし |
| 空の場合 | 一致するレコードがないときのメッセージ | 何も表示されません |
「さらに読み込む」はキャッシュから配信されるページでも動作し、公開済みのレコードのみが表示されます。
リスティングアイテムテンプレートで項目をデザインする
- Vendix テンプレート → 新規追加に移動します。動的コンテンツグループでリスティング項目を選択し、コンテンツタイプで、エディターでのプレビューに使うレコードのタイプを選択します。
- Vendix Fields タグを使って Elementor で1件のレコードをデザインし、テンプレートを公開します。
- ARN Listing で項目をリスティングアイテムテンプレートに設定し、テンプレートでそれを選択します。同じテンプレートを詳細ウィンドウにも使用できます(ウィンドウのコンテンツ、リスティングアイテムテンプレート)。
リスティングアイテムテンプレートには条件やオン/オフの切り替えはなく、公開されている間使用されます。
レコードを読み込むその他のウィジェット
- ARN Showcase Cards: ソースをコンテンツタイプのレコードに設定し、コンテンツタイプ、これらのタームのみ、順序(既定はページ順の昇順)、カード数(既定は12、最大48)を選択します。カードのパーツでは、ロゴ、短い説明、ステータス、カテゴリー、ウィンドウのセクションなど、カードの各パーツに使うフィールドを選択します。各カードは専用の詳細ウィンドウを開きます。前へ/次へでカード間を移動でき、Esc でウィンドウが閉じてフォーカスがカードに戻ります。
- ARN Release Notes: ソースを動的コンテンツに設定すると、コンテンツタイプの各レコードから1件ずつリリースを新しい順に読み込み、指定したフィールドからバージョン、日付、タイトル、変更内容を表示します。リリースで件数を設定します(既定は10、最大48)。
- ARN 投稿ナビゲーションでは、ページ順、タイトル順、フィールド順でレコード間を移動できます。Vendix テンプレートで投稿・ページ・アーカイブのテンプレートをデザインするをご覧ください。
定義を別のサイトに移行する
- インポート / エクスポートのエクスポートでコンテンツタイプにチェックを入れ、JSON をダウンロードをクリックします。すべてのタイプにチェックを入れると、すべてのタクソノミーとフィールドグループもファイルに含まれます。
- 移行先のサイトで、インポートの定義ファイル (.json)(最大1 MB)を選択し、キーがすでに定義されている場合の動作として置き換える(既定)またはそのままにするを選択します。
- インポートをクリックし、追加・更新・スキップされた内容のレポートを確認します。
ファイルに含まれるのは定義のみで、レコードは含まれません。
制限事項と知っておくと便利なこと
- 別のプラグインがすでに同じキーを登録しているコンテンツタイプやタクソノミーは、そのプラグインのものとして扱われます。一覧にはキーは別のプラグインで使用中と表示され、そのプラグインが無効になると Vendix が登録します。
- 定義を削除しても、そのレコード、ターム、フィールド値は残ります。コンテンツタイプを削除する際は、そのレコードを100件ずつゴミ箱に移動することもできます。
- レコードのスキーマノードは、SEO & Visibility エンジンがオンの間のみ Vendix の構造化データに追加され、レコード自身の SEO ボックスでの選択が優先されます。
- フィルターバー、ページ番号、「さらに読み込む」はグリッドとリストのレイアウトで動作します。タブとスライダーでは1ページ分のレコードが表示されます。
- Vendix を完全にアンインストールすると定義のみが削除されます。レコード、ターム、フィールド値はコンテンツとして残ります。