A Django app to generate HTML breadcrumbs dynamically from URL path
Project description
django-dynamic-breadcrumbs
django-dynamic-breadcrumbs
is a Django app to generate HTML breadcrumbs
dynamically from URL paths.
At https://example.com/reference/instrument/guitar/
, shows:
Home > Reference > Instrument > Guitar
.
Quick start
1. Install
pip install django-dynamic-breadcrumbs
2. Add to settings
Add "dynamic_breadcrumbs" label to your INSTALLED_APPS settings:
INSTALLED_APPS = [
...
'dynamic_breadcrumbs',
]
Add dynamic_breadcrumbs.context_processors.breadcrumbs
to context_processors:
TEMPLATES = [
{
"BACKEND": "django.template.backends.django.DjangoTemplates",
"DIRS": [os.path.join(BASE_DIR, "templates")],
"APP_DIRS": True,
"OPTIONS": {
"context_processors": [
#...
"dynamic_breadcrumbs.context_processors.breadcrumbs",
],
},
},
]
3. Add template
Include the dynamic_breadcrumbs/breadcrumbs.html
in your base template.
{% if breadcrumbs %}
<div class="container">
{% include "dynamic_breadcrumbs/breadcrumbs.html" with breadcrumbs=breadcrumbs%}
</div>
{% endif %}
Now each time you visit a page which makes use of the above template, it will have the breadcrumbs generated from the URL path.
Documentation
Full docs at: https://django-dynamic-breadcrumbs.readthedocs.io/
License
MIT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-dynamic-breadcrumbs-0.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54aeb634cfc12460cc3311fd83cec80884b4ab50337a1e5b384ca803edee84e2 |
|
MD5 | 4e4875c2c04895b026c07df18cb3dda3 |
|
BLAKE2b-256 | af6731a364c1eb055e19fc7ebd82faefad54b39a43f1ae6bbca8a2463e6d7e11 |