. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Contracts\UserInterface; use Fisharebest\Webtrees\Family; use Fisharebest\Webtrees\Functions\FunctionsCharts; use Fisharebest\Webtrees\Functions\FunctionsPrint; use Fisharebest\Webtrees\Gedcom; use Fisharebest\Webtrees\GedcomTag; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Services\ChartService; use Fisharebest\Webtrees\Tree; use Illuminate\Support\Collection; use Ramsey\Uuid\Uuid; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; /** * Class DescendancyChartModule */ class DescendancyChartModule extends AbstractModule implements ModuleChartInterface { use ModuleChartTrait; // Chart styles public const CHART_STYLE_LIST = 0; public const CHART_STYLE_BOOKLET = 1; public const CHART_STYLE_INDIVIDUALS = 2; public const CHART_STYLE_FAMILIES = 3; // Defaults public const DEFAULT_STYLE = self::CHART_STYLE_LIST; public const DEFAULT_GENERATIONS = '3'; // Limits public const MINIMUM_GENERATIONS = 2; public const MAXIMUM_GENERATIONS = 10; /** @var int[] */ protected $dabo_num = []; /** @var string[] */ protected $dabo_sex = []; /** * 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('Descendants'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “DescendancyChart” module */ return I18N::translate('A chart of an individual’s descendants.'); } /** * CSS class for the URL. * * @return string */ public function chartMenuClass(): string { return 'menu-chart-descendants'; } /** * 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('Descendants of %s', $individual->fullName()); } /** * A form to request the chart parameters. * * @param Request $request * @param Tree $tree * @param UserInterface $user * @param ChartService $chart_service * * @return Response */ public function getChartAction(Request $request, Tree $tree, UserInterface $user, ChartService $chart_service): Response { $ajax = (bool) $request->get('ajax'); $xref = $request->get('xref', ''); $individual = Individual::getInstance($xref, $tree); Auth::checkIndividualAccess($individual); Auth::checkComponentAccess($this, 'chart', $tree, $user); $chart_style = (int) $request->get('chart_style', self::DEFAULT_STYLE); $generations = (int) $request->get('generations', self::DEFAULT_GENERATIONS); $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); if ($ajax) { return $this->chart($request, $tree, $chart_service); } $ajax_url = $this->chartUrl($individual, [ 'chart_style' => $chart_style, 'generations' => $generations, 'ajax' => true, ]); return $this->viewResponse('modules/descendancy_chart/page', [ 'ajax_url' => $ajax_url, 'chart_style' => $chart_style, 'chart_styles' => $this->chartStyles(), 'default_generations' => self::DEFAULT_GENERATIONS, 'generations' => $generations, 'individual' => $individual, 'maximum_generations' => self::MAXIMUM_GENERATIONS, 'minimum_generations' => self::MINIMUM_GENERATIONS, 'module_name' => $this->name(), 'title' => $this->chartTitle($individual), ]); } /** * @param Request $request * @param Tree $tree * @param ChartService $chart_service * * @return Response */ public function chart(Request $request, Tree $tree, ChartService $chart_service): Response { $this->layout = 'layouts/ajax'; $xref = $request->get('xref', ''); $individual = Individual::getInstance($xref, $tree); Auth::checkIndividualAccess($individual); $chart_style = (int) $request->get('chart_style', self::DEFAULT_STYLE); $generations = (int) $request->get('generations', self::DEFAULT_GENERATIONS); $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); switch ($chart_style) { case self::CHART_STYLE_LIST: default: return $this->descendantsList($individual, $generations); case self::CHART_STYLE_BOOKLET: return $this->descendantsBooklet($individual, $generations); case self::CHART_STYLE_INDIVIDUALS: $individuals = $chart_service->descendants($individual, $generations - 1); return $this->descendantsIndividuals($tree, $individuals); case self::CHART_STYLE_FAMILIES: $families = $chart_service->descendantFamilies($individual, $generations - 1); return $this->descendantsFamilies($tree, $families); } } /** * Show a hierarchical list of descendants * * @TODO replace ob_start() with views. * * @param Individual $individual * @param int $generations * * @return Response */ private function descendantsList(Individual $individual, int $generations): Response { ob_start(); echo ''; $html = ob_get_clean(); return new Response($html); } /** * print a child descendancy * * @param Individual $person * @param int $depth the descendancy depth to show * @param int $generations * * @return void */ private function printChildDescendancy(Individual $person, $depth, int $generations): void { echo '
  • '; echo ''; // check if child has parents and add an arrow echo ''; echo ''; echo '
    '; if ($depth == $generations) { echo ''; } else { echo ''; echo ''; } echo FunctionsPrint::printPedigreePerson($person); echo ''; foreach ($person->childFamilies() as $cfamily) { foreach ($cfamily->spouses() as $parent) { echo '' . view('icons/arrow-up') . '' . I18N::translate('Start at parents') . ''; // only show the arrow for one of the parents break; } } // d'Aboville child number $level = $generations - $depth; echo '

     '; echo ''; //needed so that RTL languages will display this properly if (!isset($this->dabo_num[$level])) { $this->dabo_num[$level] = 0; } $this->dabo_num[$level]++; $this->dabo_num[$level + 1] = 0; $this->dabo_sex[$level] = $person->sex(); for ($i = 0; $i <= $level; $i++) { $isf = $this->dabo_sex[$i]; if ($isf === 'M') { $isf = ''; } if ($isf === 'U') { $isf = 'NN'; } echo ' ' . $this->dabo_num[$i] . ' '; if ($i < $level) { echo '.'; } } echo ''; echo '
    '; echo '
  • '; // loop for each spouse foreach ($person->spouseFamilies() as $family) { $this->printFamilyDescendancy($person, $family, $depth, $generations); } } /** * print a family descendancy * * @param Individual $person * @param Family $family * @param int $depth the descendancy depth to show * @param int $generations * * @return void */ private function printFamilyDescendancy(Individual $person, Family $family, int $depth, int $generations): void { $uid = Uuid::uuid4()->toString(); // create a unique ID // print marriage info echo '
  • '; echo ''; echo ''; echo ''; if ($family->canShow()) { foreach ($family->facts(Gedcom::MARRIAGE_EVENTS) as $fact) { echo ' ', $fact->summary(), ''; } } echo ''; // print spouse $spouse = $family->spouse($person); echo ''; echo '
  • '; } /** * Show a tabular list of individual descendants. * * @param Tree $tree * @param Collection $individuals * * @return Response */ private function descendantsIndividuals(Tree $tree, Collection $individuals): Response { $this->layout = 'layouts/ajax'; return $this->viewResponse('lists/individuals-table', [ 'individuals' => $individuals, 'sosa' => false, 'tree' => $tree, ]); } /** * Show a tabular list of individual descendants. * * @param Tree $tree * @param Collection $families * * @return Response */ private function descendantsFamilies(Tree $tree, Collection $families): Response { $this->layout = 'layouts/ajax'; return $this->viewResponse('lists/families-table', [ 'families' => $families, 'tree' => $tree, ]); } /** * Show a booklet view of descendants * * @TODO replace ob_start() with views. * * @param Individual $individual * @param int $generations * * @return Response */ private function descendantsBooklet(Individual $individual, int $generations): Response { ob_start(); $this->printChildFamily($individual, $generations); $html = ob_get_clean(); return new Response($html); } /** * Print a child family * * @param Individual $individual * @param int $depth - the descendancy depth to show * @param string $daboville - d'Aboville number * @param string $gpid * * @return void */ private function printChildFamily(Individual $individual, $depth, $daboville = '1.', $gpid = ''): void { if ($depth < 2) { return; } $i = 1; foreach ($individual->spouseFamilies() as $family) { FunctionsCharts::printSosaFamily($family, '', -1, $daboville, $individual->xref(), $gpid, false); foreach ($family->children() as $child) { $this->printChildFamily($child, $depth - 1, $daboville . ($i++) . '.', $individual->xref()); } } } /** * This chart can display its output in a number of styles * * @return string[] */ private function chartStyles(): array { return [ self::CHART_STYLE_LIST => I18N::translate('List'), self::CHART_STYLE_BOOKLET => I18N::translate('Booklet'), self::CHART_STYLE_INDIVIDUALS => I18N::translate('Individuals'), self::CHART_STYLE_FAMILIES => I18N::translate('Families'), ]; } }