PHPackages                             dereuromark/cakephp-bouncer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. dereuromark/cakephp-bouncer

ActiveCakephp-plugin[Admin Panels](/categories/admin)

dereuromark/cakephp-bouncer
===========================

CakePHP plugin for approval workflow - users propose changes, admins approve or reject before publishing

1.2.0(2w ago)14.8k[2 issues](https://github.com/dereuromark/cakephp-bouncer/issues)MITPHPPHP >=8.2CI passing

Since Nov 17Pushed 1mo agoCompare

[ Source](https://github.com/dereuromark/cakephp-bouncer)[ Packagist](https://packagist.org/packages/dereuromark/cakephp-bouncer)[ Docs](https://dereuromark.github.io/cakephp-bouncer/)[ RSS](/packages/dereuromark-cakephp-bouncer/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (34)Versions (18)Used By (0)

Bouncer Plugin For CakePHP
==========================

[](#bouncer-plugin-for-cakephp)

[![Build Status](https://github.com/dereuromark/cakephp-bouncer/actions/workflows/ci.yml/badge.svg)](https://github.com/dereuromark/cakephp-bouncer/actions/workflows/ci.yml)[![Coverage Status](https://camo.githubusercontent.com/1a8fd48466671290031d86d74cca3b9f6038f0d7f0bd21979753107db01f1d88/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f6465726575726f6d61726b2f63616b657068702d626f756e6365722f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://codecov.io/github/dereuromark/cakephp-bouncer)[![PHPStan](https://camo.githubusercontent.com/f60d96f7c2579690ab6dfa8918f777fe93a02a92301c661eb38a85861a92b780/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e2e7376673f7374796c653d666c6174)](https://phpstan.org/)[![Latest Stable Version](https://camo.githubusercontent.com/001be8bbc39c73500e1ed1d92ebbaff10c6fa58b0df47a48bbc92fcabcb25f76/68747470733a2f2f706f7365722e707567782e6f72672f6465726575726f6d61726b2f63616b657068702d626f756e6365722f762f737461626c652e737667)](https://packagist.org/packages/dereuromark/cakephp-bouncer)[![Minimum PHP Version](https://camo.githubusercontent.com/ec21f169d70b69344c67d6f18fa1a24d20476d2f0cd680e8c4a1534c22f34e5f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230382e322d3838393242462e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/942e017bf0672002dd32a857c95d66f28c5900ab541838c6c664442516309c8a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/756fba1d5464f371ceb9ffe403104b10bc2704a35442ccd805fc315b4a993dbf/68747470733a2f2f706f7365722e707567782e6f72672f6465726575726f6d61726b2f63616b657068702d626f756e6365722f642f746f74616c2e737667)](https://packagist.org/packages/dereuromark/cakephp-bouncer)[![Coding Standards](https://camo.githubusercontent.com/7d06840986f78de39fb7ba7052db7208fb349427094ac1a4540449ca87776aff/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f63732d506870436f6c6c6563746976652d707572706c652e7376673f7374796c653d666c61742d737175617265)](https://github.com/php-collective/code-sniffer)

This branch is for **CakePHP 5.1+**. See [version map](https://github.com/dereuromark/cakephp-bouncer/wiki#cakephp-version-map) for details.

Approval workflow for CakePHP: users propose changes, admins/moderators review and approve or reject before the changes hit the live database. Built for content-management systems, user-generated content moderation, data-entry quality control, and multi-stage editorial workflows.

Features
--------

[](#features)

- **Drop-in approval workflow** — single behavior on a Table turns saves into pending drafts; original record stays untouched until approved.
- **Admin diff viewer** — built-in UI for the queue with side-by-side and inline diffs (word-level via `jfcherng/php-diff`), filters, status badges, and one-click approve / reject with reasons.
- **3-way merge** — proposals that became stale because the source record changed independently auto-merge non-overlapping edits; real conflicts surface for manual resolution.
- **Draft-safe re-edits** — users editing the same record see and update their own pending draft instead of stacking duplicates; auto-supersede keeps the queue focused.
- **Flexible bypass** — exempt user lists, custom bypass callbacks, or per-save `bypassBouncer` flag — integrate with policies, roles, or admin tooling.
- **Pairs with AuditStash** — Bouncer logs the approval workflow; [cakephp-audit-stash](https://github.com/dereuromark/cakephp-audit-stash) logs the data changes the approvals apply.
- **Transaction-safe** — atomic apply on approval; failures roll back cleanly and leave the queue intact.

Installation
------------

[](#installation)

```
composer require dereuromark/cakephp-bouncer
bin/cake plugin load Bouncer
bin/cake migrations migrate -p Bouncer
```

Then add the behavior to any Table that should require approval — see the [Getting Started guide](https://dereuromark.github.io/cakephp-bouncer/guide/).

> **Reverts are out of scope.** Bouncer is the gate *before* changes ship. To roll a record back *after* it shipped, use AuditStash's [Revert / Restore feature](https://dereuromark.github.io/cakephp-audit-stash/features/revert).

Documentation
-------------

[](#documentation)

Full docs: ****

- [Getting Started](https://dereuromark.github.io/cakephp-bouncer/guide/) — installation, behavior setup, controller wiring
- [Configuration](https://dereuromark.github.io/cakephp-bouncer/guide/configuration) — behavior options and `Bouncer.*` app config
- [Usage](https://dereuromark.github.io/cakephp-bouncer/guide/usage) — controller patterns, draft re-edit, programmatic approval
- [View Helper](https://dereuromark.github.io/cakephp-bouncer/guide/view-helper) — render proposals in your own templates
- [Features overview](https://dereuromark.github.io/cakephp-bouncer/features/) — admin UI, approval workflow, 3-way merge, advanced patterns, AuditStash integration

Demo
----

[](#demo)

Contributing
------------

[](#contributing)

See [CONTRIBUTING.md](CONTRIBUTING.md).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance75

Regular maintenance activity

Popularity25

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~19 days

Total

12

Last Release

15d ago

Major Versions

0.1.6 → 1.0.02026-03-20

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/39854?v=4)[Mark Scherer](/maintainers/dereuromark)[@dereuromark](https://github.com/dereuromark)

---

Top Contributors

[![dereuromark](https://avatars.githubusercontent.com/u/39854?v=4)](https://github.com/dereuromark "dereuromark (96 commits)")

---

Tags

cakephpcakephp-plugingate-keepermoderationphpplugincakephpworkflowmoderationadmin-panelbouncerapprovaldraftstandalone-ui

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dereuromark-cakephp-bouncer/health.svg)

```
[![Health](https://phpackages.com/badges/dereuromark-cakephp-bouncer/health.svg)](https://phpackages.com/packages/dereuromark-cakephp-bouncer)
```

###  Alternatives

[dereuromark/cakephp-ide-helper

CakePHP IdeHelper Plugin to improve auto-completion

1882.3M44](/packages/dereuromark-cakephp-ide-helper)[dereuromark/cakephp-tags

Tags plugin for CakePHP

1764.8k1](/packages/dereuromark-cakephp-tags)[cakephp/migrations

Database Migration plugin for CakePHP

13812.9M298](/packages/cakephp-migrations)[dereuromark/cakephp-geo

A CakePHP plugin around geocoding tools and helpers.

51186.8k6](/packages/dereuromark-cakephp-geo)[dereuromark/cakephp-setup

A CakePHP plugin containing lots of useful management tools

36199.6k2](/packages/dereuromark-cakephp-setup)[dereuromark/cakephp-queue

The Queue plugin for CakePHP provides deferred task execution.

308954.9k25](/packages/dereuromark-cakephp-queue)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)