Misago v0.18.0 Release Notes

Release Date: 2018-06-01 // almost 6 years ago
  • ⚡️ Updating instructions

    ⚡️ To update Misago from 0.17 to 0.18 use PIP to uninstall old Misago and install new one:

    pip uninstall misago
    pip install misago
    

    Now, open your forum's settings.py and find INSTALLED_APPS in it. Next, find this code:

    # 3rd party apps used by Misago'debug\_toolbar', 'crispy\_forms', 'mptt', 'rest\_framework',
    

    And add social_django below rest_framework, like this:

    # 3rd party apps used by Misago'debug\_toolbar', 'crispy\_forms', 'mptt', 'rest\_framework', 'social\_django',
    

    Also add following code at the end of your settings.py:

    SOCIAL\_AUTH\_PIPELINE = ( # Steps required by social pipeline to work - don't delete those!'social\_core.pipeline.social\_auth.social\_details', 'social\_core.pipeline.social\_auth.social\_uid', 'social\_core.pipeline.social\_auth.social\_user', # Uncomment next line to let your users to associate their old forum account with social one.# 'misago.users.social.pipeline.associate\_by\_email',# Those steps make sure banned users may not join your site or use banned name or email.'misago.users.social.pipeline.validate\_ip\_not\_banned', 'misago.users.social.pipeline.validate\_user\_not\_banned', # Reads user data received from social site and tries to create valid and available username# Required if you want automatic account creation to work. Otherwhise optional.'misago.users.social.pipeline.get\_username', # Uncomment next line to enable automatic account creation if data from social site is valid# and get\_username found valid name for new user account:# 'misago.users.social.pipeline.create\_user',# This step asks user to complete simple, pre filled registration form containing username,# email, legal note if you remove it without adding custom one, users will have no fallback# for joining your site using their social account.'misago.users.social.pipeline.create\_user\_with\_form', # Steps finalizing social authentication flow - don't delete those!'social\_core.pipeline.social\_auth.associate\_user', 'misago.users.social.pipeline.require\_activation', )SOCIAL\_AUTH\_POSTGRES\_JSONFIELD = True
    

    Misago 0.18 also renamed the "Full name" field to "Real name", if your settings.py contains following line:

    'misago.users.profilefields.default.FullNameField',
    

    You will have to change it to following to keep your forum working:

    'misago.users.profilefields.default.RealNameField',
    

    Next, open your urls.py and find following lines in it:

    urlpatterns = [ url(r'^', include('misago.urls', namespace='misago')),
    

    Now add url(r'^', include('social_django.urls', namespace='social')), below that code, so it looks like this:

    urlpatterns = [ url(r'^', include('misago.urls', namespace='misago')), url(r'^', include('social\_django.urls', namespace='social')),
    

    ✅ Run following commands to make sure your forum's database and static files are up to date with latest changes:

    python manage.py migrate
    python manage.py collectstatic
    python manage.py deleteprofilefield fullname
    

    You will also need to run regularly clear the database tables used to hold temporary data returned from social sites. To do this, add following task to your cron:

    25 0 * * * python manage.py clearsocial
    

    📚 To learn how to enable social login for selected site on your Misago, see the guide in documentation.

    🆕 New features

    • #416 - Sign in or join using social authentication.

    Theme changes

    • 📊 #996 - Don't require user to vote/view votes to access poll edit/delete buttons.

    🐛 Bugs fixed

    • #995 - Posting action doesn't recognize and display attachments errors to the user.
    • #997 - Don't prompt user for label if they didn't enter URL in previous prompt.
    • #998 - Private Threads icon in header erroneously claims that user has unread messages.

    Implementation and API changes

    • #416 - Function signature for registration validators has changed to request, cleaned_data={}, add_error=None, with add_error kwarg being an add_error bound method belonging to form or serializer requesting registration validation.
    • #994 - Make registration-only bans option behavior more intuitive. Previously bans with "registration only" option disabled were ignored during registration, username or email changes.
    • #1004 - Delete marked users management task will delete already-marked user accounts even if administrator disabled option for users to request account deletion with MISAGO_ENABLE_DELETE_OWN_ACCOUNT = False.

    📚 Documentation changes

    • #416 - Added guide for setting up social auth using GitHub as provider.

    Localization changes

    none