django-basetheme-bootstrap
A module handling basic fonctionnality needed in django project such as base.html using bootstrap, account settings, preferences management, ...
Quick start
- Add "basetheme_bootstrap" to your INSTALLED_APPS setting like this (while not forgetting
crispy_forms). Note that basetheme_bootstrap have to be before django.contrib.admin to override the default template for password reset.
INSTALLED_APPS = [
...
'crispy_forms',
'basetheme_bootstrap',
...
'django.contrib.admin',
]- Add the context_processors::
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
...
'basetheme_bootstrap.context_processors.processors',
],
},
},
]- Adjust the configuration::
################################################################################
# django-crispy-forms
################################################################################
CRISPY_TEMPLATE_PACK = 'bootstrap4'
################################################################################
# basetheme_bootstrap
################################################################################
BASETHEME_BOOTSTRAP_TEMPLATE_LOCATION_PROJECT = "test_app_1"
BASETHEME_BOOTSTRAP_USER_PREFERENCE_MODEL_ENABLED = True
BASETHEME_BOOTSTRAP_USER_PREFERENCE_MODEL_LOCATION_APP = "test_app_1"
BASETHEME_BOOTSTRAP_USER_PREFERENCE_MODEL_NAME = "MyUserPreferences"
BASETHEME_BOOTSTRAP_USERNAME_IS_EMAIL = False
BASETHEME_BOOTSTRAP_FIRST_LAST_NAME_REQUIRED = False
################################################################################- Include the polls URLconf in your project urls.py like this::
from django.urls import path, include
path('', include('basetheme_bootstrap.urls')),-
Run
python manage.py migrateto create the UserPreferences model if you decided to have one. -
Make your templates extends base template from
basetheme_bootstrap, or even better create your own base.html which extends the one frombasetheme_bootstrap::
{% extends "basetheme_bootstrap/base4.html" %}Cheat sheet
mkdir -p locale && python manage.py makemessages -l en -l fr --no-location && rm -rf ./locale