よくあるつまずきと注意点


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

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

定義画面が開けない

管理メニューに「フィールド定義」が無い・開くと 403 になる

  • ロールを使っていないユーザーは、そのブログの管理者の権限が要ります。

  • ロールを使っているユーザーは、ロールの設定で「フィールド定義の編集」にチェックが要ります。

  • プレビュー中は開けません。

編集画面に入力欄が出ない

フィールドセットを作ったのに出ない

  • フィールドセットとフィールドの「有効にする」にチェックが入っているかを確かめます。

  • フィールドセットの「表示条件」を確かめます。エントリーのカテゴリーなどが条件に合わないと出ません。

  • テーマのテンプレートに同じキー(field[] の宣言)があると、定義の入力欄は出ません。テンプレート側を削除するか、キーを変えます。

  • テーマで編集画面のテンプレートを上書きしている場合、Admin_FieldDefinition_CustomFields の追記が要ります(従来のカスタムフィールドとの併用と移行)。

  • モジュール ID では、「カスタムフィールドを表示」にチェックが要ります。

  • 「権限・ロール別の表示」で「表示しない」になっていないかを確かめます(管理者には常に出ます)。

「本文の下」「サイドバー」を選んだのに標準の位置に出る

  • 編集画面のテンプレートに、その場所の差し込み口(<acms-custom-fields-slot>)がありません。差し込み口は <acms-custom-fields> と同じフォームの中に置きます。

コンポーネントのフィールドが何も出ない

  • 使うコンポーネントが見つからないか、無効になっています。定義画面のカードの表示(「使うコンポーネントが見つかりません。」など)を確かめます。

  • 展開後のキーがほかのキーと重なるか、64 文字を超えると展開しません。

保存できない

「入力欄が出ていない項目にエラーがあります」と出る

  • 権限・ロールや表示条件で画面に出ていない項目が、必須・入力チェックに失敗しています。必須は画面に出ているかどうかに関係なく、保存時に確かめます。

  • 急いで回避するときは、その定義の「有効にする」を外します。

公開ボタンや一覧から公開できない

  • 「公開時に必須」の項目が空です。一覧からまとめて公開したときは「公開時に必須の項目が未入力のため、…件のエントリーを公開しませんでした。」と表示されます。エントリーを開いて入力してから公開します。

数値・メールアドレス・選択肢の値で保存が止まる

  • これらの型は、型に合う値かを保存時に確かめます。CSV インポートでも確かめます。選択肢の型は、値が選択肢にある必要があります。

独自の型(テンプレート型)のフィールドがあると保存が止まる

  • 入力欄のテンプレートにファイルの入力(<input type="file">)があると、保存が止まります。画像・ファイルはメディアの型を使います。

値が消える・保存されない

隠れたフィールドの値が消えた

  • 「非表示のときは値を保存しない」を選んでいると、条件付き表示で隠れたまま保存したときに値が消えます。

項目ごとにブロックを選ぶフィールドグループの値が消えた

  • 項目のブロックを選び直すと、前のブロックの欄の値は保存したときに消えます。

モジュール ID の値が消えた

  • 「カスタムフィールドを表示」を外して保存すると、そのモジュール ID の定義の値は保存されず、それまでの値も消えます。

JS で入力欄の値を書き換えても保存されない

  • 定義の入力欄は React で描いています。DOM の value を直接書き換えても保存されません。JS イベント field-definition.value.set を使います(プラグインからの拡張)。

  • フィールドグループの項目の入力には name がありません。テーマの JS が name で入力を探していると見つかりません。

テンプレートで値が出ない

何も出ない

  • 書く場所(モジュール)を確かめます。エントリーのカスタムフィールドは entry:loop の中か Entry_Field の中に書きます(テンプレートでの出力(基本の型))。

  • キーの綴りを、定義画面のカードのキーと比べます。コンポーネントのフィールドは、展開後のキー(<フィールドのキー>_<中のキー>)で書きます。

画像が表示されない・ファイルのリンクが壊れる

  • メディア画像の {キー@path} は相対パスなので、%{MEDIA_ARCHIVES_DIR}{キー@path} と書きます。メディアファイルの {キー@path} は /media-download/… から始まるので、何も付けません。

選択肢の表示名ではなく値が出る

  • 仕様です。選択肢の型は値を保存します。BEGIN_IF で読み替えます。

メディアギャラリー・複数の参照がループで出ない

  • ループの名前に派生キーまで書きます(<!-- BEGIN キー@path:loop -->、<!-- BEGIN キー@title:loop -->)。ループの中で値が出るのは、その派生キーだけです(ギャラリーの {キー@alt}、複数の参照の {キー@url} は空になります)。

  • 代わりの書き方は、ギャラリーなら添字({キー@alt[1]}。0 から数えます)、Twig、メディア画像をフィールドグループに入れる方法です。複数の参照は Twig か、参照(1 件)をフィールドグループに入れる方法です。

参照先が出ない

  • 参照先が下書き・非公開・公開期間外・削除済みだと出しません。

Twig で値の型が思ったものと違う

  • 数字だけの値は数値に、true / false は真偽値に、空は null になります。チェック時の値を 1 にしたチェックボックスは数値の 1 になります。

型・キーが使えない

キーが使えない

型が選べない

  • 「Pro」の印が付いた型は、プロフェッショナルライセンス以上で使えます。

  • アーカイブ画像・アーカイブファイルは、ユーザーの定義だけで選べます。

  • タブはタブの入れ物の中に、ブロックは「項目ごとにブロックを 1 つ選ぶ」フィールドグループの直下にだけ置けます。

  • フィールドグループの中には、複数の値を持つ型・隠し値・地図などは置けません。

テーマの宣言が効かない

定義画面に「テーマ」の定義が出ない

  • 監査ログの警告を確かめます。JSON として読めない、version や entityType が違う、1MB を超えるファイルは読みません。

  • ファイル名が対象と合っているか(admin/field-definitions/entry.json など)を確かめます。

  • そのテーマを使っているブログかを確かめます。子孫のブログには継承されません。

テーマの定義が編集画面に出ない

  • 同じキーの定義を管理画面で作ると、管理画面の定義が優先されます。

  • そのブログで「このブログでは使わない」にしていないかを確かめます。

  • カテゴリーなどの参照を読み替えられないと、その定義は無効(close)で読み込まれます。

独自の型の変更が反映されない

  • 型の宣言はテンプレートのキャッシュに保存されます。テンプレートのキャッシュを削除します。

placements.json の場所が選べない

  • foot・side などの標準の場所と同じ名前は無視されます。別の名前にします。