From 7800fcbbcecbf98a645f23ef63cbbd174312045c Mon Sep 17 00:00:00 2001
From: Marcel Werk <burntime@woltlab.com>
Date: Tue, 26 May 2026 20:09:24 +0200
Subject: [PATCH] Add breadcrumb navigation to the ACP

Introduces an `acpBreadcrumbs` component rendered above the page content via the new `breadcrumbs.tpl` template. The breadcrumb path is derived from the active ACP menu items through the new `ACPMenu::getBreadcrumbs()` method, which returns the menu items from the top-level section down to the immediate parent of the current page.

Also reduces the top padding of the main content area to account for the additional breadcrumb row.
---
 wcfsetup/install/files/acp/style/layout.scss  | 34 ++++++++++++++++++-
 .../files/acp/templates/breadcrumbs.tpl       | 27 +++++++++++++++
 .../install/files/acp/templates/header.tpl    |  4 +--
 .../lib/system/menu/acp/ACPMenu.class.php     | 27 +++++++++++++++
 4 files changed, 89 insertions(+), 3 deletions(-)
 create mode 100644 wcfsetup/install/files/acp/templates/breadcrumbs.tpl

diff --git a/wcfsetup/install/files/acp/style/layout.scss b/wcfsetup/install/files/acp/style/layout.scss
index 415110cee2f..ede9f81303e 100644
--- a/wcfsetup/install/files/acp/style/layout.scss
+++ b/wcfsetup/install/files/acp/style/layout.scss
@@ -508,7 +508,7 @@ html[data-color-scheme="dark"] {
 	flex: 1 1 auto;
 
 	@include screen-lg {
-		padding: 40px 0;
+		padding: 30px 0;
 	}
 
 	@include screen-md-down {
@@ -1066,3 +1066,35 @@ html[data-color-scheme="dark"] {
 
 	@include wcfFontSmall;
 }
+
+.acpBreadcrumbs {
+	margin-bottom: 5px;
+}
+
+.acpBreadcrumbs__list {
+	display: flex;
+	align-items: center;
+	gap: 5px;
+	color: var(--wcfContentDimmedText);
+
+	@include wcfFontSmall;
+}
+
+.acpBreadcrumbs__item {
+	display: flex;
+	align-items: center;
+	gap: 5px;
+}
+
+.acpBreadcrumbs__item__separator {
+	display: flex;
+}
+
+.acpBreadcrumbs__item__link {
+	color: inherit;
+
+	&:hover {
+		color: inherit;
+		text-decoration: underline;
+	}
+}
diff --git a/wcfsetup/install/files/acp/templates/breadcrumbs.tpl b/wcfsetup/install/files/acp/templates/breadcrumbs.tpl
new file mode 100644
index 00000000000..ccab66308ea
--- /dev/null
+++ b/wcfsetup/install/files/acp/templates/breadcrumbs.tpl
@@ -0,0 +1,27 @@
+{if PACKAGE_ID && $__wcf->user->userID && $__isLogin|empty}
+	{hascontent}
+		<nav class="acpBreadcrumbs" aria-label="{lang}wcf.page.breadcrumb{/lang}">
+			<ol class="acpBreadcrumbs__list">
+				{content}
+					{foreach from=$__wcf->getACPMenu()->getBreadcrumbs() item='acpBreadcrumb' name='acpBreadcrumbs'}
+						<li class="acpBreadcrumbs__item">
+							{if $acpBreadcrumb->getLink()}
+								<a class="acpBreadcrumbs__item__link" href="{$acpBreadcrumb->getLink()}">
+									<span class="acpBreadcrumbs__item__title">{$acpBreadcrumb}</span>
+								</a>
+							{else}
+								<span class="acpBreadcrumbs__item__title">{$acpBreadcrumb}</span>
+							{/if}
+
+							{if !$tpl.foreach.acpBreadcrumbs.last}
+								<span class="acpBreadcrumbs__item__separator" aria-hidden="true">
+									<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 6l6 6-6 6"></path></svg>
+								</span>
+							{/if}
+						</li>
+					{/foreach}
+				{/content}
+			</ol>
+		</nav>
+	{/hascontent}
+{/if}
diff --git a/wcfsetup/install/files/acp/templates/header.tpl b/wcfsetup/install/files/acp/templates/header.tpl
index fc96b0af478..250ba7c5eb5 100644
--- a/wcfsetup/install/files/acp/templates/header.tpl
+++ b/wcfsetup/install/files/acp/templates/header.tpl
@@ -188,8 +188,8 @@
 		
 		<div id="acpPageContentContainer" class="acpPageContentContainer">
 			{include file='pageMenu'}
-			
+
 			<section id="main" class="main" role="main">
 				<div class="layoutBoundary">
 					<div id="content" class="content">
-					
+						{include file='breadcrumbs'}
diff --git a/wcfsetup/install/files/lib/system/menu/acp/ACPMenu.class.php b/wcfsetup/install/files/lib/system/menu/acp/ACPMenu.class.php
index e30d6c06e6a..51fb22dc912 100644
--- a/wcfsetup/install/files/lib/system/menu/acp/ACPMenu.class.php
+++ b/wcfsetup/install/files/lib/system/menu/acp/ACPMenu.class.php
@@ -115,4 +115,31 @@ protected function removeEmptyItems(string $parentMenuItem = '')
             }
         }
     }
+
+    /**
+     * Returns the breadcrumb items for the active menu path, ordered from the
+     * top-level section down to the immediate parent of the current page. The
+     * current page itself is omitted.
+     *
+     * @return AcpMenuItem[]
+     * @since 6.3
+     */
+    public function getBreadcrumbs(): array
+    {
+        if ($this->activeMenuItems === []) {
+            return [];
+        }
+
+        $names = \array_reverse($this->activeMenuItems);
+        \array_pop($names);
+
+        $breadcrumbs = [];
+        foreach ($names as $name) {
+            if (isset($this->menuItemList[$name])) {
+                $breadcrumbs[] = $this->menuItemList[$name];
+            }
+        }
+
+        return $breadcrumbs;
+    }
 }