Description
Cheyytec Content Warning Blur hides spoilers, NSFW images and sensitive content behind a blurred overlay with a short warning and a “Show content” button. Nothing is revealed until the visitor chooses to click.
Wrap any text or image in one shortcode and it is blurred instantly — no configuration, no page builder, no external service.
What people use it for
- Spoiler blur — hide plot twists, episode recaps, endings and game spoilers until the reader opts in.
- NSFW blur — blur adult or suggestive images on art, fandom and community sites so nothing loads uncovered on screen.
- Trigger warnings — put a content warning over descriptions of violence, self-harm, abuse or other distressing topics.
- Graphic and medical images — blur wounds, surgery photos or clinical material behind a clear warning.
- Surprise reveals — quiz answers, puzzle solutions, prize announcements and gift ideas.
Key features
- Wrap anything — text, images, or other shortcodes — in a content warning.
- Blur + click-to-reveal — content stays hidden until the visitor clicks the button.
- Custom wording — set your own warning label and button text, per shortcode or site-wide (Settings Content Warning).
- Lightweight and dependency-free — a tiny script and stylesheet load only where the shortcode is used.
- Works with the block editor, classic editor and most page builders.
How to use
Wrap the content you want to hide inside the [cheyytec_content_warning] shortcode:
[cheyytec_content_warning]This is the sensitive text or image that will be blurred.[/cheyytec_content_warning]
Customise the wording with attributes:
[cheyytec_content_warning label="Spoiler ahead" button="Reveal spoiler"]The butler did it.[/cheyytec_content_warning]
You can also place an image or gallery inside the shortcode — it will be blurred until revealed.
Pro version
Content Warning Blur Pro adds:
- 18+ age gate — require an age confirmation before revealing, with an
age="18"attribute and your own confirmation text. - Remembered consent — once a visitor confirms their age, age-gated content stays revealed for a number of days you choose (cookie).
- Automatic category warnings — blur every post in selected categories automatically, no shortcode needed.
- Reveal analytics — see which pages get their warnings revealed the most.
Installation
- Upload the
cheyytec-content-warning-blurfolder to the/wp-content/plugins/directory, or install the plugin through the Plugins screen in WordPress. - Activate the plugin through the Plugins screen.
- Wrap any content in the
[cheyytec_content_warning]...[/cheyytec_content_warning]shortcode.
FAQ
-
Can I use it to hide spoilers?
-
Yes — that is one of the most common uses. Wrap the spoiler in the shortcode and set your own wording, for example
[cheyytec_content_warning label="Spoiler ahead" button="Reveal spoiler"]. The text stays blurred until the reader clicks. -
Can I blur NSFW or adult images?
-
Yes. Put the image inside the shortcode and it is rendered blurred with a warning over it, so nothing appears uncovered when the page loads. The Pro version adds an 18+ age gate that asks for age confirmation before revealing, and remembers the visitor’s choice.
-
What can I put inside the shortcode?
-
Any text or images, and even other shortcodes. The enclosed content is blurred until the visitor clicks to reveal it.
-
Yes. Use the
labelandbuttonattributes, for example:[cheyytec_content_warning label="Graphic content" button="I understand, show it"]...[/cheyytec_content_warning]. -
Does it require any configuration?
-
No. Just wrap your content in the shortcode and it works. Optionally, set your default label and button text under Settings Content Warning.
-
Is the content still in the page source?
-
Yes. This plugin is a visual opt-in warning (blur until click); it is not an access-control or security feature. It’s ideal for spoilers, trigger warnings and sensitive media that you still want present on the page.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Cheyytec Content Warning Blur – Spoiler, NSFW & Trigger Warning Click to Reveal” is open source software. The following people have contributed to this plugin.
Contributors
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- New: settings page (Settings Content Warning) to set the default warning label and button text site-wide.
- New: Pro version with 18+ age gate (remembered consent), automatic category warnings and reveal analytics.
1.0.0
- Initial release: the
[cheyytec_content_warning]enclosing shortcode with blur, click-to-reveal, and custom label and button text.