. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Functions\FunctionsEdit; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Services\ChartService; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; /** * Class PedigreeChartModule */ class PedigreeChartModule extends AbstractModule implements ModuleChartInterface { use ModuleChartTrait; // Defaults protected const DEFAULT_GENERATIONS = '4'; // Limits protected const MAX_GENERATIONS = 12; protected const MIN_GENERATIONS = 2; // Chart orientation options. These are used to generate icons, views, etc. public const ORIENTATION_LEFT = 'left'; public const ORIENTATION_RIGHT = 'right'; public const ORIENTATION_UP = 'up'; public const ORIENTATION_DOWN = 'down'; protected const MIRROR_ORIENTATION = [ self::ORIENTATION_UP => self::ORIENTATION_DOWN, self::ORIENTATION_DOWN => self::ORIENTATION_UP, self::ORIENTATION_LEFT => self::ORIENTATION_RIGHT, self::ORIENTATION_RIGHT => self::ORIENTATION_LEFT, ]; protected const DEFAULT_ORIENTATION = self::ORIENTATION_RIGHT; /** @var ChartService */ private $chart_service; /** * PedigreeChartModule constructor. * * @param ChartService $chart_service */ public function __construct(ChartService $chart_service) { $this->chart_service = $chart_service; } /** * How should this module be identified in the control panel, etc.? * * @return string */ public function title(): string { /* I18N: Name of a module/chart */ return I18N::translate('Pedigree'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “PedigreeChart” module */ return I18N::translate('A chart of an individual’s ancestors, formatted as a tree.'); } /** * CSS class for the URL. * * @return string */ public function chartMenuClass(): string { return 'menu-chart-pedigree'; } /** * 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('Pedigree tree of %s', $individual->fullName()); } /** * A form to request the chart parameters. * * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getChartAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); $user = $request->getAttribute('user'); $ajax = $request->getQueryParams()['ajax'] ?? ''; $xref = $request->getQueryParams()['xref'] ?? ''; $individual = Individual::getInstance($xref, $tree); Auth::checkIndividualAccess($individual); Auth::checkComponentAccess($this, 'chart', $tree, $user); $orientation = $request->getQueryParams()['orientation'] ?? static::DEFAULT_ORIENTATION; $generations = (int) ($request->getQueryParams()['generations'] ?? static::DEFAULT_GENERATIONS); $generations = min(static::MAX_GENERATIONS, $generations); $generations = max(static::MIN_GENERATIONS, $generations); $generation_options = $this->generationOptions(); if ($ajax === '1') { return $this->chart($individual, $orientation, $generations, $this->chart_service); } $ajax_url = $this->chartUrl($individual, [ 'ajax' => true, 'generations' => $generations, 'orientation' => $orientation, ]); return $this->viewResponse('modules/pedigree-chart/page', [ 'ajax_url' => $ajax_url, 'generations' => $generations, 'generation_options' => $generation_options, 'individual' => $individual, 'module_name' => $this->name(), 'orientation' => $orientation, 'orientations' => $this->orientations(), 'title' => $this->chartTitle($individual), ]); } /** * @param Individual $individual * @param string $orientation * @param int $generations * @param ChartService $chart_service * * @return ResponseInterface */ public function chart(Individual $individual, string $orientation, int $generations, ChartService $chart_service): ResponseInterface { $ancestors = $chart_service->sosaStradonitzAncestors($individual, $generations); // Father’s ancestors link to the father’s pedigree // Mother’s ancestors link to the mother’s pedigree.. $links = $ancestors->map(function (?Individual $individual, $sosa) use ($ancestors, $orientation, $generations): string { if ($individual instanceof Individual && $sosa >= 2 ** $generations / 2 && $individual->childFamilies()->isNotEmpty()) { // The last row/column, and there are more generations. if ($sosa >= 2 ** $generations * 3 / 4) { return $this->nextLink($ancestors->get(3), $orientation, $generations); } return $this->nextLink($ancestors->get(2), $orientation, $generations); } // A spacer to fix the "Left" layout. return ''; }); // Root individual links to their children. $links->put(1, $this->previousLink($individual, $orientation, $generations)); $html = view('modules/pedigree-chart/chart', [ 'ancestors' => $ancestors, 'generations' => $generations, 'orientation' => $orientation, 'layout' => 'right', 'links' => $links, ]); return response($html); } /** * Build a menu for the chart root individual * * @param Individual $individual * @param string $orientation * @param int $generations * * @return string */ public function nextLink(Individual $individual, string $orientation, int $generations): string { $icon = view('icons/arrow-' . $orientation); $title = $this->chartTitle($individual); $url = $this->chartUrl($individual, [ 'orientation' => $orientation, 'generations' => $generations, ]); return '' . $icon . '' . $title . ''; } /** * Build a menu for the chart root individual * * @param Individual $individual * @param string $orientation * @param int $generations * * @return string */ public function previousLink(Individual $individual, string $orientation, int $generations): string { $icon = view('icons/arrow-' . self::MIRROR_ORIENTATION[$orientation]); $siblings = []; $spouses = []; $children = []; foreach ($individual->childFamilies() as $family) { foreach ($family->children() as $child) { if ($child !== $individual) { $siblings[] = $this->individualLink($child, $orientation, $generations); } } } foreach ($individual->spouseFamilies() as $family) { foreach ($family->spouses() as $spouse) { if ($spouse !== $individual) { $spouses[] = $this->individualLink($spouse, $orientation, $generations); } } foreach ($family->children() as $child) { $children[] = $this->individualLink($child, $orientation, $generations); } } return view('modules/pedigree-chart/previous', [ 'icon' => $icon, 'individual' => $individual, 'generations' => $generations, 'orientation' => $orientation, 'chart' => $this, 'siblings' => $siblings, 'spouses' => $spouses, 'children' => $children, ]); } /** * @param Individual $individual * @param string $orientation * @param int $generations * * @return string */ protected function individualLink(Individual $individual, string $orientation, int $generations): string { $text = $individual->fullName(); $title = $this->chartTitle($individual); $url = $this->chartUrl($individual, [ 'orientation' => $orientation, 'generations' => $generations, ]); return '' . $text . ''; } /** * @return string[] */ protected function generationOptions(): array { return FunctionsEdit::numericOptions(range(static::MIN_GENERATIONS, static::MAX_GENERATIONS)); } /** * @return string[] */ protected function orientations(): array { return [ self::ORIENTATION_LEFT => I18N::translate('Left'), self::ORIENTATION_RIGHT => I18N::translate('Right'), self::ORIENTATION_UP => I18N::translate('Up'), self::ORIENTATION_DOWN => I18N::translate('Down'), ]; } }