メディア・参照・地図・アップロード・ブロックエディターの型の設定
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
このページの型は、値と一緒に キー@media などの派生キーを保存します。テンプレートでの出し方は「テンプレートでの出力(メディア・参照・地図・アップロード)」を参照してください。
メディア画像・メディアファイル
型のキーは media-image・media-file です。メディアライブラリから選ぶか、アップロードして選びます。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
許可する拡張子(カンマ区切り) |
| 選べるメディアの拡張子です。空欄なら制限しません(メディア画像は画像、メディアファイルはファイルから選びます)。 | 空 |
|
サムネイルの幅(px) |
| メディア画像だけ。編集画面のプレビューの幅です。 | 既定の幅 |
|
保存されるキー | 内容 |
|---|---|
| メディアの ID |
@path・@altなどの値は保存せず、表示のたびにメディアライブラリの情報から作ります。メディアの代替テキストなどを直すと、表示も変わります。代替テキストが空の画像には、編集画面で「alt なし」の印が出ます。
テンプレートでは、メディア画像の
@pathの前に%{MEDIA_ARCHIVES_DIR}を付けます。メディアファイルの@pathは/media-download/…から始まるので、何も付けません。
メディアギャラリー
型のキーは media-gallery です。プロフェッショナルライセンス以上で使えます。画像を複数選び、並べ替えられます。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
許可する拡張子(カンマ区切り) |
| 選べる画像の拡張子です。 | 空 |
|
並べ替えを許可する |
| 編集画面で並べ替えられるようにします。 | オン | — |
サムネイルの幅(px) |
| 編集画面のプレビューの幅です。 | 既定の幅 |
|
最大枚数 | (入力チェック | 選べる枚数の上限です。空欄は無制限です。 | 無制限 |
|
キー・キー@media にメディアの ID を、選んだ順に複数保存します。標準のテンプレートで画像を回すときは <!-- BEGIN キー@path:loop --> を使い、ループの中の {キー@alt} は空になります(代替テキストは {キー@alt[1]} のように添字で出すか、Twig を使います)。最小の枚数は、入力チェックの「最小選択数」で指定します。フィールドグループの中には置けません。
エントリー・カテゴリー・ユーザーの参照
ほかのエントリー・カテゴリー・ユーザーを選んで紐付けます。1 件を選ぶ型と、複数を選ぶ型があります。
型 | 型のキー | 保存されるキー |
|---|---|---|
エントリー参照 |
|
|
エントリー参照(複数) |
| 同上(複数) |
カテゴリー参照 |
|
|
カテゴリー参照(複数) |
| 同上(複数) |
ユーザー参照 |
|
|
ユーザー参照(複数) |
| 同上(複数) |
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
選択範囲のブログ ID(省略時は編集中のブログ) |
| このブログのものから選びます。 | 編集中のブログ |
|
選択範囲のカテゴリー ID(そのカテゴリーに属するエントリーだけ。省略可) |
| エントリー参照だけ。サブカテゴリーとしての所属も含みます。子孫のカテゴリーは含みません。 | 制限なし |
|
選択できるステータス(省略時はすべて) |
| エントリー参照だけ。「公開」「非公開」「下書き」( | すべて | 公開 |
親カテゴリー ID(配下だけ選択。省略可) |
| カテゴリー参照だけ。そのカテゴリーとその配下から選びます。 | 制限なし |
|
選択できる権限(省略時はすべて) |
| ユーザー参照だけ。「管理者」「編集者」「投稿者」( | すべて | 編集者 |
並べ替えを許可する |
| 複数を選ぶ型だけ。 | オン | — |
ユーザーのカスタムフィールドを公開側に出す |
| ユーザー参照だけ。Twig・JSON(V2 モジュール)の出力に、参照先ユーザーのカスタムフィールドを含めます。公開してよい値だけのときに使ってください。 | オフ | — |
件数の上限・下限は、入力チェックの「最大選択数」「最小選択数」で指定します(複数を選ぶ型)。
ブログのエクスポート・インポートでは、保存済みの参照先の ID を読み替えます。定義のエクスポート・インポートでは、選択範囲のブログ・カテゴリーの ID をコードで書き出し、取り込み先の ID に読み替えます。
複数を選ぶ型は、フィールドグループの中に置けません。
地図
型のキーは map です。プロフェッショナルライセンス以上で使えます。地図をクリックしてピンを置くか、緯度・経度を入力します。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
地図の種類 |
| 「OpenStreetMap」( |
| Google マップ |
初期表示の緯度 |
| ピンが無いときに表示する位置です(値には保存しません)。緯度と経度の両方を入れたときだけ使い、空欄なら東京駅付近です。 | 空 |
|
初期表示の経度 |
| 同上。 | 空 |
|
初期表示のズーム |
| 同上。0〜21 の整数です。 | 空 |
|
住所検索を出す |
| 住所で検索してピンを置けるようにします。入力した住所は、検索のために外部の地図サービスへ送信されます。 | オン | — |
ストリートビューを使えるようにする |
| Google マップを選んだときだけ使えます。 | オフ | — |
キー に「緯度,経度」(例: 35.6812000,139.7671000)を保存し、キー@lat・キー@lng・キー@zoom も保存します。検索対象の既定はオフです。フィールドグループの中には置けません。
アーカイブ画像・アーカイブファイル(ユーザーのみ)
型のキーは image・file です。ユーザーの定義でだけ選べます。ファイルをメディアライブラリを通さずに、アーカイブへ直接アップロードします。
設定項目(画面) | config のキー | 内容 | 既定値 | 入力例 |
|---|---|---|---|---|
許可する拡張子(カンマ区切り) |
| カンマか空白で区切ります。サイトで許可された拡張子から指定でき、空欄ならすべて(画像はすべての画像)です。 | 空 |
|
大きさの上限(KB) |
| 空なら上限を設けません(サーバーの設定の上限は超えられません)。 | 空 |
|
画像の大きさ(長辺 px) |
| アーカイブ画像だけ。空なら元の大きさのまま保存します。縮小のみで、拡大はしません。 | 空 |
|
小さい画像(tiny。長辺 px) |
| アーカイブ画像だけ。 | 空 |
|
大きい画像(large。長辺 px) |
| アーカイブ画像だけ。 | 空 |
|
正方形の画像(square。一辺 px) |
| アーカイブ画像だけ。 | 空 |
|
代替テキストの欄を出す |
| アーカイブ画像だけ。 | オフ | — |
ダウンロード時のファイル名の欄を出す |
| アーカイブファイルだけ。 | オフ | — |
従来の画像・ファイルのカスタムフィールドと同じ派生キー(@path など)で保存します。初期値はありません。検索対象の既定はオフです。フィールドグループ・コンポーネントの中には置けません。
ブロックエディター
型のキーは block-editor です。ブロックエディターで本文のような内容を組み立てます。値は HTML として キー に保存されます。
設定項目(画面) | 内容 | 既定値 |
|---|---|---|
機能 | 斜体・下線・文字色などの装飾を、「編集画面セットのまま」「使う」「使わない」から選びます。 | 編集画面セットのまま |
ブロック > 使えるブロック | チェックしたブロックだけを追加できます。何もチェックしなければ、編集画面セットのブロックエディター設定のブロックをすべて使えます。 | すべて |
ブロック > どのブロックも追加できなくする | ブロックを追加できなくします。 | オフ |
ブロック > 使えないブロック | チェックしたブロックを追加できなくします。 | なし |
このフィールド専用の一覧を使う | 文字サイズ・フォント・クラス・画像のサイズ・カラーパレットなどの一覧を、このフィールドだけ変えます。無効のときは、編集画面セットのブロックエディター設定の一覧を使います。 | オフ |
これらの設定は、定義の config.settings に保存されます。テーマの JSON に書くときは、管理画面で設定してエクスポートした JSON を写すのが確実です。