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:

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 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 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.6 Alpha 2