Improved navigation and breadcrumb labels

Author: nfourtythree

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release Notes for Craft Commerce
 
+## Unreleased
+
+- Improved Craft Commerce navigation and breadcrumb labels.
+
 ## 4.7.3 - 2025-01-22
 
 - Fixed a bug where users products had a “Save as a new product” action even if a plugin was preventing duplication via `craft\services\Elements::EVENT_AUTHORIZE_DUPLICATE`. ([#3819](https://github.com/craftcms/commerce/issues/3819))

src/Plugin.php

@@ -386,14 +386,15 @@ public function getCpNavItem(): ?array
 
         if (Craft::$app->getUser()->checkPermission('commerce-manageStoreSettings')) {
             $ret['subnav']['store-settings'] = [
-                'label' => Craft::t('commerce', 'Store Settings'),
+                'label' => Craft::t('commerce', 'Store Management'),
                 'url' => 'commerce/store-settings',
             ];
         }
 
         if (Craft::$app->getUser()->getIsAdmin() && Craft::$app->getConfig()->getGeneral()->allowAdminChanges) {
             $ret['subnav']['settings'] = [
-                'label' => Craft::t('commerce', 'System Settings'),
+                'ariaLabel' => Craft::t('commerce', 'Commerce Settings'),
+                'label' => Craft::t('app', 'Settings'),
                 'url' => 'commerce/settings',
             ];
         }

src/templates/_layouts/promotions.twig

@@ -4,6 +4,10 @@
 {% set selectedSubnavItem = "promotions" %}
 {% set bodyClass = (bodyClass is defined ? bodyClass~' ' : '') ~ "commercepromotions" %}
 
+{% set crumbs = [
+  { label: 'Commerce'|t('commerce'), url: url('commerce') },
+] %}
+
 {% set sidebarNavItems = {
     sales: { label: 'Sales'|t('commerce'), url: url('commerce/promotions/sales') }
 } %}

src/templates/_layouts/settings.twig

@@ -2,21 +2,29 @@
 {% set selectedSubnavItem = 'settings' %}
 {% set bodyClass = (bodyClass is defined ? bodyClass~' ' : '') ~ "commercesettings" %}
 
-{% set title = "System Settings"|t('commerce') %}
+{% set title = "Settings"|t('app') %}
+
+{% set crumbs = [
+  { label: "Commerce"|t('commerce'), url: url('commerce') },
+] %}
 
 {% set navItems = {} %}
 
 {% if currentUser.admin %}
 {% set navItems = {
     'general': { title: "General Settings"|t('commerce')},
-    'ordersettings': { title: "Order Fields"|t('commerce')},
-    'orderstatuses': { title: "Order Statuses"|t('commerce')},
-    'lineitemstatuses': { title: "Line Item Statuses"|t('commerce')},
     'emails': { title: "Emails"|t('commerce')},
     'pdfs': { title: "PDFs"|t('commerce')},
     'gateways': { title: "Gateways"|t('commerce')},
+
+    'orders-heading': { heading: 'Orders'|t('commerce')},
+    'ordersettings': { title: "Order Fields"|t('commerce')},
+    'orderstatuses': { title: "Order Statuses"|t('commerce')},
+    'lineitemstatuses': { title: "Line Item Statuses"|t('commerce')},
+
     'products-heading': { heading: "Products"|t('commerce')},
     'producttypes': { title: "Product Types"|t('commerce')},
+
     'subscriptions-heading': { heading: "Subscriptions"|t('commerce')},
     'subscriptions/fields': { title: "Subscription Fields"|t('commerce')},
 } %}

src/templates/_layouts/shipping.twig

@@ -4,6 +4,10 @@
 
 {% set title = "Shipping"|t('commerce') %}
 
+{% set crumbs = [
+  { label: 'Commerce'|t('commerce'), url: url('commerce') },
+] %}
+
 {% set navItems = {} %}
 
 {% if currentUser.admin or currentUser.can('commerce-manageShipping') %}

src/templates/_layouts/store-settings.twig

@@ -2,7 +2,11 @@
 {% set selectedSubnavItem = 'store-settings' %}
 {% set bodyClass = (bodyClass is defined ? bodyClass~' ' : '') ~ "commercesettings" %}
 
-{% set title = "Store Settings"|t('commerce') %}
+{% set title = "Store Management"|t('commerce') %}
+
+{% set crumbs = [
+  { label: 'Commerce'|t('commerce'), url: url('commerce') },
+] %}
 
 {% set navItems = {} %}
 

src/templates/_layouts/tax.twig

@@ -4,6 +4,10 @@
 
 {% set title = "Tax"|t('commerce') %}
 
+{% set crumbs = [
+  { label: 'Commerce'|t('commerce'), url: url('commerce') },
+] %}
+
 {% set navItems = {} %}
 
 {% if currentUser.admin or currentUser.can('commerce-manageTaxes') %}

src/templates/orders/_edit.twig

@@ -5,6 +5,7 @@
 {% set bodyClass = (bodyClass is defined ? bodyClass~' ' : '') ~ "commerceorders commerceordersedit" %}
 
 {% set crumbs = [
+    { label: 'Commerce'|t('commerce'), url: url('commerce') },
     { label: "Orders"|t('commerce'), url: url('commerce/orders') }
 ] %}
 

src/templates/orders/_index.twig

@@ -4,6 +4,10 @@
 {% set elementType = 'craft\\commerce\\elements\\Order' %}
 {% set bodyClass = (bodyClass is defined ? bodyClass~' ' : '') ~ "commerceorders commerceordersindex" %}
 
+{% set crumbs = [
+  { label: 'Commerce'|t('commerce'), url: url('commerce') },
+] %}
+
 {% do craft.app.view.registerTranslations('commerce', [
     "Apply",
     "Copy the URL",

src/templates/products/_edit.twig

@@ -6,6 +6,7 @@
 {% set bodyClass = (bodyClass is defined ? bodyClass~' ' : '') ~ "commerceproducts commerceproductsedit" %}
 
 {% set crumbs = [
+    { label: 'Commerce'|t('commerce'), url: url('commerce') },
     { label: "Products"|t('commerce'), url: url('commerce/products') },
     { label: productType.name|t('commerce'), url: url('commerce/products/'~productType.handle) }
 ] %}