. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Exception; use Fisharebest\Webtrees\Fact; use Fisharebest\Webtrees\Family; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\PlaceLocation; use Fisharebest\Webtrees\Services\LeafletJsService; use Fisharebest\Webtrees\Services\ModuleService; use Illuminate\Support\Collection; use stdClass; /** * Class PlacesMapModule */ class PlacesModule extends AbstractModule implements ModuleTabInterface { use ModuleTabTrait; protected const ICONS = [ 'FAM:CENS' => ['color' => 'cyan', 'name' => 'list fas'], 'FAM:MARR' => ['color' => 'green', 'name' => 'infinity fas'], 'INDI:BAPM' => ['color' => 'pink', 'name' => 'water fas'], 'INDI:BARM' => ['color' => 'pink', 'name' => 'star-of-david fas'], 'INDI:BASM' => ['color' => 'pink', 'name' => 'star-of-david fas'], 'INDI:BIRT' => ['color' => 'pink', 'name' => 'baby-carriage fas'], 'INDI:BURI' => ['color' => 'purple', 'name' => 'times fas'], 'INDI:CENS' => ['color' => 'cyan', 'name' => 'list fas'], 'INDI:CHR' => ['color' => 'pink', 'name' => 'water fas'], 'INDI:CHRA' => ['color' => 'pink', 'name' => 'water fas'], 'INDI:CREM' => ['color' => 'black', 'name' => 'times fas'], 'INDI:DEAT' => ['color' => 'black', 'name' => 'times fas'], 'INDI:EDUC' => ['color' => 'violet', 'name' => 'university fas'], 'INDI:GRAD' => ['color' => 'violet', 'name' => 'university fas'], 'INDI:OCCU' => ['color' => 'cyan', 'name' => 'industry fas'], 'INDI:RESI' => ['color' => 'cyan', 'name' => 'home fas'], ]; protected const DEFAULT_ICON = ['color' => 'gold', 'name' => 'bullseye fas']; private LeafletJsService $leaflet_js_service; private ModuleService $module_service; /** * PlacesModule constructor. * * @param LeafletJsService $leaflet_js_service * @param ModuleService $module_service */ public function __construct(LeafletJsService $leaflet_js_service, ModuleService $module_service) { $this->leaflet_js_service = $leaflet_js_service; $this->module_service = $module_service; } /** * 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('Places'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Places” module */ return I18N::translate('Show the location of events on a map.'); } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 8; } /** * 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 { $map_providers = $this->module_service->findByInterface(ModuleMapProviderInterface::class); return $map_providers->isNotEmpty() && $this->getMapData($individual)->features !== []; } /** * @param Individual $indi * * @return stdClass */ private function getMapData(Individual $indi): stdClass { $facts = $this->getPersonalFacts($indi); $geojson = [ 'type' => 'FeatureCollection', 'features' => [], ]; foreach ($facts as $id => $fact) { $location = new PlaceLocation($fact->place()->gedcomName()); // Use the co-ordinates from the fact (if they exist). $latitude = $fact->latitude(); $longitude = $fact->longitude(); // Use the co-ordinates from the location otherwise. if ($latitude === null || $longitude === null) { $latitude = $location->latitude(); $longitude = $location->longitude(); } if ($latitude !== null && $longitude !== null) { $geojson['features'][] = [ 'type' => 'Feature', 'id' => $id, 'geometry' => [ 'type' => 'Point', 'coordinates' => [$longitude, $latitude], ], 'properties' => [ 'icon' => static::ICONS[$fact->tag()] ?? static::DEFAULT_ICON, 'tooltip' => $fact->place()->gedcomName(), 'summary' => view('modules/places/event-sidebar', $this->summaryData($indi, $fact)), ], ]; } } return (object) $geojson; } /** * @param Individual $individual * * @return Collection * @throws Exception */ private function getPersonalFacts(Individual $individual): Collection { $facts = $individual->facts(); foreach ($individual->spouseFamilies() as $family) { $facts = $facts->merge($family->facts()); // Add birth of children from this family to the facts array foreach ($family->children() as $child) { $childsBirth = $child->facts(['BIRT'])->first(); if ($childsBirth instanceof Fact && $childsBirth->place()->gedcomName() !== '') { $facts->push($childsBirth); } } } $facts = Fact::sortFacts($facts); return $facts->filter(static function (Fact $item): bool { return $item->place()->gedcomName() !== ''; }); } /** * @param Individual $individual * @param Fact $fact * * @return mixed[] */ private function summaryData(Individual $individual, Fact $fact): array { $record = $fact->record(); $name = ''; $url = ''; $tag = $fact->label(); if ($record instanceof Family) { // Marriage $spouse = $record->spouse($individual); if ($spouse instanceof Individual) { $url = $spouse->url(); $name = $spouse->fullName(); } } elseif ($record !== $individual) { // Birth of a child $url = $record->url(); $name = $record->fullName(); $tag = I18N::translate('Birth of a child'); } return [ 'tag' => $tag, 'url' => $url, 'name' => $name, 'value' => $fact->value(), 'date' => $fact->date()->display(true), 'place' => $fact->place(), ]; } /** * 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; } /** * Generate the HTML content of this tab. * * @param Individual $individual * * @return string */ public function getTabContent(Individual $individual): string { return view('modules/places/tab', [ 'data' => $this->getMapData($individual), 'leaflet_config' => $this->leaflet_js_service->config(), ]); } }