Updating instructions

To update Misago from 0.7 to 0.8 use PIP to uninstall old Misago and install new one:

pip uninstall misago
pip install misago

This release includes changes to database. Make sure you have backup of your data before carrying on with the update.

Enabling profile fields

Misago 0.8 adds new feature named "profile fields" that enables your users to share additional information about themselves with other users via "details" tab on their profiles.

To enable this feature on your forum, open your settings.py and find this code:

import os


# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

And edit it look like this:

import os


# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))


# Define placeholder gettext function
# This function will mark strings in settings visible to makemessages
# without need for Django's i18n features be initialized first.
_ = lambda x: x

Next, insert below code in same file, preferably at it its and:

# Profile fields

MISAGO_PROFILE_FIELDS = [
    {
        'name': _("Personal"),
        'fields': [
            'misago.users.profilefields.default.FullNameField',
            'misago.users.profilefields.default.GenderField',
            'misago.users.profilefields.default.BioField',
            'misago.users.profilefields.default.LocationField',
        ],
    },
    {
        'name': _("Contact"),
        'fields': [
            'misago.users.profilefields.default.TwitterHandleField',
            'misago.users.profilefields.default.SkypeIdField',
            'misago.users.profilefields.default.WebsiteField',
        ],
    },
    {
        'name': _("IP address"),
        'fields': [
            'misago.users.profilefields.default.JoinIpField',
            'misago.users.profilefields.default.LastIpField',
        ],
    },
]

Finally, find django.contrib.contenttypes in your INSTALLED_APPS:

INSTALLED_APPS = [
   # ...bunch of lines here
    'django.contrib.contenttypes',
    # ...more lines there
]

And insert the 'django.contrib.postgres', line below it:

INSTALLED_APPS = [
   # ...bunch of lines here
    'django.contrib.contenttypes',
    'django.contrib.postgres',
    # ...more lines there
]

Here's the reference of INSTALLED_APPS including this change if you need one.

Wrapping up the update

After installing Misago 0.8 from PIP and modifying your settings.py, you should run thepython manage.py migrate to update your database and python manage.py collectstatic for your site to update your static files to their latest versions.

If you'll encounter database permission error during migration, you'll need to elevate your database's user to superuser in order for Misago's migrations to enable the hstore extension for your database. {lease see the documentation short example on how to do this.

New langauge

Misago 0.8 is first release that contains (nearly complete) translation for other language, with 98% of language strings translated for simplified chinese. To enable simplified chinese language on your site, edit your settings.py, find LANGUAGE_CODE = 'en_us' in it and edit it to LANGUAGE_CODE = 'zh_hans'.

New features

• 865 - User profiles fields.
• 876 - Included translation files for simplified chinese with 98% of language strings translated.

Theme changes

• 875 - Tweaked the spacing between elements in posts content, making header-induced breaks more noticeable.

Bugs fixed

• 869 - Goto views computed the target page incorrectly.
• 870 - Tweaked margins on row in post's changelog header so horizontal scrollbar no longer shows up.
• 871 - Invalid captcha would not interrupt the registration process, thus allowing users to register accounts after entering invalid answer to Q&A captcha.
• 876 - Moment.js translation was resolved incorrectly for some language codes, like zh_Hans.
• 877 - Approve thread moderation action didn't update its has_unapproved_posts flag correctly.

Implementation and API changes

none

Documentation changes

• 865 - Documentation for user profile fields feature.
• 872 - Small spelling corrections in setup and maintenance part of the docs.