wagtail-herald v0.1.0 - Core Foundation
First release of wagtail-herald, a comprehensive SEO toolkit for Wagtail CMS.
Features
SEOSettings Model
Site-wide SEO configuration manageable from Wagtail admin:
- Organization info (name, type, logo) for Schema.org
- Social profiles (Twitter, Facebook)
- Default OG image and locale settings
- Favicons (SVG, PNG, Apple Touch Icon)
- Site verification codes (Google, Bing)
- Custom head HTML injection
SEOPageMixin
Page-level SEO customization:
- OG image override per page
- noindex / nofollow controls
- Custom canonical URL
Template Tags
-
{% seo_head %}- Outputs complete SEO meta tags:<title>with site name- Meta description
- Canonical URL
- Open Graph tags (og:title, og:description, og:image, etc.)
- Twitter Card tags
- Favicon links
- Site verification meta tags
-
{% seo_schema %}- Outputs JSON-LD structured data:- WebSite schema
- Organization schema
i18n Support
- Admin UI available in English and Japanese
Performance
- Optimized with
select_relatedfor image fields (single query with JOINs) - Per-request caching via Wagtail's built-in mechanisms
Installation
pip install wagtail-heraldQuick Start
# settings.py
INSTALLED_APPS = [
...
'wagtail.contrib.settings',
'wagtail_herald',
]
# models.py
from wagtail_herald.models import SEOPageMixin
class ArticlePage(SEOPageMixin, Page):
promote_panels = Page.promote_panels + SEOPageMixin.seo_panels{% load wagtail_herald %}
<head>
{% seo_head %}
</head>
<body>
...
{% seo_schema %}
</body>Requirements
- Python 3.10+
- Django 4.2+
- Wagtail 5.2+
Full Changelog: https://github.com/kkm-horikawa/wagtail-herald/commits/v0.1.0