Misago

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:

python
3rd party apps used by Misago
'debug_toolbar',
'crispy_forms',
'mptt',
'rest_framework',


And add `social_django` below `rest_framework`, like this:

python
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:

python
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.17.4 is an maintenance release that fixes displaying of erroneous "moderation" button on thread page that opens empty menu.

Updating instructions

To update Misago to 0.17.4 use PIP to uninstall old Misago and install new one:


pip uninstall misago
pip install misago


Then run `migrate` and `collectstatic` commands to make sure your forum's database and static files are up to date:


python manage.py migrate
python manage.py collectstatic


Bugs fixed

* 982 - Thread view contains empty moderation menu.

Misago 0.17.3 is small bugfix release that Misago not fallbacking to setting's default value when MISAGO_ENABLE_DELETE_OWN_ACCOUNT is not set in your settings.py.

Misago 0.17 is a feature release that adds "best answer" and "delete my account" functionalities to Misago's forums as well as fixes the path handling logic that stopped admin control panel from working when Misago was ran under the path.

Updating instructions

To update Misago from 0.16 to 0.17 use PIP to uninstall old Misago and install new one:


pip uninstall misago
pip install misago


Then run `migrate` and `collectstatic` commands to make sure your forum's database and static files are up to date:


python manage.py migrate
python manage.py collectstatic

Data anonymization

Starting with Misago 0.17, deleting user account will also replace all IP addresses associated with this account with `0.0.0.0` and replace cached usernames with "Ghost".

If you want to customize this username for your community, you may do so by adding this line to your `settings.py`:

python
MISAGO_ANONYMOUS_USERNAME = "Wisp"


Delete own account

Big change introduced by Misago 0.17 is feature allowing your forum's users to delete their own accounts on their own accord by using the "Delete my account" option on their forum options page.

This feature is enabled by default on newly created forums, but needs to be enabled manually on every Misago forum that was created using earlier version.

To enable this feature manually, add following line to your `settings.py`:

python
MISAGO_ENABLE_DELETE_OWN_ACCOUNT = True


Likewise, to disable this feature, simply make sure that `MISAGO_ENABLE_DELETE_OWN_ACCOUNT` is not present in your `settings.py`.

Deleting user account may take some time to process, and as such happens in dedicated task that you should add to your crontab:


0 1 * * * python manage.py deletemarkedusers



Docker for development

Misago now has Docker for development setup! If you want to give Misago a try, but you are weary of having to setup python project together with database, you may do it now easily if you have Docker installed.

This feature is contribution from our community member, einarf.


New features

* 969 - Mark a post as best answer in a thread.
* 971 - Allow users to delete their own forum accounts.
* 981 - Misago now has docker config, which should make it easier to setup for developing locally.
* 983 - Added `fixcategoriestree` management command for repairing the thread category tree in case it gets corrupted.

Theme changes

*none*

Bugs fixed

* 925 - Fixed fake data generators after they stopped working due to `fake-factory`'s rename to `Faker`.
* 970 - Misago incorrectly relied on `request.path_info` whereas it actually wanted `request.path`, thus breaking admin auth and redirections as well as other small features that operated on path strings.

Implementation and API changes

*none*

Documentation changes

*none*

Localization changes

* 965 - Changed turkish locale's code to `tr` from `tr_TR`. Synced translations with Transifex.
* 974 - Added translation strings for best answers and own account deletion to Transifex.
* 974 - Synchronized translations with Transifex.

Misago 0.16 is quality of life release that brings small fixes and and improvements to project's codebase.

Updating instructions

To update Misago from 0.15 to 0.16 use PIP to uninstall old Misago and install new one:


pip uninstall misago
pip install misago


Then run `migrate` and `collectstatic` commands to make sure your forum's database and static files are up to date:


python manage.py migrate
python manage.py collectstatic


New features

* 966 - Redirect user from guest-only view to url defined in `LOGIN_REDIRECT_URL` if they signed in on it instead of displaying him an error 403.

Theme changes

*none*

Bugs fixed

* 963 - Instead of 404, display message about category being non-browseable when user can see the category, but not its contents.

Implementation and API changes

*none*

Documentation changes

*none*

Localization changes

* 965 - Changed turkish locale's code to `tr` from `tr_TR`. Synced translations with transifex