Beschrijving
Levels Block Editor Styles for Oxygen Builder
Beschrijving
Levels Block Editor Styles for Oxygen Builder automatically injects your Oxygen Builder CSS into the WordPress block editor, ensuring that what you see in the editor matches what appears on the frontend.
Features
- Automatic Style Detection – Automatically finds and loads all relevant Oxygen CSS files
- Scoped Styling – All CSS is scoped to prevent affecting editor UI elements
- Reusable Block Support – Detects and loads styles for embedded reusable blocks
- Smart Context Detection – Only loads in the block editor for users with edit permissions
- Performance Optimized – Live-read approach with minimal overhead
- Responsive Images – Automatically converts img tags to responsive versions with srcset and sizes attributes
- Per-Image Size Control – Use the
data-image-sizeattribute to override the default image size per element - Settings Page – Configure features under Oxygen > Block Editor Styles
Block Editor Styles
The plugin collects CSS from four sources:
- oxygen.css – Core Oxygen framework styles
- universal.css – Site-wide Oxygen styles
- Page-specific CSS – Cached page styles
- Reusable block CSS – Styles for embedded reusable blocks
All CSS selectors are automatically rewritten to be scoped within the editor content area to prevent affecting the WordPress admin UI.
Responsive Images
When enabled, the plugin automatically replaces <img> tags in your content with responsive versions that include srcset and sizes attributes. This provides optimized images for all screen sizes without any manual work.
How to use in Oxygen Builder:
- Go to Oxygen > Block Editor Styles in the WordPress admin
- Enable “Responsive Images”
- Choose a default image size (e.g. “large”)
- All images in your content will now automatically get srcset attributes
Per-image size override:
You can override the default size on individual images using the data-image-size attribute:
- Select your Image element in Oxygen
- Go to Advanced > Attributes
- Add attribute:
data-image-size - Set value to any registered image size:
thumbnail,medium,medium_large,large, orfull
The data-image-size attribute is automatically removed from the final HTML output – it only serves as a control attribute for the plugin.
Requirements
- Oxygen Builder 4.x (must be installed and activated)
- WordPress 5.8 or higher
- PHP 7.4 or higher
Related Plugins
Looking to speed up your Oxygen workflow? Check out Ready Made Oxygen Integration – Turn Figma designs into editable Oxygen Builder sections – copy & paste, just like that.
Optional Dependencies
For 100% reliable CSS scoping, you can install the CSS parser library via Composer:
composer install --no-dev Without the library, the plugin uses a regex fallback that works for most cases.
Credits
Developed by Levels Branding & Webdevelopment OG
Schermafbeeldingen
Before: Block editor with default styling
Installatie
- Upload the plugin files to
/wp-content/plugins/levels-block-editor-styles-for-oxygen-builder/, or install through WordPress plugins screen - Activate the plugin through the ‘Plugins’ screen in WordPress
- Block editor styles work automatically – no configuration needed
- For responsive images, go to Oxygen > Block Editor Styles and enable the feature
Note: This plugin requires Oxygen Builder 4.x to be installed and activated.
FAQ
Does this work with Oxygen 6.x?
No, this plugin is designed specifically for Oxygen Builder 4.x only.
Will this affect my frontend styles?
No, the plugin only loads styles in the block editor. Your frontend remains unchanged.
Do I need to configure anything?
Block editor styles work automatically. For responsive images, go to Oxygen > Block Editor Styles to enable and configure the feature.
How do I set a specific image size for one image?
In Oxygen Builder, select your Image element, go to Advanced > Attributes, and add the attribute
data-image-sizewith a value likemedium,large, orfull. This overrides the global default for that specific image.Does responsive images work with Image URL mode in Oxygen?
Yes! The plugin detects the attachment from the URL regardless of whether you used Media Library or Image URL mode in Oxygen. As long as the image URL points to a file in your WordPress media library, it will be converted.
What if I see weird styling in the editor UI?
All styles are scoped to the content area only. If you experience issues, please report them in the support forum.
Do I need Composer?
No, Composer is optional. The plugin includes a regex fallback for CSS scoping that works in most cases. Installing the CSS parser library via Composer just provides extra reliability for complex CSS.
Beoordelingen
Er zijn geen beoordelingen voor deze plugin.
Bijdragers & ontwikkelaars
“Levels Block Editor Styles for Oxygen Builder” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
Bijdragers
Vertaal “Levels Block Editor Styles for Oxygen Builder” in je eigen taal.
Interesse in ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
1.1.0
- Added settings page under Oxygen > Block Editor Styles
- Added responsive images feature with automatic srcset generation
- Added per-image size control via
data-image-sizeattribute - Added configurable default image size
1.0.0
- Initial release
- Automatic CSS collection from Oxygen sources
- Scoped CSS injection into block editor
- Support for reusable blocks
- Optional CSS parser library for enhanced reliability
- Regex fallback for environments without Composer
