Single Content Sync

概要

Features

• 任意のコンテンツエンティティ（Node、Media、タクソノミーターム、Blockなど）をすべてのエンティティ参照とともにYAML形式でエクスポート
• 管理UI、プログラム、またはDrushコマンドを通じてYAMLまたはZIPファイルからコンテンツをインポート
• Paragraphs、Media、ファイル、タクソノミータームを含むすべての参照エンティティの自動再帰エクスポート
• 翻訳サポート - 多言語コンテンツのすべての翻訳をエクスポートおよびインポート
• Views Bulk Operationsを使用して複数のコンテンツアイテムを一度に一括エクスポート
• ZIPエクスポートオプションにはすべてのファイルアセット（画像、ドキュメント、動画）が含まれる
• UUIDベースのコンテンツ同期 - 既存コンテンツの更新または新規作成
• 誤った環境へのインポートを防ぐためのサイトUUID検証
• SingleContentSyncBaseFieldsProcessorおよびSingleContentSyncFieldProcessorプラグインによるカスタムエンティティタイプとフィールドタイプのサポート用プラグインシステム
• エクスポート/インポート動作をカスタマイズするためのイベントシステム（ExportEvent、ImportEvent、ExportFieldEvent、ImportFieldEvent）
• コマンドラインでのエクスポート/インポート操作用のDrushコマンド
• 埋め込みエンティティとメニューリンクの設定可能なエクスポートモード（none、stub、またはfull）
• 単一エンティティを素早くエクスポートするためのエンティティ正規ページのエクスポートタブ
• Layout Builderセクション、Paragraphs、Metatag、Webform、および多くのcontribフィールドタイプのサポート
• 整形テキストフィールド内の内部リンクのインテリジェントな処理 - インポート時にエンティティ参照を解決

Use Cases

Tips

• コンテンツにファイル（画像、ドキュメント）が含まれる場合は、ZIPエクスポートを使用してすべてのアセットが含まれ、正しくインポートされるようにしてください。
• 本番環境では、クローンされていない環境からの誤ったコンテンツ上書きを防ぐためにサイトUUIDチェックを有効にしてください。
• 埋め込みエンティティには「stub」エクスポートモードを使用して、参照の整合性を維持しながらエクスポートファイルサイズを削減してください。
• エクスポートされたYAMLファイルをカスタムモジュールのassetsフォルダに保存して、デプロイ時のコンテンツインポートに使用してください。
• ファイルを作成せずにエクスポートされる内容をプレビューするために、最初に--dry-runオプション付きでDrushコマンドを使用してください。
• ImportEventをサブスクライブして、コンテンツが保存される前にカスタム検証または変換ロジックを追加してください。
• フィルタリングされたコンテンツセット（例：2024年のすべての公開記事）をエクスポートするために、Viewsで一括エクスポートアクションを使用してください。
• カスタムフィールドプロセッサプラグインを作成する場合、基本機能のためにSingleContentSyncFieldProcessorPluginBaseを継承してください。
• エクスポート/インポートフォームのYAMLエディタはシンタックスハイライトを提供します - コンテンツ構造をすばやく確認するために使用してください。
• 複雑な移行の場合、プロセスをより制御するために、このモジュールをコアMigrateと組み合わせることを検討してください。