INSTALL

TracDjangoAuth
Trac Authentication against Django's userdb
(c) 2011 Ville Korhonen <ville@xd.fi>

INSTALL
=======

 - NB: TracAccountManager plugin is REQUIRED
 - NB: Working Django installation is REQUIRED

Loading Django modules fails if DJANGO_SETTINGS_MODULE
environment variable is not set refer to mod_python/
mod_wsgi/tracd/<put your webserver here> manual on how
to set environment variables on your system.


Your Django project should be in PYTHONPATH.


Installing package:
===================
 - pip install TracDjangoAuth
 OR
 - easy_install TracDjangoAuth
 OR
 - download TracDjangoAuth archive, unzip, python setup.py install
   OR python setup.py bdist_egg and copy dist/*.egg to
   plugins -directory inside your Trac environment
 
 
Configuration:
==============
Edit trac.ini:

 [components]
 tracdjangoauth.auth_django.djangopasswordstore = enabled
 acct_mgr.web_ui.loginmodule = enabled
 trac.web.auth.loginmodule = disabled

 [account-manager]
 password_store = DjangoPasswordStore
 require_group = Trac                   ; optional, to which Django group user
                                        ; must belong to be authenticated