=== Wizard Blocks Manager for Gutenberg ===
Contributors: frapesce
Tags: editor, generate, create, crud, easy
Requires at least: 6.8
Tested up to: 7.0
Stable tag: 2.0
Requires PHP: 8.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Easily create, edit, and manage Gutenberg blocks without writing React

== Description ==

The ultimate **No-React Visual Builder** for Native Gutenberg Blocks.
Create, edit, and manage custom blocks directly from your WordPress dashboard, generating 100% native `block.json` and React code under the hood. 
**Zero vendor lock-in**: export your blocks and use them standalone!

**Follow us on [GITHUB](https://github.com/frafish/wizard-blocks)!**

= Effortlessly Build & Manage Gutenberg Blocks =

Wizard Blocks acts as a powerful transpiler: you configure attributes visually, and it automatically writes the complex React (`wp.element`, `wp.components`) and JS code required by Gutenberg. You get the performance of native blocks without writing a single line of Javascript.

= Features =

- Quick **Build** and Edit Custom blocks, with **Wizard editing** for all block options
- Powerful built-in **Codemirror Code Editor** for PHP, JS, CSS and JSON fields
- Easy **Attributes Manager** with Visual Editor to add infinite options to your Block
- Custom Block edit **Tabs** (Content, Style, Advanced, etc) for logic separation of your Attributes
- Manage unlimited **Block Variations**, to cover a wide range of scenarios
- Quick **Import** from zip (plugin or backup) and **Export** backup zip of all custom blocks
- Get **autogenerated PHP Code** to register custom blocks into your Theme functions.php file
- Block **Custom SVG Icon** support, or classic Dashicon alternative
- Import any **Assets CSS and JS libs** from Media Library, optimized enqueue of them only if block is used
- Block Media, to include your **relative images** in your block Content
- **Disable** unused/unwanted Blocks
- Block **Versioning** (with Revision support)
- Block **Styles Variation**
- Use your custom Block **Textdomain**
- Control **Attributes conditional logic** display rules
- Manage **Block Example values** or **Image Preview**
- Full **Telex** compatibility and support, simplified import of generated zip

[More information on Wizard Blocks](https://wizardblocks.io/wizard/)

Perfect for:
- Content creators
- Web designers
- Web agencies

**Why choose Wizard Blocks over the competitors?**

- **🔥 Zero Vendor Lock-in (Standalone Blocks):** Unlike other block builders, Wizard Blocks generates standard Gutenberg file structures (`block.json`, PHP, CSS, JS). You can export your blocks, drop them into any theme, and deactivate our plugin. They will keep working forever!
- **🚀 Native Performance, No Bloat:** We don't use heavy wrappers or shortcodes to render blocks in the frontend. You get 100% native Gutenberg blocks, keeping your database clean and your website blazing fast.
- **⚛️ No React/JS Knowledge Needed:** Build complex block settings using our Visual Attribute Manager. The plugin automatically transpiles your choices into optimized React/JavaScript code (`editor.js`) on the fly.
- **🛠 Built-in IDE & Versioning:** Write your PHP renders and CSS directly in the dashboard using the integrated Codemirror editor. Keep your code safe with the native WordPress Revision system applied to your blocks.
- **📦 Developer Friendly:** Import/Export via ZIP, automatically generate `functions.php` snippets, and sync your blocks across multiple projects seamlessly.
- **💻 Complete management of CSS, JS and PHP Templates** directly from the interface: no FTP or direct file access needed.

= Compatibility =

Fully compatible with the WP Gutenberg Block standard!
Once your blocks are generated, you can **use them standalone in your theme or plugin**.
There is no need to keep this plugin active to render your blocks in the frontend. 

== PRO *Advanced Features:* == 

- **Personal Block Library** with **Cloud sync** (on your Private site or Public hub)
- Full access to our Free and PRO Block Repository with one click installation
- Generate Block String **Translations**, for Render labels and Attributes, also compatible with WPML
- Full **Twig/Timber 2** support, in Block Render and Settings
- Use all Custom Gutenberg Blocks as **native Elementor Widgets**
- Insert Gutenberg Blocks and Patterns as **Shortcode** in any Editor
- Add **Custom CSS** setting to any Block, to easily improve styles with automatic **selector**, optimized in frontend
- **Display Conditions** applied to any Block based on Rules (User Role, Date, Device Type, Custom Meta, etc)

[Discover PRO](https://wizardblocks.io/pro/)

More is yet to come...
- Limit blocks on wanted Post Type Edit page
- Static rendered blocks (HTML, not PHP) with Handlebars, more security and super speed (cached)
- **API Controls** (like Roles, Custom Fields, Posts, Users, Taxonomy, Terms)
- Move/Install automatically a Block into **current Theme Child** or **autogenerated Custom Plugin** 


*Wizard Blocks repository:*
- Gutenberg **Contact Form** with multiple Actions
- entities list DataTables view
- Loop **Swiper Carousel**
- Frontend Filters
- HTML Scraping
- our database is growing so... Contact us and REQUEST YOURS!


== Installation ==

= Minimum Requirements =

* WordPress 6.0 or greater
* PHP version 7.4 or greater
* MySQL version 5.0 or greater
* WordPress Memory limit of 128 MB

= We recommend your host supports: =

* PHP version 8.0 or greater
* MySQL version 8.0 or greater
* WordPress Memory limit of 256 MB or higher is preferred

== Frequently Asked Questions ==

= Is compatible with Elementor? =

Yes, with PRO if you enable "Gutenberg Blocks Widgets" Feature in Elementor Settings page this plugin make a porting of each Gutenberg Block as Elementor Widget, so you can use them in any Elementor Template.

= Is compatible with Divi, Visual Composer, Oxygen, Breakdance, Beaver, Brizy, SeedProd, etc? =

Yes, with PRO is compatible with ANY Wordpress Builder which supports Shortcodes, using Blocks as Shortcodes widget.

= Could I insert a block in a specific Hook? =

Yes, with PRO is possible, but you have to insert it programmatically (via functions.php) as Block Shortcode.

= Does it support native MultiSite/Network mode? =

Yes, it works fine, managing Blocks separately for each site instance.

== Screenshots ==

1. **Easily Create Custom Gutenberg Blocks:** A dedicated admin menu provides access to all Block creation and management features.
2. **Seamless WordPress Integration:** Leverage native themes and core features for a smooth experience.
3. **Secure Dynamic Content:** Build dynamic block content using plain PHP, eliminating the risk of site disruption (as writing Shortcodes in functions.php).
4. **Automated Editor JavaScript:** The built-in wizard generates all necessary, minified, and optimized editor JavaScript (no npm required).
5. **Flexible Scripting and Styling:** Write custom scripts and styles, and optionally upload external CSS and JS libraries.
6. **Intuitive Attribute Management:** Easily generate and manage block attributes, readily available for rendering.
7. **Full Block JSON Schema Support:** Visually manage all standard block JSON fields, adhering to the official block structure.
8. **Block Revisions:** Maintain multiple block revisions to safeguard custom code and facilitate version control.
9. **Usage Statistics:** Track and analyze usage statistics for all blocks—custom, core, and plugin-provided.
10. **Streamlined Import/Export:** Easily import and export blocks, share single block ZIP files across sites, and optionally deactivate the plugin once blocks are registered in your theme.
11. **Block Media Management:** Select images from Media Library to move them inside your Block
12. **Block Styles:** Add Custom styles and colors for a quick block styling.
13. **Block Variations:** Add Variations for your Block to reuse them easily in different layouts.
14. **Block Supports:** Toggle native Block Supports like: align, anchor, color, etc
15. **Import with Full Telex Compatibility:** Import your Telex projects with ease, preserving all configurations and assets.

== Changelog ==

= 2.0 - 2026-05-20 =
* Add Block Variations management 
* Add Block Examples management
* Add Block Styles management  
* Moved Elementor and Shortcode to PRO 

= 1.3 - 2025-10-03 =
* Added Media Block
* Stability fixes
* Added compatibility with 3rd part blocks
* Full compatibility with Telex
* Added Hooks and Filters

= 1.2 - 25-06-2025 =
* Added Ctrl+S save block
* Added Code Editor Resizer
* Enabled native block API
* Stability fixes

= 1.1 - 31-01-2025 =
* Stability fixes
* Edit Multiple files per assets

= 1.0.2 - 22-10-2024 =
* Added Revisions
* Added Attributes Condition
* Stability fixes

= 1.0.1 - 17-05-2024 =
* First release

