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.
Files changed (250) hide show
  1. {commentail-1.1.0 → commentail-1.2.0}/CHANGELOG.md +34 -0
  2. {commentail-1.1.0/commentail.egg-info → commentail-1.2.0}/PKG-INFO +103 -57
  3. {commentail-1.1.0 → commentail-1.2.0}/README.md +102 -56
  4. {commentail-1.1.0 → commentail-1.2.0}/README.ru.md +108 -66
  5. {commentail-1.1.0 → commentail-1.2.0}/commentail/admin_views.py +10 -11
  6. {commentail-1.1.0 → commentail-1.2.0}/commentail/admission.py +13 -9
  7. commentail-1.2.0/commentail/background.py +45 -0
  8. {commentail-1.1.0 → commentail-1.2.0}/commentail/drafts.py +6 -3
  9. commentail-1.2.0/commentail/locale/de/LC_MESSAGES/django.mo +0 -0
  10. {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/de/LC_MESSAGES/django.po +4 -4
  11. commentail-1.2.0/commentail/locale/es/LC_MESSAGES/django.mo +0 -0
  12. {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/es/LC_MESSAGES/django.po +4 -4
  13. commentail-1.2.0/commentail/locale/fr/LC_MESSAGES/django.mo +0 -0
  14. {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/fr/LC_MESSAGES/django.po +4 -4
  15. commentail-1.2.0/commentail/locale/pt_BR/LC_MESSAGES/django.mo +0 -0
  16. {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/pt_BR/LC_MESSAGES/django.po +4 -4
  17. commentail-1.2.0/commentail/locale/ru/LC_MESSAGES/django.mo +0 -0
  18. {commentail-1.1.0 → commentail-1.2.0}/commentail/locale/ru/LC_MESSAGES/django.po +4 -4
  19. {commentail-1.1.0 → commentail-1.2.0}/commentail/logging.py +7 -1
  20. commentail-1.2.0/commentail/management/commands/process_commentail.py +13 -0
  21. {commentail-1.1.0 → commentail-1.2.0}/commentail/outbox.py +35 -14
  22. {commentail-1.1.0 → commentail-1.2.0}/commentail/public.py +7 -6
  23. {commentail-1.1.0 → commentail-1.2.0}/commentail/services.py +4 -1
  24. {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/commentail.css +48 -0
  25. commentail-1.2.0/commentail/templates/commentail/captcha.html +1 -0
  26. commentail-1.2.0/commentail/templates/commentail/form.html +1 -0
  27. commentail-1.2.0/commentail/validation.py +6 -0
  28. {commentail-1.1.0 → commentail-1.2.0/commentail.egg-info}/PKG-INFO +103 -57
  29. {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/SOURCES.txt +7 -0
  30. commentail-1.2.0/docs/releases/1.2.0.md +67 -0
  31. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Changelog.md +34 -0
  32. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Configuration.md +7 -3
  33. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Deployment.md +8 -4
  34. commentail-1.2.0/docs/wiki/Email-and-worker.md +249 -0
  35. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Example-and-testing.md +24 -6
  36. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Guest-comments.md +3 -2
  37. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Home.md +11 -6
  38. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Installation.md +25 -30
  39. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Moderation.md +1 -1
  40. commentail-1.2.0/docs/wiki/Release-1.2.0.md +67 -0
  41. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Replies-and-editing.md +3 -1
  42. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Roadmap.md +12 -0
  43. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Security-and-privacy.md +3 -2
  44. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Stability.md +3 -0
  45. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Styling.md +17 -5
  46. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Support.md +2 -2
  47. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Templates.md +1 -1
  48. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Troubleshooting.md +9 -5
  49. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/_Sidebar.md +1 -0
  50. {commentail-1.1.0 → commentail-1.2.0}/example/README.md +11 -2
  51. {commentail-1.1.0 → commentail-1.2.0}/pyproject.toml +1 -1
  52. {commentail-1.1.0 → commentail-1.2.0}/requirements-test-common.txt +2 -2
  53. {commentail-1.1.0 → commentail-1.2.0}/tests/test_admission.py +3 -2
  54. commentail-1.2.0/tests/test_background.py +174 -0
  55. {commentail-1.1.0 → commentail-1.2.0}/tests/test_cleanup.py +8 -4
  56. commentail-1.2.0/tests/test_email_backends.py +205 -0
  57. commentail-1.2.0/tests/test_input_boundaries.py +81 -0
  58. {commentail-1.1.0 → commentail-1.2.0}/tests/test_notifications.py +6 -9
  59. {commentail-1.1.0 → commentail-1.2.0}/tests/test_public_ui.py +3 -2
  60. {commentail-1.1.0 → commentail-1.2.0}/tests/test_security.py +10 -0
  61. commentail-1.1.0/commentail/locale/de/LC_MESSAGES/django.mo +0 -0
  62. commentail-1.1.0/commentail/locale/es/LC_MESSAGES/django.mo +0 -0
  63. commentail-1.1.0/commentail/locale/fr/LC_MESSAGES/django.mo +0 -0
  64. commentail-1.1.0/commentail/locale/pt_BR/LC_MESSAGES/django.mo +0 -0
  65. commentail-1.1.0/commentail/locale/ru/LC_MESSAGES/django.mo +0 -0
  66. commentail-1.1.0/commentail/management/commands/process_commentail.py +0 -24
  67. commentail-1.1.0/commentail/templates/commentail/captcha.html +0 -1
  68. commentail-1.1.0/commentail/templates/commentail/form.html +0 -1
  69. commentail-1.1.0/docs/wiki/Email-and-worker.md +0 -108
  70. {commentail-1.1.0 → commentail-1.2.0}/LICENSE +0 -0
  71. {commentail-1.1.0 → commentail-1.2.0}/MANIFEST.in +0 -0
  72. {commentail-1.1.0 → commentail-1.2.0}/commentail/__init__.py +0 -0
  73. {commentail-1.1.0 → commentail-1.2.0}/commentail/admin_urls.py +0 -0
  74. {commentail-1.1.0 → commentail-1.2.0}/commentail/apps.py +0 -0
  75. {commentail-1.1.0 → commentail-1.2.0}/commentail/assets.py +0 -0
  76. {commentail-1.1.0 → commentail-1.2.0}/commentail/avatars.py +0 -0
  77. {commentail-1.1.0 → commentail-1.2.0}/commentail/checks.py +0 -0
  78. {commentail-1.1.0 → commentail-1.2.0}/commentail/config.py +0 -0
  79. {commentail-1.1.0 → commentail-1.2.0}/commentail/detection.py +0 -0
  80. {commentail-1.1.0 → commentail-1.2.0}/commentail/forms.py +0 -0
  81. {commentail-1.1.0 → commentail-1.2.0}/commentail/group_permissions.py +0 -0
  82. {commentail-1.1.0 → commentail-1.2.0}/commentail/limits.py +0 -0
  83. {commentail-1.1.0 → commentail-1.2.0}/commentail/management/__init__.py +0 -0
  84. {commentail-1.1.0 → commentail-1.2.0}/commentail/management/commands/__init__.py +0 -0
  85. {commentail-1.1.0 → commentail-1.2.0}/commentail/middleware.py +0 -0
  86. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0001_initial.py +0 -0
  87. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0002_sitegrouppermission_hide_sitegrouppermission_view.py +0 -0
  88. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0003_actiontoken_captchachallenge_guestgrant.py +0 -0
  89. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0004_submissionrecord.py +0 -0
  90. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0005_rateevent.py +0 -0
  91. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0006_alter_comment_guest_name_and_more.py +0 -0
  92. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0007_actiontoken_nonce_replysubscription_mailjob.py +0 -0
  93. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0008_mailjob_revision.py +0 -0
  94. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0009_formticket.py +0 -0
  95. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0010_captchachallenge_backend_and_more.py +0 -0
  96. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0011_discussion_content_type_discussion_object_id_and_more.py +0 -0
  97. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0012_formticket_draft.py +0 -0
  98. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0013_sitecommentsettings_email_enabled.py +0 -0
  99. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0014_reading_indexes.py +0 -0
  100. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/0015_sitecommentsettings_highlight_staff.py +0 -0
  101. {commentail-1.1.0 → commentail-1.2.0}/commentail/migrations/__init__.py +0 -0
  102. {commentail-1.1.0 → commentail-1.2.0}/commentail/models.py +0 -0
  103. {commentail-1.1.0 → commentail-1.2.0}/commentail/objects.py +0 -0
  104. {commentail-1.1.0 → commentail-1.2.0}/commentail/page_integration.py +0 -0
  105. {commentail-1.1.0 → commentail-1.2.0}/commentail/panels.py +0 -0
  106. {commentail-1.1.0 → commentail-1.2.0}/commentail/permissions.py +0 -0
  107. {commentail-1.1.0 → commentail-1.2.0}/commentail/policies.py +0 -0
  108. {commentail-1.1.0 → commentail-1.2.0}/commentail/recent.py +0 -0
  109. {commentail-1.1.0 → commentail-1.2.0}/commentail/rules_csv.py +0 -0
  110. {commentail-1.1.0 → commentail-1.2.0}/commentail/security.py +0 -0
  111. {commentail-1.1.0 → commentail-1.2.0}/commentail/signals.py +0 -0
  112. {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/admin.css +0 -0
  113. {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/admin.js +0 -0
  114. {commentail-1.1.0 → commentail-1.2.0}/commentail/static/commentail/commentail.js +0 -0
  115. {commentail-1.1.0 → commentail-1.2.0}/commentail/structured.py +0 -0
  116. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/action.html +0 -0
  117. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/action_error.html +0 -0
  118. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/base.html +0 -0
  119. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/confirm_delete.html +0 -0
  120. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/detail.html +0 -0
  121. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/field.html +0 -0
  122. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/form.html +0 -0
  123. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/group_permission_row.html +0 -0
  124. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/group_permissions.html +0 -0
  125. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/heading.html +0 -0
  126. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/list.html +0 -0
  127. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/mail.html +0 -0
  128. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/management.html +0 -0
  129. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/objects.html +0 -0
  130. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/page_panel.html +0 -0
  131. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/rules.html +0 -0
  132. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/rules_import.html +0 -0
  133. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/admin/selection.html +0 -0
  134. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/author.html +0 -0
  135. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/avatar.html +0 -0
  136. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/base.html +0 -0
  137. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/block.html +0 -0
  138. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/comment.html +0 -0
  139. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/edit-form.html +0 -0
  140. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/base.html +0 -0
  141. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/button.html +0 -0
  142. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm.html +0 -0
  143. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm.txt +0 -0
  144. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/confirm_subject.txt +0 -0
  145. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit.html +0 -0
  146. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit.txt +0 -0
  147. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/edit_subject.txt +0 -0
  148. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published.html +0 -0
  149. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published.txt +0 -0
  150. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/published_subject.txt +0 -0
  151. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected.html +0 -0
  152. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected.txt +0 -0
  153. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/rejected_subject.txt +0 -0
  154. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply.html +0 -0
  155. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply.txt +0 -0
  156. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/emails/reply_subject.txt +0 -0
  157. {commentail-1.1.0 → commentail-1.2.0}/commentail/templates/commentail/replies.html +0 -0
  158. {commentail-1.1.0 → commentail-1.2.0}/commentail/templatetags/__init__.py +0 -0
  159. {commentail-1.1.0 → commentail-1.2.0}/commentail/templatetags/commentail_admin.py +0 -0
  160. {commentail-1.1.0 → commentail-1.2.0}/commentail/templatetags/commentail_tags.py +0 -0
  161. {commentail-1.1.0 → commentail-1.2.0}/commentail/text.py +0 -0
  162. {commentail-1.1.0 → commentail-1.2.0}/commentail/urls.py +0 -0
  163. {commentail-1.1.0 → commentail-1.2.0}/commentail/views.py +0 -0
  164. {commentail-1.1.0 → commentail-1.2.0}/commentail/wagtail_hooks.py +0 -0
  165. {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/dependency_links.txt +0 -0
  166. {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/requires.txt +0 -0
  167. {commentail-1.1.0 → commentail-1.2.0}/commentail.egg-info/top_level.txt +0 -0
  168. {commentail-1.1.0 → commentail-1.2.0}/docs/assets/commentail-preview.png +0 -0
  169. {commentail-1.1.0 → commentail-1.2.0}/docs/assets/support-qr.png +0 -0
  170. {commentail-1.1.0 → commentail-1.2.0}/docs/releases/0.1.0.md +0 -0
  171. {commentail-1.1.0 → commentail-1.2.0}/docs/releases/0.1.1.md +0 -0
  172. {commentail-1.1.0 → commentail-1.2.0}/docs/releases/0.2.0.md +0 -0
  173. {commentail-1.1.0 → commentail-1.2.0}/docs/releases/1.0.0.md +0 -0
  174. {commentail-1.1.0 → commentail-1.2.0}/docs/releases/1.1.0.md +0 -0
  175. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Callbacks.md +0 -0
  176. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Object-adapters.md +0 -0
  177. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Performance.md +0 -0
  178. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Recent-comments.md +0 -0
  179. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-0.1.0.md +0 -0
  180. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-0.1.1.md +0 -0
  181. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-0.2.0.md +0 -0
  182. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-1.0.0.md +0 -0
  183. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Release-1.1.0.md +0 -0
  184. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Rules-and-CSV.md +0 -0
  185. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Structured-data.md +0 -0
  186. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/Template-contract.md +0 -0
  187. {commentail-1.1.0 → commentail-1.2.0}/docs/wiki/_Footer.md +0 -0
  188. {commentail-1.1.0 → commentail-1.2.0}/example/demo/__init__.py +0 -0
  189. {commentail-1.1.0 → commentail-1.2.0}/example/demo/settings.py +0 -0
  190. {commentail-1.1.0 → commentail-1.2.0}/example/demo/urls.py +0 -0
  191. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/__init__.py +0 -0
  192. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/comments.py +0 -0
  193. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/management/__init__.py +0 -0
  194. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/management/commands/__init__.py +0 -0
  195. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/management/commands/bootstrap_demo.py +0 -0
  196. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/migrations/0001_initial.py +0 -0
  197. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/migrations/0002_product.py +0 -0
  198. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/migrations/__init__.py +0 -0
  199. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/models.py +0 -0
  200. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/templates/demo_home/home_page.html +0 -0
  201. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/templates/demo_home/product.html +0 -0
  202. {commentail-1.1.0 → commentail-1.2.0}/example/demo_home/views.py +0 -0
  203. {commentail-1.1.0 → commentail-1.2.0}/example/manage.py +0 -0
  204. {commentail-1.1.0 → commentail-1.2.0}/requirements-test.txt +0 -0
  205. {commentail-1.1.0 → commentail-1.2.0}/setup.cfg +0 -0
  206. {commentail-1.1.0 → commentail-1.2.0}/tests/__init__.py +0 -0
  207. {commentail-1.1.0 → commentail-1.2.0}/tests/settings.py +0 -0
  208. {commentail-1.1.0 → commentail-1.2.0}/tests/targets/__init__.py +0 -0
  209. {commentail-1.1.0 → commentail-1.2.0}/tests/targets/apps.py +0 -0
  210. {commentail-1.1.0 → commentail-1.2.0}/tests/targets/migrations/0001_initial.py +0 -0
  211. {commentail-1.1.0 → commentail-1.2.0}/tests/targets/migrations/__init__.py +0 -0
  212. {commentail-1.1.0 → commentail-1.2.0}/tests/targets/models.py +0 -0
  213. {commentail-1.1.0 → commentail-1.2.0}/tests/templates/wagtailcore/page.html +0 -0
  214. {commentail-1.1.0 → commentail-1.2.0}/tests/test_actions.py +0 -0
  215. {commentail-1.1.0 → commentail-1.2.0}/tests/test_admin.js +0 -0
  216. {commentail-1.1.0 → commentail-1.2.0}/tests/test_admin_ui.py +0 -0
  217. {commentail-1.1.0 → commentail-1.2.0}/tests/test_avatars.py +0 -0
  218. {commentail-1.1.0 → commentail-1.2.0}/tests/test_capability_access.py +0 -0
  219. {commentail-1.1.0 → commentail-1.2.0}/tests/test_captcha_backend.py +0 -0
  220. {commentail-1.1.0 → commentail-1.2.0}/tests/test_concurrency.py +0 -0
  221. {commentail-1.1.0 → commentail-1.2.0}/tests/test_detection.py +0 -0
  222. {commentail-1.1.0 → commentail-1.2.0}/tests/test_email_presentation.py +0 -0
  223. {commentail-1.1.0 → commentail-1.2.0}/tests/test_extension_contracts.py +0 -0
  224. {commentail-1.1.0 → commentail-1.2.0}/tests/test_group_panel.py +0 -0
  225. {commentail-1.1.0 → commentail-1.2.0}/tests/test_inline_edit.py +0 -0
  226. {commentail-1.1.0 → commentail-1.2.0}/tests/test_lifecycle.py +0 -0
  227. {commentail-1.1.0 → commentail-1.2.0}/tests/test_localization.py +0 -0
  228. {commentail-1.1.0 → commentail-1.2.0}/tests/test_mail_admin.py +0 -0
  229. {commentail-1.1.0 → commentail-1.2.0}/tests/test_name_limit.js +0 -0
  230. {commentail-1.1.0 → commentail-1.2.0}/tests/test_object_adapters.py +0 -0
  231. {commentail-1.1.0 → commentail-1.2.0}/tests/test_outbox.py +0 -0
  232. {commentail-1.1.0 → commentail-1.2.0}/tests/test_performance.py +0 -0
  233. {commentail-1.1.0 → commentail-1.2.0}/tests/test_presentation_contracts.py +0 -0
  234. {commentail-1.1.0 → commentail-1.2.0}/tests/test_progressive.js +0 -0
  235. {commentail-1.1.0 → commentail-1.2.0}/tests/test_rate_limits.py +0 -0
  236. {commentail-1.1.0 → commentail-1.2.0}/tests/test_recent_comments.py +0 -0
  237. {commentail-1.1.0 → commentail-1.2.0}/tests/test_release_gaps.py +0 -0
  238. {commentail-1.1.0 → commentail-1.2.0}/tests/test_reply.js +0 -0
  239. {commentail-1.1.0 → commentail-1.2.0}/tests/test_rules_admin.py +0 -0
  240. {commentail-1.1.0 → commentail-1.2.0}/tests/test_rules_csv.py +0 -0
  241. {commentail-1.1.0 → commentail-1.2.0}/tests/test_smtp_chain.py +0 -0
  242. {commentail-1.1.0 → commentail-1.2.0}/tests/test_staff_authors.py +0 -0
  243. {commentail-1.1.0 → commentail-1.2.0}/tests/test_structured_data.py +0 -0
  244. {commentail-1.1.0 → commentail-1.2.0}/tests/test_submission.py +0 -0
  245. {commentail-1.1.0 → commentail-1.2.0}/tests/test_transaction_contracts.py +0 -0
  246. {commentail-1.1.0 → commentail-1.2.0}/tests/urls.py +0 -0
  247. {commentail-1.1.0 → commentail-1.2.0}/tests/urls_custom_prefix.py +0 -0
  248. {commentail-1.1.0 → commentail-1.2.0}/tools/benchmark_performance.py +0 -0
  249. {commentail-1.1.0 → commentail-1.2.0}/tools/check_dist.py +0 -0
  250. {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.1.0
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.1.0](https://github.com/hardcodd/Commentail/releases/tag/v1.1.0)** · [PyPI](https://pypi.org/project/commentail/1.1.0/)
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
  [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
40
40
  [![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](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
- From **1.0.0**, documented integration contracts follow the [stable API and compatibility policy](docs/wiki/Stability.md).
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
+ ![Commentail discussion on a Wagtail article, with a reader question and an editor reply](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/public-discussion.jpg)
89
+
90
+ **Inside Wagtail:** the moderation queue, expanded site/page, status and date
91
+ filters, and two comments selected for bulk actions.
92
+
93
+ ![Wagtail moderation queue with expanded filters and bulk comment selection](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/moderation-filters.jpg)
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
+ ![Guest comment form with a sample draft and email-verification notice](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/guest-form.jpg)
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
+ ![Inline reply form addressed to a reader, beside the existing discussion](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/inline-reply.jpg)
107
+
108
+ **Comment review.** Read the original text, choose a moderation action and inspect
109
+ its activity history.
110
+
111
+ ![Individual comment awaiting moderation with available actions and activity history](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/comment-moderation.jpg)
112
+
113
+ **Site settings.** Discussion access, moderation policy, staff highlighting,
114
+ clickable links and email preferences in one place.
115
+
116
+ ![Site comment settings in Wagtail, including moderation, appearance and email options](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/site-settings.jpg)
117
+
118
+ **Page settings.** Inherit the site policy or override it for an individual
119
+ discussion.
120
+
121
+ ![Page discussion settings showing inheritance from the site configuration](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/page-settings.jpg)
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
- This table describes the 1.1.0 release; compatibility is unchanged from 1.0.0.
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
- Guest comments require configured SMTP and the scheduled worker. Registered
103
- users can comment without an email address, but receive no mail. Your site
104
- provides login and registration. No required external CDN or CAPTCHA service.
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
- Alongside English and Russian, 0.2.0 includes German (`de`), French (`fr`),
109
- Spanish (`es`) and Brazilian Portuguese (`pt-br`) for the public UI,
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
- Documentation remains in English and Russian.
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.1.0
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.1.0'`.
128
- You can also extract the source distribution and run `python -m pip install .` in its root.
129
- When upgrading, review the
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
- ### Recent comments elsewhere
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. Load overrides after its stylesheet:
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 | [SMTP and worker](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) |
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
- ## Release scope and verification
278
+ ## Verification and limits
231
279
 
232
- [1.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.1.0.md) describe the changes and upgrade steps;
233
- [0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
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. Browser checks covered installed Safari,
239
- Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
240
- scenarios and a phone. Historical checks also covered Chrome 142 on macOS and Windows ARM64 and Firefox
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 in 1.1.0. SMTP retries can duplicate mail after an uncertain delivery result.
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.1.0](https://github.com/hardcodd/Commentail/releases/tag/v1.1.0)** · [PyPI](https://pypi.org/project/commentail/1.1.0/)
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
  [![Tests and distributions](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/hardcodd/Commentail/actions/workflows/tests.yml)
12
12
  [![Django Packages · Commentail](https://img.shields.io/badge/Django%20Packages-Commentail-0C4B33.svg)](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
- From **1.0.0**, documented integration contracts follow the [stable API and compatibility policy](docs/wiki/Stability.md).
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
+ ![Commentail discussion on a Wagtail article, with a reader question and an editor reply](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/public-discussion.jpg)
61
+
62
+ **Inside Wagtail:** the moderation queue, expanded site/page, status and date
63
+ filters, and two comments selected for bulk actions.
64
+
65
+ ![Wagtail moderation queue with expanded filters and bulk comment selection](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/moderation-filters.jpg)
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
+ ![Guest comment form with a sample draft and email-verification notice](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/guest-form.jpg)
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
+ ![Inline reply form addressed to a reader, beside the existing discussion](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/inline-reply.jpg)
79
+
80
+ **Comment review.** Read the original text, choose a moderation action and inspect
81
+ its activity history.
82
+
83
+ ![Individual comment awaiting moderation with available actions and activity history](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/comment-moderation.jpg)
84
+
85
+ **Site settings.** Discussion access, moderation policy, staff highlighting,
86
+ clickable links and email preferences in one place.
87
+
88
+ ![Site comment settings in Wagtail, including moderation, appearance and email options](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/site-settings.jpg)
89
+
90
+ **Page settings.** Inherit the site policy or override it for an individual
91
+ discussion.
92
+
93
+ ![Page discussion settings showing inheritance from the site configuration](https://raw.githubusercontent.com/hardcodd/Commentail/main/docs/assets/screenshots/page-settings.jpg)
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
- This table describes the 1.1.0 release; compatibility is unchanged from 1.0.0.
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
- Guest comments require configured SMTP and the scheduled worker. Registered
75
- users can comment without an email address, but receive no mail. Your site
76
- provides login and registration. No required external CDN or CAPTCHA service.
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
- Alongside English and Russian, 0.2.0 includes German (`de`), French (`fr`),
81
- Spanish (`es`) and Brazilian Portuguese (`pt-br`) for the public UI,
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
- Documentation remains in English and Russian.
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.1.0
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.1.0'`.
100
- You can also extract the source distribution and run `python -m pip install .` in its root.
101
- When upgrading, review the
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
- ### Recent comments elsewhere
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. Load overrides after its stylesheet:
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 | [SMTP and worker](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) |
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
- ## Release scope and verification
250
+ ## Verification and limits
203
251
 
204
- [1.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/1.1.0.md) describe the changes and upgrade steps;
205
- [0.1.0 release notes](https://github.com/hardcodd/Commentail/blob/main/docs/releases/0.1.0.md) preserve the initial release contract.
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. Browser checks covered installed Safari,
211
- Chrome, Yandex Browser and Firefox with and without JS, plus selected VoiceOver
212
- scenarios and a phone. Historical checks also covered Chrome 142 on macOS and Windows ARM64 and Firefox
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 in 1.1.0. SMTP retries can duplicate mail after an uncertain delivery result.
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