FEATURE: Add link to Docs in top menu (#34)

Added a plugin setting so admins have the choice of including a link to Docs in the top menu.

assets/javascripts/discourse/initializers/setup-docs.js.es6

@@ -1,6 +1,13 @@
 import { withPluginApi } from "discourse/lib/plugin-api";
+import I18n from "I18n";
+
+function initialize(api, container) {
+  const siteSettings = container.lookup("site-settings:main");
+
+  if (!siteSettings.docs_enabled) {
+    return;
+  }
 
-function initialize(api) {
   api.decorateWidget("hamburger-menu:generalLinks", () => {
     return {
       route: "docs",
@@ -10,16 +17,20 @@ function initialize(api) {
   });
 
   api.addKeyboardShortcut("g e", "", { path: "/docs" });
+
+  if (siteSettings.docs_add_to_top_menu) {
+    api.addNavigationBarItem({
+      name: "docs",
+      displayName: I18n.t("docs.title"),
+      href: "/docs",
+    });
+  }
 }
 
 export default {
   name: "setup-docs",
 
   initialize(container) {
-    const siteSettings = container.lookup("site-settings:main");
+    withPluginApi("0.8", (api) => initialize(api, container));
-    if (!siteSettings.docs_enabled) {
-      return;
-    }
-    withPluginApi("0.8", (api) => initialize(api));
   },
 };

config/locales/client.en.yml

@@ -1,5 +1,8 @@
 en:
   js:
+    filters:
+      docs:
+        help: "browse docs topics"
     docs:
       title: "Docs"
       column_titles:

config/locales/server.en.yml

@@ -4,3 +4,4 @@ en:
     docs_categories: "A list of category slugs to include in docs"
     docs_tags: "A list of tags to include in docs"
     docs_add_solved_filter: "Adds a filter for solved topics -- requires Discourse Solved to be installed and enabled"
+    docs_add_to_top_menu: "Adds a link to the top menu to navigate to the Docs view"

config/settings.yml

@@ -13,3 +13,6 @@ plugins:
   docs_add_solved_filter:
     default: false
     client: true
+  docs_add_to_top_menu:
+    default: false
+    client: true