. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Registry; use Fisharebest\Webtrees\Services\ModuleService; use Fisharebest\Webtrees\Tree; use Fisharebest\Webtrees\Validator; use Psr\Http\Message\ServerRequestInterface; /** * Class ReportsMenuModule - provide a menu option for the reports */ class ReportsMenuModule 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('Reports'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Reports” module */ return I18N::translate('The reports menu.'); } /** * The default position for this menu. It can be changed in the control panel. * * @return int */ public function defaultMenuOrder(): int { return 5; } /** * A menu, to be added to the main application menu. * * @param Tree $tree * * @return Menu|null */ public function getMenu(Tree $tree): Menu|null { $request = Registry::container()->get(ServerRequestInterface::class); $xref = Validator::attributes($request)->isXref()->string('xref', ''); $individual = $tree->significantIndividual(Auth::user(), $xref); $submenus = $this->module_service->findByComponent(ModuleReportInterface::class, $tree, Auth::user()) ->map(static fn(ModuleReportInterface $module): Menu => $module->getReportMenu($individual)) ->sort(static fn(Menu $x, Menu $y): int => I18N::comparator()($x->getLabel(), $y->getLabel())); if ($submenus->isEmpty()) { return null; } return new Menu(I18N::translate('Reports'), '#', 'menu-report', ['rel' => 'nofollow'], $submenus->all()); } }