=== Web and Roll Editor ===
Contributors: webandroll
Tags: elementor, html widget, content editor, client, editable
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let your clients edit the texts, images and links of your custom Elementor HTML widgets, from a simple form with live preview.

== Description ==

You build pages by pasting your own HTML, CSS and JavaScript into the **Elementor HTML widget**? Your clients cannot change a single word without calling you.

Web and Roll Editor fixes that. Mark the editable zones of your code with simple `data-wr` attributes, and your clients get a clean **Site content** screen where they edit the texts, images and links, with a live preview of the page. Everything that is not marked stays locked: the layout, the CSS and the scripts cannot be broken.

**Elementor is required** (the free version is enough).

= Features =

* List of the pages that contain editable zones, detected automatically.
* Clear form, sorted by section, with your own labels and help texts.
* Live preview (desktop and mobile) updated while typing. Click a zone in the preview to jump to its field.
* Text, rich text (bold, italic, links), images from the media library with their description, links and buttons, animated counters.
* Character limits with a counter, to keep a nice layout.
* FAQ structured data (JSON-LD) rebuilt automatically when a question changes.
* Surgical saving: only the edited zones change, the rest of your code stays byte for byte identical.
* Conflict detection, and the 3 previous versions of each page kept for an instant restore.
* Elementor, WP Rocket, W3 Total Cache and LiteSpeed caches cleared after saving.
* Built-in help: how to edit, how to mark your HTML, examples ready to copy and instructions for your AI code generator.

= How to mark your HTML =

Add `data-wr` (a unique key) and `data-wr-label` (the name shown to your client) on each editable element:

`<h1 data-wr="hero-title" data-wr-label="Main title">The best bread in town</h1>`

Images (`<img>`) and links (`<a>`) are detected automatically. Other attributes: `data-wr-type="richtext"`, `data-wr-type="number"`, `data-wr-group`, `data-wr-max`, `data-wr-help`, `data-wr-text`, `data-wr-size`, `data-wr-faq` and `data-wr-faq-schema`. The full guide is in **Site content > Help > Create the HTML blocks**.

The attributes are invisible: they have no effect on the display or on SEO.

= Pro version =

Web and Roll Editor Pro adds editing directly on the page, repeatable cards and FAQ items (duplicate, move, delete), shared content for the whole site, scheduled changes, Google title and description with AI suggestions, change notifications by e-mail and automatic WebP images. More information on [webandroll-creation-web.fr](https://webandroll-creation-web.fr/).

== Installation ==

1. Install and activate **Elementor**.
2. Install and activate Web and Roll Editor from the Plugins screen.
3. In an Elementor HTML widget, add `data-wr` attributes to the texts, images and links that may change (see **Site content > Help**), then update the page.
4. The page appears in **Site content**: open it, edit, save.

== Frequently Asked Questions ==

= Does it work without Elementor? =

No. The plugin edits the code of Elementor HTML widgets, so Elementor must be installed and active.

= Who can edit the content? =

Every user who can edit pages (Editor and Administrator roles by default), and only the pages they are allowed to edit. The "Create the HTML blocks" help tab is shown to administrators only.

= Can my client break the page? =

No. Only the marked zones are editable, and the values are filtered: plain texts stay plain texts, rich texts only accept bold, italic, underline, line breaks and links.

= I edited the HTML widget in Elementor, is it still editable? =

Yes. The fields are read from the current code every time the editor is opened. If the page is changed elsewhere while someone is editing, the save is refused and the user is asked to reload, so nothing is lost.

= Does it slow down my site? =

No. Nothing is loaded on the front end: the plugin only works in the administration.

= What happens if I uninstall the plugin? =

Your pages keep their last content. The `data-wr` attributes stay in the code but have no effect. The backups stored by the plugin are deleted.

== Screenshots ==

1. The list of the editable pages.
2. The editing form with the live preview.
3. The help screen with examples ready to copy.

== Changelog ==

= 1.0.0 =
* First public version.

== Upgrade Notice ==

= 1.0.0 =
First public version.
