. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Aura\Router\RouterContainer; use Fig\Http\Message\RequestMethodInterface; 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 Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; use Psr\Http\Server\RequestHandlerInterface; use function app; use function assert; use function is_string; use function max; use function min; use function route; /** * Class AncestorsChartModule */ class AncestorsChartModule extends AbstractModule implements ModuleChartInterface, RequestHandlerInterface { use ModuleChartTrait; private const ROUTE_NAME = 'ancestors-chart'; private const ROUTE_URL = '/tree/{tree}/ancestors-{style}-{generations}/{xref}'; // Chart styles public const CHART_STYLE_TREE = 'tree'; public const CHART_STYLE_INDIVIDUALS = 'individuals'; public const CHART_STYLE_FAMILIES = 'families'; // Defaults protected const DEFAULT_GENERATIONS = '4'; protected const DEFAULT_STYLE = self::CHART_STYLE_TREE; protected const DEFAULT_PARAMETERS = [ 'generations' => self::DEFAULT_GENERATIONS, 'style' => self::DEFAULT_STYLE, ]; // Limits protected const MINIMUM_GENERATIONS = 2; protected const MAXIMUM_GENERATIONS = 10; /** @var ChartService */ private $chart_service; /** * CompactTreeChartModule constructor. * * @param ChartService $chart_service */ public function __construct(ChartService $chart_service) { $this->chart_service = $chart_service; } /** * Initialization. * * @return void */ public function boot(): void { $router_container = app(RouterContainer::class); assert($router_container instanceof RouterContainer); $router_container->getMap() ->get(self::ROUTE_NAME, self::ROUTE_URL, $this) ->allows(RequestMethodInterface::METHOD_POST) ->tokens([ 'generations' => '\d+', 'style' => implode('|', array_keys($this->styles())), ]); } /** * 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('Ancestors'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “AncestorsChart” module */ return I18N::translate('A chart of an individual’s ancestors.'); } /** * CSS class for the URL. * * @return string */ public function chartMenuClass(): string { return 'menu-chart-ancestry'; } /** * 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('Ancestors of %s', $individual->fullName()); } /** * The URL for a page showing chart options. * * @param Individual $individual * @param mixed[] $parameters * * @return string */ public function chartUrl(Individual $individual, array $parameters = []): string { return route(self::ROUTE_NAME, [ 'xref' => $individual->xref(), 'tree' => $individual->tree()->name(), ] + $parameters + self::DEFAULT_PARAMETERS); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function handle(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree); $xref = $request->getAttribute('xref'); assert(is_string($xref)); $individual = Individual::getInstance($xref, $tree); $individual = Auth::checkIndividualAccess($individual); $ajax = $request->getQueryParams()['ajax'] ?? ''; $generations = (int) $request->getAttribute('generations'); $style = $request->getAttribute('style'); $user = $request->getAttribute('user'); Auth::checkComponentAccess($this, 'chart', $tree, $user); // Convert POST requests into GET requests for pretty URLs. if ($request->getMethod() === RequestMethodInterface::METHOD_POST) { return redirect(route(self::ROUTE_NAME, [ 'tree' => $tree->name(), 'xref' => $request->getParsedBody()['xref'], 'style' => $request->getParsedBody()['style'], 'generations' => $request->getParsedBody()['generations'], ])); } $generations = min($generations, self::MAXIMUM_GENERATIONS); $generations = max($generations, self::MINIMUM_GENERATIONS); if ($ajax === '1') { $this->layout = 'layouts/ajax'; $ancestors = $this->chart_service->sosaStradonitzAncestors($individual, $generations); switch ($style) { default: case self::CHART_STYLE_TREE: return $this->viewResponse('modules/ancestors-chart/tree', [ 'individual' => $individual, 'parents' => $individual->primaryChildFamily(), 'generations' => $generations, 'sosa' => 1, ]); case self::CHART_STYLE_INDIVIDUALS: return $this->viewResponse('lists/individuals-table', [ 'individuals' => $ancestors, 'sosa' => true, 'tree' => $tree, ]); case self::CHART_STYLE_FAMILIES: $families = []; foreach ($ancestors as $individual) { foreach ($individual->childFamilies() as $family) { $families[$family->xref()] = $family; } } return $this->viewResponse('lists/families-table', ['families' => $families, 'tree' => $tree]); } } $ajax_url = $this->chartUrl($individual, [ 'ajax' => true, 'generations' => $generations, 'style' => $style, 'xref' => $xref, ]); return $this->viewResponse('modules/ancestors-chart/page', [ 'ajax_url' => $ajax_url, 'generations' => $generations, 'individual' => $individual, 'maximum_generations' => self::MAXIMUM_GENERATIONS, 'minimum_generations' => self::MINIMUM_GENERATIONS, 'module' => $this->name(), 'style' => $style, 'styles' => $this->styles(), 'title' => $this->chartTitle($individual), 'tree' => $tree, ]); } /** * This chart can display its output in a number of styles * * @return string[] */ protected function styles(): array { return [ self::CHART_STYLE_TREE => I18N::translate('Tree'), self::CHART_STYLE_INDIVIDUALS => I18N::translate('Individuals'), self::CHART_STYLE_FAMILIES => I18N::translate('Families'), ]; } }