🐞 Bug Fixes

• Pages without a keyphrase: The Image Keyphrase and Text Competing Links checks now stay out of the report until a keyphrase is set, like the other keyphrase checks. See Assessments.

🚀 Features

• Unsaved changes analyzed: The analysis now reads what the form shows, not only the published page. The report says which one it looked at – "Unsaved changes" or "Published version" – and when.
• SEO and readability lights: The report opens with one light per category, so the verdict comes before the list of checks.
• Ratings: Each analysis leaves a rating per page and language. The view button shows it as a colored dot, with an exclamation mark once the page was published again. Blueprints and templates can read it and sort pages by it.
• Analyze on publish: With analyzeOn: publish, the analysis runs on its own after every publish, silently, so the rating keeps up with the content.
• Yoast SEO 28.5: The analysis engine moves to the current Yoast release. Transition words and the keyphrase in subheadings are now read from the page structure instead of the raw text.

🚨 Breaking Changes

• View button theme: The default is now positive-icon, the icon-only accent Kirby uses for the status button. Set theme: positive to keep the filled button.

🚀 Features

• Kirby queries in the view button: keyphrase and synonyms now resolve Kirby queries for the view button, not just for the section. A keyphrase like {{ page.title.value }} follows the content instead of being analyzed literally.

🐞 Bug Fixes

• Norwegian assessments: A page whose language is no or nn now reaches Yoast's Bokmål researcher. Previously only nb did, and the other two were scored as English.

🔒 Security

• Model-derived proxy target: The proxy now resolves the preview URL from the page itself instead of fetching whatever URL the browser asked for. Prevents any Panel user, whatever their role, from making your server reach internal hosts and services that are otherwise unreachable from the outside. No configuration changes required – the analyzed URL stays the same, and urlResolver and params keep working as before.

🚀 Features

• System view license management: View your license key, activation status, and version compatibility directly in the Kirby Panel system view, and activate new licenses from there.

🚀 Features

• Yoast SEO v3.5: Upgrade to the latest Yoast SEO analysis engine with improved assessments and bug fixes.
• Updated translations: Refreshed translations for German, English, Spanish, French, and Dutch to match the latest Yoast SEO terminology.

🚀 Features

• Enhanced debug logging: Improved console logging in the browser's developer tools helps diagnose issues with SEO analysis. Set logLevel: debug in your section configuration to see detailed information about the analysis process, including fetched HTML content and assessment results.

Kirby SEO Audit v3 is a free upgrade for all users with a valid license key for v2. It includes an upgrade to the underlying analysis engine from Yoast SEO v1 to v3, resulting in better performance, accuracy, and new features.

🚀 Features

• View Button: New View Button for Kirby 5, allowing you to run SEO analysis from any page without adding a section to your blueprint.
• Yoast SEO v3: Upgrade from Yoast SEO v1 to Yoast SEO v3 with overhauled assessments and improved performance.
• Image keyphrase assessment: New assessment imageKeyphrase – Analyzes if images are optimized for your target keyphrase.
• Additional translations: More translations for the generated report: French, Spanish.
• Improved result categories: Improved result categories with Good, OK, Bad, and Feedback indicators for better prioritization.

⚠️ Migration from v1/v2

Several assessment names have changed to match Yoast SEO v3 conventions. Update your blueprints if you use the assessments property:

Removed assessments (no longer available in Yoast SEO v3):

• fleschReadingEase
• SentenceLengthInDescription
• KeywordStopWords

🚀 Features

• Kirby 5 license status integration: The plugin now displays its license status on the Panel's system page, following Kirby 5's plugin license management conventions.

Kirby SEO Audit v2 is a major release with full support for Kirby 5. This major release requires a new license key. If you already have a license, you receive either a free upgrade to v2 or a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚀 Features

• Dark mode support: The SEO Audit interface adapts to Kirby 5's dark mode.

🚀 Features

• Language compatibility validation: Some Yoast assessments, like transition words, only support certain languages. When a configured assessment doesn't support the Panel language, the section now shows an error that names the languages the assessment supports.

🚀 Features

• HTML logging: If the log level is set to info or higher, log the extracted HTML to the console. Useful for checking the HTML used for the SEO report.

type: seo-audit
contentSelector: "#main:not(.sidebar):not(.footer)"
logLevel: info

🚀 Features

• Panel license activation: Activate your license directly in the Kirby Panel without manual file editing. Click Activate in the SEO Audit section to enter your license details.
• Packagist distribution: The plugin is now available via Packagist, simplifying Composer-based installations. The private Composer repository has been deprecated.

🚀 Features

• Content scope selection: The new contentSelector property lets you define a CSS selector for the main content area to analyze. This excludes headers, footers, sidebars, and navigation from SEO analysis.

type: seo-audit
contentSelector: "#main-content"

🚀 Features

• Blueprint-defined keywords: The new keyphrase and synonyms properties set the keyphrase and synonyms in the blueprint, as an alternative to fields an editor fills in. Both accept Kirby queries, so the page title can serve as the keyphrase next to a list of synonyms:

type: seo-audit
keyphrase: "{{ page.title.value }}"
synonyms:
  - Kirby
  - SEO
  - Audit

🐞 Bug Fixes

• Image alt attribute check: On a page without images, the check failed as if none of its images had alt text. It now passes and notes that the text contains no images.

🐞 Bug Fixes

• Regional Panel languages: With the Panel interface set to a language like es_ES or pt_BR, the SEO Audit section failed to load. It loads for these languages now.

🚀 Features

• Synonyms field: synonymsField option to add synonyms to the page's keyword or keyphrase.
• Custom SEO checks: Three custom checks complement Yoast's assessments. They flag images without an alt attribute, a missing or repeated H1, and headings that skip a level.

🚀 Features

• Improved proxy configuration: The proxy option replaces transformers.proxyUrl. Its urlResolver rewrites the URL the proxy fetches, for headless setups or custom domains. Its params add headers, authentication, or a timeout to the request.

🚀 Features

• Proxy URL option: Global transformers.proxyUrl option to further modify the request URL of the content fetcher proxy.

🐞 Bug Fixes

• Proxy error handling: When the proxy fetched a page that answered with an error status, such as 404, the analysis stopped. It now analyzes the error page and logs a warning to the browser console.

🚀 Features

• Report persistence control: The new persisted section property controls whether SEO audit reports are saved to local storage. Set to true (default) to keep reports between sessions, or false to always start with a fresh analysis.

Initial Release

Kirby SEO Audit v1.0 brings comprehensive SEO analysis directly to the Kirby Panel. Built on the Yoast SEO engine, it provides real-time insights and actionable recommendations without external API calls.

🚀 Features

• Yoast SEO integration: Powered by the same analysis engine used by millions of WordPress sites. Run SEO assessments locally in your browser.
• Panel section: Add the SEO Audit section to any page blueprint with type: seo-audit. Click the "Analyze" button to run a complete SEO check.
• Keyphrase analysis: Analyze keyword density, distribution, and optimization opportunities with the keyphraseField option.
• Multi-language support: Language-aware assessments provide region-specific recommendations based on your Kirby language settings.
• SEO & readability assessments: Comprehensive checks for meta descriptions, headings, content length, readability, and more.

For setup instructions, see the Installation guide.