. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Date; use Fisharebest\Webtrees\Fact; use Fisharebest\Webtrees\Family; use Fisharebest\Webtrees\Functions\Functions; use Fisharebest\Webtrees\Gedcom; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Site; /** * Class IndividualFactsTabModule */ class IndividualFactsTabModule extends AbstractModule implements ModuleTabInterface { use ModuleTabTrait; /** * How should this module be labelled on tabs, menus, etc.? * * @return string */ public function title(): string { /* I18N: Name of a module/tab on the individual page. */ return I18N::translate('Facts and events'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Facts and events” module */ return I18N::translate('A tab showing the facts and events of an individual.'); } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 2; } /** {@inheritdoc} */ public function isGrayedOut(Individual $individual): bool { return false; } /** {@inheritdoc} */ public function getTabContent(Individual $individual): string { // Only include events of close relatives that are between birth and death $min_date = $individual->getEstimatedBirthDate(); $max_date = $individual->getEstimatedDeathDate(); $indifacts = []; // The individual’s own facts foreach ($individual->facts() as $fact) { switch ($fact->getTag()) { case 'SEX': case 'NAME': case 'SOUR': case 'OBJE': case 'NOTE': case 'FAMC': case 'FAMS': break; default: $use_extra_info_module = Module::findByComponent('sidebar', $individual->tree(), Auth::user()) ->filter(function (ModuleInterface $module): bool { return $module instanceof ExtraInformationModule; })->isNotEmpty(); if (!$use_extra_info_module || !ExtraInformationModule::showFact($fact)) { $indifacts[] = $fact; } break; } } // Add spouse-family facts foreach ($individual->getSpouseFamilies() as $family) { foreach ($family->facts() as $fact) { switch ($fact->getTag()) { case 'SOUR': case 'NOTE': case 'OBJE': case 'CHAN': case '_UID': case 'RIN': case 'HUSB': case 'WIFE': case 'CHIL': break; default: $indifacts[] = $fact; break; } } $spouse = $family->getSpouse($individual); if ($spouse instanceof Individual) { $spouse_facts = self::spouseFacts($individual, $spouse, $min_date, $max_date); $indifacts = array_merge($indifacts, $spouse_facts); } $child_facts = self::childFacts($individual, $family, '_CHIL', '', $min_date, $max_date); $indifacts = array_merge($indifacts, $child_facts); } $parent_facts = self::parentFacts($individual, 1, $min_date, $max_date); $associate_facts = self::associateFacts($individual); $historical_facts = self::historicalFacts($individual, $min_date, $max_date); $indifacts = array_merge($indifacts, $parent_facts, $associate_facts, $historical_facts); Functions::sortFacts($indifacts); return view('modules/personal_facts/tab', [ 'can_edit' => $individual->canEdit(), 'has_historical_facts' => !empty($historical_facts), 'individual' => $individual, 'facts' => $indifacts, ]); } /** * Does a relative event occur within a date range (i.e. the individual's lifetime)? * * @param Fact $fact * @param Date $min_date * @param Date $max_date * * @return bool */ private static function includeFact(Fact $fact, Date $min_date, Date $max_date): bool { $fact_date = $fact->date(); return $fact_date->isOK() && Date::compare($min_date, $fact_date) <= 0 && Date::compare($fact_date, $max_date) <= 0; } /** {@inheritdoc} */ public function hasTabContent(Individual $individual): bool { return true; } /** {@inheritdoc} */ public function canLoadAjax(): bool { return false; } /** * Spouse facts that are shown on an individual’s page. * * @param Individual $individual Show events that occured during the lifetime of this individual * @param Individual $spouse Show events of this individual * @param Date $min_date * @param Date $max_date * * @return Fact[] */ private static function spouseFacts(Individual $individual, Individual $spouse, Date $min_date, Date $max_date): array { $SHOW_RELATIVES_EVENTS = $individual->tree()->getPreference('SHOW_RELATIVES_EVENTS'); $facts = []; if (strstr($SHOW_RELATIVES_EVENTS, '_DEAT_SPOU')) { foreach ($spouse->facts(Gedcom::DEATH_EVENTS) as $fact) { if (self::includeFact($fact, $min_date, $max_date)) { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_SPOU'); $facts[] = $rela_fact; } } } return $facts; } /** * Get the events of children and grandchildren. * * @param Individual $person * @param Family $family * @param string $option * @param string $relation * @param Date $min_date * @param Date $max_date * * @return Fact[] */ private static function childFacts(Individual $person, Family $family, $option, $relation, Date $min_date, Date $max_date): array { $SHOW_RELATIVES_EVENTS = $person->tree()->getPreference('SHOW_RELATIVES_EVENTS'); $facts = []; // Deal with recursion. switch ($option) { case '_CHIL': // Add grandchildren foreach ($family->getChildren() as $child) { foreach ($child->getSpouseFamilies() as $cfamily) { switch ($child->getSex()) { case 'M': foreach (self::childFacts($person, $cfamily, '_GCHI', 'son', $min_date, $max_date) as $fact) { $facts[] = $fact; } break; case 'F': foreach (self::childFacts($person, $cfamily, '_GCHI', 'dau', $min_date, $max_date) as $fact) { $facts[] = $fact; } break; default: foreach (self::childFacts($person, $cfamily, '_GCHI', 'chi', $min_date, $max_date) as $fact) { $facts[] = $fact; } break; } } } break; } // For each child in the family foreach ($family->getChildren() as $child) { if ($child->xref() == $person->xref()) { // We are not our own sibling! continue; } // add child’s birth if (strpos($SHOW_RELATIVES_EVENTS, '_BIRT' . str_replace('_HSIB', '_SIBL', $option)) !== false) { foreach ($child->facts(Gedcom::BIRTH_EVENTS) as $fact) { // Always show _BIRT_CHIL, even if the dates are not known if ($option == '_CHIL' || self::includeFact($fact, $min_date, $max_date)) { if ($option == '_GCHI' && $relation == 'dau') { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GCH1'); $facts[] = $rela_fact; } elseif ($option == '_GCHI' && $relation == 'son') { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GCH2'); $facts[] = $rela_fact; } else { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . $option); $facts[] = $rela_fact; } } } } // add child’s death if (strpos($SHOW_RELATIVES_EVENTS, '_DEAT' . str_replace('_HSIB', '_SIBL', $option)) !== false) { foreach ($child->facts(Gedcom::DEATH_EVENTS) as $fact) { if (self::includeFact($fact, $min_date, $max_date)) { if ($option == '_GCHI' && $relation == 'dau') { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GCH1'); $facts[] = $rela_fact; } elseif ($option == '_GCHI' && $relation == 'son') { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GCH2'); $facts[] = $rela_fact; } else { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . $option); $facts[] = $rela_fact; } } } } // add child’s marriage if (strstr($SHOW_RELATIVES_EVENTS, '_MARR' . str_replace('_HSIB', '_SIBL', $option))) { foreach ($child->getSpouseFamilies() as $sfamily) { foreach ($sfamily->facts(['MARR']) as $fact) { if (self::includeFact($fact, $min_date, $max_date)) { if ($option == '_GCHI' && $relation == 'dau') { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GCH1'); $facts[] = $rela_fact; } elseif ($option == '_GCHI' && $relation == 'son') { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GCH2'); $facts[] = $rela_fact; } else { // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . $option); $facts[] = $rela_fact; } } } } } } return $facts; } /** * Get the events of parents and grandparents. * * @param Individual $person * @param int $sosa * @param Date $min_date * @param Date $max_date * * @return Fact[] */ private static function parentFacts(Individual $person, $sosa, Date $min_date, Date $max_date): array { $SHOW_RELATIVES_EVENTS = $person->tree()->getPreference('SHOW_RELATIVES_EVENTS'); $facts = []; if ($sosa == 1) { foreach ($person->getChildFamilies() as $family) { // Add siblings foreach (self::childFacts($person, $family, '_SIBL', '', $min_date, $max_date) as $fact) { $facts[] = $fact; } foreach ($family->getSpouses() as $spouse) { foreach ($spouse->getSpouseFamilies() as $sfamily) { if ($family !== $sfamily) { // Add half-siblings foreach (self::childFacts($person, $sfamily, '_HSIB', '', $min_date, $max_date) as $fact) { $facts[] = $fact; } } } // Add grandparents foreach (self::parentFacts($spouse, $spouse->getSex() == 'F' ? 3 : 2, $min_date, $max_date) as $fact) { $facts[] = $fact; } } } if (strstr($SHOW_RELATIVES_EVENTS, '_MARR_PARE')) { // add father/mother marriages foreach ($person->getChildFamilies() as $sfamily) { foreach ($sfamily->facts(['MARR']) as $fact) { if (self::includeFact($fact, $min_date, $max_date)) { // marriage of parents (to each other) $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_FAMC'); $facts[] = $rela_fact; } } } foreach ($person->getChildStepFamilies() as $sfamily) { foreach ($sfamily->facts(['MARR']) as $fact) { if (self::includeFact($fact, $min_date, $max_date)) { // marriage of a parent (to another spouse) // Convert the event to a close relatives event $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_PARE'); $facts[] = $rela_fact; } } } } } foreach ($person->getChildFamilies() as $family) { foreach ($family->getSpouses() as $parent) { if (strstr($SHOW_RELATIVES_EVENTS, '_DEAT' . ($sosa == 1 ? '_PARE' : '_GPAR'))) { foreach ($parent->facts(Gedcom::DEATH_EVENTS) as $fact) { if (self::includeFact($fact, $min_date, $max_date)) { switch ($sosa) { case 1: // Convert the event to a close relatives event. $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_PARE'); $facts[] = $rela_fact; break; case 2: // Convert the event to a close relatives event $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GPA1'); $facts[] = $rela_fact; break; case 3: // Convert the event to a close relatives event $rela_fact = clone($fact); $rela_fact->setTag('_' . $fact->getTag() . '_GPA2'); $facts[] = $rela_fact; break; } } } } } } return $facts; } /** * Get any historical events. * * @param Individual $person * @param Date $min_date * @param Date $max_date * * @return Fact[] */ private static function historicalFacts(Individual $person, Date $min_date, Date $max_date): array { $facts = []; if (file_exists(Site::getPreference('INDEX_DIRECTORY') . 'histo.' . WT_LOCALE . '.php')) { $histo = []; require Site::getPreference('INDEX_DIRECTORY') . 'histo.' . WT_LOCALE . '.php'; foreach ($histo as $hist) { $fact = new Fact($hist, $person, 'histo'); if (self::includeFact($fact, $min_date, $max_date)) { $facts[] = $fact; } } } return $facts; } /** * Get the events of associates. * * @param Individual $person * * @return Fact[] */ private static function associateFacts(Individual $person): array { $facts = []; /** @var Individual[] $associates */ $associates = array_merge( $person->linkedIndividuals('ASSO'), $person->linkedIndividuals('_ASSO'), $person->linkedFamilies('ASSO'), $person->linkedFamilies('_ASSO') ); foreach ($associates as $associate) { foreach ($associate->facts() as $fact) { $arec = $fact->attribute('_ASSO'); if (!$arec) { $arec = $fact->attribute('ASSO'); } if ($arec && trim($arec, '@') === $person->xref()) { // Extract the important details from the fact $factrec = '1 ' . $fact->getTag(); if (preg_match('/\n2 DATE .*/', $fact->gedcom(), $match)) { $factrec .= $match[0]; } if (preg_match('/\n2 PLAC .*/', $fact->gedcom(), $match)) { $factrec .= $match[0]; } if ($associate instanceof Family) { foreach ($associate->getSpouses() as $spouse) { $factrec .= "\n2 _ASSO @" . $spouse->xref() . '@'; } } else { $factrec .= "\n2 _ASSO @" . $associate->xref() . '@'; } $facts[] = new Fact($factrec, $associate, 'asso'); } } } return $facts; } }