. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; 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 Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; /** * Class DescendancyChartModule */ class DescendancyChartModule extends AbstractModule implements ModuleChartInterface { use ModuleChartTrait; // Chart styles public const CHART_STYLE_TREE = 'tree'; public const CHART_STYLE_INDIVIDUALS = 'individuals'; public const CHART_STYLE_FAMILIES = 'families'; // Defaults public const DEFAULT_STYLE = self::CHART_STYLE_TREE; 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 = []; /** @var ChartService */ private $chart_service; /** * DescendancyChartModule 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('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 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); $chart_style = $request->getQueryParams()['chart_style'] ?? self::DEFAULT_STYLE; $generations = (int) ($request->getQueryParams()['generations'] ?? self::DEFAULT_GENERATIONS); $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); if ($ajax === '1') { return $this->chart($request); } $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 ServerRequestInterface $request * * @return ResponseInterface */ public function chart(ServerRequestInterface $request): ResponseInterface { $this->layout = 'layouts/ajax'; $tree = $request->getAttribute('tree'); $xref = $request->getQueryParams()['xref']; $individual = Individual::getInstance($xref, $tree); Auth::checkIndividualAccess($individual); $chart_style = $request->getQueryParams()['chart_style']; $generations = (int) $request->getQueryParams()['generations']; $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); switch ($chart_style) { case self::CHART_STYLE_TREE: default: return response(view('modules/descendancy_chart/tree', ['individual' => $individual, 'generations' => $generations, 'daboville' => '1'])); case self::CHART_STYLE_INDIVIDUALS: $individuals = $this->chart_service->descendants($individual, $generations - 1); return $this->descendantsIndividuals($tree, $individuals); case self::CHART_STYLE_FAMILIES: $families = $this->chart_service->descendantFamilies($individual, $generations - 1); return $this->descendantsFamilies($tree, $families); } } /** * Show a tabular list of individual descendants. * * @param Tree $tree * @param Collection $individuals * * @return ResponseInterface */ private function descendantsIndividuals(Tree $tree, Collection $individuals): ResponseInterface { $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 ResponseInterface */ private function descendantsFamilies(Tree $tree, Collection $families): ResponseInterface { $this->layout = 'layouts/ajax'; return $this->viewResponse('lists/families-table', [ 'families' => $families, 'tree' => $tree, ]); } /** * This chart can display its output in a number of styles * * @return string[] */ private function chartStyles(): array { return [ self::CHART_STYLE_TREE => I18N::translate('Tree'), self::CHART_STYLE_INDIVIDUALS => I18N::translate('Individuals'), self::CHART_STYLE_FAMILIES => I18N::translate('Families'), ]; } }