WP Branches For Post

Beschrijving

WP Branches For Post adds a Git-like editorial workflow to WordPress.

When a published page or post needs a larger edit, you do not have to change the live content directly. Create a private working branch, edit it in the normal WordPress editor, review the differences, and merge only when you are ready. The public original keeps its post ID, URL and publication identity throughout the workflow.

Version 2.1 adds a three-way merge review. The plugin remembers the original state at branch creation, compares the current original with the current branch, separates non-conflicting work from real conflicts, and helps you update or merge without silently overwriting newer changes.

De workflow in één oogopslag

1. Open a published, private or scheduled post, page, or supported custom post type.
2. Open het paneel Berichtbranch en kies “Branch maken”.
3. WordPress opent een geïsoleerde conceptbranch. Het openbare origineel blijft ongewijzigd.
4. Bewerk de branch zoals gewoonlijk. Bekijk een voorbeeld wanneer je die nodig hebt.
5. Choose “Review changes”.
6. Review branch changes, newer original changes, conflicts, and identity changes.
7. If the original has newer non-conflicting edits, choose “Update branch from original” when you want the branch to include them before continuing.
8. When the review is clean, choose “Save & merge into original”.
9. If both sides changed the same value differently, review the conflict and use force merge only when you intentionally want the branch value for the listed conflict.
10. Na een geslaagde samenvoeging blijft het origineel het openbare bericht en wordt de werkbranch naar de prullenbak verplaatst.

Functiegids met schermafbeeldingen

De schermafbeeldingen op de pluginpagina volgen dezelfde workflow als hieronder, zodat je kunt zien hoe elke bediening eruitziet voordat je ze gebruikt:

• Schermafbeelding 1 — Begin veilig: open het paneel Berichtbranch op het origineel en kies “Branch maken”. Het live bericht wordt niet bewerkt.
• Screenshot 2 — Work in isolation: the branch editor shows its relationship to the original, preview links, review state, and the actions available for that branch.
• Screenshot 3 — Review before merging: “Review changes” opens the three-way comparison so you can inspect the baseline, current original, and branch values together.
• Screenshot 4 — Bring in safe upstream work: when the original has newer non-conflicting changes, “Update branch from original” becomes available.
• Screenshot 5 — Continue after updating: after the branch is refreshed from the original, the editor reloads with the rebased state and a fresh merge review.
• Schermafbeelding 6 — Stop bij echte conflicten: wanneer zowel het origineel als de branch dezelfde samenvoegbare waarde verschillend hebben gewijzigd, wordt normaal samenvoegen geblokkeerd en worden de conflicterende paden getoond.
• Screenshot 7 — Force only after review: force merge uses a separate destructive confirmation and prefers the branch value only for reviewed conflicts.
• Screenshot 8 — Refuse stale reviews: if the branch or original changes after review, the merge is stopped and the current state must be reviewed again.
• Schermafbeelding 9 — Verwijder expliciet: het opgeven van een branch vereist bevestiging en verplaatst alleen de branch naar de prullenbak; het openbare origineel blijft onaangeroerd.
• Screenshot 10 — See active work from the original: the original post lists existing branches and their current review states.
• Schermafbeelding 11 – Behoud de normale WordPress navigatie: branchstatus en snelle acties blijven beschikbaar vanuit de berichtenlijst.
• Schermafbeelding 12 — Begrijp het bereik van gesynchroniseerde patronen: branches die naar gesynchroniseerde patronen verwijzen, tonen een waarschuwing omdat het bewerken van het gesynchroniseerde patroon zelf globaal is in WordPress.

Wat het paneel Berichtbranch je toont

Bij een origineel bericht toont het paneel of een branch kan worden gemaakt en geeft het actieve branches weer die je kunt bewerken.

Bij een branch toont het paneel:

• Een link terug naar het origineel.
• Voorbeeldlinks voor de branch en het origineel.
• De maker van de branch.
• The current review state.
• Hoeveel branchwijzigingen en conflicten zijn gevonden.
• “Review changes” to open the detailed merge review.
• “Update branch from original” when newer original changes can be brought into the branch safely.
• “Opslaan en samenvoegen met origineel” wanneer de branch normaal kan worden samengevoegd.
• An explicit force-merge path for reviewed conflicts.
• “Branch verwijderen” wanneer de werkbranch moet worden opgegeven.

Understanding the review states

• Schoon: geen nieuwere incompatibele wijziging verhindert normaal samenvoegen.
• Update available: the original contains newer non-conflicting work. The plugin can update the branch while keeping branch-only edits.
• Informational: the original changed identity-related data that the branch is not allowed to overwrite, such as slug or publication identity.
• Conflict: the original and the branch changed the same mergeable data differently. Normal merge is blocked until you review the situation.
• Legacy/unknown: an older branch does not have the full 2.1 baseline needed for an exact three-way review. Review it manually before any force merge.
• Ontbreekt: het origineel kan niet langer veilig worden bepaald, waardoor samenvoegen niet beschikbaar is.

What the merge review contains

The review separates changes into four groups:

• Branchwijzigingen: samenvoegbare waarden die in de werkbranch zijn gewijzigd.
• Wijzigingen in het origineel sinds het maken van de branch: nieuwere wijzigingen die rechtstreeks in het origineel zijn aangebracht.
• Conflicten: paden die aan beide kanten verschillend zijn gewijzigd.
• Identiteitswijzigingen van het origineel die bij samenvoegen behouden blijven: wijzigingen die de plugin bewust niet overschrijft.

Voor controleerbare velden toont het paneel ook de basis, het huidige origineel en de branchwaarden, zodat je begrijpt waarom een item wordt vermeld.

Wat wordt gesynchroniseerd

A successful merge can synchronize normal editorial content, supported post meta, and taxonomies.

The plugin intentionally preserves the original post’s identity and publication state. In particular, the merge does not replace the original post ID, GUID, slug, author or publication dates. For hierarchical content, the branch cannot change the original parent relationship because that can change a public URL.

Media IDs already referenced by content and featured-image metadata remain usable. Attachments are not re-parented.

Bewerken terwijl iemand het origineel wijzigt

Versie 2.1 gebruikt de basis die bij het maken van de branch is vastgelegd om drie situaties te onderscheiden:

• Alleen de branch heeft een waarde gewijzigd: de branchwaarde kan worden toegepast.
• Alleen het origineel heeft een waarde gewijzigd: de nieuwere waarde van het origineel blijft behouden.
• Beide hebben dezelfde waarde verschillend gewijzigd: de waarde is een conflict en normaal samenvoegen wordt geblokkeerd.

Daarom kan een branch vaak veilig worden samengevoegd, zelfs wanneer het origineel na het maken van de branch is gewijzigd.

Update branch from original

When the original has newer non-conflicting changes, “Update branch from original” rebases the working branch onto the newer original state.

Branch-only work is preserved, original-only work is imported into the branch, and a fresh baseline is recorded. If the operation cannot complete safely, the plugin attempts to restore the branch to its previous state instead of leaving a partial update.

Geforceerd samenvoegen

Geforceerd samenvoegen is bewust niet de standaardroute.

It is offered only after a conflict is detected and reviewed. For listed merge conflicts, force merge prefers the branch value. Non-conflicting newer work on the original is still preserved.

Extensions can further restrict who is allowed to force merge through the plugin’s capability/filter boundary.

Gesynchroniseerde patronen

A WordPress synced pattern is global content. Editing the synced pattern itself changes that pattern everywhere it is used and is not isolated by a post branch.

Wanneer een branch naar gesynchroniseerde patronen verwijst, waarschuwt WP Branches For Post je in het branchpaneel zodat globale patroonwijzigingen niet worden verward met geïsoleerde branchwijzigingen.

Veiligheid en foutafhandeling

• Branches blijven niet-openbaar en normaal publiceren in WordPress wordt teruggezet naar concept.
• Mutating operations repeat WordPress capability checks at the service layer.
• Browseracties en REST-routes gebruiken de juiste nonce- en permissiebeveiliging.
• Every 2.1 branch stores a full baseline snapshot for three-way review.
• Normaal samenvoegen weigert onopgeloste conflicten.
• Merge and rebase operations verify synchronized state, reject stale reviewed data, and attempt rollback after write failures.
• If a merge cannot finish its branch cleanup, the original is restored instead of reporting a partial success.
• Geslaagde samenvoegingen en verwijderde branches worden naar de prullenbak verplaatst in plaats van permanent verwijderd.
• WordPress creates the normal revision history when the original is updated.
• The plugin does not directly rewrite revisions or attachment parents with SQL.

Blok-editor, Klassieke editor en lijstschermen

The complete review experience is available in the Block Editor document sidebar.

Classic Editor, post-list row actions and the admin bar retain compatibility controls for creating/opening branches and performing supported branch actions. For the clearest conflict review, use the Block Editor panel.

Troubleshooting the branch controls

Als een actie niet beschikbaar is of de plugin een samenvoeging stopt, is dat normaal een veiligheidscontrole en geen verborgen instelling:

• Create branch is disabled while the original has unsaved Block Editor changes. Save or discard those edits first so the branch baseline matches the saved original.
• Create branch is available only for supported saved statuses such as published, private and scheduled content, and only when your WordPress capabilities allow the operation.
• Update branch from original appears only when the original has newer changes that do not conflict with the branch. You do not have to run it before every merge.
• Save & merge into original is not offered for an unresolved true conflict. Open Review changes and inspect the listed paths first.
• If the branch or original changes after you reviewed it, the merge is stopped and the review is refreshed. Review the current state before trying again.
• Force merge is shown only for a state that requires explicit conflict/legacy review and only when your account is allowed to force the merge.
• Als het origineel ontbreekt of niet langer hetzelfde berichttype gebruikt als de branch, is samenvoegen niet beschikbaar.
• The Block Editor provides the complete three-way review. Classic Editor and list screens keep compatibility actions, but conflict-heavy work is clearest in the Block Editor.

Compatibiliteit met oudere branches

Branches die met oudere pluginversies zijn gemaakt, blijven herkenbaar.

A 2.0-style branch with a compatible stored baseline hash can still merge normally when the original has not changed. Older branches without a full 2.1 snapshot cannot show the detailed three-way comparison, so the plugin treats them conservatively and requires explicit review when the state is uncertain.

Voor ontwikkelaars

Handige filters en acties zijn onder meer:

• 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

Beveiligingskritieke invarianten blijven van kracht nadat extensiefilters zijn uitgevoerd. Een branch blijft een concept van hetzelfde berichttype, beschermde runtimemetadata blijven uitgesloten, samenvoegbare kernvelden blijven binnen de allowlist van de plugin en geforceerd samenvoegen blijft door de autorisatiegrens van de plugin gaan.

Zie ARCHITECTURE.md voor de gegevensstroom, SECURITY.md voor autorisatie- en synchronisatiegrenzen en TESTING.md voor de reproduceerbare volledige validatieomgeving die voor 2.1 is gebruikt.

De broncode van de blok-editor staat in src/index.js en wordt gebouwd met @wordpress/scripts.

Human-readable source code and build tooling are maintained at https://github.com/hsxk/WP-Branches-For-Post/.