Skip to content
PressQueue
Documentation Permissions

Reference

Permissions

Who can see and change what in PressQueue, and how to give writers the sharing panel.

Administrators can use everything in PressQueue. Other roles see nothing until their role has one of PressQueue's permissions. Editors and authors see the "Social sharing" panel in the editor only when their role has PressQueue's post sharing permission. A role plugin can add it.

The permissions

PressQueue adds these WordPress capabilities. On activation, the Administrator role gets all of them. Settings, "Who can use PressQueue", lists them under "Technical details".

Capability What it allows
edit_pressqueue_post_controls The "Social sharing" panel in the editor: "Share this post", "Customize for this post" and "Share now"
manage_pressqueue_rules Rules and message templates
manage_pressqueue_connections Channels and the Buffer connection
view_pressqueue_deliveries Activity
operate_pressqueue_deliveries Resume, retry and cancel shares
view_pressqueue_decisions "Why posts were shared or skipped" and "Check a post"
operate_pressqueue_batches Share old posts
manage_pressqueue_settings Settings, including Social images and Data and privacy
export_pressqueue_data Download data

Any one of these also opens the PressQueue menu. A user with only the post sharing permission sees an Overview that explains the "Social sharing" panel and says that rules, channels and the activity log are managed by the site administrator.

Giving writers the panel

Use a role plugin to add edit_pressqueue_post_controls to the Editor or Author role. Writers then get the panel for the posts they can edit. They can switch sharing off for a post, change its message, channels, timing and images, and use "Share now". They do not see rules, channels or settings.

A writer only sees the sharing details of posts they can edit. For other posts PressQueue says "Details are hidden because you cannot edit this post."

WP-CLI

The wp pressqueue commands need a logged-in WordPress user with the same capabilities. See WP-CLI commands.