About this plugin
The Dead Dove plugin lets administrators and users apply content warnings to their content. Administrators define the available content warnings in a custom taxonomy of terms, and specify which of them trigger warnings by default. Users can overide these defaults in their user settings.
Tags may be applied at the post level, block level, or even within a block using a shortcode. 0, they can also be applied when posting to BuddyBoss activity feeds and forums, even by users who lack access to the WordPress dashboard.
Content that has been tagged with a term that triggers a content warning for the user viewing it will be blurred from view. To view the content the user must read and accept a disclaimer that has been defined by the administrator in the description of the taxonomy term.
Features
- Blur content based on assigned terms and display warning text before viewing.
- Administrators select which terms require warnings, with the warning text pulled from term descriptions.
- Users can override admin settings by choosing their own tag warning preferences.
- Warning can be applied at the post or block level, using a shortcode with terms as parameters, or when posting to a Buddyboss activity feed or forum.
- Multiple term descriptions are shown if more than one warning term is applied.
Usage
Admin Settings
- Go to Settings > Content Warning.
- Select the terms that require a content warning.
- Add a description to each term to provide the warning text.
User Settings
- Users who have access to the WordPress Dashboard can go to Your Profile to adjust their warning settings.
- BuddyBoss users can adjust their warning settings by going to Account Settings, Content Warning Settings.
- Users can disable warnings for certain terms set by the admin or enable warnings for terms that were not set by the admin.
- User selections are stored in the deaddove_user_warning_terms user meta key.
Post term usage
To apply a content warning to an entire post, apply a term that requires a content warning to the post. The content warning taxonomy will appear in the post editor screen, alongside tags, and are used in the same way.
Block Usage
- In the block editor, add the Content Warning block.
- Select warning terms in the block settings.
- Add your content inside the Content Warning block, which will be blurred until the user agrees to view it.
Shortcode Usage
Use the [content_warning] shortcode to apply warnings within a block. The slug of the term or terms should be entered into the shortcode separated by commas.
Example 1: Single term
[content_warning tags="sensitive"] This section discusses sensitive material. [/content_warning]
Example 2: Multiple terms
[content_warning tags="graphic,offensive"] This section contains graphic language and offensive themes. [/content_warning]
BuddyBoss Usage
When adding content to the Activity Feed or Forum post, the available content warnings are shown in a drop-down in the editing box.
Roadmap
- Geolocation-based Warnings: Modify content visibility based on the viewer’s location.
- Custom Styling Options: Provide options to style blurred content and buttons using CSS.
- Apply Shortcode from Editing Toolbar: Simpler application of content warnings to text selections.
License
This plugin is licensed under the GPLv2 or later. See the license for more details.