Changelog

🚀 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

• New View Button for Kirby 5, allowing you to run SEO analysis from any page without adding a section to your blueprint.
• Upgrade from Yoast SEO v1 to Yoast SEO v3 with overhauled assessments and improved performance.
• New assessment: imageKeyphrase – Analyzes if images are optimized for your target keyphrase.
• More translations for the generated report: French, Spanish.
• 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

🐞 Bug Fixes

• Non-Composer installation: Fixed plugin installation for projects that do not use Composer. Previously, manually downloading and extracting the plugin to site/plugins/ could fail due to missing autoloader configuration. The plugin now works correctly regardless of installation method.

🚀 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. This provides a unified view of all plugin licenses alongside Kirby's own license information.

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

• Kirby 5 compatibility: Full support for Kirby 5, including the new Panel architecture and updated APIs.
• Dark mode support: The SEO Audit interface adapts to Kirby 5's dark mode, providing a consistent visual experience across the Panel.
• Maintained Kirby 4 support: The plugin continues to work with Kirby 4 projects, allowing you to upgrade at your own pace.

🚀 Features

• Language compatibility validation: The plugin now validates that configured assessments are compatible with the current Panel language. Some Yoast assessments (like transition words) only work with specific languages. If you configure an incompatible assessment, the plugin will show a clear error instead of failing silently, helping you choose appropriate assessments for your content language.

🚀 Features

• 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 and manage your license directly in the Kirby Panel without manual file editing. Click the activation link in the SEO Audit section to enter your license details. Visit the Kirby Tools Hub to purchase or manage licenses.
• 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, providing more accurate assessments focused on your actual page content.

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

🚀 Features

• As an alternative to both the keyphraseField and synonymsField properties (which are separate fields that an editor has to fill in) you can define keywords/keyphrases and synonyms directly in the blueprint:
  • keyphrase
  • synonyms

Both of these new properties support Kirby queries. For example, you can use the page title as a keyword next to a list of synonyms:

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

🐞 Bug Fixes

• Image alt assessment accuracy: The alt attribute assessment is now skipped when the analyzed content contains no images. Previously, pages without images would show a misleading "Good" result for alt attributes, implying images were checked when none existed. Now the assessment is only shown when relevant.

🐞 Bug Fixes

• Locale format conversion: Kirby's POSIX locale format (like es_ES) is now properly converted to IETF BCP 47 language tag format (like es-ES) for the Yoast SEO engine. This ensures language-specific assessments work correctly regardless of how your Kirby languages are configured.

🚀 Features

• synonymsField option to add synonyms to the page's keyword or keyphrase.
• Custom SEO checks that complement the default assessments provided by Yoast SEO.
  • Alt attribute: Checks whether all images have an alt attribute.
  • Single H1: Checks whether the content contains a H1 heading.
  • Heading structure order: Checks whether the headings (H1 to H6) follow a proper sequential order.

🚀 Features

• Improved proxy configuration: Replaced the global transformers.proxyUrl option with a more flexible proxy configuration. The new option accepts:
  • urlResolver: Custom function for URL resolution (useful for headless setups or custom domains).
  • params: Options passed directly to Kirby's Remote::request() method for custom headers, authentication, or timeout settings.

🚀 Features

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

🐞 Bug Fixes

• Always return 200 status code from the proxy API path, but log the request error if it occurs.

🏎 Performance

• Externalize Yoast SEO translations into a separate build chunk to reduce the main bundle size.

🚀 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. This is useful when you want editors to run a new audit each time they open a page.

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.