よくあるつまずきと注意点
この機能は 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になります。
型・キーが使えない
キーが使えない
field・status・title・linkなどの予約語と、ACMS_POSTで始まるキーは使えません(フィールドの追加と共通の設定)。キーは 64 文字までです。
型が選べない
「Pro」の印が付いた型は、プロフェッショナルライセンス以上で使えます。
アーカイブ画像・アーカイブファイルは、ユーザーの定義だけで選べます。
タブはタブの入れ物の中に、ブロックは「項目ごとにブロックを 1 つ選ぶ」フィールドグループの直下にだけ置けます。
フィールドグループの中には、複数の値を持つ型・隠し値・地図などは置けません。
テーマの宣言が効かない
定義画面に「テーマ」の定義が出ない
監査ログの警告を確かめます。JSON として読めない、
versionやentityTypeが違う、1MB を超えるファイルは読みません。ファイル名が対象と合っているか(
admin/field-definitions/entry.jsonなど)を確かめます。そのテーマを使っているブログかを確かめます。子孫のブログには継承されません。
テーマの定義が編集画面に出ない
同じキーの定義を管理画面で作ると、管理画面の定義が優先されます。
そのブログで「このブログでは使わない」にしていないかを確かめます。
カテゴリーなどの参照を読み替えられないと、その定義は無効(
close)で読み込まれます。
独自の型の変更が反映されない
型の宣言はテンプレートのキャッシュに保存されます。テンプレートのキャッシュを削除します。
placements.json の場所が選べない
foot・sideなどの標準の場所と同じ名前は無視されます。別の名前にします。