Block Style Modifiers is a simple WordPress plugin that allows you to add multiple block styles to Gutenberg blocks.
Style Modifiers are additive CSS classes that:
- Can be applied in addition to a Block Style
- Can be selected multiple at the same time
- Support both checkbox (non-exclusive) and radio (exclusive) behavior per category
- Are predefined and documented by themes or plugins
- Preserve class order, allowing advanced CSS control
Category Behavior
Style modifiers are organized into categories with two behaviors:
- Non-exclusive categories (checkbox): Multiple modifiers can be selected simultaneously (default:
exclusive: false)
- Exclusive categories (radio): Only one modifier from the category can be selected at a time (
exclusive: true)
Structured Category Object
Categories must be defined as objects with:
slug - Language-independent identifier for grouping (required)
label - Translatable UI label (required)
description - Optional category description
exclusive - Boolean flag for radio behavior (default: false)
1.0.7
- Added: 5 new animation types (Slide Down, Slide Left, Slide Right, Rotate In, Flip In X)
- Added: 4 new hover effects (Shake, Brighten, Darken, Blur to Focus)
- Improved: Architecture - Animations now only apply to wrapper blocks (Group, Row, Stack, etc.)
- Improved: Architecture - Hover effects now only apply to content blocks (Image, Cover, Media & Text)
- Fixed: CSS property conflicts between animations and hover effects
- Fixed: Grayscale effect renamed to "Grayscale to Color on Hover" for clarity
- Removed: Overlay hover effect (redundant with Darken effect)
- Performance: Optimized will-change properties for better GPU acceleration
- Accessibility: All new effects respect prefers-reduced-motion
1.0.6
- Added: Structured category object support (slug, label, description, exclusive)
- Added: Exclusive category behavior (radio selection within categories)
- Added: Non-exclusive category behavior (checkbox selection - default)
- Breaking: Category must now be a structured object (string format no longer supported)
- Updated: Documentation with structured category examples
- Added: Default modifiers
1.0.5
- Added: Structured category object support (slug, label, description, exclusive)
- Added: Exclusive category behavior (radio selection within categories)
- Added: Non-exclusive category behavior (checkbox selection - default)
- Breaking: Category must now be a structured object (string format no longer supported)
- Updated: Documentation with structured category examples
- Updated: Block Style Modifier Pack with theme-independent default modifiers
- Improved: Category-based grouping and selection UI
1.0.4
Updated: readme.txt
1.0.3
Updated: readme.txt
1.0.2
Updated: readme.txt
1.0.1
- Added: Source code section in readme.
- Escaped: $inline_style variable to prevent potential security issues.
1.0.0
- Initial release of Block Style Modifiers.