. */ 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 All facts belonging to this source. */ private $facts; /** @var ClipboardService */ private $clipboard_service; /** * SourcesTabModule constructor. * * @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'); } /** * A sentence describing what this module does. * * @return string */ 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; } /** {@inheritdoc} */ public function hasTabContent(Individual $individual): bool { return $individual->canEdit() || $this->getFactsWithSources($individual)->isNotEmpty(); } /** {@inheritdoc} */ public function isGrayedOut(Individual $individual): bool { return $this->getFactsWithSources($individual)->isEmpty(); } /** {@inheritdoc} */ 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 * @return Fact[] */ 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; } /** {@inheritdoc} */ 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 * @return string[] */ public function supportedFacts(): Collection { return new Collection(['SOUR']); } }