Skip to main content

Django Fiber - a simple, user-friendly CMS for all your Django projects

Project description

Travis build image PyPI version Coverage Status

An important message about this project

Hi Django Fiber enthusiasts! This project was started by the people at Ride The Pony, Leukeleu and Jouw Omgeving. They started Django Fiber in 2011, because they wanted a good, simple Django CMS available. Lots of people felt the same, which was why Django Fiber became pretty popular. And it is still going strong in lots of sites, so we hear :)

Later, they discovered Wagtail, and found it to be even better than their own creation. So they decided to move on. Nevertheless, Django Fiber was popular, used in many websites, and they didn’t want to just drop it. At the start of 2017 they handed over control of the project to a new group of maintainers - the discussion about this handover can be found in issue #244.

Currently Django Fiber is in ‘maintenance mode’. What this means it that it will be updated to run with the latest releases of Django - and of other packages that Django Fiber depends on. However, no effort will be made to add new features.

If a user really wants a new feature added - then a well-written PR will be reviewed and considered. But other than that, Django Fiber is staying exactly as it is :)

About Django Fiber

Do you want to see a Django Fiber screencast, to get a feel for what it can do for you? Check it out on Vimeo

Convinced? Want to use Django Fiber in your own Django project? Then follow the instructions below.

Requirements

These dependencies are automatically installed:

Pillow>=2.2.1
django-mptt>=0.8
django_compressor>=2.0
djangorestframework>=3.4
easy-thumbnails>=2.2

Installation

We’re assuming you are using Django 1.8-1.10. Then simply install Fiber using pip:

$ pip install django-fiber

Setup

Open settings.py and add the following to your INSTALLED_APPS

INSTALLED_APPS = (
     ...
     'mptt',
     'compressor',
     'easy_thumbnails',
     'fiber',
     ...
)

Add Fiber to the MIDDLEWARE_CLASSES list

import django.conf.global_settings as DEFAULT_SETTINGS

MIDDLEWARE_CLASSES = DEFAULT_SETTINGS.MIDDLEWARE_CLASSES + (
    ...
    'fiber.middleware.ObfuscateEmailAddressMiddleware',
    'fiber.middleware.AdminPageMiddleware',
)

(Or, add the same items to MIDDLEWARE if you are using Django 1.10 or later.)

Add the request context processor

TEMPLATES = [
    {
        ...
        'OPTIONS': {
            'context_processors': [
                ...
                'django.template.context_processors.request',
            ]
        }
    },
]

And configure compressor

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

STATIC_ROOT = os.path.join(BASE_DIR, 'static')
STATIC_URL = '/static/'
STATICFILES_FINDERS = DEFAULT_SETTINGS.STATICFILES_FINDERS + [
    'compressor.finders.CompressorFinder',
]

Edit your urls.py to add the Fiber site to your url-patterns

from django.conf.urls import include, url
from fiber.views import page

urlpatterns = [
    ...
    url(r'^api/v2/', include('fiber.rest_api.urls')),
    url(r'^admin/fiber/', include('fiber.admin_urls')),
    ...
    url(r'', page),
]

Post-installation

Create database tables:

$ python manage.py migrate

All static Fiber files need to be symlinked in (or copied to) your static files folder if you’re not on your dev machine:

$ python manage.py collectstatic --link

Further documentation

For further usage and configuration details take a look at our documentation project at readthedocs.

Changelog

See CHANGELOG.md for the latest changes.

Analytics

Project details


Release history Release notifications | RSS feed

This version

1.5

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-fiber-1.5.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

django_fiber-1.5-py2.py3-none-any.whl (2.5 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-fiber-1.5.tar.gz.

File metadata

  • Download URL: django-fiber-1.5.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-fiber-1.5.tar.gz
Algorithm Hash digest
SHA256 c6cb34a893be74407aaa434fe452088e494d8a3f82276504f9e6323054d5e911
MD5 6f48ba221091978834430e054e75be6c
BLAKE2b-256 50e3d3387dd416e77162a08c2c9673b93ea75576d9095e0ec99b252613f74c3e

See more details on using hashes here.

Provenance

File details

Details for the file django_fiber-1.5-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_fiber-1.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b501c907fe1b3fb1dd5fa56f0bb89485ff77dbaee0fe54f3e9c415b198c18be6
MD5 f5e498b955b391af50173818021e7c2c
BLAKE2b-256 6c8fd576441f961755d646b0416c309961e47a40b9938519410697e676e77358

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page