コンテンツタイプでのDXPR Builder利用.
すでにあるコンテンツタイプを、目で見て作るページに変えます。Bodyのような長いテキストフィールドの表示を、DXPR Builderフォーマッターに切り替えます。以降、そのタイプの全アイテムが編集者にビルダーを表示します。このページは既存サイト向けです。新しいDXPR CMSサイトではコンテンツタイプが設定済みです。
動画ではコンテンツタイプのBodyフィールドをDXPR Builderに切り替えています。
始める前に
- DXPR Builderはプロダクトキー付きでインストール済みです（DXPR Builderのインストール）。
- コンテンツタイプを管理できます（例：管理者として）。
コンテンツタイプでのDXPR Builder利用
以下の手順では、コンテンツタイプがすで持つ長いテキストフィールド（例：既定のBodyフィールド）を使います。ない場合は、先にDXPR Builderフィールドの追加を行います。
- 開くのはStructure > Content typesです。
- コンテンツタイプ横のメニューを開き、Manage displayをクリックします。
- 表示モードの一覧が開いたら、Manage（Defaultの分）をクリックします。
- テキストフィールドのFormatをDefaultからDXPR Builderに変えます。
- 次にSaveをクリックします。
- そのタイプのコンテンツを作成し、Titleを入力します。
- 再びSaveをクリックします。
- コンテンツエリアにカーソルを合わせます。DXPR Builderツールバーが表示されます。
DXPR Builderフィールドの追加
コンテンツタイプにまだ長いテキストフィールドがない場合にフィールドを追加します。
- 開くのはStructure > Content typesで、コンテンツタイプのManage fieldsをクリックします。
- 次にCreate a new fieldをクリックします。
- 選ぶのはFormatted textで、次にLong textを選びます。古いDrupalではText (formatted, long)と表示されます。
- 入力するのはLabelで、例は「Event details」です。Continueをクリックします。
- クリックするのはSaveです。
次に上記手順2から5で、そのFormatをDXPR Builderにします。
編集フォームでのフィールド非表示
DXPR Builder付属のコンテンツタイプは、ビルダーフィールドを編集フォームで隠します。編集者はビルダーでのみ変更します。自分のタイプでも同様にするには：
- コンテンツタイプのManage form displayを開きます。
- ビルダーフィールドをDisabledセクションにドラッグします。
- クリックするのはSaveです。
表示内容
そのタイプのコンテンツは、フィールドがあった場所にビルダーを表示して開きます。新しいアイテムにはAdd Elements付きの空ビルダーが出ます。Edit with DXPR Builder権限のない編集者と訪問者には、コントロールなしの描画済みページが見えます。
コンテンツタイプは複数のビルダーフィールドを持てます。各フィールドがページに独自のビルダーを持ち、編集可能領域ごとに1つです。
フォーマッターは、任意のエンティティタイプのShort text、Long text、Long text with summaryフィールドに作用します。カスタムブロックタイプも含みます。dxpr_builder_blockは既製のDrag and Drop Blockタイプを追加します。
設定
| 設定 | 内容 | 初期値 |
|---|---|---|
| Editing Profile（フォーマッター横の歯車アイコン） | このフィールドのエレメント、ブロック、ビュー、エディターボタンを決めるユーザープロファイルの選択 | Default (Role-based Profile)：各編集者はロールのプロファイルになります |
ビルダーが表示されない場合
- Format一覧にDXPR Builder選択肢がない。 フィールドが書式付きテキストフィールドではありません。上記の手順でLong textフィールドを追加し、そちらを使います。
- Manage displayにManage layoutボタンはあるがFormat列がない。 表示がLayout Builderです。Manage layoutをクリックし、フィールドのブロックを設定してFormatterをDXPR Builderにします。
- コンテンツがフィールドをプレーンテキストで表示する。 他の表示モードに書式を設定しています。Defaultか、ページが使う表示モードに設定します。
- 編集者にコントロールが出ない。 編集者のロールにEdit with DXPR Builder権限がありません。People > Permissions（
/admin/people/permissions）で付与します。
次のステップ
- 最初のページを作る：新しいコンテンツにセクション、ロー、エレメントを追加します。
- ユーザープロファイル：各ロールがビルダーで見る内容を決めます。
- 編集ツール：ビルダーのすべてのコントロールを確認できます。