WordPress.org

Plugin Directory

Birim Approvals – Post Approval Workflow for Clients & Editors

Birim Approvals – Post Approval Workflow for Clients & Editors

Description

A content approval workflow for WordPress: posts, pages and files publish only after the right people, including clients without an account, approve that exact version.

WordPress lets a contributor submit a post for review, but it does not say who must approve it, it does not remember what they approved, and anyone who can publish can skip the step. Clients and legal reviewers usually approve by email, and someone publishes by hand. Birim Approvals replaces that with a real sign-off.

A publish gate

  • Choose which content types need approval: posts, pages, any custom post type, and media files.
  • Until the required people approve, a post cannot be published or scheduled: not from the block editor, the classic editor, Quick Edit, the REST API or another plugin.
  • Administrators can publish anyway only by giving a reason, which is recorded.

Approval of the exact version

  • An approval counts only for the version it was given on (title, text, excerpt and featured image; for files, the file itself and its title).
  • If anything changes afterwards, earlier decisions stop counting, approvers are told, and publishing locks again. Nobody can sneak in an edit after the client said yes.

Approvers inside and outside WordPress

  • Team members decide in the editor or under Dashboard > Approvals, with a preview, even if their role cannot edit posts.
  • Clients, legal, compliance do not need an account. Type their email as an approver and they get a personal, expiring link to a review page with Approve and Request changes.
  • A shared link for teams: let anyone at @client.com approve after confirming their email with a one-time code. A forwarded link alone can never approve.
  • Works with Public Post Preview: if you already share drafts with it, those preview pages show the same approval box.
  • Choose whether every approver must approve or any one is enough. Requesting changes always needs a comment and always blocks.

Files too

  • Ask a client to approve a logo, a contract or a set of photos from the media library. They download it through their link. Replace or rename the file and they are asked again.
  • Works with Birim Private Files: approvers can open protected files they are asked to approve.

Notes

  • On WordPress 6.9 and later, optionally require all editor Notes to be resolved before publishing.

A record you can rely on

  • An audit log of every request, view, approval, change request, reset, link and override: who, when, on which version, with comments, IP address and browser. Download it as CSV.
  • IP addresses and browser details are removed after a period you choose; the decisions are kept.
  • Works with WordPress’s privacy tools (export and erase personal data).
  • A dashboard widget shows what is waiting for you and what you are waiting on, and [birim_approvals] lists open requests for reviewers on a front-end page.

Lightweight

No build tools, no tracking, no external requests. Emails are sent by your site.

Screenshots

Installation

  1. Install from Plugins > Add New, or upload the birim-approvals folder to /wp-content/plugins/.
  2. Activate the plugin. Nothing changes until you choose content types.
  3. Go to Settings > Approvals, tick the content types that need approval and, optionally, default approvers.
  4. Open a draft. In the Approvals box, type approvers (usernames, or emails of people outside WordPress), choose the rule and click Request approval.

A step-by-step guide with user flows and troubleshooting: https://birimone.pages.dev/approvals/

FAQ

How do I require approval before a post is published?

In Settings > Approvals, tick the content types that need approval. In the editor, type approvers in the Approvals box (usernames, or emails of people outside WordPress) and click Request approval. Publish and Schedule are refused until everyone required has approved the current version.

Does it change already published posts?

No. Approval is required before a post is first published, or published again after being unpublished. Edits to live posts are not gated in this version.

My approver says the link does not work.

Links expire after 7 days by default (Settings > Approvals), are replaced when you send a new one, and stop working when you revoke them or cancel the request. Click “Send a new link” next to their name in the Approvals box.

The approval email did not arrive.

Emails are sent by your WordPress site. Many hosts’ email lands in spam or is not delivered. Use an SMTP plugin to send through a real mail service, and ask the approver to check spam.

Why did approvals reset?

Someone saved a change to the title, text, excerpt or featured image (or replaced the file) after people had decided. The history in the Approvals box shows when. Approvers have been asked to look again.

Images in the post do not show on the review page.

If your images are protected (for example with Birim Private Files), people without an account cannot load them on the review page. Ask them to approve the file separately, or make the images public.

Who can do what?

Authors, editors and administrators can request approval. Editors and administrators can change settings and see the log. Only administrators can publish without approval, and they must give a reason. Approvers can be anyone with an account, or anyone with an email address.

Is an approval a legal signature?

No. It is a sign-off record: who approved which version and when. It is not an electronic signature under eIDAS, ESIGN or similar laws.

Can the log be edited?

Not from the plugin; rows are only ever added. It is stored in your own database, so anyone with database access can change it. The log is kept if you uninstall the plugin.

How do I report a security issue?

Please email security@birim.one instead of posting in the forum. See https://birimone.pages.dev/security/ for the full policy.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Birim Approvals – Post Approval Workflow for Clients & Editors” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • First release: publish gate, version-bound approvals, team and outside approvers, shared links with email codes, Public Post Preview support, file approvals, Notes rule, audit log, privacy tools.