メディア・参照・地図・アップロード・ブロックエディターの型の設定


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

このページの型は、値と一緒に キー@media などの派生キーを保存します。テンプレートでの出し方は「テンプレートでの出力(メディア・参照・地図・アップロード)」を参照してください。

メディア画像・メディアファイル

型のキーは media-image・media-file です。メディアライブラリから選ぶか、アップロードして選びます。

設定項目(画面)

config のキー

内容

既定値

入力例

許可する拡張子(カンマ区切り)

allowedExtensions

選べるメディアの拡張子です。空欄なら制限しません(メディア画像は画像、メディアファイルはファイルから選びます)。

空

jpg,png,webp

サムネイルの幅(px)

thumbnailWidth

メディア画像だけ。編集画面のプレビューの幅です。

既定の幅

240

保存されるキー

内容

キー・キー@media

メディアの ID

  • @path・@alt などの値は保存せず、表示のたびにメディアライブラリの情報から作ります。メディアの代替テキストなどを直すと、表示も変わります。

  • 代替テキストが空の画像には、編集画面で「alt なし」の印が出ます。

  • テンプレートでは、メディア画像の @path の前に %{MEDIA_ARCHIVES_DIR} を付けます。メディアファイルの @path は /media-download/… から始まるので、何も付けません。

メディアギャラリー

型のキーは media-gallery です。プロフェッショナルライセンス以上で使えます。画像を複数選び、並べ替えられます。

設定項目(画面)

config のキー

内容

既定値

入力例

許可する拡張子(カンマ区切り)

allowedExtensions

選べる画像の拡張子です。

空

jpg,png

並べ替えを許可する

allowReorder

編集画面で並べ替えられるようにします。

オン

—

サムネイルの幅(px)

thumbnailWidth

編集画面のプレビューの幅です。

既定の幅

160

最大枚数

(入力チェック all_maxChecked)

選べる枚数の上限です。空欄は無制限です。

無制限

10

キー・キー@media にメディアの ID を、選んだ順に複数保存します。標準のテンプレートで画像を回すときは <!-- BEGIN キー@path:loop --> を使い、ループの中の {キー@alt} は空になります(代替テキストは {キー@alt[1]} のように添字で出すか、Twig を使います)。最小の枚数は、入力チェックの「最小選択数」で指定します。フィールドグループの中には置けません。

エントリー・カテゴリー・ユーザーの参照

ほかのエントリー・カテゴリー・ユーザーを選んで紐付けます。1 件を選ぶ型と、複数を選ぶ型があります。

型

型のキー

保存されるキー

エントリー参照

relation-entry

キー と キー@entry にエントリー ID

エントリー参照(複数)

relation-entries

同上(複数)

カテゴリー参照

relation-category

キー と キー@category にカテゴリー ID

カテゴリー参照(複数)

relation-categories

同上(複数)

ユーザー参照

relation-user

キー と キー@user にユーザー ID

ユーザー参照(複数)

relation-users

同上(複数)

設定項目(画面)

config のキー

内容

既定値

入力例

選択範囲のブログ ID(省略時は編集中のブログ)

scopeBlogId

このブログのものから選びます。

編集中のブログ

1

選択範囲のカテゴリー ID(そのカテゴリーに属するエントリーだけ。省略可)

scopeCategoryId

エントリー参照だけ。サブカテゴリーとしての所属も含みます。子孫のカテゴリーは含みません。

制限なし

3

選択できるステータス(省略時はすべて)

scopeStatus

エントリー参照だけ。「公開」「非公開」「下書き」(open・close・draft)。

すべて

公開

親カテゴリー ID(配下だけ選択。省略可)

scopeParentCategoryId

カテゴリー参照だけ。そのカテゴリーとその配下から選びます。

制限なし

5

選択できる権限(省略時はすべて)

scopeAuth

ユーザー参照だけ。「管理者」「編集者」「投稿者」(administrator・editor・contributor)。

すべて

編集者

並べ替えを許可する

allowReorder

複数を選ぶ型だけ。

オン

—

ユーザーのカスタムフィールドを公開側に出す

outputFields

ユーザー参照だけ。Twig・JSON(V2 モジュール)の出力に、参照先ユーザーのカスタムフィールドを含めます。公開してよい値だけのときに使ってください。

オフ

—

  • 件数の上限・下限は、入力チェックの「最大選択数」「最小選択数」で指定します(複数を選ぶ型)。

  • ブログのエクスポート・インポートでは、保存済みの参照先の ID を読み替えます。定義のエクスポート・インポートでは、選択範囲のブログ・カテゴリーの ID をコードで書き出し、取り込み先の ID に読み替えます。

  • 複数を選ぶ型は、フィールドグループの中に置けません。

地図

型のキーは map です。プロフェッショナルライセンス以上で使えます。地図をクリックしてピンを置くか、緯度・経度を入力します。

設定項目(画面)

config のキー

内容

既定値

入力例

地図の種類

provider

「OpenStreetMap」(osm)か「Google マップ」(google)。Google マップを使うには API キーの設定が要ります。

osm

Google マップ

初期表示の緯度

defaultLat

ピンが無いときに表示する位置です(値には保存しません)。緯度と経度の両方を入れたときだけ使い、空欄なら東京駅付近です。

空

35.6812

初期表示の経度

defaultLng

同上。

空

139.7671

初期表示のズーム

defaultZoom

同上。0〜21 の整数です。

空

15

住所検索を出す

search

住所で検索してピンを置けるようにします。入力した住所は、検索のために外部の地図サービスへ送信されます。

オン

—

ストリートビューを使えるようにする

streetView

Google マップを選んだときだけ使えます。

オフ

—

キー に「緯度,経度」(例: 35.6812000,139.7671000)を保存し、キー@lat・キー@lng・キー@zoom も保存します。検索対象の既定はオフです。フィールドグループの中には置けません。

アーカイブ画像・アーカイブファイル(ユーザーのみ)

型のキーは image・file です。ユーザーの定義でだけ選べます。ファイルをメディアライブラリを通さずに、アーカイブへ直接アップロードします。

設定項目(画面)

config のキー

内容

既定値

入力例

許可する拡張子(カンマ区切り)

allowedExtensions

カンマか空白で区切ります。サイトで許可された拡張子から指定でき、空欄ならすべて(画像はすべての画像)です。

空

jpg,png

大きさの上限(KB)

maxFileSize

空なら上限を設けません(サーバーの設定の上限は超えられません)。

空

2048

画像の大きさ(長辺 px)

size

アーカイブ画像だけ。空なら元の大きさのまま保存します。縮小のみで、拡大はしません。

空

1200

小さい画像(tiny。長辺 px)

tinySize

アーカイブ画像だけ。

空

280

大きい画像(large。長辺 px)

largeSize

アーカイブ画像だけ。

空

2400

正方形の画像(square。一辺 px)

squareSize

アーカイブ画像だけ。

空

300

代替テキストの欄を出す

altInput

アーカイブ画像だけ。

オフ

—

ダウンロード時のファイル名の欄を出す

downloadName

アーカイブファイルだけ。

オフ

—

従来の画像・ファイルのカスタムフィールドと同じ派生キー(@path など)で保存します。初期値はありません。検索対象の既定はオフです。フィールドグループ・コンポーネントの中には置けません。

ブロックエディター

型のキーは block-editor です。ブロックエディターで本文のような内容を組み立てます。値は HTML として キー に保存されます。

設定項目(画面)

内容

既定値

機能

斜体・下線・文字色などの装飾を、「編集画面セットのまま」「使う」「使わない」から選びます。

編集画面セットのまま

ブロック > 使えるブロック

チェックしたブロックだけを追加できます。何もチェックしなければ、編集画面セットのブロックエディター設定のブロックをすべて使えます。

すべて

ブロック > どのブロックも追加できなくする

ブロックを追加できなくします。

オフ

ブロック > 使えないブロック

チェックしたブロックを追加できなくします。

なし

このフィールド専用の一覧を使う

文字サイズ・フォント・クラス・画像のサイズ・カラーパレットなどの一覧を、このフィールドだけ変えます。無効のときは、編集画面セットのブロックエディター設定の一覧を使います。

オフ

これらの設定は、定義の config.settings に保存されます。テーマの JSON に書くときは、管理画面で設定してエクスポートした JSON を写すのが確実です。