Troubleshooting the PublishPress Revisions Plugin
This guide has advice for fixing various problems that users sometimes find the with the PublishPress Revisions plugin.
You don't see the Revisions button
Check the status of your content:
- The Free version of PublishPress Revisions controls who can create revisions for published content.
- The Pro version of PublishPress Revisions also works on content that is unpublished.
It's also worth check that the default revisions feature is enabled on your site. PublishPress Revisions builds on the default revisions feature in WordPress. However, some popular hosts such as WPEngine do disable revisions.
Still not seeing the Revisions button? Check the user permissions
Start by checking that PublishPress Revisions works correctly for users in the “Revisor” role.
- Create a user in the “Revisor” role and log in to their account.
- Can this user create revisions for published content?
If this is not working, then you probably have another plugin enabled that is conflicting with PublishPress Revisions.
Next, it is important to check the correct user roles have the correct permissions. One common issue with PublishPress Revisions will occur when people edit the default user permissions.
If you want moderate revisions from users in a particular role then make sure that they DO NOT have these two permissions:
To check these permissions, install the PublishPress Capabilities plugin.
After installing PublishPress Capabilities, go to User > Capabilities in your WordPress admin menu.
In the top-right corner, choose the role you want to edit, using the “Select Role to View / Edit” box.
Now look for the permissions shown below. If these boxes are empty, then the users will not be able to create permissions.
Some revisions are missing from the queue
If some revisions are missing from the queue, you can disable a performance enhancement for better compatibility with themes and plugins.
- Go to “Revisions”, then “Settings”.
- Check the “Compatibility Mode” box.
iframe or scripts tags are missing
If you see HTML tags such as
<scripts> being stripped from revisions, make sure that your user has the unfiltered html permission.
This solution may also work if revisions are converting characters such as “&” to HTML code such as
Scheduled revisions are not publishing
If you find that scheduled revisions are not being published at the correct time, try unchecking the “Asynchronous Publishing” box in the Settings area:
Other possible solutions to this problem:
Preview button is not working correctly
There is some variation in how themes respond to revision previews. Please try adjusting the following plugin setting:
- Revisions > Settings > Preview / Approval > Preview Link Type