This document describes the steps needed to get FeinCMS up and running.
FeinCMS is based on Django, so you need a working Django installation first. I’m developing FeinCMS using a Subversion checkout of Django, but any version which is at least 1.0 should work currently. If it does not, this is considered a bug and I’d be happy to hear about it.
You can download a stable release of FeinCMS using easy_install:
$ sudo easy_install feincms
Please note that the package installable with easy_install only contains the files needed to run FeinCMS. It does not include documentation, tests or the example project which comes with the development version, which you can download using the Git version control system:
$ git clone git://github.com/matthiask/feincms.git
In addition, you will need a django-mptt installation (The released version 0.2.1 is incompatible with Django SVN trunk. The django-mptt version from SVN is fixed to work with current versions of Django, but seems to be unmaintained and has several small bugs. Consider getting the version from the github repository linked to above.)
Finally, some content types or extensions require recent versions of lxml, django-tagging, feedparser and the python imaging library PIL (PIL is actually a dependency of Django‘s ImageField).
There isn’t much left to do apart from adding feincms to INSTALLED_APPS. The customized administration interface needs some media and javascript libraries, which you have to make available to the browser. You should publish the files in the folder feincms/media/feincms/ somewhere on your site and set the FEINCMS_ADMIN_MEDIA to the location. You can do this either by copying the media files into your media folder or by installing a symlink to the correct place.
Please note that the feincms module will not create or need any database tables, but you need to put it into INSTALLED_APPS because otherwise the templates in feincms/templates/ will not be found by the template loader.
The tools contained in FeinCMS can be used for many CMS-related activities. The most common use of a CMS is to manage a hierarchy of pages and this is the most advanced module of FeinCMS too. Please proceed to Using the built-in page module to find out how you can get the page module up and running.