Oxygen HTML Converter WP Registry grade B. Medium-severity findings · 1 findingWP RegistryMedium-severity findings · 1 findingOpen the reportB

Convert pasted HTML into native Oxygen Builder 6 content that can be edited and saved in the builder.

This repository is the public Core plugin. The long-term product goal is simple: paste HTML, get a native Oxygen document, and continue editing without validation errors or broken document state.

Current staging candidate:

• v0.9.1-beta, the compatibility and import-integrity update; public publication is separate from staging deployment.
• WordPress.org promotion uses the numeric stable tag 0.9.1; the plugin runtime retains the 0.9.1-beta prerelease version.

What Core Does

• Converts full HTML fragments and pages into native Oxygen elements
• Preserves IDs, classes, data attributes, and inline styles
• Supports builder paste/import flows
• Maps supported safe interactions; executable script fallback requires explicit unsafe opt-in and permission
• Keeps imported content editable in Oxygen Builder

Supported Scope

Core is intended for:

• single-page marketing and landing-page HTML
• inline styles
• utility-first markup, especially Tailwind-like classes
• native Oxygen conversion of supported utility styling
• common frontend interactions such as nav toggles, anchor scroll, reveal-on-scroll, counters, and simple inline handlers

Core is not yet a promise of perfect conversion for every arbitrary frontend stack on the web.

Detailed scope:

• Supported Scope
• OxyMade/Oxygen 6 Globals + WindPress Decision
• Definition of Done for v0.9.1-beta

Import Methods

• Admin page: Tools -> Oxygen HTML Converter
• Builder paste: Ctrl+V
• Builder import modal: Ctrl+Shift+H

Requirements

• WordPress 6.5+
• PHP 8.2+
• Oxygen Builder 6.1.0 or 6.1.3 (stable); 6.2.0-beta.8 is an explicitly experimental compatibility target. Other unverified versions fail closed.
• Logged-in user with manage_options by default

The required capability can be changed with oxy_html_converter_required_capability.

Open Core Model

This repo contains only the public Core.

• Core owns conversion, builder-safe serialization, editability, and baseline parity
• Pro should extend Core through hooks, not patch Core files
• Core must not require Pro for the import/editability guarantee

More detail:

• Open Core Model

Project Docs

• Documentation Index
• Contributing
• Security Policy
• Release Checklist
• Release Notes: 0.9.0-beta
• Upgrade Guide
• Operations and Cache Permissions
• Changelog

Installation

1. Download the plugin ZIP attached to the latest GitHub release.
2. In WordPress admin, go to Plugins -> Add New -> Upload Plugin.
3. Upload the ZIP and activate it.
4. Ensure a supported Oxygen Builder version is installed and active.

Do not install GitHub's automatically generated “Source code” archives as the WordPress plugin package. Use the attached oxygen-html-converter-*.zip artifact, which is built and verified by the repository release tooling.

Testing

• Canonical reproducible inputs and their stable contract: fixtures/html/fixture-index.json
• Fast gate: npm run check
• PHP unit gate: composer test
• JS tests: npm run test:js
• Hermetic fixture gate: npm run test:fixtures:local
• Build and hash the exact release artifact: npm run build:zip
• Install that explicit ZIP on the maintained SSH staging target using the commands in docs/RELEASE_CHECKLIST.md
• Focused staging fixture gate: npm run test:fixtures -- --ssh-host=oxyconvo.lab --wordpress-root=/var/www/wordpress
• Staging browser round-trip: npm run test:staging:browser -- --base-url=https://oxyconvo.lab --page-id=<id>
• Docker-only legacy live helpers remain available for isolated local debugging; they are not the canonical release target
• Release verification: npm run release:verify
• Build release ZIP: npm run build:zip

Extension Hooks

Core exposes versioned extension points for add-ons, including Pro:

• oxy_html_converter_before_boot
• oxy_html_converter_core_init
• oxy_html_converter_loaded
• oxy_html_converter_feature_flags
• oxy_html_converter_builder_script_data
• oxy_html_converter_after_enqueue_builder_scripts
• oxy_html_converter_convert_options
• oxy_html_converter_required_capability
• oxy_html_converter_preview_options
• oxy_html_converter_batch_options
• oxy_html_converter_tree_builder
• oxy_html_converter_conversion_result
• oxy_html_converter_convert_response
• oxy_html_converter_batch_response
• oxy_html_converter_preview_response
• oxy_html_converter_expose_error_details

API compatibility is versioned via OXY_HTML_CONVERTER_API_VERSION.

License

GPL-2.0-or-later. See LICENSE.

Support And Security

• Read SUPPORT.md before opening a question or bug report.
• Use the structured GitHub issue forms for reproducible bugs and feature requests.
• Follow SECURITY.md and report vulnerabilities privately.