. */ 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 NotesTabModule */ class NotesTabModule extends AbstractModule implements ModuleTabInterface { use ModuleTabTrait; /** @var Fact[] A list facts for this note. */ private $facts; /** @var ClipboardService */ private $clipboard_service; /** * NotesTabModule constructor. * * @param ClipboardService $clipboard_service */ public function __construct(ClipboardService $clipboard_service) { $this->clipboard_service = $clipboard_service; } /** * How should this module be labelled on tabs, menus, etc.? * * @return string */ public function title(): string { /* I18N: Name of a module */ return I18N::translate('Notes'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Notes” module */ return I18N::translate('A tab showing the notes attached to an individual.'); } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 5; } /** {@inheritdoc} */ public function hasTabContent(Individual $individual): bool { return $individual->canEdit() || $this->getFactsWithNotes($individual); } /** {@inheritdoc} */ public function isGrayedOut(Individual $individual): bool { return !$this->getFactsWithNotes($individual); } /** {@inheritdoc} */ public function getTabContent(Individual $individual): string { return view('modules/notes/tab', [ 'can_edit' => $individual->canEdit(), 'clipboard_facts' => $this->clipboard_service->pastableFactsOfType($individual, $this->supportedFacts()), 'individual' => $individual, 'facts' => $this->getFactsWithNotes($individual), ]); } /** * Get all the facts for an individual which contain notes. * * @param Individual $individual * * @return Fact[] */ private function getFactsWithNotes(Individual $individual): array { 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 = []; foreach ($facts as $fact) { if (preg_match('/(?:^1|\n\d) NOTE/', $fact->gedcom())) { $this->facts[] = $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|string[] */ public function supportedFacts(): Collection { return new Collection(['NOTE']); } }