# HaPantheon WordPress Theme

HaPantheon 2.1.0 is an installable classic/hybrid WordPress theme for an RTL editorial archive. Gutenberg stores structured content attributes, while server-rendered source blocks emit the production class hierarchy consumed by the bundled `assets/css/pantheon.css` and `assets/js/pantheon.js`.

## Installation and demo import

1. Upload the theme ZIP under **Appearance → Themes → Add New → Upload Theme** and activate it.
2. Open the top-level WordPress dashboard menu named exactly **Import**.
3. Select **Import demo website**.

The importer creates the front page, posts page, About, Oracle, FAQ, Contact and legal pages; sample posts and five categories; local Media Library attachments; five editable menu locations; post-template assignments; theme settings; and the Site Icon. It is idempotent: rerunning without replacement preserves edited records, while the replacement option restores bundled demo content and menus.

## Gutenberg editing

The corrected front page and special pages use 19 named dynamic blocks under the `hapantheon/` namespace. Each block represents an independently editable production section or component, including the five-hall gate, statistics, halls, ranked post queries, featured story, newsletter, manifesto, timeline, editorial process, Oracle sections, FAQ, contact layout and recipe body.

The blocks store fields, repeaters, media IDs and record-selection values. Their public output uses the source selectors directly. They do not rebuild the design with `core/group`, `core/columns`, or a page-sized Custom HTML block. Select a section in Gutenberg List View, edit its fields in the block sidebar, replace Media Library images, reorder whole sections, or choose dynamic category/post inputs.

Record collections remain dynamic:

- Ranked archive blocks query current WordPress posts by category.
- Hall blocks resolve category names, links and counts.
- The featured block resolves a WordPress post by ID or slug and permits editorial overrides.
- Header and footer links use registered WordPress menus.
- Recipe facts use post meta and structured recipe-block attributes.

## Forms

The newsletter and contact forms remain native, server-rendered WordPress forms. They preserve the production form roots and classes while adding only nonvisual fields required for nonces, spam mitigation, routing and ARIA relationships.

Contact submissions validate and send through `wp_mail()` to the WordPress administrator email. Newsletter signups are stored in WordPress and can be exported as UTF-8 CSV from **Import**. Production mail delivery may require an SMTP plugin or host configuration.

## Editing map

| Area | WordPress screen |
|---|---|
| Front page and special-page sections | **Pages → Edit**, then Gutenberg List View |
| Posts and article body | **Posts → Edit** |
| Article template | Post editor → **Template** |
| Article and recipe metadata | Post editor → **HaPantheon article options** |
| Header and footer navigation | **Appearance → Menus** |
| Logo, colors, font loading and footer settings | **Appearance → Customize** |
| Site Icon | **Appearance → Customize → Site Identity** |
| Demo import and newsletter CSV | **Import** |

## Source-preservation records

`SOURCE-PRESERVATION-MANIFEST.json` maps every corrected source block and public template to its root selectors, production CSS rules, JavaScript hooks, editable fields, dynamic WordPress data and narrowly allowed deviations. The complete selector, breakpoint, asset, file-change and interaction inventory is at `verification/source-parity/inventory.json`.

The production assets `assets/css/pantheon.css`, `assets/js/pantheon.js`, bundled demo images and favicon files remain byte-identical to the attached source package. `assets/css/wordpress.css` is retained as the WordPress compatibility and legacy-content layer; corrected importer compositions no longer use its generic `.hp-*` page layouts.

## Verification evidence and exact limitation

Packaged evidence under `verification/source-parity/` contains paired screenshots at 1440×900 and 390×844, normalized browser-DOM reports, computed-style reports and interaction results for Home, About, Oracle, FAQ, Contact and Recipe compositions. The deterministic attached-source contract reports zero pixel, DOM and computed-style divergence across all 12 samples.

Exact blocker: the supplied package contains no pre-WordPress HTML files, original deployment URL, reference screenshots, database export, or runnable WordPress fixture. Independent original-source versus live-WordPress parity cannot be produced from the supplied inputs. The packaged evidence therefore proves the corrected renderer against the frozen DOM contract mechanically derived from the attached production selectors; it does not claim comparison with an unavailable upstream deployment.

## Architecture

- Native posts, pages, categories, tags, featured images, comments and Media Library.
- No custom post type, ACF dependency, proprietary page builder or required plugin.
- Standard, sidebar, magazine-hero and recipe article templates.
- Dynamic archive, category, search, date and author views.
- Five WordPress menu locations.
- RTL, keyboard focus, reduced-motion support, skip link, accessible dialogs and an accessibility-preferences panel.

License: GPL-2.0-or-later.