=== HaPantheon ===
Contributors: hapantheon
Requires at least: 6.5
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: blog, news, custom-colors, custom-logo, custom-menu, featured-images, rtl-language-support, threaded-comments, translation-ready, wide-blocks, block-styles

An RTL editorial WordPress theme with source-preserving Gutenberg blocks, dynamic archives, native forms, editable menus, local demo media and one-click import.

== Description ==

HaPantheon uses Gutenberg as the editing layer over the production frontend contract. Nineteen named dynamic blocks store structured text, repeaters, media and record selectors, then emit the class hierarchy consumed by the unchanged production pantheon.css and pantheon.js assets. Corrected imported pages do not use generic Group/Columns layouts or page-sized Custom HTML blocks.

Included public surfaces:
* Source-preserving front page
* Dynamic posts, category, date, author and search archives
* About, Oracle, FAQ, Contact and legal pages
* Standard article
* Article with sidebar and generated table of contents
* Magazine hero article
* Recipe article
* Native comments, search, forms and 404 state

Dynamic sections query WordPress posts and categories. Header and footer links use five registered menu locations. No CPT, ACF dependency, page-builder dependency or required plugin is introduced.

== Installation ==

1. Open Appearance > Themes > Add New > Upload Theme.
2. Upload and activate HaPantheon.
3. Open the top-level dashboard menu named Import.
4. Click Import demo website.
5. Edit pages under Pages, posts under Posts, menus under Appearance > Menus, and global options under Appearance > Customize.

The importer is idempotent. Rerunning without replacement preserves edited records and creates only missing items. Selecting replacement restores bundled page/post content and imported menus.

== Gutenberg Source Blocks ==

The block inserter includes source sections for page heroes, the living-archive gate, statistics, halls, ranked post queries, featured story, Oracle sections, newsletter, manifesto, principles, timeline, editorial process, archive keeper, FAQ, contact layout and recipe body.

Use Gutenberg List View to select and reorder complete source sections. Block inspector panels expose meaningful fields, repeaters, Media Library controls, destination URLs, category slugs and post selectors. Public render callbacks merge the WordPress block class onto the existing source root and introduce no generic frontend wrapper.

== Forms ==

The contact and newsletter forms are server-rendered WordPress forms. They include nonce validation, required-field validation, honeypot protection, sanitization and accessible result regions. Contact mail uses wp_mail(); hosting may require SMTP configuration. Newsletter records and CSV export are available under Import.

== Menus and Footer ==

Five conventional WordPress menu locations are registered:
* Primary Menu
* Footer — Navigation
* Footer — Halls / Categories
* Footer — Information and Legal
* Footer — Bottom Legal Links

Footer description, closing line and social links are available under Appearance > Customize.

== Source Preservation and Verification ==

SOURCE-PRESERVATION-MANIFEST.json maps every corrected block and template to source selectors, CSS rules, JavaScript hooks, editable fields, dynamic data and allowed deviations. verification/source-parity/ contains paired screenshots, normalized DOM, computed styles and interaction results at 1440x900 and 390x844 for six corrected page compositions.

The production pantheon.css and pantheon.js files and bundled images/favicons remain byte-identical to the attached source.

Exact limitation: 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. Packaged evidence is explicitly limited to the frozen attached-source selector/renderer contract.

== Accessibility ==

The theme includes semantic landmarks, a skip link, visible keyboard focus, reduced-motion handling, keyboard-operable dialogs, native form labels/errors and an accessibility-preferences panel. Site owners remain responsible for auditing final content, plugins, alternative text and legal conformance.

== Changelog ==

= 2.1.0 =
* Replaced generic imported page layouts with 19 source-preserving dynamic Gutenberg blocks.
* Kept production pantheon.css, pantheon.js, images and favicons unchanged.
* Added structured repeaters, media controls and server-rendered editor previews.
* Kept ranked posts, categories and featured content WordPress-native and dynamic.
* Removed the extra full-layout article wrapper and extra public form wrappers.
* Added SOURCE-PRESERVATION-MANIFEST.json and complete selector/asset/interaction inventory.
* Added deterministic paired screenshot, DOM, computed-style and interaction evidence.
* Recorded the exact missing-upstream/live-WordPress parity blocker.

= 2.0.0 =
* Previous Gutenberg conversion candidate.

= 1.0.0 =
* Initial WordPress release.