Contributors: aldolat, specialk, thewanderingbrit
Donate link: https://dev.aldolat.it/projects/private-content/
Tags: content, private, shortcode
Requires at least: 3.0
Tested up to: 5.8
Stable tag: 6.4.1
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Display a portion of a post content only to users of a specific or multiple roles, or to a single or multiple users.
- Private Content
- Description
- Installation
- Frequently Asked Questions
- Screenshots
- 1. At the center of the screen, the shortcode is used in the WordPress editor. The text inside the shortcode will be displayed only to Authors and above roles
- 2. The shortcode in action. On the left, the text revealed to Administrators only; on the right, the page as seen by lower roles (Editors, Authors, etc., or simply readers)
- Changelog
- Upgrade Notice
Private Content provides a shortcode to display a small portion of a post content only to users of a specific role. For example, you can show the hidden text to Editors or to Authors or to any other WordPress role, even a custom role.
Private Content is not intended to be used as a membership plugin management, but instead it should be used to show small parts of a post only to certain users or roles.
For a comprehensive explanation, please see the official Wiki on GitHub. The text of the Wiki is also available as a PDF, that you can download from here.
Many thanks to:
- Jean Baptiste Jung for the idea behind this plugin;
- Jeff Starr for the initial code.
I would like to say Thank You to all the people who helped me in making this plugin better and translated it into their respective languages.
This plugin does not collect any user data.
This section describes how to install the plugin and get it working.
- Upload the
private-contentdirectory to the/wp-content/plugins/directory - Activate the plugin through the Plugins menu in WordPress
- Now the shortcode is available and ready to use.
Is there a way to display an alternate text to readers that haven't the rights to read the hidden text?
This plugin is not intended to be used in such way, but only in order to display a portion of a post to certain readers. Also, the hidden text must remain hidden, without the presence of an alternate text that could reveal the presence of the hidden text. Anyway, as of version 2.2, the plugin can display an alternate text, if it's necessary: you can use the alt option to do that. You can find more information in the Wiki page.
Also, this plugin was created only to show a small piece of text (i.e. a couple of lines) as a note to the post for particular readers.
If you need to show the entire post only to certain readers (i.e. readers who pay to read a post), you can use a plugin like Members.
The hidden text is similar to the public text. Is it possible to stylize it in a different look?
Yes, you have to edit the CSS file of your current theme.
The shortcode generates a <p> HTML tag with some classes, for example:
privateto stylize all private contents[role]-contentto stylize the content for that specific [role].[role]-onlyto stylize the content for that specific [role] only.
See the official Wiki for more information.
Yes, custom roles are fully supported starting from version 6.0. You can find more informationin in the Wiki page.
1. At the center of the screen, the shortcode is used in the WordPress editor. The text inside the shortcode will be displayed only to Authors and above roles
2. The shortcode in action. On the left, the text revealed to Administrators only; on the right, the page as seen by lower roles (Editors, Authors, etc., or simply readers)
- Updated links to documentation.
The full changelog is documented in the changelog file released along with the plugin package and is hosted also on GitHub.
Now Administrators can always read text for Visitors.
Now Administrators can always read text for custom roles, unless a role="custom-only" option has been used.
Upgrade in order to use the new role-only feature.
Removed shortcode execution in feed.