Announcement: We've upgraded to Django REST Framework 2. This means that if you want to use the latest Fiber and you use Django REST Framework 0.3.X or 0.4.X for your own project, you'll have to bite the bullet and upgrade your local REST Framework code.
Do you want to see a Django Fiber screencast, to get a feel for what it can do for you? Check it out here: http://vimeo.com/ridethepony/django-fiber
Or, if you want to quickly try out Django Fiber on your machine, install the Django Fiber example project: https://github.com/ridethepony/django-fiber-example
Convinced? Want to use Django Fiber in your own Django project? Then follow the instructions below:
We're assuming you are using Django 1.3.x, 1.4.x or 1.5.x.
$ pip install django-fiber
These dependencies are automatically installed:
Pillow==2.0.0
django-mptt==0.5.5
django-compressor==1.3
djangorestframework==2.3.6
import django.conf.global_settings as DEFAULT_SETTINGS
MIDDLEWARE_CLASSES = DEFAULT_SETTINGS.MIDDLEWARE_CLASSES + (
'fiber.middleware.ObfuscateEmailAddressMiddleware',
'fiber.middleware.AdminPageMiddleware',
)
TEMPLATE_CONTEXT_PROCESSORS = DEFAULT_SETTINGS.TEMPLATE_CONTEXT_PROCESSORS + (
'django.core.context_processors.request',
)
INSTALLED_APPS = (
...
'django.contrib.staticfiles',
'mptt',
'compressor',
'fiber',
...
)
import os
BASE_DIR = os.path.abspath(os.path.dirname(__file__))
STATIC_ROOT = os.path.join(BASE_DIR, 'static')
STATIC_URL = '/static/'
STATICFILES_FINDERS = DEFAULT_SETTINGS.STATICFILES_FINDERS + (
'compressor.finders.CompressorFinder',
)
from django.conf import settings
urlpatterns = patterns('',
...
(r'^api/v2/', include('fiber.rest_api.urls')),
(r'^admin/fiber/', include('fiber.admin_urls')),
(r'^jsi18n/$', 'django.views.i18n.javascript_catalog', {'packages': ('fiber',),}),
...
(r'', 'fiber.views.page'),
)
Create database tables:
$ python manage.py syncdb
All static Fiber files need to be symlinked in (or copied to) your media folder:
$ python manage.py collectstatic --link
For further usage and configuration details take a look at our documentation project at readthedocs.
See CHANGELOG.md for the latest changes.