askbot 0.8.3

Question and Answer forum, like StackOverflow, written in python and Django

This version of Askbot is made to transition from Django 1.5 and 1.6 version 1.7 and higher.

To upgrade, or select appropriate version of Askbot, please follow instructions at https://github.com/ASKBOT/askbot-devel/blob/master/askbot/doc/source/upgrade.rst

Questions? Suggestions? Found a bug? -> please post at http://askbot.org/en/questions/

Features

• standard Q&A functionalities including votes, reputation system, etc.
• user levels: admin, moderator, regular, suspended, blocked
• per-user inbox for responses & flagged items (for moderators)
• email alerts - instant and delayed, optionally tag filtered
• search by full text and a set of tags simultaneously
• imports data from StackExchange, Jive, ZenDesk

Installation

The general steps are:

• install the code
• if there is no database yet - create one
• create a new or configure existing django site for askbot
• create/update the database tables

Methods to install code

• pip install askbot
• download .tar.gz file from the bottom of this page, then run python setup.py install
• clone code from the github git clone git://github.com/ASKBOT/askbot-devel.git, and then python setup.py develop

Create/configure django site

Either run command askbot-setup or merge contents of directory askbot/setup_templates in the source code into your project directory.

Create/update database tables

Back up your database if it is not blank, then two commands:

• python manage.py syncdb
• python manage.py migrate

There are two apps to migrate - askbot and django_authopenid (a forked version of the original, included within askbot), so you can as well migrate them separately

Limitations

There are some limitations that will be removed in the future. If any of these cause issues - please do not hesitate to contact [e-mail].

Askbot patches auth_user table. The migration script will automatically add missing columns, however it will not overwrite any existing columns. Please do back up your database before adding askbot to an existing site.

Included into askbot there are two forked apps: django_authopenid and livesettings. If you have these apps on your site, you may have trouble installing askbot.

User registration and login system is bundled with Askbot, but can be replaced with any other. It is quite good though, it allows logging in with password and many authentication service providers, including popular social services and recover account by email.

If there are any other collisions, askbot will simply fail to install, it will not damage your data.

Background Information

Askbot is based on CNPROG project by Mike Chen and Sailing Cai, project which was originally inspired by StackOverflow and Yahoo Answers.

Footnotes

(**) - With MySQL you have to use MyISAM data backend, because it's the only one that supports Full Text Search.