5 The Postorius Django app provides a web user interface to
8 Postorius is free software: you can redistribute it and/or
9 modify it under the terms of the GNU Lesser General Public License as
10 published by the Free Software Foundation, version 3 of the License.
12 Postorius is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
15 General Public License for more details.
17 You should have received a copy of the GNU Lesser General Public License
18 along with Postorius. If not, see <http://www.gnu.org/licenses/>.
31 * Add 'Delivery Mode' and 'Moderation Action' columns to List members
33 * Add support to list and handle pending un-subscription requests. (Closes
35 * Add support to specify a reason when handling (un)subscription requests
37 * Success messages to mass subscribes now properly distinguish subscription
38 from invitation and indicate possible pending confirmation or approval.
40 * User profile dropdown no longer is too far right. (Closes #486)
41 * Expose ``archive_rendering_mode`` in Archiver settings to choose between
42 plaintext and rich text rendering of emails in Hyperkitty. (Closes #487)
43 * Allow choosing ``delivery_mode`` and ``delivery_status`` when subscribing to
45 * Redirect to ``domain_index`` after ``domain_edit`` succeeds. (Closes
47 * Expose new ``bounce_notify_owner_on_bounce_increment`` list setting on
48 ``Bounce Processing`` settings, and expose the corresponding template.
49 * Expose the ``forward_unrecognized_bounces_to`` setting on
50 ``Bounce Processing`` settings.
51 * Clarified the description of ``Maximum number of recipients``. (Closes #515)
52 * List summary view will now display a table for all subscriptions with
53 ``delivery_mode`` and ``delivery_status``. (Closes #470)
54 * Add a new user management interface for superusrs. (See #518)
55 * Allow searching for users in list user views. (See #518)
56 * Show both display name and email in user management interface if available,
58 * Allow ``list:admin:notice:pending`` template to be set in Postorius. (Closes
64 * Use mass-subscription API in core for Mass Removal of Members. (Closes #464)
65 * Fix a bug where users with multiple subscriptions to a List couldn't view
66 their Preferences for all addresses. (Closes #472)
67 * Check for pending unsubscription requests and notify user when the request is
68 pending approval. (Closes #473)
69 * Improve the performance of Members' page by skipping an API call. (Closes
71 * Improve the performance of List index page for Superuser. (See !599)
72 * Skip looking up choosable_domains for non-superuser to reduce API calls. (See
74 * Improve the performance of List owner access checks. (See !598)
75 * Add a new ``APICountingMiddleware`` to performance testing purposes. (See
77 * Use ``user_id`` as ``subscriber`` instead of addresses to improve the
78 efficiency of list index page. (Closes #419)
79 * ``AUTOCREATE_MAILMAN_USER`` setting is now removed and a Mailman user is
80 always created when a User object in created in Django. Also remove duplicate
81 implementation of ``get_mailman_user`` from ``MailmanUserManager`` so that we
82 can use a single implementation that uses caching for efficient lookups.
83 * Bump bundled jQuery to 3.6.0.slim version. (See !637)
84 * Use the full jQuery not the slim version. (Closes #523)
88 * Move the focus to the textarea in mass subscribe page if there are errors in
89 the form. (Closes #493)
99 * Update the default Site when creating a domain to match the domain if it is
100 ``example.com``. (Closes #427)
101 * Add the ability to subscribe via Primary Address instead of specific
103 * Fix a bug where the user's display name would be ignore when
104 subscribing. (Closes #429)
105 * Display a user's name in the pending subscription request list. (Closes #430)
106 * Set a user's preferrred_address in Core if it isn't already set and the user
107 has a Primary Address that is verified.
108 * Use the new APIs in Core to get the count of held messages and pending
109 subscriptions to improve peroformance of settings page for list
111 * Show held message is local time of the User. (Closes #434)
112 * Fix a bug where non-member options page would show an owner's options if the
113 same email was subscribed as owner and non-member in a list. (Closes #436)
114 * Switching subscription from one email address to other or Primary Address now
115 preserves preferences and does not require Moderator approval. (Closes #425)
116 * Make 'Archives' and 'List Options' urls more prominently visible in the
117 list summary page as buttons. (Closes #439)
118 * Added the ability to issue invitations from the mass subscribe view.
119 * Expose ``emergency`` moderation setting for MailingList.
120 * Fixed some minor HTML errors. (Closes #442)
121 * Fix the bug where ListOfStringsField couldn't be unset in Postorius. (Closes
123 * Allow ``list:user:action:invite`` template to be set in Postorius. (Closes
125 * Fix a bug where the Bans form would always use default language instead of
126 current request's language. (Closes #441)
127 * Fix the URL on cancel buttons in template's confirm delete page. (Closes
129 * Use server side filtering for pending subscription requests for moderator
131 * Allow setting moderation action for a nonmember from Held Message modal. (
133 * Add a new view to confirm subscriptions or new emails for Users using
134 Postorius. (Fixes #459)
135 * Fix a bug where membership check compared email addresses in different
137 * Mass removal now accepts address formats with display names and/or angle
138 brackets. (Closes #455)
139 * Add support to override ``send_welcome_message`` when mass subscribing to
140 suppress welcome messages. (Closes #99)
141 * Add support for Django 3.1.x. (See !574)
142 * The list's ``send_goodbye_message`` is now settable on the Automatic
143 Responses view. (Closes #466)
144 * Support ``HYPERKITTY_ENABLE_GRAVATAR`` setting to control the user gravatar.
154 * Expose additional list settings. (See !483)
155 * Correct description of Digest Frequency. (Closes #395)
156 * Added links to Reply-To munging articles. (Closes #401)
157 * Fix "Show Headers" button to show the held message headers in the
158 held message popup. (Closes #407)
159 * Fix the held message popup structure and increase the max width of the popup
160 to be 800px(modal-lg) for larger screens. (Closes #405)
161 * Fix FILTER_VHOST = True option to try to find the email host corresponding
162 to the requesting web host. (Closes #394)
163 * Allow specifying a reason when rejecting a held message. (Closes #412)
164 * Allow users to set their preferred language in their preferences. (Closes #413)
165 * Add support to ban addresses for the entire Mailman installation. (Closes #357)
166 * Un-handled ``HTTPError`` exception raised from MailmanClient now results in an
167 error page and proper logging instead of mysterious ``KeyError`` in logs.
169 * Change List settings navigation to be vertical instead of horizontal. (See
171 * Move bounce processing settings into a new vertical tab for better
173 * Add URL to edit the Web host for each domain in Domain Index page. Also, show
174 the ``SITE_ID`` for each webhost. (Closes #426)
182 * Do not show pagination, when user is authenticated. (Closes #387)
183 * Drop support for Django 1.11.
184 * Add support to choose options for ``pre_confirm``, ``pre_approve`` and
185 ``pre_verify`` when mass subscribing. (Fixes #203)
192 * Show templates' file names in selection list where admins can pick
193 individual templates for customization. (See !425)
194 * Make template short names more prominent on all email templates related
196 * Bind object attributes to local variables in {% blocktrans %} (See !439)
197 * Set the initial style in new list form as the default style. (Closes #310)
198 * Fix a bug where logged in users's index page view would cap the total number
199 of lists for a role to 50. (Closes #335)
200 * Fix a bug where handling non-existent held message can raise 500
201 exception. (Closes #349)
202 * Emit appropriate signals when Domain and MailingList is updated. (Closes
204 * Do not strip leading whitespaces in Email Templates. (Closes #301)
205 * Hold date for held messages are now displayed correctly. (Closes #312)
206 * Add support for Python 3.8.
207 * Add support for Django 3.0.
214 * Fix a string substitution bug which would cause un-substituted raw string to
215 be exposed as notification to admin. (Closes #327)
216 * Add support for ``FILTER_VHOST`` option to filter MalingLists based on
217 ``HOST`` header of incoming request. (Closes #330)
218 * List Summary page now renders List info as markdown. (Closes #244)
219 * Moderation action for held message's sender can now be set from held
220 message's view.(Closes #127)
221 * Add a 'Ban' button to list of subscription requests to help administrators
222 against spams. (Closes #339)
223 * Added support for Django 2.2.
224 * ``pytest`` will be used to run tests instead of default Django's test runner.
225 * Remove ``vcrpy`` and use fixtures to start and stop Mailman's REST API to
226 test against, without having to record tapes to be replayed.
227 * Corrected display message in 'recieve_list_copy' option in global mailman
228 preferences of mailman settings. (Closes #351)
229 * Allow setting a MailingList's Preferred Language. (Closes #303)
230 * Allow a empty templates as a workaround for missing settings to skip
231 email decoration. (Closes #331)
232 * Expose ``digest_volume_frequency``, ``digest_send_periodict`` and
233 ``digests_enabled`` settings for MailingLists.
234 * Add a badge with count of held messages and pending subscription requests
235 for moderator approval. (Closes #308)
236 * Add support to add, view and remove domain owners.
237 * Allow setting the visibility options for MailingList's member list.
238 * Make page titles localizable.
245 * Add support for ``explicit_header_only`` in list settings.
253 * Expose ``max_num_recipients`` in list settings. (Closes #297)
254 * Add support for Non-member management in Postorius. (Closes #265)
255 * ``Members`` tab in Mailing List settings page is now called ``Users``.
257 * Show pending subscription requests are only pending for Moderator.
265 * Add support for Python 3.7 with Django 2.0+
266 * Index page only shows related lists for signed-in users with option to
267 filter based on role.
268 * Expose respond_to_post_requests in Postorius. (Closes #223)
275 * A Django migration was missing from version 1.2.0. This is now added.
281 * Postorius now runs only on Python 3.4+ and supports Django 1.8 and 1.11+
282 * Added the ability to set and edit ``alias_domain`` to the ``domains`` forms.
283 * List Create form now allows selecting the ``style``. A ``style`` is how a new
284 mailing list is configured.
285 * Minimum supported Mailman Core version is now 3.2.0. This is because the
286 ``styles`` attribute for MailingList resource is exposed in 3.2, which
287 contains all the default ``styles`` supported by Core and their human readable
289 * Account subscription page now lists all the memberships with their respective
290 roles. This avoids repeated API calls for the way data was displayed
291 before. (Closes #205)
292 * Postorius now supports only Django 1.11+.
293 * Duplicate MailingList names doesn't return a 500 error page and instead adds
294 an error to the New MailingList form. (Fixes #237)
295 * Pending subscription requests page is now paginated. (See !298)
296 * Add owners/moderators form now allows specifying a Display Name, along with
297 their email. (Fixes #254)
298 * Members views now show total number of members at the top. (See !315)
299 * Fixed a bug where GET on views that only expect a POST would cause 500 server
300 errors instead of 405 method not allowed. (Fixes #185)
301 * Member preferences form can now be saved without having to change all the
303 * Fixed a bug where the 'Delete' button to remove list owners didn't work due to
304 wrong URL being rendered in the templates. (Fixes #274)
305 * Require Explicit Destination is added to the Message Acceptance form.
307 * Delete Domain page now shows some extra warning information about all the
308 mailing lists that would be deleted after deleting the Domain. (See !250)
309 * Superusers can now view Mailman Core's current version and REST API version
310 being used under 'System Information' menu in the top navigation bar. (See !325)
311 * Fixed a bug where 500 error template wouldn't render properly due to missing
312 context variables in views that render that templates (See !334)
313 * Postorius now allows adding and editing templates for email headers, footers
314 and some of the automatic responses sent out by Mailman. (See !327)
320 * Added a new ``reset_passwords`` command that resets _all_ user's passwords
321 inside of Core. This password is different from the one Postorius
322 maintains. The Postorius password is the one used for logging users in.
323 * Postorius now sets the 'Display Name' of the user in Core correctly. This
324 fixes a security vulnerability where user's display_name would be set as their
332 * Improved testing and internal bug fixes.
333 * Preserve formatting of Mailing List description in the summary view.
334 * Site's Name isn't capitalized anymore in the navigation bar.
335 * html5shiv and response.js libraries are now included, instead of loading from a CDN.
337 1.1.0 -- "Welcome to This World"
338 ================================
341 * Added DMARC mitigation settings
342 * Switch to Allauth auth library
343 * Preference page improvements
344 * Moderation page improvements
345 * Django support up to Django 1.11
346 * Added form to edit header matches
347 * Domain edit form improvements
348 * All pipelines recognized in alter messages form
349 * Use django-mailman3 to share common code with HyperKitty
350 * Various bug fixes, code cleanup, and performance improvements
371 * Help texts Small visual alignment fix; removed unnecessary links to
373 * Import fix in fieldset_forms module (Django1.6 only)
376 1.0.0 -- "Frizzle Fry"
377 ======================
380 * French translation. Provided by Guillaume Libersat
381 * Addedd an improved test harness using WebTest. Contributed by Aurélien Bompard.
382 * Show error message in login view. Contributed by Aurélien Bompard (LP: 1094829).
383 * Fix adding the a list owner on list creation. Contributed by Aurélien Bompard (LP: 1175967).
384 * Fix untranslatable template strings. Contributed by Sumana Harihareswara (LP: 1157947).
385 * Fix wrong labels in metrics template. Contributed by Sumana Harihareswara (LP: 1409033).
386 * URLs now contain the list-id instead of the fqdn_listname. Contributed by Abhilash Raj (LP: 1201150).
387 * Fix small bug moderator/owner forms on list members page. Contributed by Pranjal Yadav (LP: 1308219).
388 * Fix broken translation string on the login page. Contributed by Pranjal Yadav.
389 * Show held message details in a modal window. Contributed by Abhilash Raj (LP: 1004049).
390 * Rework of internal testing
391 * Mozilla Persona integration: switch from django-social-auto to django-browserid: Contributed by Abhilash Raj.
392 * Fix manage.py mmclient command for non-IPython shells. Contributed by Ankush Sharma (LP: 1428169).
393 * Added archiver options: Site-wide enabled archivers can not be enabled
394 on a per-list basis through the web UI.
395 * Added functionality to choose or switch subscription addresses. Contributed by Abhilash Raj.
396 * Added subscription moderation, pre_verification/_confirmation.
397 * Several style changes.
400 1.0 beta 1 -- "Year of the Parrot"
401 ==================================
404 * fixed pip install (missing MANIFEST) (LP: 1307624). Contributed by Aurélien Bompard
405 * list owners: edit member preferences
406 * users: add multiple email addresses
407 * list info: show only subscribe or unsubscribe button. Contributed by Bhargav Golla
408 * remove members/owners/moderator. Contributed by Abhilash Raj
411 1.0 alpha 2 -- "Is It Luck?"
412 ============================
415 * dev setup fix for Django 1.4 contributed by Rohan Jain
416 * missing csrf tokens in templates contributed by Richard Wackerbarth (LP: 996658)
417 * moderation: fixed typo in success message call
418 * installation documentation for Apache/mod_wsgi
419 * moved project files to separate branch
420 * show error message if connection to Mailman API fails
421 * added list members view
422 * added developer documentation
423 * added test helper utils
424 * all code now conform to PEP8
425 * themes: removed obsolete MAILMAN_THEME settings from templates, contexts, file structure; contributed by Richard Wackerbarth (LP: 1043258)
426 * added access control for list owners and moderators
427 * added a mailmanclient shell to use as a ``manage.py`` command (``python manage.py mmclient``)
428 * use "url from future" template tag in all templates. Contributed by Richard Wackerbarth.
429 * added "new user" form. Contributed by George Chatzisofroniou.
430 * added user subscription page
431 * added decorator to allow login via http basic auth (to allow non-browser clients to use API views)
432 * added api view for list index
433 * several changes regarding style and navigation structure
434 * updated to jQuery 1.8. Contributed by Richard Wackerbarth.
435 * added a favicon. Contributed by Richard Wackerbarth.
436 * renamed some menu items. Contributed by Richard Wackerbarth.
437 * changed static file inclusion. Contributed by Richard Wackerbarth.
438 * added delete domain feature.
439 * url conf refactoring. Contributed by Richard Wackerbarth.
440 * added user deletion feature. Contributed by Varun Sharma.
444 1.0 alpha 1 -- "Space Farm"
445 ===========================
448 Many thanks go out to Anna Senarclens de Grancy and Benedict Stein for
449 developing the initial versions of this Django app during the Google Summer of
452 * add/remove/edit mailing lists
454 * show all mailing lists on server
455 * subscribe/unsubscribe/mass subscribe mailing lists
457 * show basic list info and metrics
458 * login using django user account or using BrowserID
459 * show basic user profile
460 * accept/discard/reject/defer messages
461 * Implementation of Django Messages contributed by Benedict Stein (LP: #920084)
462 * Dependency check in setup.py contributed by Daniel Mizyrycki
463 * Proper processing of acceptable aliases in list settings form contributed by