cleaned up navigation

Author: lachiebol

app/routes/page.php

@@ -116,7 +116,6 @@ function renderGuide(Slim\Views\Twig $view, Response $response, Psr\Http\Message
         'selectedPiwikVersion' => Environment::getPiwikVersion(),
         'urlIfAvailableInNewerVersion' => (Environment::isLatestPiwikVersion() ? false : Url::getUrlIfDocumentIsAvailableInPiwikVersion($request->getUri()->getPath(), LATEST_PIWIK_DOCS_VERSION)),
         'pluginSpecs' => $pluginSpecs,
-        'hideGuideSections' => true,
     ]);
 });
 

app/templates/api-swagger-index.twig

@@ -62,6 +62,52 @@
                 return button;
             }
 
+            function sectionContainsTarget(section, targetId) {
+                if (section.heading.id === targetId) {
+                    return true;
+                }
+
+                return section.elements.some(function (element) {
+                    if (element.id === targetId) {
+                        return true;
+                    }
+
+                    return Array.prototype.some.call(element.querySelectorAll('[id]'), function (child) {
+                        return child.id === targetId;
+                    });
+                });
+            }
+
+            function scrollToHashTarget(targetId) {
+                let target = document.getElementById(targetId);
+                if (!target) {
+                    return;
+                }
+
+                target.scrollIntoView();
+            }
+
+            function expandSectionForHash(sections, hash) {
+                let targetId = (hash || '').replace(/^#/, '');
+                if (!targetId) {
+                    return;
+                }
+
+                let didExpand = false;
+                sections.forEach(function (section) {
+                    if (sectionContainsTarget(section, targetId)) {
+                        setSectionCollapsedState(section, false);
+                        didExpand = true;
+                    }
+                });
+
+                if (didExpand) {
+                    window.requestAnimationFrame(function () {
+                        scrollToHashTarget(targetId);
+                    });
+                }
+            }
+
             function initCollapsibleSections() {
                 let docsParent = document.querySelector('.documentation');
                 if (!docsParent) {
@@ -117,6 +163,12 @@
                 collapsibleSections.forEach(function (section) {
                     setSectionCollapsedState(section, true);
                 });
+
+                expandSectionForHash(collapsibleSections, window.location.hash);
+
+                window.addEventListener('hashchange', function () {
+                    expandSectionForHash(collapsibleSections, window.location.hash);
+                });
             }
 
             if (document.readyState === 'loading') {

app/templates/left-menu.twig

@@ -42,7 +42,7 @@
         </div>
     {% endif %}
 
-    {% if pluginSpecs is defined and pluginSpecs is not empty %}
+    {% if pluginSpecs is defined and pluginSpecs is not empty and hideGuideSections|default(false) %}
         <div class="guide-sections panel panel-default">
             <div class="panel-heading">
                 <h4 class="panel-title">