Spirit
Spirit is a Python based forum built using the Django framework.
To see it in action, please visit The Spirit Project.
Requirements
Spirit requires the following software to be installed:
- Python 2.7
- Django 1.6
- PostgreSQL or MySQL or Oracle Database
Dependencies
Check out the requirements provided.
Integration
Spirit can be integrated with any other Django application without much of a hassle.
The only thing to notice is that Spirit uses its own AUTH_USER_MODEL.
If you want to roll your own user app, your user model must inherit from spirit.models.user.AbstractForumUser
.
If you just want to extend the Spirit user model (adding new fields or methods),
your model must inherit from spirit.models.user.AbstractUser
.
Installing (Advanced)
Check out the example provided.
In short:
Add spirit
, djconfig
and haystack
to your INSTALLED_APPS
Add url(r'^', include('spirit.urls', namespace="spirit", app_name="spirit")),
to your urls.py
Add from spirit.settings import *
to the top of your settings.py file,
otherwise you will have to setup all django's related constants (Middlewares, Login_url, etc)
Run:
pip install -r requeriments.txt
python manage.py syncdb
python manage.py loaddata spirit_init
python manage.py createcachetable spirit_cache
Note:
You will need to setup a search engine, Spirit is configured to work with Woosh by default.
An email server is required, you can host your own (ie: exim), or hire an external service provider (ie: Mandrill).
Start a development server:
python manage.py runserver
Visit (http://127.0.0.1:8000/)
Note: On production, you would rather run Spirit on a real web server. ie: gunicorn + Nginx. Running Spirit on a virtualenv is adviced.
Updating
Soon.
Contributing
Feel free to check out the source code and submit pull requests.
You may also report any bug or propose new features in the issues tracker
Copyright / License
Copyright 2014 Esteban Castro Borsani.
Licensed under the MIT License.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.