commentail 1.1.0__tar.gz → 1.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {commentail-1.1.0 → commentail-1.2.0}/CHANGELOG.md +34 -0
- {commentail-1.1.0/commentail.egg-info → commentail-1.2.0}/PKG-INFO +103 -57
- {commentail-1.1.0 → commentail-1.2.0}/README.md +102 -56
- {commentail-1.1.0 → commentail-1.2.0}/README.ru.md +108 -66
- {commentail-1.1.0 → commentail-1.2.0}/commentail/admin_views.py +10 -11
- {commentail-1.1.0 → commentail-1.2.0}/commentail/admission.py +13 -9
- commentail-1.2.0/commentail/background.py +45 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/drafts.py +6 -3
- commentail-1.2.0/commentail/locale/de/LC_MESSAGES/django.mo +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/de/LC_MESSAGES/django.po +4 -4
- commentail-1.2.0/commentail/locale/es/LC_MESSAGES/django.mo +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/es/LC_MESSAGES/django.po +4 -4
- commentail-1.2.0/commentail/locale/fr/LC_MESSAGES/django.mo +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/fr/LC_MESSAGES/django.po +4 -4
- commentail-1.2.0/commentail/locale/pt_BR/LC_MESSAGES/django.mo +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/pt_BR/LC_MESSAGES/django.po +4 -4
- commentail-1.2.0/commentail/locale/ru/LC_MESSAGES/django.mo +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/ru/LC_MESSAGES/django.po +4 -4
- {commentail-1.1.0 → commentail-1.2.0}/commentail/logging.py +7 -1
- commentail-1.2.0/commentail/management/commands/process_commentail.py +13 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/outbox.py +35 -14
- {commentail-1.1.0 → commentail-1.2.0}/commentail/public.py +7 -6
- {commentail-1.1.0 → commentail-1.2.0}/commentail/services.py +4 -1
- {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/commentail.css +48 -0
- commentail-1.2.0/commentail/templates/commentail/captcha.html +1 -0
- commentail-1.2.0/commentail/templates/commentail/form.html +1 -0
- commentail-1.2.0/commentail/validation.py +6 -0
- {commentail-1.1.0 → commentail-1.2.0/commentail.egg-info}/PKG-INFO +103 -57
- {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/SOURCES.txt +7 -0
- commentail-1.2.0/docs/releases/1.2.0.md +67 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Changelog.md +34 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Configuration.md +7 -3
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Deployment.md +8 -4
- commentail-1.2.0/docs/wiki/Email-and-worker.md +249 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Example-and-testing.md +24 -6
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Guest-comments.md +3 -2
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Home.md +11 -6
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Installation.md +25 -30
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Moderation.md +1 -1
- commentail-1.2.0/docs/wiki/Release-1.2.0.md +67 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Replies-and-editing.md +3 -1
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Roadmap.md +12 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Security-and-privacy.md +3 -2
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Stability.md +3 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Styling.md +17 -5
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Support.md +2 -2
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Templates.md +1 -1
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Troubleshooting.md +9 -5
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/_Sidebar.md +1 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/README.md +11 -2
- {commentail-1.1.0 → commentail-1.2.0}/pyproject.toml +1 -1
- {commentail-1.1.0 → commentail-1.2.0}/requirements-test-common.txt +2 -2
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_admission.py +3 -2
- commentail-1.2.0/tests/test_background.py +174 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_cleanup.py +8 -4
- commentail-1.2.0/tests/test_email_backends.py +205 -0
- commentail-1.2.0/tests/test_input_boundaries.py +81 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_notifications.py +6 -9
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_public_ui.py +3 -2
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_security.py +10 -0
- commentail-1.1.0/commentail/locale/de/LC_MESSAGES/django.mo +0 -0
- commentail-1.1.0/commentail/locale/es/LC_MESSAGES/django.mo +0 -0
- commentail-1.1.0/commentail/locale/fr/LC_MESSAGES/django.mo +0 -0
- commentail-1.1.0/commentail/locale/pt_BR/LC_MESSAGES/django.mo +0 -0
- commentail-1.1.0/commentail/locale/ru/LC_MESSAGES/django.mo +0 -0
- commentail-1.1.0/commentail/management/commands/process_commentail.py +0 -24
- commentail-1.1.0/commentail/templates/commentail/captcha.html +0 -1
- commentail-1.1.0/commentail/templates/commentail/form.html +0 -1
- commentail-1.1.0/docs/wiki/Email-and-worker.md +0 -108
- {commentail-1.1.0 → commentail-1.2.0}/LICENSE +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/MANIFEST.in +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/admin_urls.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/apps.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/assets.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/avatars.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/checks.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/config.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/detection.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/forms.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/group_permissions.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/limits.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/management/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/management/commands/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/middleware.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0001_initial.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0002_sitegrouppermission_hide_sitegrouppermission_view.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0003_actiontoken_captchachallenge_guestgrant.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0004_submissionrecord.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0005_rateevent.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0006_alter_comment_guest_name_and_more.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0007_actiontoken_nonce_replysubscription_mailjob.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0008_mailjob_revision.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0009_formticket.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0010_captchachallenge_backend_and_more.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0011_discussion_content_type_discussion_object_id_and_more.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0012_formticket_draft.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0013_sitecommentsettings_email_enabled.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0014_reading_indexes.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0015_sitecommentsettings_highlight_staff.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/models.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/objects.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/page_integration.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/panels.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/permissions.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/policies.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/recent.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/rules_csv.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/security.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/signals.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/admin.css +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/admin.js +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/commentail.js +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/structured.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/action.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/action_error.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/base.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/confirm_delete.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/detail.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/field.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/form.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/group_permission_row.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/group_permissions.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/heading.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/list.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/mail.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/management.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/objects.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/page_panel.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/rules.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/rules_import.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/selection.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/author.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/avatar.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/base.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/block.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/comment.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/edit-form.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/base.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/button.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm_subject.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit_subject.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published_subject.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected_subject.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply_subject.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/replies.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templatetags/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templatetags/commentail_admin.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/templatetags/commentail_tags.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/text.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/urls.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/views.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail/wagtail_hooks.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/dependency_links.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/requires.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/top_level.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/assets/commentail-preview.png +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/assets/support-qr.png +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/releases/0.1.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/releases/0.1.1.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/releases/0.2.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/releases/1.0.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/releases/1.1.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Callbacks.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Object-adapters.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Performance.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Recent-comments.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-0.1.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-0.1.1.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-0.2.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-1.0.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-1.1.0.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Rules-and-CSV.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Structured-data.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Template-contract.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/_Footer.md +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo/settings.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo/urls.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/comments.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/management/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/management/commands/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/management/commands/bootstrap_demo.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/migrations/0001_initial.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/migrations/0002_product.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/migrations/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/models.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/templates/demo_home/home_page.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/templates/demo_home/product.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/views.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/example/manage.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/requirements-test.txt +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/setup.cfg +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/settings.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/targets/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/targets/apps.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/targets/migrations/0001_initial.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/targets/migrations/__init__.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/targets/models.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/templates/wagtailcore/page.html +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_actions.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_admin.js +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_admin_ui.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_avatars.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_capability_access.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_captcha_backend.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_concurrency.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_detection.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_email_presentation.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_extension_contracts.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_group_panel.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_inline_edit.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_lifecycle.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_localization.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_mail_admin.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_name_limit.js +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_object_adapters.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_outbox.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_performance.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_presentation_contracts.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_progressive.js +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_rate_limits.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_recent_comments.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_release_gaps.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_reply.js +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_rules_admin.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_rules_csv.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_smtp_chain.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_staff_authors.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_structured_data.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_submission.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/test_transaction_contracts.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/urls.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tests/urls_custom_prefix.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tools/benchmark_performance.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tools/check_dist.py +0 -0
- {commentail-1.1.0 → commentail-1.2.0}/tools/check_translations.py +0 -0
|
@@ -3,6 +3,38 @@
|
|
|
3
3
|
Each release records changes relative to the previous version. Upgrade notes
|
|
4
4
|
describe changes that an existing installation needs to review.
|
|
5
5
|
|
|
6
|
+
## [1.2.0] — 2026-10-22 · Stable
|
|
7
|
+
|
|
8
|
+
- Verify Wagtail 8.0.1 in every Wagtail 8 CI stack while retaining the existing
|
|
9
|
+
support bounds. Update test pins to certifi 2026.10.19 and Pillow 13.0.0 to
|
|
10
|
+
address the known advisories in the previous test environment.
|
|
11
|
+
|
|
12
|
+
- Support the configured Django email backend for guest submissions and mail
|
|
13
|
+
delivery without requiring SMTP settings for other backends. Keep SMTP timeout
|
|
14
|
+
protection and permanent refusal handling; retry other backend failures within
|
|
15
|
+
the existing budget without storing provider diagnostics.
|
|
16
|
+
- Add `commentail.background.process_pending(mail_limit=100)` for periodic host
|
|
17
|
+
task queues, returning JSON-compatible sent/removed counts. The existing
|
|
18
|
+
`process_commentail` command shares the same implementation; a separate command
|
|
19
|
+
schedule is unnecessary when the host schedules this function. Retain the DB
|
|
20
|
+
outbox, retries, leases and cleanup; reject caller transactions before side effects.
|
|
21
|
+
- Place reply cancellation beside Send comment at the bottom of the form,
|
|
22
|
+
preserving native navigation, inline dismissal and focus restoration to Reply.
|
|
23
|
+
Use a compact text action that reveals its button surface on hover or keyboard
|
|
24
|
+
focus. Refresh static assets and review overridden reply-form templates when
|
|
25
|
+
upgrading.
|
|
26
|
+
|
|
27
|
+
- Compact guest form spacing and hints, place a short math CAPTCHA input beside
|
|
28
|
+
its text refresh action, emphasize submission, and explain email confirmation
|
|
29
|
+
after submission in every supported language. The submit button inherits host
|
|
30
|
+
text colors and paired button overrides, with no fixed light/dark palette.
|
|
31
|
+
- Validate numeric navigation/filter IDs before conversion, reject null bytes in
|
|
32
|
+
comment text and guest names, and enforce the stored guest-email length.
|
|
33
|
+
Malformed input returns validation errors instead of server/database errors;
|
|
34
|
+
native draft recovery drops unsupported null bytes while retaining the rest.
|
|
35
|
+
- Redact capability secrets from Django logs even when the token parameter name
|
|
36
|
+
is percent-encoded. Host proxy/access logs still require their own redaction.
|
|
37
|
+
|
|
6
38
|
## [1.1.0] — 2026-10-20 · Stable
|
|
7
39
|
|
|
8
40
|
- Explain failed moderation actions with a translated recovery page and a return
|
|
@@ -165,3 +197,5 @@ See [0.1.0 release notes](docs/releases/0.1.0.md).
|
|
|
165
197
|
[0.2.0]: https://github.com/hardcodd/Commentail/compare/v0.1.1...v0.2.0
|
|
166
198
|
|
|
167
199
|
[1.1.0]: https://github.com/hardcodd/Commentail/compare/v1.0.0...v1.1.0
|
|
200
|
+
|
|
201
|
+
[1.2.0]: https://github.com/hardcodd/Commentail/compare/v1.1.0...v1.2.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: commentail
|
|
3
|
-
Version: 1.
|
|
3
|
+
Version: 1.2.0
|
|
4
4
|
Summary: Self-hosted Wagtail comments with moderation, verified guests and threaded replies
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
Project-URL: Source, https://github.com/hardcodd/Commentail
|
|
@@ -34,14 +34,14 @@ Dynamic: license-file
|
|
|
34
34
|
|
|
35
35
|
Moderated discussions, verified guests and inline replies — styled by your site.
|
|
36
36
|
|
|
37
|
-
**Current release: [1.
|
|
37
|
+
**Current release: [1.2.0](https://github.com/hardcodd/Commentail/releases/tag/v1.2.0)** · [PyPI](https://pypi.org/project/commentail/1.2.0/)
|
|
38
38
|
|
|
39
39
|
[](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
|
|
40
40
|
[](https://djangopackages.org/packages/p/commentail/)
|
|
41
41
|
|
|
42
42
|
English · [Русский](README.ru.md)
|
|
43
43
|
|
|
44
|
-
[Get started](#quick-start) · [Documentation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Home.md) · [Wiki](https://github.com/hardcodd/Commentail/wiki) · [Support](#support-commentail)
|
|
44
|
+
[Get started](#quick-start) · [Screenshots](#screenshots) · [Documentation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Home.md) · [Wiki](https://github.com/hardcodd/Commentail/wiki) · [Support](#support-commentail)
|
|
45
45
|
|
|
46
46
|
<img src="https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/commentail-preview.png" alt="Commentail — a blue bird perched on a comment bubble" width="100%">
|
|
47
47
|
|
|
@@ -55,12 +55,6 @@ The widget inherits your site's typography and colors. CSS custom properties,
|
|
|
55
55
|
replaceable templates and Python callbacks let you adapt it without a frontend
|
|
56
56
|
framework or an external comments platform.
|
|
57
57
|
|
|
58
|
-
> **1.1.0** improves moderation with bulk actions, erasure confirmation,
|
|
59
|
-
> clearer filters and selection, preserved navigation and useful error recovery.
|
|
60
|
-
> Optional staff badges and publication notices only after moderation are included.
|
|
61
|
-
> [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
|
|
62
|
-
> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.1.0.md).
|
|
63
|
-
|
|
64
58
|
## Why Commentail?
|
|
65
59
|
|
|
66
60
|
| For readers | For editors | For developers |
|
|
@@ -79,7 +73,54 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
|
|
|
79
73
|
the visible text and author name. Choose either format or disable output in Python.
|
|
80
74
|
[Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
|
|
81
75
|
|
|
82
|
-
|
|
76
|
+
Documented integrations follow the [stable API and compatibility policy](docs/wiki/Stability.md).
|
|
77
|
+
|
|
78
|
+
## Screenshots
|
|
79
|
+
|
|
80
|
+
Captured from Commentail **1.1.0**, installed from PyPI in an isolated Wagtail
|
|
81
|
+
8.0.1 / Django 6.1.2 demo. Names and conversations are sample data.
|
|
82
|
+
The public page uses a custom host theme; the widget and admin screens are the
|
|
83
|
+
released package, without template overrides.
|
|
84
|
+
|
|
85
|
+
**On the site:** a discussion about Wagtail, Django templates and progressive
|
|
86
|
+
enhancement, with a threaded reply and a highlighted editor.
|
|
87
|
+
|
|
88
|
+

|
|
89
|
+
|
|
90
|
+
**Inside Wagtail:** the moderation queue, expanded site/page, status and date
|
|
91
|
+
filters, and two comments selected for bulk actions.
|
|
92
|
+
|
|
93
|
+

|
|
94
|
+
|
|
95
|
+
<details>
|
|
96
|
+
<summary>Guest form, inline reply, comment review and site/page settings</summary>
|
|
97
|
+
|
|
98
|
+
**Guest form.** A private email field, email-verification notice and the local
|
|
99
|
+
arithmetic challenge. The sample is an unsent draft.
|
|
100
|
+
|
|
101
|
+

|
|
102
|
+
|
|
103
|
+
**Inline reply.** The reply form opens below the selected comment and keeps the
|
|
104
|
+
recipient visible. This sample is also an unsent draft.
|
|
105
|
+
|
|
106
|
+

|
|
107
|
+
|
|
108
|
+
**Comment review.** Read the original text, choose a moderation action and inspect
|
|
109
|
+
its activity history.
|
|
110
|
+
|
|
111
|
+

|
|
112
|
+
|
|
113
|
+
**Site settings.** Discussion access, moderation policy, staff highlighting,
|
|
114
|
+
clickable links and email preferences in one place.
|
|
115
|
+
|
|
116
|
+

|
|
117
|
+
|
|
118
|
+
**Page settings.** Inherit the site policy or override it for an individual
|
|
119
|
+
discussion.
|
|
120
|
+
|
|
121
|
+

|
|
122
|
+
|
|
123
|
+
</details>
|
|
83
124
|
|
|
84
125
|
## Compatibility
|
|
85
126
|
|
|
@@ -92,46 +133,44 @@ From **1.0.0**, documented integration contracts follow the [stable API and comp
|
|
|
92
133
|
| Frontend | Django templates, optional progressive JavaScript |
|
|
93
134
|
| License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
|
|
94
135
|
|
|
95
|
-
|
|
96
|
-
CI defines all five framework
|
|
97
|
-
pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
|
|
136
|
+
CI defines all five framework pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
|
|
98
137
|
Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
|
|
99
138
|
listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
|
|
100
139
|
Wagtail 8.1 and later require separate verification before support is declared.
|
|
101
140
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
141
|
+
The Wagtail 8 CI stacks select 8.0.1 or a newer patch within 8.0.
|
|
142
|
+
|
|
143
|
+
Guest comments require configured Django email delivery and scheduled background
|
|
144
|
+
processing. Use SMTP or another Django `EMAIL_BACKEND`, and schedule the command
|
|
145
|
+
or `commentail.background.process_pending()` through your existing task queue.
|
|
146
|
+
Registered users can comment without an email address, but receive no mail. Your
|
|
147
|
+
site provides login and registration. No required external CDN or CAPTCHA service.
|
|
148
|
+
See [email setup](docs/wiki/Email-and-worker.md).
|
|
105
149
|
|
|
106
150
|
### Languages
|
|
107
151
|
|
|
108
|
-
|
|
109
|
-
|
|
152
|
+
English (`en`), Russian (`ru`), German (`de`), French (`fr`), Spanish (`es`)
|
|
153
|
+
and Brazilian Portuguese (`pt-br`) are available for the public UI,
|
|
110
154
|
moderation/settings and all notification emails.
|
|
111
155
|
The host site selects the active Django language; queued emails retain the
|
|
112
156
|
recipient's saved language. User comments and rejection reasons are not translated.
|
|
113
|
-
|
|
157
|
+
The guides are in English; this README is also [available in Russian](README.ru.md).
|
|
114
158
|
[Language configuration →](docs/wiki/Configuration.md#languages)
|
|
115
159
|
|
|
116
160
|
## Quick start
|
|
117
161
|
|
|
118
162
|
### 1. Install
|
|
119
163
|
|
|
120
|
-
In your site's virtual environment, install the release:
|
|
164
|
+
In your existing Wagtail site's virtual environment, install the published release:
|
|
121
165
|
|
|
122
166
|
```sh
|
|
123
|
-
python -m pip install commentail==1.
|
|
167
|
+
python -m pip install commentail==1.2.0
|
|
124
168
|
```
|
|
125
169
|
|
|
126
170
|
For the optional PostgreSQL driver, use
|
|
127
|
-
`python -m pip install 'commentail[postgres]==1.
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.1.0.md),
|
|
131
|
-
including migration `0015`, updated static assets and host template overrides.
|
|
132
|
-
When coming from 0.1.1, also apply the [0.2.0 upgrade notes](docs/releases/0.2.0.md). For older
|
|
133
|
-
installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
|
|
134
|
-
its original Wagtail 7.4 and Django 5.2 limits.
|
|
171
|
+
`python -m pip install 'commentail[postgres]==1.2.0'`.
|
|
172
|
+
For an existing installation, follow
|
|
173
|
+
the [upgrade guide](docs/wiki/Installation.md#upgrading-and-restoring) for your target version.
|
|
135
174
|
|
|
136
175
|
### 2. Connect Django and Wagtail
|
|
137
176
|
|
|
@@ -163,7 +202,31 @@ The template controls where Page comments are available; the corresponding Page
|
|
|
163
202
|
editor receives a Comments tab. Configure site defaults, then inherit or override
|
|
164
203
|
on individual Pages. **Review all** is the initial moderation policy.
|
|
165
204
|
|
|
166
|
-
###
|
|
205
|
+
### 4. Enable email and cleanup
|
|
206
|
+
|
|
207
|
+
Configure Django's email backend and run this command once per minute:
|
|
208
|
+
|
|
209
|
+
```sh
|
|
210
|
+
python manage.py process_commentail
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
The command sends queued mail and removes expired temporary records. Guests confirm
|
|
214
|
+
their email before moderation. Authors with email are subscribed to direct-reply
|
|
215
|
+
notifications when mail is enabled; every reply email includes per-comment unsubscribe.
|
|
216
|
+
|
|
217
|
+
You can configure an API-based Django backend and schedule
|
|
218
|
+
`commentail.background.process_pending()` in your project's queue instead of a
|
|
219
|
+
separate command job. Choose one schedule. Backend acceptance does not prove inbox
|
|
220
|
+
delivery. [Backend setup, scheduling and verification →](docs/wiki/Email-and-worker.md)
|
|
221
|
+
|
|
222
|
+
### 5. Check the integration
|
|
223
|
+
|
|
224
|
+
Submit a comment while signed in, approve it in **Comments**, then try a reply
|
|
225
|
+
and an eligible edit. In a separate browser session, submit as a guest and complete
|
|
226
|
+
email confirmation. Check the real site's theme, permissions and mail delivery.
|
|
227
|
+
[Deployment checks →](docs/wiki/Deployment.md#host-acceptance)
|
|
228
|
+
|
|
229
|
+
## Recent comments elsewhere
|
|
167
230
|
|
|
168
231
|
Use the recent-comments tag on a home page, sidebar or another template:
|
|
169
232
|
|
|
@@ -180,26 +243,11 @@ respects the current visitor's access and Site, requires a request context and
|
|
|
180
243
|
must not be shared-cached. It needs no widget CSS or JavaScript.
|
|
181
244
|
[Fields, filters and caching →](docs/wiki/Recent-comments.md)
|
|
182
245
|
|
|
183
|
-
### 4. Enable email and cleanup
|
|
184
|
-
|
|
185
|
-
Version 0.2.0 includes minimal HTML emails with the site name, clear action
|
|
186
|
-
links and equivalent plain text. Existing host email overrides take precedence.
|
|
187
|
-
|
|
188
|
-
Configure Django's SMTP settings and schedule this once per minute:
|
|
189
|
-
|
|
190
|
-
```sh
|
|
191
|
-
python manage.py process_commentail
|
|
192
|
-
```
|
|
193
|
-
|
|
194
|
-
It sends the database outbox and removes expired transient records. Guests confirm
|
|
195
|
-
email before moderation. Public submissions with an email are automatically
|
|
196
|
-
subscribed to direct-reply notifications when mail is enabled; each reply email
|
|
197
|
-
includes per-comment unsubscribe. [Email setup and behavior →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md)
|
|
198
|
-
|
|
199
246
|
## Make it yours
|
|
200
247
|
|
|
201
248
|
The widget has a transparent surface and inherits the container's font and text
|
|
202
|
-
color, following your site's light/dark theme.
|
|
249
|
+
color, following your site's light/dark theme. No custom properties are required
|
|
250
|
+
for the default appearance. To customize it, load overrides after its stylesheet:
|
|
203
251
|
|
|
204
252
|
```css
|
|
205
253
|
.commentail {
|
|
@@ -224,25 +272,23 @@ cover the same topics. Start with the task you need:
|
|
|
224
272
|
| Configure | [Site, Page and Python settings](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Configuration.md) · [Moderation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Moderation.md) · [CSV rules](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Rules-and-CSV.md) |
|
|
225
273
|
| Reader behavior | [Guests](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Guest-comments.md) · [Replies and editing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Replies-and-editing.md) |
|
|
226
274
|
| Customize | [CSS and themes](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Styling.md) · [Templates and email](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Templates.md) · [Python callbacks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Callbacks.md) · [Django model adapters](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Object-adapters.md) |
|
|
227
|
-
| Operate | [
|
|
275
|
+
| Operate | [Email and background processing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md) · [Deployment](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Deployment.md) · [Security and privacy](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Security-and-privacy.md) |
|
|
228
276
|
| Diagnose | [Troubleshooting / FAQ](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Troubleshooting.md) · [Example and testing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Example-and-testing.md) · [Performance and load checks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Performance.md) |
|
|
229
277
|
|
|
230
|
-
##
|
|
278
|
+
## Verification and limits
|
|
231
279
|
|
|
232
|
-
[
|
|
233
|
-
|
|
280
|
+
See the [changelog](CHANGELOG.md) and [release/upgrade guides](docs/wiki/Installation.md#upgrading-and-restoring)
|
|
281
|
+
for version-specific changes.
|
|
234
282
|
The source distribution includes the runnable Wagtail example, tests and
|
|
235
283
|
guides; the wheel includes the runtime, translations, templates and static assets.
|
|
236
284
|
|
|
237
285
|
The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
|
|
238
|
-
translations and source/wheel installation.
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
|
|
242
|
-
exhaustive accessibility or device certification.
|
|
286
|
+
translations and source/wheel installation. Local checks and hosted CI are separate;
|
|
287
|
+
inspect the workflow for the revision you use. Browser/accessibility coverage and
|
|
288
|
+
its limits are documented in [Example and testing](docs/wiki/Example-and-testing.md#acceptance-boundaries).
|
|
243
289
|
|
|
244
290
|
There is no separate REST API, rich-text editor, uploads, likes, reports or live
|
|
245
|
-
updates
|
|
291
|
+
updates. Mail retries can duplicate delivery after an uncertain backend result.
|
|
246
292
|
Host-specific themes, access rules and email delivery need their own acceptance checks.
|
|
247
293
|
|
|
248
294
|
## Support Commentail
|
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
|
|
7
7
|
Moderated discussions, verified guests and inline replies — styled by your site.
|
|
8
8
|
|
|
9
|
-
**Current release: [1.
|
|
9
|
+
**Current release: [1.2.0](https://github.com/hardcodd/Commentail/releases/tag/v1.2.0)** · [PyPI](https://pypi.org/project/commentail/1.2.0/)
|
|
10
10
|
|
|
11
11
|
[](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
|
|
12
12
|
[](https://djangopackages.org/packages/p/commentail/)
|
|
13
13
|
|
|
14
14
|
English · [Русский](README.ru.md)
|
|
15
15
|
|
|
16
|
-
[Get started](#quick-start) · [Documentation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Home.md) · [Wiki](https://github.com/hardcodd/Commentail/wiki) · [Support](#support-commentail)
|
|
16
|
+
[Get started](#quick-start) · [Screenshots](#screenshots) · [Documentation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Home.md) · [Wiki](https://github.com/hardcodd/Commentail/wiki) · [Support](#support-commentail)
|
|
17
17
|
|
|
18
18
|
<img src="https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/commentail-preview.png" alt="Commentail — a blue bird perched on a comment bubble" width="100%">
|
|
19
19
|
|
|
@@ -27,12 +27,6 @@ The widget inherits your site's typography and colors. CSS custom properties,
|
|
|
27
27
|
replaceable templates and Python callbacks let you adapt it without a frontend
|
|
28
28
|
framework or an external comments platform.
|
|
29
29
|
|
|
30
|
-
> **1.1.0** improves moderation with bulk actions, erasure confirmation,
|
|
31
|
-
> clearer filters and selection, preserved navigation and useful error recovery.
|
|
32
|
-
> Optional staff badges and publication notices only after moderation are included.
|
|
33
|
-
> [Version-to-version changelog](https://github.com/hardcodd/Commentail/blob/main/CHANGELOG.md) · [Roadmap](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Roadmap.md).
|
|
34
|
-
> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.1.0.md).
|
|
35
|
-
|
|
36
30
|
## Why Commentail?
|
|
37
31
|
|
|
38
32
|
| For readers | For editors | For developers |
|
|
@@ -51,7 +45,54 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
|
|
|
51
45
|
the visible text and author name. Choose either format or disable output in Python.
|
|
52
46
|
[Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
|
|
53
47
|
|
|
54
|
-
|
|
48
|
+
Documented integrations follow the [stable API and compatibility policy](docs/wiki/Stability.md).
|
|
49
|
+
|
|
50
|
+
## Screenshots
|
|
51
|
+
|
|
52
|
+
Captured from Commentail **1.1.0**, installed from PyPI in an isolated Wagtail
|
|
53
|
+
8.0.1 / Django 6.1.2 demo. Names and conversations are sample data.
|
|
54
|
+
The public page uses a custom host theme; the widget and admin screens are the
|
|
55
|
+
released package, without template overrides.
|
|
56
|
+
|
|
57
|
+
**On the site:** a discussion about Wagtail, Django templates and progressive
|
|
58
|
+
enhancement, with a threaded reply and a highlighted editor.
|
|
59
|
+
|
|
60
|
+

|
|
61
|
+
|
|
62
|
+
**Inside Wagtail:** the moderation queue, expanded site/page, status and date
|
|
63
|
+
filters, and two comments selected for bulk actions.
|
|
64
|
+
|
|
65
|
+

|
|
66
|
+
|
|
67
|
+
<details>
|
|
68
|
+
<summary>Guest form, inline reply, comment review and site/page settings</summary>
|
|
69
|
+
|
|
70
|
+
**Guest form.** A private email field, email-verification notice and the local
|
|
71
|
+
arithmetic challenge. The sample is an unsent draft.
|
|
72
|
+
|
|
73
|
+

|
|
74
|
+
|
|
75
|
+
**Inline reply.** The reply form opens below the selected comment and keeps the
|
|
76
|
+
recipient visible. This sample is also an unsent draft.
|
|
77
|
+
|
|
78
|
+

|
|
79
|
+
|
|
80
|
+
**Comment review.** Read the original text, choose a moderation action and inspect
|
|
81
|
+
its activity history.
|
|
82
|
+
|
|
83
|
+

|
|
84
|
+
|
|
85
|
+
**Site settings.** Discussion access, moderation policy, staff highlighting,
|
|
86
|
+
clickable links and email preferences in one place.
|
|
87
|
+
|
|
88
|
+

|
|
89
|
+
|
|
90
|
+
**Page settings.** Inherit the site policy or override it for an individual
|
|
91
|
+
discussion.
|
|
92
|
+
|
|
93
|
+

|
|
94
|
+
|
|
95
|
+
</details>
|
|
55
96
|
|
|
56
97
|
## Compatibility
|
|
57
98
|
|
|
@@ -64,46 +105,44 @@ From **1.0.0**, documented integration contracts follow the [stable API and comp
|
|
|
64
105
|
| Frontend | Django templates, optional progressive JavaScript |
|
|
65
106
|
| License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
|
|
66
107
|
|
|
67
|
-
|
|
68
|
-
CI defines all five framework
|
|
69
|
-
pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
|
|
108
|
+
CI defines all five framework pairs on Python 3.12, 3.13 and 3.14 with both databases (30 combinations).
|
|
70
109
|
Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
|
|
71
110
|
listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
|
|
72
111
|
Wagtail 8.1 and later require separate verification before support is declared.
|
|
73
112
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
113
|
+
The Wagtail 8 CI stacks select 8.0.1 or a newer patch within 8.0.
|
|
114
|
+
|
|
115
|
+
Guest comments require configured Django email delivery and scheduled background
|
|
116
|
+
processing. Use SMTP or another Django `EMAIL_BACKEND`, and schedule the command
|
|
117
|
+
or `commentail.background.process_pending()` through your existing task queue.
|
|
118
|
+
Registered users can comment without an email address, but receive no mail. Your
|
|
119
|
+
site provides login and registration. No required external CDN or CAPTCHA service.
|
|
120
|
+
See [email setup](docs/wiki/Email-and-worker.md).
|
|
77
121
|
|
|
78
122
|
### Languages
|
|
79
123
|
|
|
80
|
-
|
|
81
|
-
|
|
124
|
+
English (`en`), Russian (`ru`), German (`de`), French (`fr`), Spanish (`es`)
|
|
125
|
+
and Brazilian Portuguese (`pt-br`) are available for the public UI,
|
|
82
126
|
moderation/settings and all notification emails.
|
|
83
127
|
The host site selects the active Django language; queued emails retain the
|
|
84
128
|
recipient's saved language. User comments and rejection reasons are not translated.
|
|
85
|
-
|
|
129
|
+
The guides are in English; this README is also [available in Russian](README.ru.md).
|
|
86
130
|
[Language configuration →](docs/wiki/Configuration.md#languages)
|
|
87
131
|
|
|
88
132
|
## Quick start
|
|
89
133
|
|
|
90
134
|
### 1. Install
|
|
91
135
|
|
|
92
|
-
In your site's virtual environment, install the release:
|
|
136
|
+
In your existing Wagtail site's virtual environment, install the published release:
|
|
93
137
|
|
|
94
138
|
```sh
|
|
95
|
-
python -m pip install commentail==1.
|
|
139
|
+
python -m pip install commentail==1.2.0
|
|
96
140
|
```
|
|
97
141
|
|
|
98
142
|
For the optional PostgreSQL driver, use
|
|
99
|
-
`python -m pip install 'commentail[postgres]==1.
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.1.0.md),
|
|
103
|
-
including migration `0015`, updated static assets and host template overrides.
|
|
104
|
-
When coming from 0.1.1, also apply the [0.2.0 upgrade notes](docs/releases/0.2.0.md). For older
|
|
105
|
-
installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
|
|
106
|
-
its original Wagtail 7.4 and Django 5.2 limits.
|
|
143
|
+
`python -m pip install 'commentail[postgres]==1.2.0'`.
|
|
144
|
+
For an existing installation, follow
|
|
145
|
+
the [upgrade guide](docs/wiki/Installation.md#upgrading-and-restoring) for your target version.
|
|
107
146
|
|
|
108
147
|
### 2. Connect Django and Wagtail
|
|
109
148
|
|
|
@@ -135,7 +174,31 @@ The template controls where Page comments are available; the corresponding Page
|
|
|
135
174
|
editor receives a Comments tab. Configure site defaults, then inherit or override
|
|
136
175
|
on individual Pages. **Review all** is the initial moderation policy.
|
|
137
176
|
|
|
138
|
-
###
|
|
177
|
+
### 4. Enable email and cleanup
|
|
178
|
+
|
|
179
|
+
Configure Django's email backend and run this command once per minute:
|
|
180
|
+
|
|
181
|
+
```sh
|
|
182
|
+
python manage.py process_commentail
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
The command sends queued mail and removes expired temporary records. Guests confirm
|
|
186
|
+
their email before moderation. Authors with email are subscribed to direct-reply
|
|
187
|
+
notifications when mail is enabled; every reply email includes per-comment unsubscribe.
|
|
188
|
+
|
|
189
|
+
You can configure an API-based Django backend and schedule
|
|
190
|
+
`commentail.background.process_pending()` in your project's queue instead of a
|
|
191
|
+
separate command job. Choose one schedule. Backend acceptance does not prove inbox
|
|
192
|
+
delivery. [Backend setup, scheduling and verification →](docs/wiki/Email-and-worker.md)
|
|
193
|
+
|
|
194
|
+
### 5. Check the integration
|
|
195
|
+
|
|
196
|
+
Submit a comment while signed in, approve it in **Comments**, then try a reply
|
|
197
|
+
and an eligible edit. In a separate browser session, submit as a guest and complete
|
|
198
|
+
email confirmation. Check the real site's theme, permissions and mail delivery.
|
|
199
|
+
[Deployment checks →](docs/wiki/Deployment.md#host-acceptance)
|
|
200
|
+
|
|
201
|
+
## Recent comments elsewhere
|
|
139
202
|
|
|
140
203
|
Use the recent-comments tag on a home page, sidebar or another template:
|
|
141
204
|
|
|
@@ -152,26 +215,11 @@ respects the current visitor's access and Site, requires a request context and
|
|
|
152
215
|
must not be shared-cached. It needs no widget CSS or JavaScript.
|
|
153
216
|
[Fields, filters and caching →](docs/wiki/Recent-comments.md)
|
|
154
217
|
|
|
155
|
-
### 4. Enable email and cleanup
|
|
156
|
-
|
|
157
|
-
Version 0.2.0 includes minimal HTML emails with the site name, clear action
|
|
158
|
-
links and equivalent plain text. Existing host email overrides take precedence.
|
|
159
|
-
|
|
160
|
-
Configure Django's SMTP settings and schedule this once per minute:
|
|
161
|
-
|
|
162
|
-
```sh
|
|
163
|
-
python manage.py process_commentail
|
|
164
|
-
```
|
|
165
|
-
|
|
166
|
-
It sends the database outbox and removes expired transient records. Guests confirm
|
|
167
|
-
email before moderation. Public submissions with an email are automatically
|
|
168
|
-
subscribed to direct-reply notifications when mail is enabled; each reply email
|
|
169
|
-
includes per-comment unsubscribe. [Email setup and behavior →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md)
|
|
170
|
-
|
|
171
218
|
## Make it yours
|
|
172
219
|
|
|
173
220
|
The widget has a transparent surface and inherits the container's font and text
|
|
174
|
-
color, following your site's light/dark theme.
|
|
221
|
+
color, following your site's light/dark theme. No custom properties are required
|
|
222
|
+
for the default appearance. To customize it, load overrides after its stylesheet:
|
|
175
223
|
|
|
176
224
|
```css
|
|
177
225
|
.commentail {
|
|
@@ -196,25 +244,23 @@ cover the same topics. Start with the task you need:
|
|
|
196
244
|
| Configure | [Site, Page and Python settings](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Configuration.md) · [Moderation](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Moderation.md) · [CSV rules](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Rules-and-CSV.md) |
|
|
197
245
|
| Reader behavior | [Guests](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Guest-comments.md) · [Replies and editing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Replies-and-editing.md) |
|
|
198
246
|
| Customize | [CSS and themes](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Styling.md) · [Templates and email](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Templates.md) · [Python callbacks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Callbacks.md) · [Django model adapters](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Object-adapters.md) |
|
|
199
|
-
| Operate | [
|
|
247
|
+
| Operate | [Email and background processing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md) · [Deployment](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Deployment.md) · [Security and privacy](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Security-and-privacy.md) |
|
|
200
248
|
| Diagnose | [Troubleshooting / FAQ](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Troubleshooting.md) · [Example and testing](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Example-and-testing.md) · [Performance and load checks](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Performance.md) |
|
|
201
249
|
|
|
202
|
-
##
|
|
250
|
+
## Verification and limits
|
|
203
251
|
|
|
204
|
-
[
|
|
205
|
-
|
|
252
|
+
See the [changelog](CHANGELOG.md) and [release/upgrade guides](docs/wiki/Installation.md#upgrading-and-restoring)
|
|
253
|
+
for version-specific changes.
|
|
206
254
|
The source distribution includes the runnable Wagtail example, tests and
|
|
207
255
|
guides; the wheel includes the runtime, translations, templates and static assets.
|
|
208
256
|
|
|
209
257
|
The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
|
|
210
|
-
translations and source/wheel installation.
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
|
|
214
|
-
exhaustive accessibility or device certification.
|
|
258
|
+
translations and source/wheel installation. Local checks and hosted CI are separate;
|
|
259
|
+
inspect the workflow for the revision you use. Browser/accessibility coverage and
|
|
260
|
+
its limits are documented in [Example and testing](docs/wiki/Example-and-testing.md#acceptance-boundaries).
|
|
215
261
|
|
|
216
262
|
There is no separate REST API, rich-text editor, uploads, likes, reports or live
|
|
217
|
-
updates
|
|
263
|
+
updates. Mail retries can duplicate delivery after an uncertain backend result.
|
|
218
264
|
Host-specific themes, access rules and email delivery need their own acceptance checks.
|
|
219
265
|
|
|
220
266
|
## Support Commentail
|