commentail 1.0.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.0.0 → commentail-1.2.0}/CHANGELOG.md +74 -0
- {commentail-1.0.0/commentail.egg-info → commentail-1.2.0}/PKG-INFO +103 -54
- {commentail-1.0.0 → commentail-1.2.0}/README.md +102 -53
- {commentail-1.0.0 → commentail-1.2.0}/README.ru.md +108 -63
- {commentail-1.0.0 → commentail-1.2.0}/commentail/admin_views.py +182 -50
- {commentail-1.0.0 → commentail-1.2.0}/commentail/admission.py +13 -9
- commentail-1.2.0/commentail/background.py +45 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/drafts.py +6 -3
- {commentail-1.0.0 → commentail-1.2.0}/commentail/forms.py +9 -2
- commentail-1.2.0/commentail/locale/de/LC_MESSAGES/django.mo +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/locale/de/LC_MESSAGES/django.po +113 -4
- commentail-1.2.0/commentail/locale/es/LC_MESSAGES/django.mo +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/locale/es/LC_MESSAGES/django.po +113 -4
- commentail-1.2.0/commentail/locale/fr/LC_MESSAGES/django.mo +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/locale/fr/LC_MESSAGES/django.po +113 -4
- commentail-1.2.0/commentail/locale/pt_BR/LC_MESSAGES/django.mo +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/locale/pt_BR/LC_MESSAGES/django.po +113 -4
- commentail-1.2.0/commentail/locale/ru/LC_MESSAGES/django.mo +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/locale/ru/LC_MESSAGES/django.po +113 -4
- {commentail-1.0.0 → commentail-1.2.0}/commentail/logging.py +7 -1
- commentail-1.2.0/commentail/management/commands/process_commentail.py +13 -0
- commentail-1.2.0/commentail/migrations/0015_sitecommentsettings_highlight_staff.py +20 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/models.py +1 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/outbox.py +45 -18
- {commentail-1.0.0 → commentail-1.2.0}/commentail/policies.py +2 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/public.py +16 -6
- {commentail-1.0.0 → commentail-1.2.0}/commentail/services.py +6 -3
- commentail-1.2.0/commentail/static/commentail/admin.css +250 -0
- commentail-1.2.0/commentail/static/commentail/admin.js +83 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/static/commentail/commentail.css +77 -0
- commentail-1.2.0/commentail/templates/commentail/admin/action_error.html +22 -0
- commentail-1.2.0/commentail/templates/commentail/admin/base.html +4 -0
- commentail-1.2.0/commentail/templates/commentail/admin/confirm_delete.html +24 -0
- commentail-1.2.0/commentail/templates/commentail/admin/detail.html +4 -0
- commentail-1.2.0/commentail/templates/commentail/admin/field.html +10 -0
- commentail-1.2.0/commentail/templates/commentail/admin/form.html +39 -0
- commentail-1.2.0/commentail/templates/commentail/admin/heading.html +5 -0
- commentail-1.2.0/commentail/templates/commentail/admin/list.html +69 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/mail.html +2 -3
- commentail-1.2.0/commentail/templates/commentail/admin/management.html +19 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/objects.html +2 -3
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/rules.html +2 -3
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/rules_import.html +2 -4
- commentail-1.2.0/commentail/templates/commentail/admin/selection.html +26 -0
- commentail-1.2.0/commentail/templates/commentail/author.html +1 -0
- commentail-1.2.0/commentail/templates/commentail/avatar.html +1 -0
- commentail-1.2.0/commentail/templates/commentail/block.html +1 -0
- commentail-1.2.0/commentail/templates/commentail/captcha.html +1 -0
- commentail-1.2.0/commentail/templates/commentail/comment.html +1 -0
- commentail-1.2.0/commentail/templates/commentail/form.html +1 -0
- commentail-1.2.0/commentail/templatetags/commentail_admin.py +51 -0
- commentail-1.2.0/commentail/validation.py +6 -0
- {commentail-1.0.0 → commentail-1.2.0/commentail.egg-info}/PKG-INFO +103 -54
- {commentail-1.0.0 → commentail-1.2.0}/commentail.egg-info/SOURCES.txt +21 -0
- commentail-1.2.0/docs/releases/1.1.0.md +73 -0
- commentail-1.2.0/docs/releases/1.2.0.md +67 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Changelog.md +74 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Configuration.md +28 -3
- {commentail-1.0.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.0.0 → commentail-1.2.0}/docs/wiki/Example-and-testing.md +25 -7
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Guest-comments.md +3 -2
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Home.md +11 -6
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Installation.md +25 -22
- commentail-1.2.0/docs/wiki/Moderation.md +108 -0
- commentail-1.2.0/docs/wiki/Release-1.1.0.md +73 -0
- commentail-1.2.0/docs/wiki/Release-1.2.0.md +67 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Replies-and-editing.md +3 -1
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Roadmap.md +19 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Security-and-privacy.md +3 -2
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Stability.md +3 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Styling.md +26 -5
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Support.md +2 -2
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Template-contract.md +9 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Templates.md +1 -1
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Troubleshooting.md +9 -5
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/_Sidebar.md +2 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/README.md +11 -2
- {commentail-1.0.0 → commentail-1.2.0}/pyproject.toml +1 -1
- {commentail-1.0.0 → commentail-1.2.0}/requirements-test-common.txt +2 -2
- commentail-1.2.0/tests/test_admin.js +226 -0
- commentail-1.2.0/tests/test_admin_ui.py +829 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_admission.py +3 -2
- commentail-1.2.0/tests/test_background.py +174 -0
- {commentail-1.0.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.0.0 → commentail-1.2.0}/tests/test_mail_admin.py +12 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_notifications.py +6 -9
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_outbox.py +100 -1
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_public_ui.py +3 -2
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_security.py +10 -0
- commentail-1.2.0/tests/test_staff_authors.py +120 -0
- commentail-1.0.0/commentail/locale/de/LC_MESSAGES/django.mo +0 -0
- commentail-1.0.0/commentail/locale/es/LC_MESSAGES/django.mo +0 -0
- commentail-1.0.0/commentail/locale/fr/LC_MESSAGES/django.mo +0 -0
- commentail-1.0.0/commentail/locale/pt_BR/LC_MESSAGES/django.mo +0 -0
- commentail-1.0.0/commentail/locale/ru/LC_MESSAGES/django.mo +0 -0
- commentail-1.0.0/commentail/management/commands/process_commentail.py +0 -24
- commentail-1.0.0/commentail/static/commentail/admin.css +0 -80
- commentail-1.0.0/commentail/static/commentail/admin.js +0 -27
- commentail-1.0.0/commentail/templates/commentail/admin/detail.html +0 -5
- commentail-1.0.0/commentail/templates/commentail/admin/form.html +0 -13
- commentail-1.0.0/commentail/templates/commentail/admin/list.html +0 -9
- commentail-1.0.0/commentail/templates/commentail/block.html +0 -1
- commentail-1.0.0/commentail/templates/commentail/captcha.html +0 -1
- commentail-1.0.0/commentail/templates/commentail/comment.html +0 -1
- commentail-1.0.0/commentail/templates/commentail/form.html +0 -1
- commentail-1.0.0/docs/wiki/Email-and-worker.md +0 -104
- commentail-1.0.0/docs/wiki/Moderation.md +0 -56
- commentail-1.0.0/tests/test_admin.js +0 -35
- commentail-1.0.0/tests/test_admin_ui.py +0 -272
- {commentail-1.0.0 → commentail-1.2.0}/LICENSE +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/MANIFEST.in +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/admin_urls.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/apps.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/assets.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/avatars.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/checks.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/config.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/detection.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/group_permissions.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/limits.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/management/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/management/commands/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/middleware.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0001_initial.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0002_sitegrouppermission_hide_sitegrouppermission_view.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0003_actiontoken_captchachallenge_guestgrant.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0004_submissionrecord.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0005_rateevent.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0006_alter_comment_guest_name_and_more.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0007_actiontoken_nonce_replysubscription_mailjob.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0008_mailjob_revision.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0009_formticket.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0010_captchachallenge_backend_and_more.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0011_discussion_content_type_discussion_object_id_and_more.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0012_formticket_draft.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0013_sitecommentsettings_email_enabled.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/0014_reading_indexes.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/migrations/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/objects.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/page_integration.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/panels.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/permissions.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/recent.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/rules_csv.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/security.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/signals.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/static/commentail/commentail.js +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/structured.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/action.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/group_permission_row.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/group_permissions.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/admin/page_panel.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/base.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/edit-form.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/base.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/button.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm_subject.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit_subject.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published_subject.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected_subject.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply_subject.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templates/commentail/replies.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templatetags/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/templatetags/commentail_tags.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/text.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/urls.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/views.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail/wagtail_hooks.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail.egg-info/dependency_links.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail.egg-info/requires.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/commentail.egg-info/top_level.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/assets/commentail-preview.png +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/assets/support-qr.png +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/releases/0.1.0.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/releases/0.1.1.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/releases/0.2.0.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/releases/1.0.0.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Callbacks.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Object-adapters.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Performance.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Recent-comments.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Release-0.1.0.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Release-0.1.1.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Release-0.2.0.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Release-1.0.0.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Rules-and-CSV.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/Structured-data.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/docs/wiki/_Footer.md +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo/settings.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo/urls.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/comments.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/management/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/management/commands/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/management/commands/bootstrap_demo.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/migrations/0001_initial.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/migrations/0002_product.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/migrations/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/models.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/templates/demo_home/home_page.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/templates/demo_home/product.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/demo_home/views.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/example/manage.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/requirements-test.txt +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/setup.cfg +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/settings.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/targets/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/targets/apps.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/targets/migrations/0001_initial.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/targets/migrations/__init__.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/targets/models.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/templates/wagtailcore/page.html +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_actions.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_avatars.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_capability_access.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_captcha_backend.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_concurrency.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_detection.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_email_presentation.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_extension_contracts.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_group_panel.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_inline_edit.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_lifecycle.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_localization.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_name_limit.js +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_object_adapters.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_performance.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_presentation_contracts.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_progressive.js +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_rate_limits.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_recent_comments.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_release_gaps.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_reply.js +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_rules_admin.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_rules_csv.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_smtp_chain.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_structured_data.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_submission.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/test_transaction_contracts.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/urls.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tests/urls_custom_prefix.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tools/benchmark_performance.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tools/check_dist.py +0 -0
- {commentail-1.0.0 → commentail-1.2.0}/tools/check_translations.py +0 -0
|
@@ -3,6 +3,76 @@
|
|
|
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
|
+
|
|
38
|
+
## [1.1.0] — 2026-10-20 · Stable
|
|
39
|
+
|
|
40
|
+
- Explain failed moderation actions with a translated recovery page and a return
|
|
41
|
+
link to the same list filters. Changed statuses, permissions and unavailable
|
|
42
|
+
comments leave the entire bulk action unchanged, including audit and mail jobs.
|
|
43
|
+
|
|
44
|
+
- Send optional publication notices only after moderator approval of pending
|
|
45
|
+
comments or author revisions. Immediate publication stays silent for the author;
|
|
46
|
+
guest confirmation/edit links and reply notifications remain available.
|
|
47
|
+
|
|
48
|
+
- Keep the permission-aware Management menu on every Commentail admin page.
|
|
49
|
+
Group settings and group access fields into compact sections with aligned
|
|
50
|
+
controls, adjacent checkbox labels and inline validation errors.
|
|
51
|
+
|
|
52
|
+
- Preserve the comment list's search, filters and pagination through comment
|
|
53
|
+
cards, single moderation and revision decisions, erasure confirmation and mail
|
|
54
|
+
retries. The card's back link returns to the same selection in each tab.
|
|
55
|
+
|
|
56
|
+
- Add a selection panel above the comment list with a live count, clear selection,
|
|
57
|
+
and explanations for unavailable bulk actions. Selection applies to eligible
|
|
58
|
+
rows on the current page. A cog management menu, grouped advanced filters and
|
|
59
|
+
action-help popover support keyboard dismissal and reduced-motion preferences.
|
|
60
|
+
Controls remain available without JavaScript.
|
|
61
|
+
Refresh static assets when upgrading.
|
|
62
|
+
|
|
63
|
+
- Highlight staff author names with a colored badge and add a golden crown on
|
|
64
|
+
super administrators’ avatars, with a distinct golden name badge. Enabled by
|
|
65
|
+
default; a per-Site switch disables both.
|
|
66
|
+
Apply migration `0015_sitecommentsettings_highlight_staff` and refresh static
|
|
67
|
+
assets. Existing template overrides need the new author decorations to show them.
|
|
68
|
+
|
|
69
|
+
- Require confirmation before single or bulk text erasure, showing the comment
|
|
70
|
+
count and irreversible-erasure warning, with cancellation that leaves data intact.
|
|
71
|
+
|
|
72
|
+
- Add bulk hide, restore and permanent text erasure to the comment list,
|
|
73
|
+
including All statuses, with per-Site permissions and status-aware selection.
|
|
74
|
+
Invalid batches roll back entirely; successful actions retain list filters.
|
|
75
|
+
|
|
6
76
|
## [1.0.0] — 2026-10-19 · Stable
|
|
7
77
|
|
|
8
78
|
The feature set is frozen at 0.2.0 Beta. This release introduces the documented
|
|
@@ -125,3 +195,7 @@ See [0.1.0 release notes](docs/releases/0.1.0.md).
|
|
|
125
195
|
|
|
126
196
|
[1.0.0]: https://github.com/hardcodd/Commentail/compare/v0.2.0...v1.0.0
|
|
127
197
|
[0.2.0]: https://github.com/hardcodd/Commentail/compare/v0.1.1...v0.2.0
|
|
198
|
+
|
|
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,11 +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.0.0** starts the stable API and compatibility policy with the
|
|
59
|
-
> feature set of 0.2.0 Beta, including recent comments, six languages and HTML emails.
|
|
60
|
-
> [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).
|
|
61
|
-
> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md).
|
|
62
|
-
|
|
63
58
|
## Why Commentail?
|
|
64
59
|
|
|
65
60
|
| For readers | For editors | For developers |
|
|
@@ -78,7 +73,54 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
|
|
|
78
73
|
the visible text and author name. Choose either format or disable output in Python.
|
|
79
74
|
[Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
|
|
80
75
|
|
|
81
|
-
|
|
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>
|
|
82
124
|
|
|
83
125
|
## Compatibility
|
|
84
126
|
|
|
@@ -91,44 +133,44 @@ From **1.0.0**, documented integration contracts follow the [stable API and comp
|
|
|
91
133
|
| Frontend | Django templates, optional progressive JavaScript |
|
|
92
134
|
| License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
|
|
93
135
|
|
|
94
|
-
|
|
95
|
-
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).
|
|
96
137
|
Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
|
|
97
138
|
listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
|
|
98
139
|
Wagtail 8.1 and later require separate verification before support is declared.
|
|
99
140
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
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).
|
|
103
149
|
|
|
104
150
|
### Languages
|
|
105
151
|
|
|
106
|
-
|
|
107
|
-
|
|
152
|
+
English (`en`), Russian (`ru`), German (`de`), French (`fr`), Spanish (`es`)
|
|
153
|
+
and Brazilian Portuguese (`pt-br`) are available for the public UI,
|
|
108
154
|
moderation/settings and all notification emails.
|
|
109
155
|
The host site selects the active Django language; queued emails retain the
|
|
110
156
|
recipient's saved language. User comments and rejection reasons are not translated.
|
|
111
|
-
|
|
157
|
+
The guides are in English; this README is also [available in Russian](README.ru.md).
|
|
112
158
|
[Language configuration →](docs/wiki/Configuration.md#languages)
|
|
113
159
|
|
|
114
160
|
## Quick start
|
|
115
161
|
|
|
116
162
|
### 1. Install
|
|
117
163
|
|
|
118
|
-
In your site's virtual environment, install the release:
|
|
164
|
+
In your existing Wagtail site's virtual environment, install the published release:
|
|
119
165
|
|
|
120
166
|
```sh
|
|
121
|
-
python -m pip install commentail==1.
|
|
167
|
+
python -m pip install commentail==1.2.0
|
|
122
168
|
```
|
|
123
169
|
|
|
124
170
|
For the optional PostgreSQL driver, use
|
|
125
|
-
`python -m pip install 'commentail[postgres]==1.
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md),
|
|
129
|
-
including the 0.2.0 index migration and email overrides when coming from 0.1.1. For older
|
|
130
|
-
installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
|
|
131
|
-
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.
|
|
132
174
|
|
|
133
175
|
### 2. Connect Django and Wagtail
|
|
134
176
|
|
|
@@ -160,7 +202,31 @@ The template controls where Page comments are available; the corresponding Page
|
|
|
160
202
|
editor receives a Comments tab. Configure site defaults, then inherit or override
|
|
161
203
|
on individual Pages. **Review all** is the initial moderation policy.
|
|
162
204
|
|
|
163
|
-
###
|
|
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
|
|
164
230
|
|
|
165
231
|
Use the recent-comments tag on a home page, sidebar or another template:
|
|
166
232
|
|
|
@@ -177,26 +243,11 @@ respects the current visitor's access and Site, requires a request context and
|
|
|
177
243
|
must not be shared-cached. It needs no widget CSS or JavaScript.
|
|
178
244
|
[Fields, filters and caching →](docs/wiki/Recent-comments.md)
|
|
179
245
|
|
|
180
|
-
### 4. Enable email and cleanup
|
|
181
|
-
|
|
182
|
-
Version 0.2.0 includes minimal HTML emails with the site name, clear action
|
|
183
|
-
links and equivalent plain text. Existing host email overrides take precedence.
|
|
184
|
-
|
|
185
|
-
Configure Django's SMTP settings and schedule this once per minute:
|
|
186
|
-
|
|
187
|
-
```sh
|
|
188
|
-
python manage.py process_commentail
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
It sends the database outbox and removes expired transient records. Guests confirm
|
|
192
|
-
email before moderation. Public submissions with an email are automatically
|
|
193
|
-
subscribed to direct-reply notifications when mail is enabled; each reply email
|
|
194
|
-
includes per-comment unsubscribe. [Email setup and behavior →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md)
|
|
195
|
-
|
|
196
246
|
## Make it yours
|
|
197
247
|
|
|
198
248
|
The widget has a transparent surface and inherits the container's font and text
|
|
199
|
-
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:
|
|
200
251
|
|
|
201
252
|
```css
|
|
202
253
|
.commentail {
|
|
@@ -221,25 +272,23 @@ cover the same topics. Start with the task you need:
|
|
|
221
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) |
|
|
222
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) |
|
|
223
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) |
|
|
224
|
-
| 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) |
|
|
225
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) |
|
|
226
277
|
|
|
227
|
-
##
|
|
278
|
+
## Verification and limits
|
|
228
279
|
|
|
229
|
-
[
|
|
230
|
-
|
|
280
|
+
See the [changelog](CHANGELOG.md) and [release/upgrade guides](docs/wiki/Installation.md#upgrading-and-restoring)
|
|
281
|
+
for version-specific changes.
|
|
231
282
|
The source distribution includes the runnable Wagtail example, tests and
|
|
232
283
|
guides; the wheel includes the runtime, translations, templates and static assets.
|
|
233
284
|
|
|
234
285
|
The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
|
|
235
|
-
translations and source/wheel installation.
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
|
|
239
|
-
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).
|
|
240
289
|
|
|
241
290
|
There is no separate REST API, rich-text editor, uploads, likes, reports or live
|
|
242
|
-
updates
|
|
291
|
+
updates. Mail retries can duplicate delivery after an uncertain backend result.
|
|
243
292
|
Host-specific themes, access rules and email delivery need their own acceptance checks.
|
|
244
293
|
|
|
245
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,11 +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.0.0** starts the stable API and compatibility policy with the
|
|
31
|
-
> feature set of 0.2.0 Beta, including recent comments, six languages and HTML emails.
|
|
32
|
-
> [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).
|
|
33
|
-
> [Changes and upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md).
|
|
34
|
-
|
|
35
30
|
## Why Commentail?
|
|
36
31
|
|
|
37
32
|
| For readers | For editors | For developers |
|
|
@@ -50,7 +45,54 @@ Published comments include **Schema.org Comment microdata and JSON-LD**, using
|
|
|
50
45
|
the visible text and author name. Choose either format or disable output in Python.
|
|
51
46
|
[Structured-data guide →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Structured-data.md)
|
|
52
47
|
|
|
53
|
-
|
|
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>
|
|
54
96
|
|
|
55
97
|
## Compatibility
|
|
56
98
|
|
|
@@ -63,44 +105,44 @@ From **1.0.0**, documented integration contracts follow the [stable API and comp
|
|
|
63
105
|
| Frontend | Django templates, optional progressive JavaScript |
|
|
64
106
|
| License | [MIT](https://github.com/hardcodd/Commentail/blob/main/LICENSE) |
|
|
65
107
|
|
|
66
|
-
|
|
67
|
-
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).
|
|
68
109
|
Package bounds are `Wagtail>=7.4.3,<8.1` and `Django>=5.2,<6.2`; only the pairs
|
|
69
110
|
listed above are supported. Wagtail 7.4 with Django 6.1 is outside this matrix.
|
|
70
111
|
Wagtail 8.1 and later require separate verification before support is declared.
|
|
71
112
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
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).
|
|
75
121
|
|
|
76
122
|
### Languages
|
|
77
123
|
|
|
78
|
-
|
|
79
|
-
|
|
124
|
+
English (`en`), Russian (`ru`), German (`de`), French (`fr`), Spanish (`es`)
|
|
125
|
+
and Brazilian Portuguese (`pt-br`) are available for the public UI,
|
|
80
126
|
moderation/settings and all notification emails.
|
|
81
127
|
The host site selects the active Django language; queued emails retain the
|
|
82
128
|
recipient's saved language. User comments and rejection reasons are not translated.
|
|
83
|
-
|
|
129
|
+
The guides are in English; this README is also [available in Russian](README.ru.md).
|
|
84
130
|
[Language configuration →](docs/wiki/Configuration.md#languages)
|
|
85
131
|
|
|
86
132
|
## Quick start
|
|
87
133
|
|
|
88
134
|
### 1. Install
|
|
89
135
|
|
|
90
|
-
In your site's virtual environment, install the release:
|
|
136
|
+
In your existing Wagtail site's virtual environment, install the published release:
|
|
91
137
|
|
|
92
138
|
```sh
|
|
93
|
-
python -m pip install commentail==1.
|
|
139
|
+
python -m pip install commentail==1.2.0
|
|
94
140
|
```
|
|
95
141
|
|
|
96
142
|
For the optional PostgreSQL driver, use
|
|
97
|
-
`python -m pip install 'commentail[postgres]==1.
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
[upgrade notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.0.0.md),
|
|
101
|
-
including the 0.2.0 index migration and email overrides when coming from 0.1.1. For older
|
|
102
|
-
installations, also review the [0.1.1 notes](docs/releases/0.1.1.md). The 0.1.0 package retains
|
|
103
|
-
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.
|
|
104
146
|
|
|
105
147
|
### 2. Connect Django and Wagtail
|
|
106
148
|
|
|
@@ -132,7 +174,31 @@ The template controls where Page comments are available; the corresponding Page
|
|
|
132
174
|
editor receives a Comments tab. Configure site defaults, then inherit or override
|
|
133
175
|
on individual Pages. **Review all** is the initial moderation policy.
|
|
134
176
|
|
|
135
|
-
###
|
|
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
|
|
136
202
|
|
|
137
203
|
Use the recent-comments tag on a home page, sidebar or another template:
|
|
138
204
|
|
|
@@ -149,26 +215,11 @@ respects the current visitor's access and Site, requires a request context and
|
|
|
149
215
|
must not be shared-cached. It needs no widget CSS or JavaScript.
|
|
150
216
|
[Fields, filters and caching →](docs/wiki/Recent-comments.md)
|
|
151
217
|
|
|
152
|
-
### 4. Enable email and cleanup
|
|
153
|
-
|
|
154
|
-
Version 0.2.0 includes minimal HTML emails with the site name, clear action
|
|
155
|
-
links and equivalent plain text. Existing host email overrides take precedence.
|
|
156
|
-
|
|
157
|
-
Configure Django's SMTP settings and schedule this once per minute:
|
|
158
|
-
|
|
159
|
-
```sh
|
|
160
|
-
python manage.py process_commentail
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
It sends the database outbox and removes expired transient records. Guests confirm
|
|
164
|
-
email before moderation. Public submissions with an email are automatically
|
|
165
|
-
subscribed to direct-reply notifications when mail is enabled; each reply email
|
|
166
|
-
includes per-comment unsubscribe. [Email setup and behavior →](https://github.com/hardcodd/Commentail/blob/main/docs/wiki/Email-and-worker.md)
|
|
167
|
-
|
|
168
218
|
## Make it yours
|
|
169
219
|
|
|
170
220
|
The widget has a transparent surface and inherits the container's font and text
|
|
171
|
-
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:
|
|
172
223
|
|
|
173
224
|
```css
|
|
174
225
|
.commentail {
|
|
@@ -193,25 +244,23 @@ cover the same topics. Start with the task you need:
|
|
|
193
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) |
|
|
194
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) |
|
|
195
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) |
|
|
196
|
-
| 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) |
|
|
197
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) |
|
|
198
249
|
|
|
199
|
-
##
|
|
250
|
+
## Verification and limits
|
|
200
251
|
|
|
201
|
-
[
|
|
202
|
-
|
|
252
|
+
See the [changelog](CHANGELOG.md) and [release/upgrade guides](docs/wiki/Installation.md#upgrading-and-restoring)
|
|
253
|
+
for version-specific changes.
|
|
203
254
|
The source distribution includes the runnable Wagtail example, tests and
|
|
204
255
|
guides; the wheel includes the runtime, translations, templates and static assets.
|
|
205
256
|
|
|
206
257
|
The CI workflow defines 30 framework/Python/database combinations, JavaScript, lint, migration drift,
|
|
207
|
-
translations and source/wheel installation.
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
140 ESR on Windows ARM64; Chrome x64 used Windows emulation. This is not an
|
|
211
|
-
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).
|
|
212
261
|
|
|
213
262
|
There is no separate REST API, rich-text editor, uploads, likes, reports or live
|
|
214
|
-
updates
|
|
263
|
+
updates. Mail retries can duplicate delivery after an uncertain backend result.
|
|
215
264
|
Host-specific themes, access rules and email delivery need their own acceptance checks.
|
|
216
265
|
|
|
217
266
|
## Support Commentail
|