feat: site dropdown (#1046)

Author: lukasvinclav

docs/configuration/settings.md

@@ -18,6 +18,15 @@ from django.utils.translation import gettext_lazy as _
 UNFOLD = {
     "SITE_TITLE": "Custom suffix in <title> tag",
     "SITE_HEADER": "Appears in sidebar at the top",
+    "SITE_SUBHEADER": "Appears under SITE_HEADER",
+    "SITE_DROPDOWN": [
+        {
+            "icon": "diamond",
+            "title": _("My site"),
+            "link": "https://example.com",
+        },
+        # ...
+    ],
     "SITE_URL": "/",
     # "SITE_ICON": lambda request: static("icon.svg"),  # both modes, optimise for 32px height
     "SITE_ICON": {

docs/configuration/site-dropdown.md

@@ -0,0 +1,32 @@
+---
+title: Site dropdown
+order: 2
+description: Learn how to configure dropdown navigation in the sidebar when clicking on the site header in Django Unfold admin interface.
+---
+
+# Site dropdown
+
+Unfold provides a possibility to specify a dropdown navigation in sidebar when clicking on the site header by using `SITE_DROPDOWN` option in `UNFOLD` configuration dictionary. When this option is set, a dropdown icon will display on the site header to mark that site header is clickable.
+
+```python
+# settings.py
+
+from django.urls import reverse_lazy
+from django.utils.translation import gettext_lazy as _
+
+
+UNFOLD = {
+    "SITE_DROPDOWN": [
+        {
+            "icon": "diamond",
+            "title": _("My site"),
+            "link": "https://example.com",
+        },
+        {
+            "icon": "diamond",
+            "title": _("My site"),
+            "link": reverse_lazy("admin:index"),
+        },
+    ]
+}
+```

docs/dashboard/index.md

@@ -35,11 +35,7 @@ TEMPLATES = [
 {% endblock %}
 
 {% block branding %}
-    <h1 id="site-name">
-        <a href="{% url 'admin:index' %}">
-            {{ site_header|default:_('Django administration') }}
-        </a>
-    </h1>
+    {% include "unfold/helpers/site_branding.html" %}
 {% endblock %}
 
 {% block content %}