Misago

This release brings showstopper fix to hidden online status handling, ability to require moderator approve users or category posts and threads, as well as changes in posting process implementation bringing developers option to plug in custom validation for posts as well as custom posting middleware that can send posts to moderation queue. This release also includes option to make selected bans checked only in registration form and new `clearreadtracker` management task intented to be ran periodically to clean readtracker's record.

Updating instructions

To update Misago from 0.6 Alpha 3 to 0.6 Alpha 4, use PIP to uninstall old Misago and install new one:


pip uninstall misago
pip install misago --pre


Next, add `clearreadtracker` task to your task runner (like cron) for your forum to run periodic maintenance of readtracker's database tables.

If you've overrided the `MISAGO_POSTING_MIDDLEWARES` setting, you'll need to manually insert the `misago.threads.api.postingendpoint.moderationqueue.ModerationQueueMiddleware` middleware after the `misago.threads.api.postingendpoint.reply.ReplyMiddleware`.

New features

* 40 - Post validation framework allows running custom validation and cleaning logic when users post on forum.
* 122 - Added support for `[url]` and `[img]` BBCodes.
* 555 - Added registration-only bans.
* 674 - Added `clearreadtracker` management command that clears expired entries from readtracker.
* 745 - Categories may be setup either via its properties or user role to require user threads, replies or edits to receive moderator approval before being visible to other users.

Bugs fixed

* 743 - Fixed showstopper in `get_user_status` that occured when getting hidden user's status.

Implementation and API changes

* 746 - Populate `images`, `internal_links`, `outgoing_links` and `mentions` in `parsing_result` dict returned by parser.

Documentation changes

*none*

This release brings bugfixes, reliability improvements and cleanups to Misago's codebase.

Updating instructions

To update Misago from 0.6 Alpha 2 to 0.6 Alpha 3, use PIP to uninstall old Misago and install new one:


pip uninstall misago
pip install misago --pre


Next, run `migrate` command to update your database to latest version:


python manage.py migrate


New features
- 125 - Added schema.org structural data on threads lists, thread view and users lists.
- 702 - Misago now comes with special "cleansource" utility tool that reformats and lints python codebase using [yapf](https://github.com/google/yapf), [pylint](https://www.pylint.org/), [isort](https://github.com/timothycrosley/isort) and custom overrides.

Bugs fixed
- 723 - Added default values for some settings. This solves showstopper on changing forum configuration using empty values, and brings in intended behavior of Misago changing those settings to default if user attempts to clear their values.
- 724 - Fixed misalignment of labels in modals horizontal forms.
- 732 - Threadview pagination could report incorrect number of pages for threads with number of pages on next page equal to `MISAGO_POSTS_TAIL`.
- 733 - Disallowed `/options/`, `/p/` and `/private-threads/` in default robots.txt
- 737 - Fixed showstopper when user enters string containing non-ascii characters in auth forms accepting e-mail addresses.

Implementation and API changes
- 594 - Renamed `user.acl` attribute to `user.acl_cache` and `user.acl_` to `user.acl`.
- 629 - User follows and followers lists in API were moved to designated edges.
- 643 - `UserTestCase`, `AuthenticatedUserTestCase` and `SuperUserTestCase` are using `force_login` and `logout` utilities instead of previous approach of signing user in and out via test client, which has greatly speed up tests suite.
- 644 - Introduced optional API for creating derivate model serializers in situ, via `Serializer.subset_fields`, `Serializer.extend_fields` and `Serializer.exclude_fields`. Performed cleaning pass over existing serializers making those list's fields easier to maintain.
- 648 - Moved constants under their classes or `constants.py` modules, simplified their names and made them easier to use across codebase.
- 676 - Misago's `validate_password` utility has been removed and replaced with Django's [password validation facilities](https://docs.djangoproject.com/en/1.10/topics/auth/passwords/).
- 706 - moved bunch of forms used exclusively by an API to serializers, so they handle json data better.
- 707 - relative imports other than from sibling or child paths have been converted back to absolute.
- 710 - moved user profile and users lists views to classes.
- 726 - replaced `user.is_authenticated()` and `user.is_anonymous()` calls with `user.is_authenticated` and `user.is_anonymous` as per [Django 1.10 api change](https://docs.djangoproject.com/en/1.10/releases/1.10/#user-is-auth-anon-deprecation).
- 727 - cleanup `get_user_model()` usage and made it consistent with Django's codebase.
- 731 - camelcase `Model`, `Form` and `SearchForm` attributes on generics for writing admin views.
- 728 - cleanup `import *` and `__all__` clauses in python code.
- 734 - moved bulk of user API edges and views to viewmodels.
- 740 - codebase is now tested with pylint to fish out basic errors and omissions like using undefined name, redefining value or having unused imports.
- 741 - cleaned response.json handling in tests a little.

Documentation changes
- 739 - documented installation error that occurs when installing Misago using setuptools release older than 8.

This release brings bugfixes, reliability improvements and some API cleanups to Misago.

Updating instructions

To update Misago from 0.6 Alpha 1 to 0.6 Alpha 2, use PIP to uninstall old Misago and install new one:


pip uninstall misago
pip install misago --pre


This release includes new features that require additional configuration:

Moment.js locale context processor

This release adds new context processor, available under the `misago.core.context_processors.momentjs_locale` that has to be added to your `TEMPLATES['OPTIONS']['context_processors']` setting in order for Misago to load Moment.js locale file. If your site is running with `LANGUAGE_CODE` set to something else than `en-us` (default), you'll need to add this context processor to your `settings.py`.

To do so, find list of `context_processors` under the `TEMPLATES` setting, and add `
'misago.core.context_processors.momentjs_locale',` line to it, like this:

python
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [
os.path.join(BASE_DIR, 'theme', 'templates'),
],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.i18n',
'django.template.context_processors.media',
'django.template.context_processors.request',
'django.template.context_processors.static',
'django.template.context_processors.tz',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',

'misago.core.context_processors.site_address',
'misago.core.context_processors.momentjs_locale',
'misago.conf.context_processors.settings',
'misago.users.context_processors.user_links',
'misago.legal.context_processors.legal_links',

Data preloaders
'misago.conf.context_processors.preload_settings_json',
'misago.core.context_processors.current_link',
'misago.markup.context_processors.preload_api_url',
'misago.threads.context_processors.preload_threads_urls',
'misago.users.context_processors.preload_user_json',

Note: keep frontend_context processor last for previous processors
to be able to expose data UI app via request.frontend_context
'misago.core.context_processors.frontend_context',
],
},
},
]


Older clients support

Misago Alpha 0.2 includes small JavaScript snippet in its scripts that test for presence of JavaScript apis required for it to run, and includes polyfill if those are not found. This was done mostly with IE11 support in mind, but should also work for some older android devices and Trident-powered clients.

New features
- 475 - If you are unhappy with default slugs generation logic, you may now specify custom function instead via entering path to it in `MISAGO_SLUGIFY` setting.
- 703, 718 - [Polyfills](https://babeljs.io/docs/usage/polyfill/) are included by Misago if client's JS lacks apis required by Misago JavaScript.
- 721 - Misago will now set current language's ISO 639-1 code in `<html>`'s `lang=` attribute.

Bugs fixed
- 695 - removed overflow form user status on posters ranking.
- 696 - Don't linkify url's in `code` elements.
- 712 - Display previous thread's title in "thread title was changed from" event instead of "undefined".
- 714 - Display valid likes message for posts with more than three likes.

Implementation and API changes
- 589 - `misago.core.forms` module is no longer abstraction layer over `django.forms`. Instead its utility module defining two misago-specifis form fields `IsoDateTimeField` and `YesNoSwitch`.
- 635 - `misago.core.shortcuts.pagination_dict` no longer includes `page_range` in pagination data. Also returned value type is `dict` instead of `OrderedDict`.
- 699 - Unified posting flags value types to be booleans. Ealier some flags used `0`'s and `1`'s instead for holding their values.
- 708 - `misago.core.apipaginator` has been removed. Misago now uses `paginate` and `pagination_dict` utilities from `misago.core.shortcuts` for paginating api.
- 713 - `misago.core.shortcuts.paginated_response` shortcut function for returning paginated responses procedural way.
- 717 - `zxcvbn.js` library is now lazily loaded by `password-strenght` component after it was displayed. This makes registration form display faster than previously due to lack of blocking 400kb (or 800kb minus gzip) download.
- 719 - `/api/auth/token/` edge has been removed. To use Misago API from other applications, use [token authentication](http://www.django-rest-framework.org/api-guide/authentication/#tokenauthentication) instead.
- 720 - `momentjs-i18n` view has been removed. Instead Misago uses context processor to inject `MOMENTJS_LOCALE_URL` variable containing path to Moment.js locale file that should be used to the templates.

Documentation changes
- 666 - moved documentation away from Sphinx/reStructuredText to GitBook/Markdown.
- 700 - links to Django docs version were made configurable and set to point to Django 1.10.

Misago 0.5.7 release is an bugfix release that introduces fixes to posts and threads multi-moderation actions.

This release brings in small fixes from last PR's and MovePostsForm.