. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Fact; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Services\ClipboardService; use Illuminate\Support\Collection; /** * Class SourcesTabModule */ class SourcesTabModule extends AbstractModule implements ModuleTabInterface { use ModuleTabTrait; /** @var Collection|null */ private Collection|null $facts = null; private ClipboardService $clipboard_service; /** * @param ClipboardService $clipboard_service */ public function __construct(ClipboardService $clipboard_service) { $this->clipboard_service = $clipboard_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('Sources'); } public function description(): string { /* I18N: Description of the “Sources” module */ return I18N::translate('A tab showing the sources linked to an individual.'); } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 3; } /** * 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 { return $individual->canEdit() || $this->getFactsWithSources($individual)->isNotEmpty(); } /** * 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 $this->getFactsWithSources($individual)->isEmpty(); } /** * Generate the HTML content of this tab. * * @param Individual $individual * * @return string */ public function getTabContent(Individual $individual): string { return view('modules/sources_tab/tab', [ 'can_edit' => $individual->canEdit(), 'clipboard_facts' => $this->clipboard_service->pastableFactsOfType($individual, $this->supportedFacts()), 'individual' => $individual, 'facts' => $this->getFactsWithSources($individual), ]); } /** * Get all the facts for an individual which contain sources. * * @param Individual $individual * * @return Collection */ private function getFactsWithSources(Individual $individual): Collection { if ($this->facts === null) { $facts = $individual->facts(); foreach ($individual->spouseFamilies() as $family) { if ($family->canShow()) { foreach ($family->facts() as $fact) { $facts->push($fact); } } } $this->facts = new Collection(); foreach ($facts as $fact) { if (preg_match('/(?:^1|\n\d) SOUR/', $fact->gedcom())) { $this->facts->push($fact); } } $this->facts = Fact::sortFacts($this->facts); } return $this->facts; } /** * Can this tab load asynchronously? * * @return bool */ public function canLoadAjax(): bool { return false; } /** * This module handles the following facts - so don't show them on the "Facts and events" tab. * * @return Collection */ public function supportedFacts(): Collection { return new Collection(['INDI:SOUR', 'FAM:SOUR']); } }