. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Exceptions\HttpAccessDeniedException; use Fisharebest\Webtrees\Factory; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Tree; use Illuminate\Support\Collection; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; use function assert; use function response; use function view; /** * Trait ModuleTabTrait - default implementation of ModuleTabInterface */ trait ModuleTabTrait { /** @var int The default position for this tab. It can be changed in the control panel. */ protected $tab_order; /** * @return string */ abstract public function title(): string; /** * Get a the current access level for a module * * @param Tree $tree * @param string $interface * * @return int */ abstract public function accessLevel(Tree $tree, string $interface): int; /** * Generate the HTML content of this tab. * * @param Individual $individual * * @return string */ abstract public function getTabContent(Individual $individual): string; /** * The text that appears on the tab. * * @return string */ public function tabTitle(): string { return $this->title(); } /** * Users change change the order of tabs using the control panel. * * @param int $tab_order * * @return void */ public function setTabOrder(int $tab_order): void { $this->tab_order = $tab_order; } /** * Users change change the order of tabs using the control panel. * * @return int */ public function getTabOrder(): int { return $this->tab_order ?? $this->defaultTabOrder(); } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 9999; } /** * This module handles the following facts - so don't show them on the "Facts and events" tab. * * @return Collection */ public function supportedFacts(): Collection { return new Collection(); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getTabAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $xref = $request->getQueryParams()['xref']; $record = Factory::individual()->make($xref, $tree); $record = Auth::checkIndividualAccess($record); $user = $request->getAttribute('user'); if ($this->accessLevel($tree, 'tab') < Auth::accessLevel($tree, $user)) { throw new HttpAccessDeniedException(); } $layout = view('layouts/ajax', [ 'content' => $this->getTabContent($record), ]); return response($layout); } }