From 321b97deb20a480870a0dc71ae600ae176f3f27d Mon Sep 17 00:00:00 2001
From: zPlus <zplus@peers.community>
Date: Aug 02 2020 12:06:06 +0000
Subject: Allow a theme or a blueprint to inject custom buttons in the navigation bar.


---

diff --git a/doc/usage/theming.rst b/doc/usage/theming.rst
index ed66a6a..21b2dc0 100644
--- a/doc/usage/theming.rst
+++ b/doc/usage/theming.rst
@@ -68,6 +68,22 @@ This navbar element is the topbar in Pagure. For example:
     {% set masthead_class = "navbar-dark bg-dark" %}
 
 
+`masthead_navbar_items()` macro
+###############################
+
+A Jinja macro that allows themes to inject custom items in the Pagure navigation
+bar. Example:
+
+::
+
+    {% macro masthead_navbar_items() %}
+        <li class="nav-item ml-3">
+            <a class="nav-link font-weight-bold" href="...">
+                Foobar
+            </a>
+        </li>
+    {% endmacro %}
+
 
 `site_title` variable
 #####################
diff --git a/pagure/templates/master.html b/pagure/templates/master.html
index 5227fc2..8a50cd8 100644
--- a/pagure/templates/master.html
+++ b/pagure/templates/master.html
@@ -23,6 +23,13 @@
              alt="pagure Logo" id="pagureLogo"/>
         </a>
         <ul class="navbar-nav ml-auto">
+
+          {# These two lines allow a theme or a blueprint to inject custom
+           # buttons in the navigation bar.
+           #}
+          {{theme.masthead_navbar_items() if theme.masthead_navbar_items is defined}}
+          {% block masthead_navbar_items %}{% endblock %}
+
           {% if not nologin %}
           {% if g.fas_user %}
           <li class="nav-item ml-3">