https://github.com/dereuromark/cakephp-bouncer
Flexible and rock solid gate keeping for CakePHP, moderate/approve changes.
https://github.com/dereuromark/cakephp-bouncer
Last synced: 3 months ago
JSON representation
Flexible and rock solid gate keeping for CakePHP, moderate/approve changes.
- Host: GitHub
- URL: https://github.com/dereuromark/cakephp-bouncer
- Owner: dereuromark
- License: mit
- Created: 2025-11-16T14:20:35.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2026-03-28T16:10:19.000Z (3 months ago)
- Last Synced: 2026-03-28T16:35:27.342Z (3 months ago)
- Language: PHP
- Size: 158 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cakephp - Bouncer plugin - The pendant to AuditStash, allow moderation and approval of add/edit/delete actions before the actual change is applied. (Auditing / Logging)
README
# Bouncer Plugin For CakePHP
[](https://github.com/dereuromark/cakephp-bouncer/actions/workflows/ci.yml)
[](https://codecov.io/github/dereuromark/cakephp-bouncer)
[](https://phpstan.org/)
[](https://packagist.org/packages/dereuromark/cakephp-bouncer)
[](https://php.net/)
[](LICENSE)
[](https://packagist.org/packages/dereuromark/cakephp-bouncer)
This plugin implements an approval workflow for CakePHP applications. Users propose changes (create or edit records), and admins/moderators can review, approve, or reject those changes before they are published to the actual database tables.
Perfect for:
- Content management systems requiring editorial approval
- User-generated content that needs moderation
- Data entry systems with quality control
- Multi-stage approval workflows
**Note:** Revert functionality is intentionally out of scope for this plugin. For reverting changes to previous states, use the [cakephp-audit-stash](https://github.com/dereuromark/cakephp-audit-stash) plugin which provides comprehensive audit logging and revert capabilities. Bouncer focuses solely on the approval workflow for proposed changes.
## Features
- **Seamless Integration**: Add approval workflow to any table with a single behavior
- **Draft Management**: Users automatically edit their existing drafts instead of creating duplicates
- **Admin Interface**: Built-in UI for reviewing and approving/rejecting changes with diff view
- **Flexible Configuration**: Configure which actions require approval, use custom bypass callbacks
- **Transaction Safety**: Atomic approval process with rollback on errors
- **AuditStash Integration**: Works seamlessly with cakephp-audit-stash for complete audit trail
## Installation
Install via [composer](https://getcomposer.org):
```bash
composer require dereuromark/cakephp-bouncer
bin/cake plugin load Bouncer
```
Run the migrations to create the \`bouncer_records\` table:
```bash
bin/cake migrations migrate -p Bouncer
```
## Documentation
See [docs/README.md](docs/README.md) for detailed documentation including:
- Quick start guide
- Configuration options
- Advanced usage (bypass callbacks, programmatic approval)
- AuditStash integration
- How it works
## Demo
See the plugin in action: [https://sandbox.dereuromark.de/sandbox/bouncer-examples](https://sandbox.dereuromark.de/sandbox/bouncer-examples)
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this project.