1. General Documentation

• Tutorial - Very short tutorial on what needs to be done to start a new project from scratch which utilizes the wiki and board.

• Applications

  • Community - General purpose features like user profiles
  • Wiki - Easiest way to add content to your site ;)
  • Board/Forum - Full featured Forum application (Message Board).
  • LinkList - A simple linklist application.
  • Blog
  • Comments - Allows you to easily use forum categories attached to your models.
  • Search - Search (currently only for the forum)

• Contributing - If you want to help and improve SCT read here what you can do

  • Badges - Show your support for SCT on your website

• SPH SETTINGS - global Sphene Community Tools settings configured in your settings.py

• Documentation TODOs

  • Development
  • Blog
  • BlockFramework

2. Download

See Downloads Section.

3. README

3.1. Directories

Sphene Community Tools (SCT) - http://sct.sphene.net Copyright (C) by Herbert Poul (herbert.poul@gmail.com)

Sphene Community Tools are django applications to build communities and similiar websites designed to be easily pluggable into any django project to build. It currently consists of a forum, wiki and blog application.

3.2. Directories

• sphenecoll/ Collection of django application (the base source for SCT).
• examples/ A simple example configuration for using forum and wiki

3.3. Requirements

• Django 2.0 or later
• Python >= 3.6
• Python Imaging Library (Pillow)

3.4. Installation

(Note: Since 0.6 SCT also comes with an experimental setup.py - if you are using (e.g. by executing: python setup.py install) please provide feedback on http://sct.sphene.net/ or herbert.poul@gmail.com if it worked or if you encountered any problems.)

To find instructions on how to setup a simple project for using forum and wiki see our tutorial at: http://sct.sphene.net/wiki/show/Tutorial/

3.4.1. Python library path

You need to add sphenecoll/ to your python include path.

3.4.2. Maintenance cron job (Optional)

To recaulcate heat for forum threads and similar, you should add the following cronjob to run once a day (or similar)

/path/to/your/django/project/manage.py sph_maintenance

3.4.3. Cache

SCT makes use of django caching framework - it is therefore advised to configure CACHE_BACKEND django setting & co. look at the django caching documentation

3.4.4. Search

Please follow the search documentation.

3.5. Examples

There are currently two examples - a very simplistic 'simpleproject' in the examples/ directory (see examples/simpleproject/README) and a more sophisticated example called CommunityDraft which i recommend as using as a base for your own projects (if you start from scratch). See http://sct.sphene.net/wiki/show/CommunityDraft/ for details.

4. Examples

The most complete example on how to use SCT in a web site is the CommunityDraft - it is bundled in releases and is the best way to get started. (http://sct.sphene.net uses an unmodified version of CommunityDraft)

SCT also contains a very simplistic example under communitytools/examples/simpleproject (see Tutorial).