FeinCMS - An extensible Django-based CMS¶

FeinCMS is an extremely stupid content management system. It knows nothing about content – just enough to create an admin interface for your own page content types. It lets you reorder page content blocks using a drag-drop interface, and you can add as many content blocks to a region (f.e. the sidebar, the main content region or something else which I haven’t thought of yet). It provides helper functions, which provide ordered lists of page content blocks. That’s all.
Adding your own content types is extremely easy. Do you like markdown that much, that you’d rather die than using a rich text editor? Then add the following code to your project, and you can go on using the CMS without being forced to use whatever the developers deemed best:
from markdown2 import markdown
from feincms.module.page.models import Page
from django.db import models
class MarkdownPageContent(models.Model):
content = models.TextField()
class Meta:
abstract = True
def render(self, **kwargs):
return markdown(self.content)
Page.create_content_type(MarkdownPageContent)
That’s it. Only ten lines of code for your own page content type.
Contents¶
- Installation instructions
- The built-in page module
- Content types - what your page content is built of
- What is a content type anyway?
- Rendering contents in your templates
- Implementing your own content types
- Customizing the render method for different regions
- Extra media for content types
- Influencing request processing through a content type
- Bundled content types
- Restricting a content type to a subset of regions
- Design considerations for content types
- Configuring and self-checking content types at creation time
- Obtaining a concrete content type model
- Extensions
- Administration interfaces
- Integrating 3rd party apps into your site
- Default page handler
- Generic and custom views
- Integrating 3rd party apps
- Adapting the 3rd party application for FeinCMS
- Registering the 3rd party application with FeinCMS’
ApplicationContent
- Writing the models
- Returning content from views
- Letting the application content use the full power of Django’s template inheritance
- More on reversing URLs
- Additional customization possibilities
- Letting 3rd party apps define navigation entries
- Media library
- Template tags
- Settings
- Database migration support for FeinCMS
- Versioning database content with
django-reversion
- Advanced topics
- Frequently Asked Questions
- Contributing to the development of FeinCMS
- FeinCMS Deprecation Timeline
Change log¶
v1.19.0 (2021-03-04)¶
- Fixed a bug where the thumbnailer would try to save JPEGs as RGBA.
- Reformatted the code using black, again.
- Added Python 3.8, Django 3.1 to the build.
- Added the Django 3.2 .headers property to the internal dummy response used in the etag request processor.
- Added a workaround for
AppConfig
-autodiscovery related crashes. (Becausefeincms.apps
now has more meanings). Changed the documentation to preferfeincms.content.application.models.*
tofeincms.apps.*
. - Updated the TinyMCE CDN URL to an version which doesn’t show JavaScript alerts.
- Added missing
on_delete
values to the django-filer content types.
v1.18.0 (2020-01-21)¶
- Added a style checking job to the CI matrix.
- Dropped compatibility with Django 1.7.
v1.16.0 (2019-02-01)¶
- Reformatted everything using black.
- Added a fallback import for the
staticfiles
template tag library which will be gone in Django 3.0.
v1.15.0 (2018-12-21)¶
- Actually made use of the timeout specified as
FEINCMS_THUMBNAIL_CACHE_TIMEOUT
instead of the hardcoded value of seven days. - Reverted the deprecation of navigation extension autodiscovery.
- Fixed the item editor JavaScript and HTML to work with Django 2.1’s updated inlines.
- Fixed
TranslatedObjectManager.only_language
to evaluate callables before filtering. - Changed the
render
protocol of content types to allow returning a tuple of(ct_template, ct_context)
which works the same way as feincms3’s template renderers.
v1.14.0 (2018-08-16)¶
- Added a central changelog instead of creating release notes per release because development is moving more slowly owing to the stable nature of FeinCMS.
- Fixed history (revision) form, recover form and breadcrumbs when FeinCMS is used with Reversion 2.0.x. This accommodates refactoring that took place in Reversion 1.9 and 2.0. If you are upgrading Reversion (rather than starting a new project), please be aware of the significant interface changes and database migrations in that product, and attempt upgrading in a development environment before upgrading a live site.
- Added
install_requires
back tosetup.py
so that dependencies are installed automatically again. Note that some combinations of e.g. Django and django-mptt are incompatible – look at the Travis CI build configuration to find out about supported combinations. - Fixed a few minor compatibility and performance problems.
- Added a new
FEINCMS_THUMBNAIL_CACHE_TIMEOUT
setting which allows caching whether a thumb exists instead of callingstorage.exists()
over and over (which might be slow with remote storages). - Fixed random reordering of applications by using an ordered dictionary for apps.
- Increased the length of the caption field for media file translations.
- Fixed
feincms.contrib.tagging
to actually work with Django versions after 1.9.x.
Old release notes¶
- FeinCMS 1.13 release notes
- FeinCMS 1.12 release notes
- FeinCMS 1.11 release notes
- FeinCMS 1.10 release notes
- FeinCMS 1.9 release notes
- FeinCMS 1.8 release notes
- FeinCMS 1.7 release notes
- FeinCMS 1.6 release notes
- FeinCMS 1.5 release notes
- FeinCMS 1.4 release notes
- FeinCMS 1.3 release notes
- FeinCMS 1.2 release notes