1
0
Files
breadcrumb-the-shire/pages/admin/docs/index($slug).php
fs b749b5d192 feat: centralize breadcrumbs in topbar and remove history navigation
Move breadcrumb rendering from individual page templates into the core
topbar. Each page now sets $breadcrumbs in its action .php file; the
topbar renders it automatically via the shared partial.

- Remove global back/forward buttons and app-nav-history.js component
- Remove Alt+Arrow keyboard shortcuts for history navigation
- Render breadcrumb in topbar-left section (replaces button area)
- Clean up breadcrumb CSS: context-neutral base (flex, no margin)
- Recalculate sticky titlebar offset in details container
- Migrate all 41 pages (core + helpdesk, audit, addressbook, api-docs)
- Add missing breadcrumbs to addressbook detail view
- Update architecture contract tests (nav-history references removed)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-05 17:17:06 +02:00

65 lines
1.8 KiB
PHP

<?php
use MintyPHP\Buffer;
use MintyPHP\Http\Request;
use MintyPHP\Router;
use MintyPHP\Service\Docs\DocsCatalogService;
use MintyPHP\Support\Guard;
Guard::requireLogin();
Guard::requireAbility(\MintyPHP\Service\Access\OperationsAuthorizationPolicy::ABILITY_ADMIN_DOCS_VIEW);
$docGroups = DocsCatalogService::docGroups();
$allDocs = DocsCatalogService::allDocs();
if ($allDocs === []) {
Router::redirect('error/not_found?url=' . urlencode(Request::pathWithQuery()));
return;
}
$defaultSlug = DocsCatalogService::defaultSlug();
$slug = trim((string) ($slug ?? ''));
if ($slug === '') {
Router::redirect('admin/docs/' . $defaultSlug);
return;
}
if (!array_key_exists($slug, $allDocs)) {
Router::redirect('error/not_found?url=' . urlencode(Request::pathWithQuery()));
return;
}
$rawMarkdown = DocsCatalogService::readMarkdown($slug);
if ($rawMarkdown === null) {
Router::redirect('error/not_found?url=' . urlencode(Request::pathWithQuery()));
return;
}
$prepared = DocsCatalogService::prepareRenderedDocument($rawMarkdown, [1, 2, 3]);
$renderedHtml = (string) $prepared['html'];
$tocItems = [];
foreach ($prepared['headings'] as $heading) {
$level = (int) $heading['level'];
if (!in_array($level, [2, 3], true)) {
continue;
}
$tocItems[] = [
'level' => $level,
'text' => (string) $heading['text'],
'anchor' => (string) $heading['anchor'],
];
}
$currentSlug = $slug;
$currentTitle = (string) $allDocs[$slug];
Buffer::set('title', $currentTitle . ' - ' . t('Documentation'));
$breadcrumbs = [
['label' => t('Home'), 'path' => 'admin'],
['label' => t('Documentation'), 'path' => 'admin/docs/' . $defaultSlug],
['label' => $currentTitle],
];
Buffer::set('style_groups', json_encode(['docs']));
Buffer::set('docs_rendered_html', $renderedHtml);