. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Exceptions\IndividualAccessDeniedException; use Fisharebest\Webtrees\Exceptions\IndividualNotFoundException; use Fisharebest\Webtrees\Factory; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Module\InteractiveTree\TreeView; use Fisharebest\Webtrees\Tree; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; use function assert; /** * Class InteractiveTreeModule * Tip : you could change the number of generations loaded before ajax calls both in individual page and in treeview page to optimize speed and server load */ class InteractiveTreeModule extends AbstractModule implements ModuleChartInterface, ModuleTabInterface { use ModuleChartTrait; use ModuleTabTrait; /** * 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('Interactive tree'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Interactive tree” module */ return I18N::translate('An interactive tree, showing all the ancestors and descendants of an individual.'); } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 7; } /** * Generate the HTML content of this tab. * * @param Individual $individual * * @return string */ public function getTabContent(Individual $individual): string { $treeview = new TreeView('tvTab'); [$html, $js] = $treeview->drawViewport($individual, 3); return view('modules/interactive-tree/tab', [ 'html' => $html, 'js' => $js, ]); } /** * Is this tab empty? If so, we don't always need to display it. * * @param Individual $individual * * @return bool */ public function hasTabContent(Individual $individual): bool { return $individual->facts(['FAMC', 'FAMS'])->isNotEmpty(); } /** * A greyed out tab has no actual content, but may perhaps have * options to create content. * * @param Individual $individual * * @return bool */ public function isGrayedOut(Individual $individual): bool { return false; } /** * Can this tab load asynchronously? * * @return bool */ public function canLoadAjax(): bool { return true; } /** * CSS class for the URL. * * @return string */ public function chartMenuClass(): string { return 'menu-chart-tree'; } /** * Return a menu item for this chart - for use in individual boxes. * * @param Individual $individual * * @return Menu|null */ public function chartBoxMenu(Individual $individual): ?Menu { return $this->chartMenu($individual); } /** * The title for a specific instance of this chart. * * @param Individual $individual * * @return string */ public function chartTitle(Individual $individual): string { /* I18N: %s is an individual’s name */ return I18N::translate('Interactive tree of %s', $individual->fullName()); } /** * The URL for this chart. * * @param Individual $individual * @param mixed[] $parameters * * @return string */ public function chartUrl(Individual $individual, array $parameters = []): string { return route('module', [ 'module' => $this->name(), 'action' => 'Chart', 'xref' => $individual->xref(), 'tree' => $individual->tree()->name(), ] + $parameters); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getChartAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $xref = $request->getQueryParams()['xref']; $individual = Factory::individual()->make($xref, $tree); $individual = Auth::checkIndividualAccess($individual, false, true); $user = $request->getAttribute('user'); Auth::checkComponentAccess($this, ModuleChartInterface::class, $tree, $user); $tv = new TreeView('tv'); [$html, $js] = $tv->drawViewport($individual, 4); return $this->viewResponse('modules/interactive-tree/page', [ 'html' => $html, 'individual' => $individual, 'js' => $js, 'module' => $this->name(), 'title' => $this->chartTitle($individual), 'tree' => $tree, ]); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function postChartAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $params = (array) $request->getParsedBody(); return redirect(route('module', [ 'module' => $this->name(), 'action' => 'Chart', 'tree' => $tree->name(), 'xref' => $params['xref'] ?? '', ])); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getDetailsAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $pid = $request->getQueryParams()['pid']; $individual = Factory::individual()->make($pid, $tree); if ($individual === null) { throw new IndividualNotFoundException(); } if (!$individual->canShow()) { throw new IndividualAccessDeniedException(); } $instance = $request->getQueryParams()['instance']; $treeview = new TreeView($instance); return response($treeview->getDetails($individual)); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getIndividualsAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $q = $request->getQueryParams()['q']; $instance = $request->getQueryParams()['instance']; $treeview = new TreeView($instance); return response($treeview->getIndividuals($tree, $q)); } }