Paragraphsからページを移す.

各ページのパラグラフを、同じコンテンツタイプの新しいフィールドでDXPR Builderエレメントとして作り直します。全ページが終わるまでパラグラフは公開 されたままです。以降は編集者がパラグラフフォームの入力ではなくページ上で直接 デザインします。パラグラフを変換する道具はありませんが、Drushで用意した HTMLを多くのページに一度に書き込めます。

はじめる前に

• DXPR Builderがインストールされ、プロダクトキーが保存済みです。 一般設定を ご覧ください。
• コンテンツタイプのフィールドと表示を管理できます。
• 表示がDXPR Builderフォーマッターを使うと、そのコンテンツタイプの全ページが コンテンツアイテムに数えられます。上限はContent Itemsタブで 確認します。

設定手順

1. まずStructure > Content types (/admin/structure/types)を開き、コンテンツタイプの Manage fieldsをクリックします。
2. フィールドを追加します。Formatted text、次にLong textを 選びます (例: 「Page content」)。
3. 開くのはManage displayで、新しいフィールドの FormatをDXPR Builderにします。
4. ParagraphsフィールドはそのままにしてSaveを クリックします。

各ページの作り直し

1. ページを開きます。空のDXPR Builderフィールドがパラグラフの横に 表示されます。
2. 各パラグラフを下の表の対応エレメントで作り直します。
3. 各パラグラフのテキストを新しいエレメントにコピーします。
4. DXPR BuilderツールバーのSaveをクリックします。

Drushで多くのページを作り直す

DXPR BuilderはBootstrap 5のHTMLをドラッグして編集できるエレメントに変えます。 古いコンテンツをHTMLで書き出せるなら、Drushで各ページに書き込みます。先に --dry-runで試します。保存せずに変更内容を表示します。

drush dxb:page:update 42 --markup=@/tmp/page-42.html --dry-run
drush dxb:page:update 42 --markup=@/tmp/page-42.html

このコマンドはコンテンツタイプの既定ディスプレイでDXPR Builderフィールドを 探します。新しいリビジョンで保存するので、ロールバックできます。

移行の仕上げ

1. 対象はManage displayで、ParagraphsフィールドをDisabledに 移してSaveをクリックします。
2. 作り直したページを確認します。携帯電話でも確認します。
3. Paragraphsフィールドは中身が不要になってからはじめてManage fieldsで 削除します。削除するとパラグラフは完全に消えます。

表示結果

各ページはDXPR Builderフィールドのコンテンツを表示し、パラグラフはもう出ません。 Edit with DXPR Builder権限を持つ編集者はページ上で編集コントロールを 見ます。Content itemsタブはそのコンテンツタイプの全ページを 挙げます。

エディターが表示されない場合

• 新旧両方のコンテンツが表示されます。 Paragraphsフィールドが表示に残っています。Manage displayで Disabledに移します。
• Drushに「No DXPR Builder field found」と報告されます。 既定ディスプレイがDXPR Builderフォーマッターを使っていません。既定ビューモードの Manage displayでFormatを設定します。
• Drushに「Multiple DXPR Builder fields found」と報告されます。 コンテンツタイプに複数あります。フィールドを指定します (例: --field=field_page_content)。
• フィールドは表示されるのに編集コントロールが出ません。 アカウントに Edit with DXPR Builder権限がないか、ライセンス上限に達しています。 ライセンスとプロダクトキーのエラーを ご覧ください。

次はこちら

• Layout Builderから: Layout Builder ページの同じ移行
• エレメントピッカー: 使える全エレメント