Repository navigation
Release 1.5.0
English · Русский
Released 6 November 2026. PyPI · GitHub release.
- An owned, dependency-free visual editor with bold, italic, strikethrough, links, quotes, lists, inline code and code blocks; switch to Markdown source when needed. Typed Markdown shortcuts are undoable.
- Independent Plain text / Markdown / Visual editor modes for guests and registered users, with shared per-Site formatting permissions enforced by the server. Plain text remains the default after installation or upgrade.
- Create, reply and author-edit forms preserve separate in-page drafts across navigation and recoverable failures. This is not persistent autosaving.
- English, Russian, German, French, Spanish and Brazilian Portuguese UI; conditional editor assets and a native textarea fallback without JavaScript.
- Consistent toolbar icons, collapsed keyboard help, editor-adjacent length limits and a distinct reply-email notice. Routine initialization and mode switches do not display instructional status messages.
- Published code blocks follow host colors instead of forcing a light background.
- Authors cannot reply to their own comments. Accounts use account identity; guests use normalized email. Existing self-replies remain visible.
- Rehearse on a separate copy, with local mail. Back up the database, package, dependency versions, settings, overrides and secrets; pause writers and workers for the final backup/cutover. Keep the same secret key.
- Install
commentail==1.5.0from PyPI, runmigrate,checkandcollectstatic --noinput, then refresh cached assets and restart the app and workers through the host deployment process. - Migration
0020adds comment/revisiontext_formatand Site editor settings. Existing text is explicitly plain: literal Markdown markers are not reinterpreted, including on editing. Settings changes do not rewrite published comments. - Review overrides of
block.html,form.html,edit-form.htmlandcomment.html. Rich comment bodies need a block container, not a paragraph. Keep the native textarea, server actions, CSRF and editor resource/data hooks; see the template contract. - Enable the desired modes under Comments → Site settings → Comment editor. Test both audiences, permitted/forbidden formats, replies to another author, eligible edits, errors, cancellation and independent drafts, with and without JS.
The schema additions are reversible, but reversing 0020 discards format metadata
and editor settings. Downgrading cannot preserve the meaning of newly formatted
comments. Restore the matched pre-upgrade database/package backup when rollback
is necessary, accounting for writes and mail after that backup.
For upgrades from older versions, also follow all intervening notes, particularly 1.4.0 and the irreversible 1.3.1 migration procedure.
Python 3.12–3.14, Wagtail 7.4.3+ / Django 5.2 or 6.0, and Wagtail 8.0.x / Django 5.2, 6.0 or 6.1 remain the supported combinations, on file SQLite and PostgreSQL 16. No dependency or support-bound changes.
The editor uses a limited Markdown dialect, not arbitrary HTML or full CommonMark. Nested quotes, language-labelled code fences, complex list items and cross-line links can remain source-only. Code whitespace is preserved; surrounding paragraph/list boundary spaces can be normalized on visual export. See the editor guide.
Host themes, permissions and actual mail delivery require site-specific acceptance.
- Home
- Главная на русском
- Course in English
- Курс на русском
- Installation
- Configuration
- Comment editor (1.6.0)
- Редактор комментариев (1.6.0)
- Moderation
- Rules and CSV
- Guest comments
- Replies and editing
- Email and worker
- Separate email configuration
- Отдельная настройка почты
- Styling
- Templates
- Recent comments
- Structured data
- Callbacks
- Object adapters
- Security and privacy
- Deployment
- Performance
- Troubleshooting
- Example and testing
- Release 0.1.0
- Release 0.1.1
- Release 0.2.0
- Stability
- Template contract
- Release 1.0.0
- Release 1.1.0
- Release 1.2.0
- Release 1.3.0
- Security update 1.3.1
- Translated Site roots 1.3.2
- Release 1.6.0
- Выпуск 1.6.0
- Release 1.5.0
- Выпуск 1.5.0
- Release 1.4.1
- Выпуск 1.4.1 на русском
- Release 1.4.0
- Выпуск 1.4.0 на русском
- Changelog
- Roadmap
- Support