Merge branch 'master' into gilbert
[philo.git] / README
1 Philo is a foundation for developing web content management systems.
2
3 Prerequisites:
4         * Python 2.5.4+ <http://www.python.org/>
5         * Django 1.2+ <http://www.djangoproject.com/>
6         * django-mptt e734079+ <https://github.com/django-mptt/django-mptt/>
7         * django-staticmedia 0.2+ <http://pypi.python.org/pypi/django-staticmedia/>
8         * (Optional) django-grappelli 2.0+ <http://code.google.com/p/django-grappelli/>
9         * (Optional) south 0.7.2+ <http://south.aeracode.org/>
10         * (Optional) recaptcha-django r6 <http://code.google.com/p/recaptcha-django/>
11
12 To contribute, please visit the project website <http://philo.ithinksw.org/>. Feel free to join us on IRC at irc://irc.oftc.net/#philo.
13
14 ====
15 Using philo
16 ====
17 After installing philo and mptt on your python path, make sure to complete the following steps:
18
19 1. add 'philo.middleware.RequestNodeMiddleware' to settings.MIDDLEWARE_CLASSES.
20 2. add 'philo' and 'mptt' to settings.INSTALLED_APPS.
21 3. include 'philo.urls' somewhere in your urls.py file.
22 4. Optionally add a root node to your current Site.
23
24 Philo should be ready to go!
25
26 If you are using philo.contrib.gilbert, you will additionally need to complete the following steps:
27
28 1. add 'django.core.context_processors.request' to settings.TEMPLATE_CONTEXT_PROCESSORS