Files
breadcrumb-the-shire/templates/partials/app-topbar.phtml
fs c7b8fd516a feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support
Completes the generic module platform that enables modules to contribute
UI elements, runtime JS components, and search resources without any
core hardcoding.

New generic UI slot types:
- topbar.right_item: module-contributed topbar buttons
- layout.body_end_template: module-contributed dialog/overlay templates
- layout.head_style: module-contributed global CSS
- runtime.component: declarative JS component registration with phase ordering

New infrastructure:
- ModuleAutoloader: PSR-4 autoloading for module-local PHP classes
- ModuleRuntimePageBuilder: symlinks module pages into runtime directory
- ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/
- ModulePermissionSynchronizer: syncs module permissions to DB
- CLI scripts: module-runtime-sync, module-build, module-migrate,
  module-permissions-sync, module-assets-sync
- {{userId}} placeholder in SearchDataService for user-scoped search queries
- Component runtime with phased initialization (early/default/late)
- AppContainer.protectExistingBindings() to prevent module→core overwrites
- Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest,
  FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:19:56 +01:00

175 lines
7.9 KiB
PHTML

<?php
use MintyPHP\Session;
$user = $_SESSION['user'] ?? [];
$accountUrl = accountUrl();
$userUuid = trim((string) ($user['uuid'] ?? ''));
$accountEditUrl = $userUuid !== '' ? lurl("admin/users/edit/{$userUuid}") : $accountUrl;
$themes = appThemes();
$theme = currentTheme();
$csrfKey = Session::$csrfSessionKey;
$csrfToken = $_SESSION[$csrfKey] ?? '';
// Tenant switcher data
$currentTenant = $_SESSION['current_tenant'] ?? null;
$currentTenantId = (int) ($currentTenant['id'] ?? 0);
$availableTenants = $_SESSION['available_tenants'] ?? [];
$tenantLabel = trim((string) ($currentTenant['description'] ?? ''));
if ($tenantLabel === '') {
$tenantLabel = t('None');
}
$canSwitchTenant = is_array($currentTenant) && count($availableTenants) > 1;
$allowUserTheme = allowUserTheme();
$layoutAuth = is_array($viewAuth['layout'] ?? null) ? $viewAuth['layout'] : [];
$layoutNav = is_array($layoutNav ?? null) ? $layoutNav : [];
$moduleSlots = is_array($layoutNav['moduleSlots'] ?? null) ? $layoutNav['moduleSlots'] : [];
$moduleTopbarSlots = is_array($moduleSlots['topbar.right_item'] ?? null) ? $moduleSlots['topbar.right_item'] : [];
?>
<header class="app-header" data-app-component="nav-history">
<nav class="app-topbar">
<ul class="app-topbar-left">
<li>
<a id="global-back" data-tooltip-pos="bottom" data-tooltip="<?php e(t('Back')); ?> (Alt+←)" title="<?php e(t('Back')); ?> (Alt+←)" aria-label="<?php e(t('Back')); ?> (Alt+←)" href="admin"><i class="bi bi-arrow-left"></i></a>
</li>
<li>
<a id="global-forward" data-tooltip-pos="bottom" data-tooltip="<?php e(t('Forward')); ?> (Alt+→)" title="<?php e(t('Forward')); ?> (Alt+→)" aria-label="<?php e(t('Forward')); ?> (Alt+→)" href="admin"><i class="bi bi-arrow-right"></i></a>
</li>
<li id="async-messages" role="status" aria-live="polite"></li>
</ul>
<div class="app-topbar-center" aria-hidden="true"></div>
<ul class="app-topbar-right">
<?php if ($canSwitchTenant): ?>
<li class="app-topbar-tenant-slot" data-app-component="tenant-switcher" data-tenant-switcher data-tooltip="<?php e(t('Tenant')); ?>" data-tooltip-pos="bottom">
<details class="dropdown app-topbar-tenant-menu">
<summary class="app-topbar-tenant-chip" aria-label="<?php e(t('Switch tenant')); ?>" title="<?php e($tenantLabel); ?>">
<span class="app-topbar-tenant-name"><?php e($tenantLabel); ?></span>
</summary>
<ul class="app-topbar-menu-list app-topbar-menu-list--right">
<?php foreach ($availableTenants as $tenant): ?>
<?php
$tenantId = (int) ($tenant['id'] ?? 0);
$isActive = $tenantId === $currentTenantId;
$rowLabel = trim((string) ($tenant['description'] ?? ''));
if ($rowLabel === '') {
$rowLabel = t('None');
}
?>
<li>
<a href="#"
class="<?php e($isActive ? 'active' : ''); ?>"
title="<?php e($rowLabel); ?>"
<?php if ($isActive): ?>
aria-current="true"
<?php else: ?>
data-switch-tenant="<?php e((string) $tenantId); ?>"
data-csrf-key="<?php e($csrfKey); ?>"
data-csrf-token="<?php e($csrfToken); ?>"
data-error-message="<?php e(t('Failed to switch tenant')); ?>"
<?php endif; ?>>
<?php e($rowLabel); ?>
<?php if ($isActive): ?>
<i class="bi bi-check"></i>
<?php endif; ?>
</a>
</li>
<?php endforeach; ?>
</ul>
</details>
</li>
<?php endif; ?>
<?php foreach ($moduleTopbarSlots as $slot): ?>
<?php
if (!is_array($slot)) {
continue;
}
$slotPermission = trim((string) ($slot['permission'] ?? ''));
if ($slotPermission !== '' && empty($layoutAuth[$slotPermission])) {
continue;
}
$slotTemplate = trim((string) ($slot['template'] ?? ''));
if ($slotTemplate === '' || !is_file($slotTemplate)) {
continue;
}
include $slotTemplate;
?>
<?php endforeach; ?>
<li>
<details class="dropdown app-topbar-user-menu" data-app-component="theme-controls"
<?php if ($allowUserTheme): ?>
data-theme-menu
data-theme-url="admin/users/theme"
data-csrf-key="<?php e($csrfKey); ?>"
data-csrf-token="<?php e($csrfToken); ?>"
<?php endif; ?>>
<summary aria-label="<?php e(t('Account')); ?>">
<i class="bi bi-person-fill"></i>
</summary>
<ul class="app-topbar-menu-list app-topbar-menu-list--right">
<li class="app-topbar-menu-heading" role="presentation"><small><?php e(t('Navigation')); ?></small></li>
<li>
<button type="button" class="app-topbar-menu-with-hotkey" id="toggle-aside" data-sidebar-toggle data-sidebar-action="visibility" aria-label="<?php e(t('Toggle Sidebar')); ?>">
<span><?php e(t('Toggle Sidebar')); ?></span>
<span class="app-topbar-hotkey" aria-hidden="true">Ctrl/Cmd+B</span>
</button>
</li>
<li class="app-topbar-menu-item-detail-sidebar">
<button type="button" id="toggle-main-content-aside" data-app-component="details-aside-toggle" aria-label="<?php e(t('Toggle Detail Sidebar')); ?>">
<?php e(t('Toggle Detail Sidebar')); ?>
</button>
</li>
<li class="app-topbar-menu-divider" role="separator"></li>
<li class="app-topbar-menu-heading" role="presentation"><small><?php e(t('Display')); ?></small></li>
<?php if ($allowUserTheme): ?>
<?php foreach ($themes as $key => $label): ?>
<?php $isActiveTheme = $key === $theme; ?>
<li>
<a href="#"
data-theme-option
data-theme-value="<?php e($key); ?>"
class="<?php e($isActiveTheme ? 'active' : ''); ?>"
<?php echo $isActiveTheme ? 'aria-current="true"' : ''; ?>>
<?php e(t($label)); ?>
</a>
</li>
<?php endforeach; ?>
<?php endif; ?>
<li>
<button type="button" data-app-component="contrast-toggle" data-contrast-toggle aria-label="<?php e(t('Toggle contrast')); ?>" aria-pressed="false">
<?php e(t('High contrast')); ?>
</button>
</li>
<li class="app-topbar-menu-divider" role="separator"></li>
<li class="app-topbar-menu-heading" role="presentation"><small><?php e(t('Language')); ?></small></li>
<?php
$variant = 'menu-items';
require __DIR__ . '/app-language-switcher.phtml';
unset($variant);
?>
<li class="app-topbar-menu-divider" role="separator"></li>
<li class="app-topbar-menu-heading" role="presentation"><small><?php e(t('Account')); ?></small></li>
<li><a href="<?php e($accountEditUrl); ?>">
<?php e(t('My account')); ?>
</a>
</li>
<li><a href="<?php e(lurl('help/hotkeys')); ?>">
<?php e(t('Keyboard shortcuts')); ?>
</a>
</li>
<li class="app-topbar-menu-divider" role="separator"></li>
<li class="app-topbar-menu-heading" role="presentation"><small><?php e(t('Session')); ?></small></li>
<li><a href="logout">
<?php e(t('Logout')); ?>
</a>
</li>
</ul>
</details>
</li>
</ul>
</nav>
</header>