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