Templates¶
Requirements¶
The supported templates requires bootstrap3. Forms are based on django-bootstrap3
application, that can be installed with:
pip install django-bootstrap3
This application is used only to render forms.
If you don’t want to use it’s default rendering, you can override the form_template.html
file as described in the example below.
Structure¶
Templates are organized in different sections, inside groups_manager/bootstrap3
folder.:
- groups_manager.html (extends "base.html")
| - groups_manager_home.html (menu with links to models lists)
| - <model>.html (model base, i.e. "member", extended by all model templates)
| - <model>_list.html
| - <model>_detail.html
| - <model>_form.html (includes form_template.html)
| - <model>_confirm_delete.html
There are different blocks:
breadcrumbs
: usually displayed on top of the page, withapp - model - page
linkssidebar
: menu available for the application and <model> actions (add, edit, etc)content
: the main content of the page
To change a template, creates the same structure inside an application loaded after groups_manager
in your INSTALLED_APPS
.
For example, to change form_template.html
file, create the folders “groups_manager/bootstrap3/” and put
the file “form_template.html” inside.
Style¶
By default, style is “bootstrap3”: this means that templates are searched inside folder “groups_manager/bootstrap3”.
To change this behaviour, edit setting TEMPLATE_STYLE
: it will be used in the views:
template_name = 'groups_manager%s/groups_manager.html' % TS