MyFieldLayout
入力項目をタブやグループに整理し、データごとに使用する入力レイアウトを切り替えます。
- 対象製品
- MyAdminPack
- 対象バージョン
- v2
概要
MyFieldLayoutは、CMSの入力項目を並べ替え、タブやグループにまとめるプラグインです。同じ種類のデータに複数のレイアウトを用意し、編集するデータごとに使用するレイアウトを切り替えられます。
レイアウトに配置しなかった項目は、そのレイアウトを使用する編集画面には表示されません。入力内容や公開側のHTMLを変更する機能ではありません。
主な機能
- 入力項目の並べ替え
- レイアウトに配置する項目の選択
- ラベルを付けたタブによる項目の切り替え
- ラベルを付けたグループによる項目の整理
- グループ内のカラム数の指定(1〜10)
- 同じ対象に対する複数レイアウトの登録
- 新規データに適用する優先レイアウトの指定
- 編集画面でのレイアウト切り替え
利用できる対象
| CMS | 対象 |
|---|---|
| Movable Type | 記事、ウェブページ、サイト内の各コンテンツタイプ |
| PowerCMS | 記事、ウェブページ、登録済みの各カスタムオブジェクト |
記事とウェブページでは、タイトル、本文、タグ、概要、キーワードの標準項目と、そのサイトに登録されたカスタムフィールドを配置できます。
Movable Typeのコンテンツタイプでは、そのコンテンツタイプに登録されたコンテンツフィールドを配置できます。
PowerCMSのカスタムオブジェクトでは、name、body、keywordsの標準項目と、そのモデルのカスタムフィールドを配置できます。
設定場所
対象サイトを選択し、管理画面の「入力レイアウト」メニューを開きます。
- 「入力レイアウト」:登録済みレイアウトの一覧
- 「入力レイアウトの新規作成」:レイアウトを適用する対象の選択
新規作成時は、記事、ウェブページ、コンテンツタイプまたはカスタムオブジェクトのいずれかを選択します。対象はレイアウトの保存後に変更できません。
設定方法
- 対象サイトで「入力レイアウトの新規作成」を開きます。
- レイアウトを作成する対象を選択します。
- 「ラベル」と「概要」を入力します。どちらも必須です。
- 「フィールド」から使用する項目をレイアウト領域へ移動し、順序を整えます。
- 必要に応じて「コンポーネント」から「タブ」または「グループ」を追加します。
- タブまたはグループのラベルを入力し、その中へ項目を移動します。
- グループを使用する場合は、必要に応じて「カラム数」を1〜10で指定します。
- 新規データへ初期適用する場合は「優先レイアウトに設定」を選択します。
- 「ステータス」を「公開」にして保存します。
CMSで必須に設定されたフィールドは、必ずレイアウトへ配置してください。
必須フィールドが未配置のまま保存しようとすると、「必須のフィールドはレイアウトに設定してください」と表示され、保存されません。
実際の動作
新規データを作成するとき
対象に優先レイアウトが設定されている場合、そのレイアウトで入力画面を表示します。優先レイアウトがない場合は、CMS標準の項目順で表示します。
優先レイアウトは、サイトと対象の組み合わせごとに1件です。別のレイアウトを優先レイアウトにすると、それまでの優先指定は解除されます。
既存データを編集するとき
データに保存されているレイアウトがある場合は、そのレイアウトを使用します。保存済みレイアウトがなく、優先レイアウトがある場合は、優先レイアウトを使用します。
編集画面の「利用可能なレイアウト」から別の公開済みレイアウトを選択できます。
レイアウトを下書きにしたとき
編集画面で選択・適用されるのは、ステータスが「公開」のレイアウトだけです。使用中のレイアウトを「下書き」にすると、そのレイアウトは編集画面に適用されず、CMS標準の項目順で表示されます。
注意事項
- レイアウトを変更しても、各データに保存済みの入力内容は削除されません。
- レイアウトに配置していない項目は編集画面に表示されません。既存データの編集に必要な項目を除外しないようにしてください。
- タブは、レイアウト内で連続して配置されたタブを1組の切り替え領域として表示します。
- 「公開日」はレイアウト情報として保存されますが、編集画面で利用できるかどうかは「ステータス」が「公開」であるかによって判定されます。
- 編集画面の構造へJavaScriptとCSSを追加して表示を組み替えるため、CMS本体や他のプラグインが同じ編集画面を変更している場合は、検証環境で併用時の表示を確認してください。
制限事項
- 公開サイトのテンプレートやHTMLのレイアウトは変更しません。
- 対象モデルに存在しないフィールドは追加できません。
- 下書き状態のレイアウトは、データの編集画面で選択できません。
- レイアウト名と概要は、それぞれ50文字まで保存するデータ項目として実装されています。
テンプレートでレイアウト情報を取得する
データに保存されたレイアウトのIDとラベルは、独自テンプレートタグで取得できます。
タグの一覧と使用方法はテンプレートタグを参照してください。
