Add favicon as an overrideable branding block - fixes #1391

2015-10-05 18:20:08 +01:00 · 2015-10-05 18:20:08 +01:00 · a86b08a622
commit a86b08a622
--- a/docs/advanced_topics/customisation/branding.rst
+++ b/docs/advanced_topics/customisation/branding.rst
@ -30,6 +30,17 @@ To replace the default logo, create a template file ``dashboard/templates/wagtai
        <img src="{{ STATIC_URL }}images/custom-logo.svg" alt="Custom Project" width="80" />
    {% endblock %}

+``branding_favicon``
+--------------------
+
+To replace the favicon displayed when viewing admin pages, create a template file ``dashboard/templates/wagtailadmin/admin_base.html`` that overrides the block ``branding_favicon``::
+
+    {% overextends "wagtailadmin/admin_base.html" %}
+
+    {% block branding_favicon %}
+        <link rel="shortcut icon" href="{{ STATIC_URL }}images/favicon.ico" />
+    {% endblock %}
+
 ``branding_login``
 ------------------

--- a/wagtail/wagtailadmin/static_src/wagtailadmin/images/favicon.ico
+++ b/wagtail/wagtailadmin/static_src/wagtailadmin/images/favicon.ico
--- a/wagtail/wagtailadmin/templates/wagtailadmin/admin_base.html
+++ b/wagtail/wagtailadmin/templates/wagtailadmin/admin_base.html
@ -10,6 +10,10 @@
    {% block extra_css %}{% endblock %}
 {% endblock %}

+{% block branding_favicon %}
+    <link rel="shortcut icon" href="{% static 'wagtailadmin/images/favicon.ico' %}" />
+{% endblock %}
+
 {% block js %}
    
    {% compress js %}
--- a/wagtail/wagtailadmin/templates/wagtailadmin/skeleton.html
+++ b/wagtail/wagtailadmin/templates/wagtailadmin/skeleton.html
@ -15,6 +15,8 @@
    {% endcompress %}

    {% block css %}{% endblock %}
+
+    {% block branding_favicon %}{% endblock %}
 </head>
 <body class="{% block bodyclass %}{% endblock %} {% if messages %}has-messages{% endif %}">
    <!--[if lt IE 9]>