Paragraphs
コンテンツページで組み合わせ可能な再利用可能なパラグラフコンポーネントを使用して、構造化されたコンテンツを作成できるようにします。
paragraphs
インストール
composer require 'drupal/paragraphs:8.x-1.19'
composer require 'drupal/paragraphs:8.x-1.17'
概要
Paragraphsモジュールは、構造化された再利用可能なコンテンツコンポーネントを作成できる強力なフィールドタイプを提供します。単一のWYSIWYGエディタに頼る代わりに、コンテンツ作成者は複数のパラグラフタイプを追加してページを構築でき、各タイプには独自のフィールドと表示設定があります。
Paragraphsはランディングページ、複雑なレイアウト、モジュラーでコンポーネントベースのアプローチが有効なあらゆるコンテンツに最適です。各Paragraphタイプは任意のDrupalフィールドを含むことができるバンドルであり、サイト構築者にコンテンツ構造の定義において完全な柔軟性を提供します。
このモジュールはEntity Reference Revisionsモジュールと統合してリビジョン履歴を維持し、Drupalの翻訳システムを通じて多言語コンテンツをサポートします。また、ドラッグ＆ドロップによる並べ替え、折りたたみ/展開機能、複製機能を備えた洗練されたウィジェットインターフェースを提供します。
Features
- 任意のDrupalフィールドの組み合わせでカスタムParagraphタイプを作成
- Entity Reference Revisionsフィールドタイプを使用して任意のエンティティに複数のParagraphsを追加
- 2つのフィールドウィジェットオプション：フル機能を備えたStable（推奨）と後方互換性のためのLegacy
- ネストされたパラグラフのサポートを含むドラッグ＆ドロップによる並べ替え
- パラグラフタイプにカスタム機能を追加するためのBehaviorプラグインシステム
- 複数の追加モード：ドロップダウンボタン、セレクトリスト、ボタン、またはモーダルフォーム
- 設定可能な編集モード：オープン、クローズ、またはネスト展開付きクローズ
- パラグラフが折りたたまれているときのサマリーとプレビュー表示モード
- 既存のコンテンツを素早くコピーするための複製機能
- 互換性のあるタイプ間でパラグラフを変換する変換機能
- 複数のパラグラフを効率的に管理するための全て折りたたみ/編集アクション
- 特定の位置にパラグラフを挿入するための上に追加機能
- 視覚的な識別のためのパラグラフタイプごとのアイコン
- Entity Reference Revisions統合によるフルリビジョンサポート
- 多言語パラグラフ翻訳サポート
- Drupal 7のParagraphsおよびField Collectionモジュールからのマイグレーションサポート
- 未公開パラグラフの表示制御
Use Cases
ランディングページビルダー
ヒーローバナー、機能グリッド、テスティモニアルスライダー、コールトゥアクション、コンテンツブロックなどのパラグラフタイプを組み合わせて多様なランディングページを作成します。コンテンツエディターは、開発者の介入なしに、異なるパラグラフタイプを選択して配置することでユニークなページレイアウトを構築できます。
リッチメディア付きブログ投稿
テキストセクション、画像ギャラリー、埋め込みビデオ、プルクォート、関連コンテンツブロック用のパラグラフを持つ記事コンテンツタイプを構築します。執筆者は記事全体にメディアを任意の順序で散りばめることができます。
製品ショーケース
製品仕様、機能ハイライト、画像カルーセル、カスタマーレビュー、関連製品用のパラグラフを持つ製品ページを作成します。各セクションは独自のレイアウトとスタイリングを持つことができます。
再利用可能なコンテンツコンポーネント
Paragraphs Libraryサブモジュールを使用して、複数のページで共有でき、1か所で更新できる会社住所ブロック、免責事項テキスト、プロモーションバナーなどの再利用可能なコンポーネントを作成します。
マルチカラムレイアウト
ネストされたパラグラフフィールドを含むパラグラフタイプ（例：左カラムと右カラムのパラグラフを含む2カラムレイアウトパラグラフ）を作成し、ドラッグ＆ドロップによる並べ替えが可能な複雑なネストレイアウトを実現します。
イベントリスティング
イベント詳細、スケジュール/アジェンダアイテム、スピーカープロフィール、会場情報、登録フォーム用のパラグラフを持つイベントコンテンツを構築します。各イベントは情報セクションのユニークな組み合わせを持つことができます。
Tips
- 多くのパラグラフを持つフィールドには「クローズ」編集モードと「サマリー」クローズモードを使用して、フォームのパフォーマンスと使いやすさを向上させましょう
- よく使用するパラグラフタイプで新しいコンテンツを事前入力するためにデフォルトのパラグラフタイプを設定しましょう
- パラグラフタイプアイコンを使用して、コンテンツエディターがウィジェットでパラグラフタイプを素早く識別できるようにしましょう
- 正確なパラグラフ配置のためにモーダルフォーム追加モードを使用する際は「上に追加」機能を有効にしましょう
- 複数のページに表示する必要があるコンテンツにはParagraphs Libraryサブモジュールの使用を検討しましょう
- Behaviorプラグインを使用して、パラグラフタイプ間で一貫したスタイリングオプション（背景色や幅設定など）を追加しましょう
- 異なるコンテキストで表示するフィールドを制御するために、パラグラフに適切なField UIフォームモードを設定しましょう
- 短いフォームは開いたままにし、長いフォームは折りたたむために「クローズモードしきい値」設定を使用しましょう
- 異なるロールが異なるパラグラフ作成能力を必要とする場合は、Paragraphs Type Permissionsサブモジュールを有効にしましょう
- 適切な多言語ワークフローを確保するためにContent Translationでパラグラフコンテンツをテストしましょう
Technical Details
Admin Pages 4
/admin/structure/paragraphs_type
利用可能なすべてのParagraphタイプを一覧表示し、各タイプの追加、編集、削除、フィールド管理のオプションを提供します。各Paragraphタイプは独自のフィールドセットを持つ再利用可能なコンテンツコンポーネントを表します。
/admin/structure/paragraphs_type/add
ラベル、マシン名、アイコン、説明、Behaviorプラグイン設定を持つ新しいParagraphタイプを作成するためのフォーム。
/admin/structure/paragraphs_type/{paragraphs_type}
既存のParagraphタイプのラベル、アイコン、説明、Behaviorプラグインを含む設定を編集します。
/admin/config/content/paragraphs
Paragraphsモジュールのグローバル設定。
権限 4
Hooks 3
hook_paragraphs_behavior_info_alter
ParagraphsBehaviorプラグインアノテーションで提供される情報を変更します。モジュールがBehaviorプラグイン定義を変更できるようにします。
hook_paragraphs_widget_actions_alter
Paragraphsウィジェットで利用可能なアクションを変更します。パラグラフアイテムにカスタムボタンやドロップダウンアクションを追加できます。
hook_paragraphs_conversion_alter
タイプ間の変換後にパラグラフを変更します。変換後の変更のために変換されたパラグラフエンティティごとに1回発火されます。
Troubleshooting 5
パラグラフを参照するEntity Reference Revisionsフィールドを翻訳可能としてマークしないでください。代わりに、パラグラフタイプ内の個々のフィールドを翻訳可能としてマークします。README.txtの多言語設定の説明を参照してください。
必要なSortableライブラリがコアに含まれているDrupal 8.8.0以降を使用していることを確認してください。ドラッグ＆ドロップ機能にはStableウィジェット（Legacyではない）が必要です。
Behaviorプラグインは、パラグラフタイプに適用可能な場合にのみ表示されます。プラグインのisApplicable()メソッドがそのパラグラフタイプに対してtrueを返すことを確認してください。
パラグラフは通常、親エンティティが削除されると削除されます。孤立したパラグラフは、中断された保存やバグから発生する可能性があります。エンティティクリーンアップモジュールやデータベースクエリを使用して孤立を特定し削除してください。
ウィジェットタイプが「Paragraphs (stable)」または「Paragraphs Legacy」に設定されていることを確認してください。パラグラフと互換性のない他のエンティティ参照ウィジェットではありません。
Security Notes 4
- 「administer paragraphs types」権限は重要なアクセス権を付与するため、信頼できる管理者にのみ与えてください
- 「view unpublished paragraphs」権限は下書きコンテンツを公開する可能性があります。慎重に割り当ててください
- Paragraphs Libraryを使用する場合、ライブラリアイテムは共有されることに注意してください - 変更はすべてのインスタンスに影響します
- パラグラフのアクセスは親エンティティから継承されます。親エンティティのアクセス制御が適切であることを確認してください