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:
python
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:
python
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:
python
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`:
python
INSTALLED_APPS = [
...bunch of lines here
'django.contrib.contenttypes',
...more lines there
]
And insert the `'django.contrib.postgres',` line below it:
python
INSTALLED_APPS = [
...bunch of lines here
'django.contrib.contenttypes',
'django.contrib.postgres',
...more lines there
]
[Here's the reference](https://github.com/rafalp/Misago/blob/master/misago/project_template/project_name/settings.py#L169) 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 the`python 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](https://rafalp.gitbooks.io/misago/setup/#about-the-djangodbutilsprogrammingerror-permission-denied-to-create-extension-errors-during-database-migration) 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.