Add per-language translation support for custom nav links

Author: akanora

javascripts/discourse/initializers/init-nav-bar-additions.js

@@ -1,4 +1,25 @@
 import { withPluginApi } from "discourse/lib/plugin-api";
+import I18n from "I18n";
+
+/**
+ * Resolve a field value from a nav link, checking for a locale-specific
+ * translation first. Falls back to the base field value.
+ */
+function getLocalizedField(link, fieldName) {
+  const translations = link.translations;
+  if (!translations || translations.length === 0) {
+    return link[fieldName];
+  }
+
+  const locale = I18n.currentLocale();
+
+  // Try exact match first (e.g. "pt_BR"), then prefix match (e.g. "pt")
+  const match =
+    translations.find((t) => t.locale === locale) ||
+    translations.find((t) => locale.startsWith(t.locale));
+
+  return (match && match[fieldName]) || link[fieldName];
+}
 
 // Built-in Discourse filter routes that have associated topic counts
 const COUNTED_FILTERS = {
@@ -39,15 +60,14 @@ export default {
         "service:topic-tracking-state"
       );
 
-      for (const {
-        display_name: displayName,
-        title,
-        url,
-      } of settings.nav_links) {
+      for (const link of settings.nav_links) {
+        const { display_name: displayName, url } = link;
+        const localizedDisplayName = getLocalizedField(link, "display_name");
+        const localizedTitle = getLocalizedField(link, "title");
         const filterType = COUNTED_FILTERS[url];
         const itemConfig = {
           name: `custom_${displayName.replace(/\s+/g, "-").toLowerCase()}`,
-          title,
+          title: localizedTitle,
           href: url,
           forceActive: (category, args, router) =>
             router.currentURL?.split("?")[0] === url,
@@ -58,10 +78,12 @@ export default {
           // reactively, picking up count changes from TopicTrackingState
           itemConfig.displayName = () => {
             const count = getCountForFilter(topicTrackingState, filterType);
-            return count > 0 ? `${displayName} (${count})` : displayName;
+            return count > 0
+              ? `${localizedDisplayName} (${count})`
+              : localizedDisplayName;
           };
         } else {
-          itemConfig.displayName = displayName;
+          itemConfig.displayName = localizedDisplayName;
         }
 
         api.addNavigationBarItem(itemConfig);

locales/en.yml

@@ -14,3 +14,16 @@ en:
             url:
               label: URL
               description: The link (e.g., /latest or https://discourse.org)
+            translations:
+              label: Translations
+              description: Per-language overrides for display name and title
+              properties:
+                locale:
+                  label: Language
+                  description: Select the language for this translation
+                display_name:
+                  label: Display name
+                  description: Translated display name for this language
+                title:
+                  label: Title
+                  description: Translated title (hover text) for this language

settings.yml

@@ -32,6 +32,73 @@ nav_links:
           min_length: 1
           max_length: 2048
           url: true
+      translations:
+        type: objects
+        schema:
+          name: translation
+          identifier: locale
+          properties:
+            locale:
+              type: enum
+              required: true
+              choices:
+                - ar
+                - be
+                - bg
+                - bs_BA
+                - ca
+                - cs
+                - da
+                - de
+                - el
+                - en
+                - en_GB
+                - es
+                - et
+                - fa_IR
+                - fi
+                - fr
+                - gl
+                - he
+                - hr
+                - hu
+                - hy
+                - id
+                - it
+                - ja
+                - ko
+                - lt
+                - lv
+                - nb_NO
+                - nl
+                - pl_PL
+                - pt
+                - pt_BR
+                - ro
+                - ru
+                - sk
+                - sl
+                - sq
+                - sr
+                - sv
+                - sw
+                - te
+                - th
+                - tr_TR
+                - ug
+                - uk
+                - ur
+                - vi
+                - zh_CN
+                - zh_TW
+            display_name:
+              type: string
+              validations:
+                max_length: 100
+            title:
+              type: string
+              validations:
+                max_length: 1000
 Hide_dropdowns:
   default: false
   description: