Repository navigation
Commentail 1.6.0 — editor themes and empty-field hints
English · Русский
Released 18 November 2026. PyPI ·
GitHub release.
Changes
- The visual editor detects the containing surface's light or dark background.
Theme switches update the toolbar, Markdown source, help and open link dialog
without replacing the editor, losing its draft or moving focus. - Seven optional CSS palette variables customize the editor and its external
dialog together. Existing local palette overrides remain supported. - Empty create/reply fields show the translated “Your comment” placeholder.
Associated labels and accessible names remain; edit forms retain their visible
contextual label. The hint is never included in saved text or Markdown.
Upgrade from 1.5.0
- Back up the current package, settings and template/style overrides; rehearse
the update in your staging site. - Install
commentail==1.6.0, runcheckandcollectstatic --noinput, clear
stale asset caches and restart the application through your deployment process.
There are no new migrations or dependencies compared with 1.5.0. - Review
form.htmloverrides: keep the associated label, native textarea
placeholder and visual root'sdata-placeholder. Keep the editor asset hooks. - Test light/dark theme changes with an unsent draft, replies, editing, Markdown,
link validation and the no-JavaScript fallback on your own theme.
Automatic detection composites ancestor background colors. Background images,
gradients and pseudo-elements are not sampled; provide a representative container
background color or explicit palette overrides for those designs. See the
palette reference.
For older upgrades, follow 1.5.0 and the intervening migration notes.
No database or server-policy change is introduced by 1.6.0. Rolling back to 1.5.0
requires restoring matching package assets and templates, not a schema reversal.
Compatibility
Unchanged: Python 3.12–3.14; Wagtail 7.4.3+ with Django 5.2/6.0 and Wagtail
8.0.x with Django 5.2/6.0/6.1; file SQLite and PostgreSQL 16. Host-specific theme
and assistive-technology behavior still require integration acceptance.