django-epfl-web2018

Web2018 for Django.

Requirements

• Python 3.8 or later
• Django 4.2, 5.2, 6.0 or 6.1

Installation

pip install django-epfl-web2018

Documentation

Settings

Add django_epfl_web2018 to INSTALLED_APPS:

INSTALLED_APPS = [
  ...
  "django_epfl_web2018",
  ...
]

Routing

Edit your urls.py and add the following:

handler400 = "django_epfl_web2018.views.error_400"
handler403 = "django_epfl_web2018.views.error_403"
handler404 = "django_epfl_web2018.views.error_404"
handler500 = "django_epfl_web2018.views.error_500"

Base Template

File: templates/web2018/web2018.html

This is the master template for all pages. It defines the overall structure and layout.

Available Template Blocks (Override Points)

• web2018_title → Page title.
• web2018_extra_link → Extra tags inside <head>.
• web2018_app_name → Application name.
• web2018_header → Custom header content (search, user menu, language).
• web2018_breadcrumb_container → Breadcrumb container.
• web2018_breadcrumb → Breadcrumb items.
• web2018_nav_main → Main navigation (mobile).
• web2018_content → Page content.
• web2018_pre_footer → Custom content that sits over/above the footer.
• web2018_extra_js → Extra tags just before </body>.

Available Template Includes (Override Points)

• footer-extra-links.html → Extra links in the footer's legal links block.

Configuration

Optional dictionary-based settings for Web2018 configuration. If the WEB2018 setting is not defined, defaults apply.

WEB2018 = {
  # Breadcrumb visibility (Default: True).
  "SHOW_BREADCRUMB": False,

  # Site title suffix appended to the page title (Default: "EPFL").
  "SITE_TITLE_SUFFIX": "My Unit",

  # Enable Google Tag Manager analytics (Default: True).
  "ENABLE_ANALYTICS": False,
}