Sensitive Image
A WordPress block for sensitive images with a reveal toggle.
by WordPress Telex · github.com/bhubbard/sensitive-image-block
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/bhubbard/sensitive-image-block/archive/refs/heads/main.zipReadme
=== Sensitive Image ===
Contributors: WordPress Telex Tags: block, image, content warning, sensitive content, media Tested up to: 6.8 Stable tag: 0.1.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html
A WordPress block for displaying potentially sensitive images behind a customizable content warning overlay.
== Description ==
The Sensitive Image block provides a professional way to handle potentially sensitive visual content by displaying images behind a customizable warning overlay. Users must explicitly choose to view the content by clicking a reveal button.
Key Features:
- Content Warning System: Images are hidden behind an overlay by default
- Customizable Overlay: Full control over background color, blur intensity, and text content
- Smooth Transitions: Professional fade animations when revealing/hiding content
- Button Customization: Customize both reveal and hide button text and styling
- Responsive Design: Works seamlessly across all device sizes
- Theme Integration: Adapts to your existing WordPress theme styling
- User Consent: Respects user choice with clear reveal/hide functionality
- Accessibility: Proper ARIA labels and keyboard navigation support
Customization Options:
- Overlay background color picker
- Blur intensity slider (0-20px)
- Custom warning text field
- Reveal button text customization
- Hide button text customization
- Button styling options
- Overlay opacity control
Use Cases:
- Medical or educational content
- Artistic content that may be sensitive
- Before/after transformations
- Potentially disturbing imagery
- Age-restricted content
- Spoiler protection for media content
== Installation ==
- Upload the plugin files to the
/wp-content/plugins/sensitive-imagedirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the 'Plugins' screen in WordPress
- Add the "Sensitive Image" block to any post or page
- Upload your image and customize the overlay settings
- Preview your content to ensure the warning system works as expected
== Frequently Asked Questions ==
= How do I customize the warning message? =
In the block settings panel, you'll find a "Warning Text" field where you can enter your custom message. The default text is "This image may contain sensitive content."
= Can I change the overlay background color? =
Yes! Use the background color picker in the block settings to choose any color that fits your site's design.
= How do I adjust the blur intensity? =
The blur intensity slider in the settings allows you to control how much the image is blurred behind the overlay, from 0 (no blur) to 20 pixels.
= Will this work with my theme? =
The block is designed to integrate seamlessly with any WordPress theme while maintaining its core functionality.
= Is the block accessible? =
Yes, the block includes proper ARIA labels and supports keyboard navigation for accessibility compliance.
= Can users re-hide the image after viewing it? =
Yes, after revealing the image, a "Hide Image" button appears allowing users to re-apply the content warning overlay.
== Screenshots ==
- Block editor interface showing image upload and overlay settings
- Frontend overlay display with customizable warning message and reveal button
- Smooth transition revealing the sensitive image content
- Block settings panel with all customization options
- Responsive design working across different device sizes
== Changelog ==
= 0.1.0 =
- Initial release
- Content warning overlay functionality
- Customizable overlay settings
- Smooth reveal/hide transitions
- Full responsive design support
- Theme integration
- Accessibility features
== Privacy ==
This block does not collect, store, or transmit any user data. All functionality is contained within your WordPress installation.
== Support ==
For support and feature requests, please visit the plugin's support forum or contact WordPress Telex.