=== Perdita ===
Contributors: eric1985
Tags: blog, one-column, two-columns, left-sidebar, right-sidebar, custom-background, custom-colors, custom-header, 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.19.24-beta
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 every template reads from it.

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

What the theme gives you:

* Live Customizer controls for colors, typography, type scale, spacing, radius, layout, header, and footer, with instant preview.
* A setup wizard for your site name, logo, colors, fonts, and layout.
* 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 that follow your tokens, 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, and other site features are not part of the theme, because a theme is for design and presentation. Use any plugin you like for them. The theme is complete on its own.

Perdita is free and open source under the GPL.

== Installation ==

1. In your WordPress admin go to Appearance > Themes > Add New and search for Perdita, or upload the Perdita zip with Upload Theme.
2. Click Install Now, then Activate.
3. Open Appearance > Customize to set your colors, fonts, and layout, or run the setup wizard from Appearance > Perdita.

== Frequently Asked Questions ==

= Will my changes survive theme updates? =

Yes. Design settings live in the database, not in theme files. For code changes, use a child theme.

= Where does Perdita store its settings? =

In one option, perdita_settings. That's the whole token document plus your setup state. 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. The editor uses your design tokens, so what you edit matches what visitors see. Perdita supports wide and full alignments and registers block patterns that follow your tokens.

= Does the setup wizard change WordPress settings? =

Only the ones you fill in. The wizard's site name, tagline, and site icon fields are the same values as Settings > General, and saving the wizard updates them there. The wizard says so on screen.

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

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

== Privacy ==

Perdita does not collect, store, or send any data about you or your visitors, and it sets no cookies. When you choose a Google font, visitors' browsers load that font from Google's servers (fonts.googleapis.com and fonts.gstatic.com), which receive the visitor's IP address as part of the request. See Google's privacy policy at https://policies.google.com/privacy. Choose a system font if you don't want that.

== Changelog ==

= 0.19.24-beta =
* Maintenance release, in lock step with Perdita Core and Perdita Pro. Nothing changes in the theme.

= 0.19.23-beta =
* Maintenance release, in lock step with Perdita Core and Perdita Pro. Nothing changes in the theme.

= 0.19.22-beta =
* Fix: links and headings inside a Cover block with no background layer keep your theme's colors. In 0.19.21, a cover saved by an old WordPress could show white links on a light background.

= 0.19.21-beta =
* New: your Google Fonts stylesheet loads without blocking the first paint. You can turn that off with the `perdita_fonts_async` filter.
* New: `perdita_replace_header` and `perdita_replace_footer` filters, so a plugin can supply the header and footer. With no plugin hooked, you keep the same header and footer.
* New: you get Perdita's own colors on every Perdita admin screen.
* Fix: you can read headings and links inside a dark Cover block.
* Fix: you see a page title on the Setup and Migrate screens.
* New: when your Perdita versions are out of step, you get an update button for each older piece.
* Fix: you get a fresh Perdita offer when you click Check again on the Updates screen, not one up to 12 hours old.

= 0.19.20-beta =
* Maintenance release, in lock step with Perdita Core and Perdita Pro. Nothing changes in the theme.

= 0.19.19-beta =
* Fix: after a theme switch, empty menu locations fill from the previous theme's assignments or from a menu named for the spot, so the header and footer no longer fall back to a page list.

= 0.19.18-beta =
* Fix: Ask Perdita in the Customizer now shows the AI provider's message when a request fails, instead of "Request failed."
* Improved: clearer messages for every OpenRouter error (credits, key, rate limit, moderation, model down), with what to do next.

= 0.19.17-beta =
* The Perdita screen adds a Download Perdita Core button next to the one-click install. It fetches the newest Core zip from one fixed address, for a host where the installer can't run, with a line on uploading it under Plugins, Add New, Upload Plugin.
* Fix: connecting OpenRouter no longer ends on a blank page after Authorize.

= 0.19.16-beta =
* The Perdita screen installs and activates the free Perdita Core plugin in one click, after checking the download against the Perdita release signature.
* A one-time notice after theme activation points at Perdita Core, with the same button. Dismiss the notice once and it stays gone.
* The wordpress.org build shows the directory's own install and activate links for Perdita Core once the directory lists the plugin, and keeps quiet before that point.

= 0.19.15-beta =
* Nested menu items open as a dropdown on wide screens (hover, keyboard, or the new toggle button) and as an indented list on phones.
* Mobile menu and footer menu links are 44px tap targets.
* Floated images stay inside the content, and page links, tags, and comments sit below the image.
* Long titles and long words wrap instead of forcing a horizontal scrollbar.
* The theme no longer runs shortcodes on the footer credit. Perdita Core expands the shortcodes through the new perdita_footer_credit_text filter.
* The skip link shows on focus, keyboard focus has a visible outline, and the footer menu loses its bullets.

= 0.19.14-beta =
* Admin screens and fallback colors use Perdita's default palette instead of blue.

= 0.19.13-beta =
* Version lockstep with Perdita Core and Pro.

= 0.19.12-beta =
* Fix: the child theme generator no longer copies Perdita's CSS into the new theme, so Perdita updates keep reaching it. The new theme also loads Perdita's stylesheet ahead of its own, so its own CSS wins a tie.

= 0.19.11-beta =
* Version lockstep with Perdita Core and Pro.

= 0.19.10-beta =
* Fix: post and page titles, bylines, tags and comments now line up with the text under them in one reading column. Child themes can pin that column to the left with `--perdita-column-margin: 0 auto`.

= 0.19.9-beta =
* Version lockstep with Perdita Core and Pro.

= 0.19.8-beta =
* Version lockstep with Perdita Core and Pro.

= 0.19.7-beta =
* Version lockstep with Perdita Core and Pro, which now update themselves by default.

= 0.19.6-beta =
* New: Card and Tinted section block styles.
* New: custom header and custom background support.
* Supports WordPress block styles, keeping Perdita's look.
* Now in beta.

= 0.19.5-alpha =
* New: the block editor uses your colors, fonts, and type scale.
* New: single posts list their tags.
* The setup wizard says which WordPress settings it changes, and its notice closes for good with the X.
* Fix: styles for the classic alignment, caption, and gallery classes.
* Fix: the migration preview is translatable.

= 0.19.4-alpha =
* Version lockstep with Perdita Core and Pro.

= 0.19.3-alpha =
* Version lockstep with Perdita Core and Pro.

= 0.19.2-alpha =
* Security: admin notices show only messages Perdita itself sent, so a crafted link cannot put fake text on a Perdita screen.

= 0.19.1-alpha =
* Security: self-hosted updates install only when signed with the Perdita release key and when the download matches its checksum.
* Security: generating a child theme needs permission to install and switch themes, and the setup wizard changes the site title, tagline, icon and default description only for administrators.
* Fix: a post with no author, or an author with a blank display name, no longer prints a bare "by" in front of its categories.
* Fix: copying the old theme's Additional CSS during migration keeps the CSS already on the site.
* Fix: Reset keeps the AI provider settings, and OpenRouter requests use a current default model.
* Fix: an out-of-credits reply from the AI service reads as a clear message.

= 0.19.0-alpha =
* No theme changes. Version bumped to stay in lock step with Perdita Core 0.19.0-alpha and Perdita Pro 0.19.0-alpha, which bring the SEO layer to parity with All in One SEO Pro: templates and variables, robots controls, a linked schema graph with author E-E-A-T, IndexNow, breadcrumbs, image SEO, webmaster tags, a robots.txt editor, feed controls, llms.txt, REST and MCP writable SEO fields, a schema type selector, redirects with regex and 410, and an internal link assistant (see the Perdita Core and Perdita Pro changelogs).

= 0.18.2-alpha =
* No theme changes. Version bumped to stay in lock step with Perdita Core 0.18.2-alpha, which hardens the MCP server's OAuth storage against concurrent writes and caps get_post content (see the Perdita Core changelog).

= 0.18.1-alpha =
* No theme changes. Version bumped to stay in lock step with Perdita Core 0.18.1-alpha, which fixes a page-cache purge gap (see the Perdita Core changelog).

= 0.18.0-alpha =
* The theme, Perdita Core, and Perdita Pro now share one version number and ship together. Each piece warns in wp-admin, with a link to the Updates screen, when the installed versions differ.

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

== Resources ==

Perdita bundles no third-party code, fonts, or images. Every file in the theme is original work by the theme author, licensed GPLv2 or later, including:

* screenshot.png: a capture of the theme's own front end with sample posts written for it by the theme author, GPLv2 or later. The type shown is Playfair Display and Inter, loaded from Google Fonts under the SIL Open Font License 1.1.
* assets/js/*.js and assets/css/*.css: 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 are not bundled. When you select a Google font, it loads from fonts.googleapis.com under that font's own license (SIL Open Font License or Apache 2.0, see https://fonts.google.com/attribution).
