WP投稿ブランチ

説明

WP Branches For Post は、WordPress に Git のような編集ワークフローを追加します。

公開済みの固定ページや投稿に大きな編集が必要でも、公開中の内容を直接変更する必要はありません。非公開の作業用ブランチを作成し、通常の WordPress エディターで編集し、差分を確認して、準備ができたときだけマージできます。ワークフロー全体を通して、公開中の元の投稿は投稿 ID、URL、公開識別情報を保持します。

バージョン 2.1 では三方向マージ確認を追加しました。プラグインはブランチ作成時の元の状態を記録し、現在の元の投稿と現在のブランチを比較して、非競合の作業と実際の競合を分離し、新しい変更を黙って上書きせずに更新やマージを行えるよう支援します。

ワークフローの概要

1. 公開済み、非公開、予約済みの投稿・固定ページ、または対応しているカスタム投稿タイプを開きます。
2. 投稿ブランチパネルを開き、「ブランチを作成」を選択します。
3. WordPress が分離された下書きブランチを開きます。公開中の元の投稿は変更されません。
4. 通常どおりブランチを編集します。必要なときはいつでもブランチをプレビューできます。
5. 「変更を確認」を選択します。
6. ブランチの変更、元の投稿の新しい変更、競合、識別情報の変更を確認します。
7. 元の投稿に新しい非競合の編集があり、それをブランチへ取り込んでから続けたい場合は、「元の投稿からブランチを更新」を選択します。
8. 確認結果に問題がなければ、「保存して元の投稿へマージ」を選択します。
9. 両方で同じ値が異なる内容に変更されている場合は競合を確認し、一覧に表示された競合で意図的にブランチ側の値を採用したい場合にだけ強制マージを使用します。
10. マージに成功すると、元の投稿はそのまま公開中の投稿として残り、作業用ブランチはゴミ箱へ移動されます。

スクリーンショット付き機能ガイド

プラグインページのスクリーンショットは以下で説明するものと同じワークフローに沿っているため、使用前に各操作がどのように表示されるか確認できます。

• スクリーンショット 1 — 安全に開始: 元の投稿で投稿ブランチパネルを開き、「ブランチを作成」を選択します。公開中の投稿は編集されません。
• スクリーンショット 2 — 分離して作業: ブランチエディターには、元の投稿との関係、プレビューリンク、確認状態、そのブランチで利用できる操作が表示されます。
• スクリーンショット 3 — マージ前に確認: 「変更を確認」を開くと三方向比較が表示され、基準、現在の元の投稿、ブランチの値を並べて確認できます。
• スクリーンショット 4 — 安全な上流変更を取り込む: 元の投稿に新しい非競合の変更があると、「元の投稿からブランチを更新」が利用可能になります。
• スクリーンショット 5 — 更新後も続行: 元の投稿からブランチを更新すると、リベース済みの状態と新しいマージ確認でエディターが再読み込みされます。
• スクリーンショット 6 — 実際の競合で停止: 元の投稿とブランチの両方が同じマージ対象値を異なる内容に変更すると、通常のマージはブロックされ、競合するパスが表示されます。
• スクリーンショット 7 — 確認後にのみ強制: 強制マージには別の破壊的操作の確認があり、確認済みの競合に対してのみブランチ側の値を優先します。
• スクリーンショット 8 — 古い確認を拒否: 確認後にブランチまたは元の投稿が変更された場合、マージは停止され、現在の状態をもう一度確認する必要があります。
• スクリーンショット 9 — 明示的に破棄: ブランチを放棄するには確認が必要で、ブランチだけがゴミ箱へ移動されます。公開中の元の投稿は変更されません。
• スクリーンショット 10 — 元の投稿から進行中の作業を確認: 元の投稿には既存のブランチと現在の確認状態が一覧表示されます。
• スクリーンショット 11 — 通常の WordPress ナビゲーションを維持: 投稿一覧からもブランチ状態とクイック操作を利用できます。
• スクリーンショット 12 — 同期パターンの影響範囲を理解: 同期パターンを参照するブランチには警告が表示されます。同期パターン自体の編集は WordPress 全体に影響するためです。

投稿ブランチパネルで確認できること

元の投稿では、パネルにブランチを作成できるかどうかが表示され、編集可能な有効ブランチが一覧表示されます。

ブランチでは、パネルに次の内容が表示されます。

• 元の投稿へ戻るリンク。
• ブランチと元の投稿のプレビューリンク。
• ブランチの作成者。
• 現在の確認状態。
• 検出されたブランチ変更と競合の件数。
• 「変更を確認」で詳細なマージ確認を開きます。
• 元の投稿の新しい変更を安全にブランチへ取り込める場合は、「元の投稿からブランチを更新」を使用します。
• ブランチを通常どおりマージできる場合は、「保存して元の投稿へマージ」を使用します。
• 確認済みの競合に対する明示的な強制マージ手順。
• 作業用ブランチを放棄する場合は、「ブランチを破棄」を使用します。

確認状態を理解する

• クリーン: 通常のマージを妨げる互換性のない新しい変更はありません。
• 更新可能: 元の投稿に新しい非競合の作業があります。プラグインはブランチ独自の編集を保持したまま、ブランチを更新できます。
• 情報: 元の投稿で、スラッグや公開識別情報など、ブランチから上書きできない識別関連データが変更されています。
• 競合: 元の投稿とブランチが同じマージ対象データを異なる内容に変更しています。状況を確認するまで通常のマージはブロックされます。
• 旧形式/不明: 古いブランチには、正確な三方向確認に必要な完全な 2.1 基準がありません。強制マージする前に手動で確認してください。
• 欠落: 元の投稿を安全に特定できなくなったため、マージは利用できません。

マージ確認に含まれる内容

確認では変更を 4 つのグループに分けます。

• ブランチの変更: 作業用ブランチで変更されたマージ対象の値。
• ブランチ作成後の元の投稿の変更: 元の投稿へ直接加えられた新しい変更。
• 競合: 両側で異なる内容に変更されたパス。
• マージで保持される元の投稿の識別情報の変更: プラグインが意図的に上書きしない変更。

確認対象のフィールドでは、項目が一覧に含まれた理由を理解できるよう、基準、現在の元の投稿、ブランチの値もパネルに表示されます。

同期される内容

マージに成功すると、通常の編集コンテンツ、対応する投稿メタデータ、タクソノミーを同期できます。

プラグインは元の投稿の識別情報と公開状態を意図的に保持します。特に、マージで元の投稿 ID、GUID、スラッグ、投稿者、公開日時を置き換えることはありません。階層型コンテンツでは、公開 URL が変わる可能性があるため、ブランチから元の親子関係を変更できません。

本文やアイキャッチ画像のメタデータですでに参照されているメディア ID は引き続き利用できます。添付ファイルの親は変更されません。

他の人が元の投稿を変更している間の編集

バージョン 2.1 では、ブランチ作成時に記録した基準を使って 3 つの状況を区別します。

• ブランチだけが値を変更した場合: ブランチ側の値を適用できます。
• 元の投稿だけが値を変更した場合: 元の投稿の新しい値が保持されます。
• 両方が同じ値を異なる内容に変更した場合: その値は競合となり、通常のマージはブロックされます。

そのため、ブランチ作成後に元の投稿が変更されても、安全にマージできる場合が多くあります。

元の投稿からブランチを更新

元の投稿に新しい非競合の変更がある場合、「元の投稿からブランチを更新」で作業用ブランチを新しい元の状態へリベースします。

ブランチだけの作業は保持され、元の投稿だけの作業はブランチへ取り込まれ、新しい基準が記録されます。操作を安全に完了できない場合、部分的に更新された状態を残すのではなく、プラグインはブランチを以前の状態へ戻そうとします。

強制マージ

強制マージは意図的に既定の手順にはしていません。

強制マージは、競合が検出され確認された後にのみ提供されます。一覧にあるマージ競合ではブランチ側の値を優先しますが、元の投稿上の新しい非競合の作業は引き続き保持されます。

拡張機能では、プラグインの権限/フィルター境界を通じて、強制マージを許可するユーザーをさらに制限できます。

同期パターン

WordPress の同期パターンはグローバルなコンテンツです。同期パターン自体を編集すると、そのパターンが使われているすべての場所が変更され、投稿ブランチ内には隔離されません。

ブランチが同期パターンを参照している場合、グローバルなパターン編集をブランチ内の編集と誤認しないよう、WP Branches For Post はブランチパネルに警告を表示します。

安全性と障害時の処理

• ブランチは非公開のまま維持され、通常の WordPress 公開操作は下書きへ戻されます。
• 変更を伴う操作では、サービス層でも WordPress の権限チェックを繰り返します。
• ブラウザー操作と REST ルートでは、適切な nonce/権限保護を使用します。
• 2.1 で作成されたすべてのブランチは、三方向確認用の完全な基準スナップショットを保存します。
• 通常のマージは未解決の競合を拒否します。
• マージとリベース操作では同期状態を検証し、古くなった確認済みデータを拒否し、書き込み失敗後にはロールバックを試みます。
• マージ後にブランチの後処理を完了できない場合、部分的な成功として扱わず、元の投稿を復元します。
• マージに成功したブランチと破棄したブランチは完全削除せず、ゴミ箱へ移動されます。
• 元の投稿が更新されると、WordPress は通常どおりリビジョン履歴を作成します。
• このプラグインは SQL でリビジョンや添付ファイルの親を直接書き換えません。

ブロックエディター、クラシックエディター、一覧画面

完全な確認機能は、ブロックエディターのドキュメントサイドバーで利用できます。

クラシックエディター、投稿一覧の行アクション、管理バーにも、ブランチの作成/オープンや対応するブランチ操作のための互換コントロールが残されています。競合を最も分かりやすく確認するには、ブロックエディターのパネルを使用してください。

ブランチ操作のトラブルシューティング

操作を利用できない、またはプラグインがマージを停止した場合、それは通常、隠し設定ではなく安全確認によるものです。

• 元の投稿に未保存のブロックエディター変更がある間は、「ブランチを作成」が無効になります。まずその編集を保存または破棄し、ブランチの基準が保存済みの元の投稿と一致するようにしてください。
• 「ブランチを作成」は、公開済み・非公開・予約済みなど対応する保存済みステータスで、かつ現在の WordPress 権限で操作が許可されている場合にのみ利用できます。
• 「元の投稿からブランチを更新」は、元の投稿にブランチと競合しない新しい変更がある場合にのみ表示されます。毎回のマージ前に実行する必要はありません。
• 未解決の本当の競合がある場合、「保存して元の投稿へマージ」は表示されません。まず「変更を確認」を開き、一覧のパスを確認してください。
• 確認後にブランチまたは元の投稿が変更された場合、マージは停止され、確認内容が更新されます。もう一度試す前に現在の状態を確認してください。
• 強制マージは、競合または旧形式の状態に対して明示的な確認が必要な場合で、かつアカウントに強制マージ権限がある場合にのみ表示されます。
• 元の投稿が欠落している、またはブランチと投稿タイプが一致しなくなった場合、マージは利用できません。
• ブロックエディターでは完全な三方向確認を利用できます。クラシックエディターと一覧画面にも互換操作は残りますが、競合が多い作業はブロックエディターで確認するのが最も分かりやすくなります。

旧バージョンで作成したブランチとの互換性

旧バージョンのプラグインで作成したブランチも引き続き認識されます。

互換性のある保存済み基準ハッシュを持つ 2.0 形式のブランチは、元の投稿が変更されていなければ通常どおりマージできます。完全な 2.1 スナップショットを持たない古いブランチでは詳細な三方向比較を表示できないため、プラグインは保守的に扱い、状態が不確かな場合は明示的な確認を求めます。

開発者向け

利用できる主なフィルターとアクション:

• wbfp_branchable_post_statuses
• wbfp_create_branch_post_data
• wbfp_excluded_meta_keys
• wbfp_mergeable_post_fields
• wbfp_can_force_merge
• wbfp_branch_created
• wbfp_before_merge
• wbfp_after_merge

拡張フィルターの実行後も、セキュリティ上重要な不変条件は引き続き強制されます。ブランチは同じ投稿タイプの下書きのまま、保護されたランタイムメタデータは除外されたまま、マージ可能なコアフィールドはプラグインの許可リスト内に保たれ、強制マージも引き続きプラグインの認可境界を通過します。

データフローについては ARCHITECTURE.md、認可と同期の境界については SECURITY.md、2.1 で使用した再現可能な完全検証環境については TESTING.md を参照してください。

ブロックエディターのソースは src/index.js にあり、@wordpress/scripts でビルドされます。

読みやすいソースコードとビルドツールは https://github.com/hsxk/WP-Branches-For-Post/ で管理しています。