=== Perdita ===
Contributors: eric1985
Tags: blog, one-column, two-columns, left-sidebar, right-sidebar, custom-colors, custom-logo, custom-menu, editor-style, featured-images, footer-widgets, theme-options, threaded-comments, translation-ready, block-patterns, wide-blocks
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 0.17.1-alpha
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A design-token theme. Your colors, fonts, and layout live in one structured document, and you can edit it by hand or describe the change you want.

== Description ==

Perdita is a classic parent theme built around one idea: your site's design lives in a single, structured token document (colors, fonts, type scale, spacing, layout), and everything else reads from it. Change a token in the Customizer and the whole site follows. Connect an AI provider and you can describe the change in plain language instead.

What the theme gives you:

* Live Customizer controls for colors, typography, type scale, spacing, radius, layout, header, and footer, with instant preview.
* A "describe it" chat control in the Customizer that turns a sentence into a design change you can review before publishing.
* Design suggestions from your logo or a short brand description.
* A one-click child theme generator, so your customizations survive updates.
* Header and footer builders with a call-to-action button, search, and up to four footer widget columns.
* Blog and archive layouts (list or grid), sidebar left, right, or none.
* Block editor support: editor styles, wide and full alignments, and a library of token-aware block patterns.
* Migration helpers that read your existing Astra, Kadence, GeneratePress, or Genesis settings and map the colors, fonts, layout, menus, and custom CSS onto Perdita tokens. Nothing in the source theme is changed.
* Translation-ready, with a .pot file included.

Contact forms, SEO, caching, analytics, backups, and the other site features are not part of the theme. They live in the free Perdita Core plugin, because a theme is for design and presentation. Install the plugin if you want them, and skip it if you don't. The theme is complete on its own either way.

Perdita is free and open source under the GPL.

== Installation ==

1. In your WordPress admin go to Appearance > Themes > Add New > Upload Theme.
2. Upload the Perdita zip and click Install Now, then Activate.
3. Open Appearance > Customize to set your colors, fonts, and layout, or run the setup wizard from Appearance > Perdita.
4. Optional: generate a child theme from Appearance > Perdita > Tools before making code changes.
5. Optional: install the free Perdita Core plugin if you want contact forms, SEO, or caching.

== Frequently Asked Questions ==

= Where are the contact forms and SEO settings? =

In the free Perdita Core plugin. Themes on wordpress.org are for design and presentation, so anything that keeps working after you switch themes (forms, SEO, caching, analytics, backups) belongs in a plugin. Install Perdita Core and those features come back with your existing settings intact.

= Do I need an AI account to use Perdita? =

No. Every design control works by hand. AI features are optional and stay off until you connect a provider.

= Which AI providers work? =

OpenRouter (free tier available, connects with a couple of clicks), Anthropic, and OpenAI. You bring your own account, and keys are stored server-side and never sent to the browser.

= Will my changes survive theme updates? =

Yes. Design settings live in the database, not in theme files. For code changes, generate a child theme from Appearance > Perdita > Tools.

= Where does Perdita store its settings? =

In one option, perdita_settings. That's the whole token document, plus your setup state and any AI provider key you've entered. Generated CSS and the font list are cached in transients, and the logo and menu assignments use core theme mods.

= Does it work with the block editor? =

Yes. Perdita ships editor styles, supports wide and full alignments, and registers block patterns that follow your design tokens.

= Does Perdita load anything from third-party servers? =

Only Google Fonts, when you choose a Google font in the Customizer. Pick a system font and nothing external loads.

== Changelog ==

= 0.17.1-alpha =
* Migrate from Kadence and GeneratePress as well as Astra and Genesis. Palette, fonts, type scale, content width, sidebar, and blog grid map onto Perdita tokens, and the old theme's editor color classes and CSS variables are carried into Additional CSS so published content keeps its colors.
* The Genesis migration note now points at the Perdita Core SEO importer, which reads Genesis SEO settings from Perdita Core 1.0.1 on.

= 0.17.0-alpha =
* Plugin-territory features moved to the free Perdita Core plugin so the theme can be submitted to wordpress.org. Forms, SEO, shortcodes, the AI section builder, and every module (caching, analytics, backups, security, SMTP, search console, PageSpeed, related posts, subscriptions, sales, MCP) now live there, with your settings carried over.
* Perdita's admin screen moved to Appearance > Perdita, with Dashboard, Design, and Tools tabs. The old top-level menu is gone.
* Activating the theme no longer redirects you anywhere. The setup wizard is offered in a dismissible notice instead.
* The theme now creates a single database option, perdita_settings. Setup state and provider keys moved into it, and the generated CSS and font list are transients.
* Migration keeps design, menus, and custom CSS. Importing SEO settings from Yoast or All in One SEO is handled by the plugin's SEO screen.

= 0.16.5-alpha =
* Security: the MCP server no longer lists other users' drafts and private posts to a low-privilege token, and connecting an app requires an editor-level account.
* Security: theme updates are now verified against the published checksum on every install, not only when the update check happened to run in the same request.
* Fixed: comments now render with the theme's own template instead of WordPress's deprecated fallback.
* Fixed: a changed security salt no longer silently turns off Turnstile; the form fails closed and an admin notice explains which settings need re-entering.
* Fixed: SMTP opportunistic TLS, subscription confirm links being reusable, unsubscribe links firing from mail scanners, author archives on plain permalinks.
* Performance: tracking parameters (utm_*, fbclid, gclid) no longer bypass the page cache, one comment purges one page instead of the whole cache, and generated CSS, the font list and related posts are cached without extra queries.
* Tested up to WordPress 7.1 on PHP 8.5.

= 0.16.4-alpha =
* Fixed nine issues found rolling the theme out on a production site: viewport tag, reading measure and wide/full alignments, mobile navigation with a no-JS fallback, cache busting, migration from WP-CLI, palette import, and header/footer hooks for third-party templates.
* Reading measure now resolves to an absolute length so headings and body text share one column.

= 0.16.3-alpha =
* Security fix: guard sodium_memzero() on hosts without ext-sodium.
* Reproducible release builds.

= 0.16.2-alpha =
* Module system with built-in modules.

== Copyright ==

Perdita WordPress Theme, (C) 2026 Eric Rosenberg, Rosenberg Digital LLC.
Perdita is distributed under the terms of the GNU GPL v2 or later.

This theme bundles no third-party code, fonts, or images.

* screenshot.png: original work by the theme author, GPLv2 or later.
* data/google-fonts.json: a list of Google Font family names and categories used to populate the font picker. Font files themselves are not bundled. When a Google font is selected, it is loaded from fonts.googleapis.com under each font's own license (SIL Open Font License or Apache 2.0, see https://fonts.google.com/attribution).
