=== 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, full-width-template, 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.16.5-alpha
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An AI-first theme framework. Describe the design you want in the Customizer and Perdita applies it from one structured token document.

== 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 you get in the free theme:

* 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, and full-width templates.
* 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 them onto Perdita tokens. Nothing in the source theme is changed.
* Translation-ready, with a .pot file included.

Perdita is free and open source under the GPL. A companion plugin, Perdita Pro, adds paid modules. The theme works fully without it.

== 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.

== Frequently Asked Questions ==

= 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.

= 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.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).
