=== WebRitual Block Bridge for Elementor ===
Contributors: webritual
Donate link: https://revolut.me/rusakevicius
Tags: elementor, block-editor, converter, migration, blocks
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Migrate Elementor pages to WordPress Gutenberg Block Editor with automatic backups and one-click rollback. Convert 20 widgets safely.

== Description ==

WebRitual Block Bridge is a conversion tool that transforms Elementor-built pages and posts into WordPress Block Editor (Gutenberg) content.

The plugin reads Elementor page data and converts it into equivalent Gutenberg blocks. It supports 20 common Elementor widgets and automatically creates backups before each conversion, allowing you to restore the original content if needed.

**Use Cases:**
* Converting Elementor pages to Gutenberg blocks
* Migrating from Elementor to native WordPress Block Editor
* Testing Block Editor compatibility with existing Elementor content
* Transitioning to WordPress Full Site Editing (FSE)

= Key Features =

* **Individual Post Selection**: Choose exactly which pages/posts to convert via intuitive UI
* **Live Preview**: See conversion status in real-time
* **Automatic Backup**: Every conversion creates a backup for safe rollback
* **One-Click Rollback**: Restore original Elementor content anytime
* **Database Cleanup**: Remove Elementor metadata after successful conversion
* **Translation Ready**: Fully translatable with i18n support

= What Gets Converted? =

The plugin intelligently converts your Elementor content structure:
* **Layouts**: Sections → Group Blocks, Columns → Column Blocks
* **Content**: Text, headings, images, buttons, videos
* **Interactive Elements**: Tabs, accordions, toggles
* **Media**: Image galleries and carousels (with lightbox support via Kadence)
* **Styling**: Basic styles are preserved where possible

= Supported Widgets (20 Total) =

**Basic Content:**
* Heading → Heading Block
* Text Editor → Paragraph Block
* Image → Image Block
* Button → Button Block
* Icon → HTML Block (Kadence icon)
* Spacer → Spacer Block
* Divider → Separator Block

**Media:**
* Video → Embed Block
* Image Carousel → Kadence Advanced Gallery (carousel with lightbox)
* Image Gallery → Kadence Advanced Gallery (grid with lightbox)

**Layout:**
* Section → Group Block
* Column → Column Block
* Inner Section → Group Block

**Interactive:**
* Tabs → Kadence Tabs Block
* Accordion → Details Block
* Toggle → Details Block

**Advanced:**
* Shortcode → Shortcode Block
* HTML → HTML Block
* Menu Anchor → HTML Block (anchor)
* Sidebar → Legacy Widget Block

= Requirements =

* WordPress 6.5 or higher
* PHP 7.4 or higher
* **Kadence Blocks** plugin (automatically prompted on activation)

WordPress will automatically prompt you to install Kadence Blocks when you activate this plugin. This is required for advanced features like tabs, galleries, and carousels to work properly.

= How It Works =

1. **Scan**: The plugin scans your site for Elementor-built content
2. **Select**: Choose which posts/pages to convert
3. **Convert**: Click convert to start the conversion process
4. **Verify**: Review your converted content in the Block Editor
5. **Rollback**: If needed, restore original Elementor content with one click
6. **Cleanup**: Optionally remove Elementor metadata to free up database space

The plugin processes each page individually, creating a backup before conversion. You can convert pages one at a time or in batches, and rollback any conversion if the result is not satisfactory.

= Safety First =

* Automatic backups before every conversion
* One-click rollback to restore original content
* No data loss - backups stored in WordPress database
* Test on staging environment recommended

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/` directory, or install through WordPress plugins screen
2. Activate the plugin through the 'Plugins' screen in WordPress
3. WordPress will prompt you to install Kadence Blocks (required dependency)
4. Navigate to **Block Bridge** in your WordPress admin
5. Scan for Elementor posts and start converting!

== Frequently Asked Questions ==

= What exactly does this plugin do? =

This plugin converts your Elementor-built pages into native WordPress Block Editor (Gutenberg) content. It reads your Elementor data, transforms it into equivalent Gutenberg blocks, and updates your page content - all while keeping a backup of the original. Think of it as a translator that converts "Elementor language" into "Gutenberg language."

= Is this safe to use on a live site? =

While the plugin includes automatic backups and rollback functionality, we strongly recommend testing on a staging environment first.

= What happens to my original Elementor content? =

Your original Elementor content is automatically backed up before conversion. You can rollback anytime to restore it.

= Do I need to keep Elementor installed? =

After successful conversion and verification, you can deactivate and remove Elementor. However, keep it installed until you're sure all conversions are correct.

= Why is Kadence Blocks required? =

Kadence Blocks provides advanced features like tabs, galleries with lightbox, and carousels that don't exist in core Gutenberg blocks.

= Can I convert back to Elementor? =

Yes! Use the rollback feature to restore your original Elementor content anytime.

= What if a widget isn't supported? =

Unsupported widgets are converted to HTML blocks with a comment indicating the original widget type. You can manually recreate them in Gutenberg.

= Will this work with Elementor Pro widgets? =

Currently, the plugin supports 20 common Elementor widgets. Elementor Pro widgets may require manual conversion.

== Screenshots ==

1. Main conversion interface with post selection
2. Real-time conversion progress
3. Backup and rollback functionality
4. Database cleanup tools
5. Conversion statistics dashboard
6. Support this work - Scan QR code to donate via Revolut

== Changelog ==

= 1.0.0 =
* Initial release
* Support for 20 common Elementor widgets
* Automatic backup and rollback functionality
* Database cleanup tools
* Translation ready
* Kadence Blocks integration for advanced features

== Upgrade Notice ==

= 1.0.0 =
Initial release of WebRitual Block Bridge for Elementor.

== 💝 Support This Work ==

This plugin is completely free and open-source. If it saved you time and money by helping you migrate away from Elementor, voluntary donations are appreciated to support ongoing development and maintenance:

[Buy me a Coffee (Revolut)](https://revolut.me/rusakevicius)
[Buy me a Coffee (GitHub)](https://github.com/sponsors/WebRitual)

All donations are voluntary and do not affect plugin functionality. Your support helps maintain this free tool for the WordPress community. Thank you! 🙏

== Support & Bug Reports ==

For support, feature requests, or bug reports, please visit [https://webritual.eu/](https://webritual.eu/)

== Credits ==

Developed by [Web Ritual](https://webritual.eu/)
