Before install django-umessages, you’ll need to have a copy of Django 1.2 or newer installed.
For further information, consult the Django download page, which offers convenient packaged downloads and installation instructions.
warning:
django-umessages has not been tested on Python3 yet.
You can install django-umessages automagicly with pip. Or by manually placing it on on your PYTHON_PATH. The recommended way is the shown in Automatic installation with pip..
It is also recommended to use virtualenv to have an isolated python environment. This way it’s possible to create a tailored environment for each project.
Automatic install with pip. All you have to do is run the following command:
pip install django-umessages
Clone the Git repository from Github. Then you can direct easy_install to the setup.py file. For ex.:
git clone git://github.com/euanlau/django-umessages.git
cd django-umessages
easy_install setup.py
You can tell pip to install django-umessages by supplying it with the git repository on Github. Do this by typing the following in your terminal:
pip install -e git+git://github.com/euanlau/django-umessages.git#egg=umessages
Clone umessages with:
git clone git://github.com/euanlau/django-umessages.git
You now have a directory django-umessages which contains the umessages application. You can add umessages to your $PYTHONPATH by symlinking it. For example:
cd YOUR_PYTHON_PATH
ln -s ~/src/django-umessages/umessages umessages
Now umessages is available to your project.
Add``umessages``` to the INSTALLED_APPS in your settings.py file of your project.
Next, you need to create a new app on your Django project. In your Command Prompt shell, type: python manage.py startapp messages. We are creating a new app for uMessages titled ‘messages’.
Next, add messages to the INSTALLED_APPS in your settings.py file.
uMessages uses the Django email facilities to send mail to users, for example after user signup for email verification. By default Django uses the SMTP backend, which may cause issues in development and/or if the default SMTP settings are not suitable for your environment. It is recommended to explicitly set the email backend provider in your settings.py. For example:
EMAIL_BACKEND = 'django.core.mail.backends.dummy.EmailBackend'
To use GMail SMTP, you may use the following code in your settings.py:
EMAIL_USE_TLS = True
EMAIL_HOST = ‘smtp.gmail.com’
EMAIL_PORT = 587
EMAIL_HOST_USER = ‘yourgmailaccount@gmail.com’
EMAIL_HOST_PASSWORD = ‘yourgmailpassword’
uMessages has a URLconf which set’s all the url’s and views for you. This should be included in your projects root URLconf.
For example, to place the URIs under the prefix /messages/, you could add the following to your project’s root URLconf. Add this code under urlpatterns in your urls.py file.
(r'^messages/', include('umessages.urls')),
This should have you a working accounts application for your project. See the settings for further configuration options.