. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Services\ModuleService; use Fisharebest\Webtrees\Tree; /** * Class ListsMenuModule - provide a menu option for the lists */ class ListsMenuModule extends AbstractModule implements ModuleMenuInterface { use ModuleMenuTrait; private ModuleService $module_service; /** * @param ModuleService $module_service */ public function __construct(ModuleService $module_service) { $this->module_service = $module_service; } /** * How should this module be identified in the control panel, etc.? * * @return string */ public function title(): string { /* I18N: Name of a module */ return I18N::translate('Lists'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Lists” module */ return I18N::translate('The lists menu.'); } /** * The default position for this menu. It can be changed in the control panel. * * @return int */ public function defaultMenuOrder(): int { return 3; } /** * A menu, to be added to the main application menu. * * @param Tree $tree * * @return Menu|null */ public function getMenu(Tree $tree): Menu|null { $submenus = $this->module_service->findByComponent(ModuleListInterface::class, $tree, Auth::user()) ->map(static fn(ModuleListInterface $module): Menu|null => $module->listMenu($tree)) ->filter() ->sort(static fn(Menu $x, Menu $y): int => I18N::comparator()($x->getLabel(), $y->getLabel())); if ($submenus->isEmpty()) { return null; } return new Menu(I18N::translate('Lists'), '#', 'menu-list', [], $submenus->all()); } }