Quickstart¶
I’m assuming that you’ve already setup your Django project, including database. So, please follow next instructions to run DartCMS panel:
- Install DartCMS with pip:
pip install dartcms
- Go to your project’s settings.py file and import DartCMS apps:
from dartcms import get_dartcms_core_apps
...
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
...
] + get_dartcms_core_apps()
Also, you can pass optional parameter named include_apps to define which apps you want to include from dartcms.
INSTALLED_APPS = [
...
] + get_dartcms_core_apps(include_apps=['shop'])
In this example, you will include only dartcms.apps.shop application in your project.
- Add DartCMS’s context processor to your templates settings:
TEMPLATES = [
{
...
'OPTIONS': {
'context_processors': [
...
'dartcms.context_processors.modules_data'
]
}
}
]
- Add DartCMS’s PageMiddleware in the end of list or tuple of your middleware classes:
MIDDLEWARE_CLASSES = (
...
'dartcms.middleware.page.PageMiddleware'
)
- Include Django admin and DartCMS urls in your urlconf:
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^cms/', include('dartcms.urls', namespace='dartcms')),
]
You can choose any url name for DartCMS urls import.
- Run django migrations:
python manage.py migrate
- Run development server and navigate your browser to http://127.0.0.1:8000/cms/. You should see DartCMS dashboard.