Static HTML to WP Page Importer

Proposed plugin folder structure

static-html-to-wp-page-importer/
|-- static-html-to-wp-page-importer.php
|-- README.md
|-- assets/
|   |-- admin.css
|   |-- admin.js
|   |-- frontend.css
|   `-- frontend.js
`-- includes/
    |-- class-shtwppi-admin.php
    |-- class-shtwppi-asset-manager.php
    |-- class-shtwppi-importer.php
    |-- class-shtwppi-plugin.php
    `-- class-shtwppi-utils.php

What it does

• Adds a dedicated HTML Importer admin page.
• Accepts either a ZIP upload or a readable server-side folder path.
• Parses multiple HTML files automatically and creates one WordPress Page per file.
• Uses the first h1, then <title>, then filename for the page title.
• Stores a stable import key in post meta to update existing imported pages instead of duplicating them.
• Imports local image and poster assets into the Media Library and rewrites references.
• Validates uploaded ZIP archives and rejects unsafe paths or unsupported file types before extraction.
• Preserves classes, IDs, and useful data-* attributes on wrapper/group content.
• Detects common effect hooks like parallax, sticky, reveal, slider/carousel and reports manual review points.
• Warns when inline styles or linked local CSS contain background-image or related url(...) assets that still need manual migration.
• Enqueues lightweight front-end helpers for reveal and parallax behavior.

Installation / use

1. Copy this plugin folder into wp-content/plugins/static-html-to-wp-page-importer.
2. Activate Static HTML to WP Page Importer in WordPress Admin.
3. Open HTML Importer from the admin menu.
4. Upload a ZIP of your static export or enter an absolute server path to the extracted folder.
5. Run the import and review the generated logs, warnings, and created pages.

Known limitations / manual review points

• Complex sliders, custom script-driven animations, and framework-specific interactions are preserved as markup but may still need manual JS replacement.
• The importer strips script tags from imported page content to avoid carrying over unsafe or duplicate scripts.
• Background images referenced through inline styles or CSS files are detected and logged, but they are not automatically imported into the Media Library in this first version.
• Gutenberg conversion is intentionally hybrid: semantic nodes are mapped into blocks where practical, while complex wrappers fall back to preserved HTML/group markup for layout fidelity.
• PHP linting was not executed in this workspace because php is not installed in the current shell environment.