=== Borealform Site Editor Toolkit ===
Contributors: scottnanc, borealformstudio
Tags: site editor, full site editing, block editor, patterns, mobile
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.0.2
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Five practical tools for the WordPress Site Editor: patterns, breadcrumbs, responsive preview, content locks, and style variations.

== Description ==

Borealform Site Editor Toolkit adds a browsable pattern gallery, template breadcrumb, responsive preview, structural content locks, and style variation picker to the native WordPress Site Editor. All five tools are included and fully functional after activation.

The plugin loads its scripts and styles only in the Site Editor. It does not add assets, tracking, licence checks, or external requests to public-facing pages or send data to Borealform.

The free edition is complete and is not a trial. Borealform Pro is a separate commercial plugin with premium pattern/template packs, saved style systems, advanced editorial controls, agency workflow features, and priority support. Pro is never required for the tools listed here. Site administrators can optionally compare Pro from the Toolkit's own admin screens; the free plugin does not track that choice.

The human-readable source code and build instructions are maintained at https://github.com/scottjgd/borealform-site-editor-toolkit.

**Pattern Gallery** lets you search and insert registered block patterns.

**Template Breadcrumb** shows the current template, template part, and selected block.

**Responsive Preview** switches the editor canvas between desktop, tablet, and mobile device modes.

**Content Lock** applies native WordPress content-only locks to supported container blocks.

**Style Variations** lets you browse and apply available global style variations. It is available on WordPress 6.5 and later when the active theme supplies variations.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/borealform-site-editor-toolkit/`, or install through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen.
3. Open **Appearance → Editor** to use the toolkit.

== Frequently Asked Questions ==

= Does this work with my theme? =

Yes. The toolkit works with block themes and reads patterns and style variations registered by WordPress, your theme, or other plugins.

= Does this add blocks that will break when I deactivate the plugin? =

No. The bundled patterns use core WordPress blocks. Content locks use native block attributes, so existing content remains valid if the plugin is deactivated.

= Does it load anything on my public-facing site? =

No. The toolkit only loads assets in the WordPress Site Editor. It does not enqueue scripts, styles, or external requests on public-facing pages.

= What WordPress version do I need? =

WordPress 6.4 or higher is required. Style Variations requires WordPress 6.5 or higher and a theme that supplies variations.

= Does the mobile UI replace the WordPress Site Editor on mobile? =

No. It adds a mobile-friendly drawer for the toolkit controls. WordPress core still controls the editor canvas and its mobile behavior.

= Where can I get Pro? =

Site administrators can choose **Appearance → Site Editor Toolkit** or the optional card in the Toolkit's Site Editor panel to compare Pro. Those links open https://borealform.com/blocklogic in a new tab. Pro is distributed separately and is never bundled with this WordPress.org plugin.

= Does the free plugin contact Borealform? =

No. It does not send telemetry, verify licences, collect email addresses, or make background requests. The only external navigation is a link an administrator deliberately opens to learn about the separate Pro extension.

== Development ==

The human-readable source code and build instructions are available at https://github.com/scottjgd/borealform-site-editor-toolkit.

To build the editor assets, run `pnpm install --frozen-lockfile` followed by `pnpm run build`. The repository also includes the WordPress.org packaging validation script.

== Changelog ==

= 1.0.2 =
* Added an administrator-only Toolkit information page and a locally dismissible, optional Pro information card in the Site Editor.
* Confirmed that the free edition makes no licence, telemetry, or background remote requests.
* Strengthened free and Pro release package validation.

= 1.0.1 =
* Renamed the plugin to Borealform Site Editor Toolkit.
* All five editor tools are now included without a licence key or external service.
* Updated translation metadata and contributor information.

= 1.0.0 =
* Initial release.