Skip to content

v0.9.0-beta.1 — Builder-safe native Oxygen imports

Pre-release
Pre-release

Choose a tag to compare

View all tags
@kamilskicki kamilskicki released this 23 Jul 08:23
v0.9.0-beta.1
0917bfc

Oxygen HTML Converter 0.9.0 beta 1

This public beta turns supported HTML into native Oxygen Builder 6 content that
can be opened, edited, saved, and reopened without corrupting the Oxygen
document tree. It is an honest supported-scope release, not a promise to
convert every arbitrary frontend application.

Highlights

  • Builder-safe Oxygen document serialization with the required root metadata,
    stable node IDs, validation, and AJAX document payloads.
  • Native mapping for supported HTML structure, inline styles, selectors,
    responsive styles, variables, utility-first markup, and common interactions.
  • Safe Mode by default: executable fallbacks require an explicit unsafe opt-in;
    unsupported forms, dynamic data, WooCommerce, complex applications, and
    advanced component patterns are reported instead of guessed.
  • Static site-kit import support for explicit pages, templates, headers,
    footers, parts, reusable blocks/components, selectors, variables, homepage
    assignment, and menus.
  • Builder paste/import workflows, conversion audit reporting, rollback
    metadata, retained page CSS guidance, and versioned extension hooks.
  • Reproducible release packaging, WordPress.org artwork, local fixture gates,
    staging browser round-trips, PHP/JS/static-analysis CI, dependency audits,
    Dependabot, structured issue forms, and private security reporting guidance.

Requirements

  • WordPress 6.5 or newer
  • PHP 8.2 or newer
  • Oxygen Builder 6.1.0
  • An administrator with manage_options by default

Install

Download and upload the attached
oxygen-html-converter-0.9.0-beta.zip through Plugins → Add New → Upload
Plugin.

Do not install GitHub's automatically generated “Source code” archives as the
WordPress plugin package. The attached ZIP is the allowlist-built and verified
runtime artifact.

Upgrade notes

  • No automatic database or option migration runs from 0.8.0 beta.
  • Existing imported content is not silently rewritten.
  • Reconvert and re-import on staging when an older import needs the new
    builder-safe document contract.
  • Page/fallback CSS stored in _oxy_html_converter_page_styles is emitted by
    this plugin. Move required CSS into Oxygen or another persistent stylesheet
    before deactivating or uninstalling the plugin.
  • Back up first and validate representative imports on staging.

See the upgrade guide
and operations guide.

Verified release evidence

  • Release commit: 0917bfc91c5d22d0749f406d418f97bc0515a246
  • Artifact SHA-256:
    38bac345d17c0363e555bcd7d13a7424443f0f37e89ee360e2a377566e70aed9
  • Runtime ZIP: 107 files, 330,364 bytes, no forbidden development or local
    artifact paths.
  • PHPUnit: 848 tests, 6,447 assertions.
  • JavaScript: 15/15 suites.
  • PHPCS, PHPStan, Composer validation, WordPress.org readme validation,
    Composer audit, npm audit, and 37-fixture local audit: passed.
  • GitHub Actions on PHP 8.2 and 8.3:
    passed; the PHP 8.2 job also rebuilt and uploaded the verified ZIP.
  • Exact SHA-named artifact installed on the canonical Oxygen staging target;
    installed manifest matched the ZIP 107/107 with zero missing, extra, or
    mismatched files.
  • Staging admin preview/convert, desktop and mobile frontend, Oxygen Builder
    save, and persistence after reload: passed with zero page, console, or
    request errors.

Known boundaries

This beta is strongest for static marketing and landing-page HTML. It does not
claim automatic parity for SPAs, arbitrary framework runtimes, inferred CMS
data, loops, WooCommerce templates, functional forms without a verified
integration, or every external CSS/JavaScript stack. Review the
supported scope
before production use.

Security

Do not open public issues for vulnerabilities. Follow the
security policy
and use GitHub Private Vulnerability Reporting.

Full details

Assets 3
Loading