. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Contracts\UserInterface; use Fisharebest\Webtrees\Family; use Fisharebest\Webtrees\GedcomRecord; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Media; use Fisharebest\Webtrees\Repository; use Fisharebest\Webtrees\Source; use Fisharebest\Webtrees\Tree; use Illuminate\Database\Capsule\Manager as DB; use Illuminate\Support\Str; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; use stdClass; /** * Class FamilyTreeFavoritesModule */ class FamilyTreeFavoritesModule extends AbstractModule implements ModuleBlockInterface { use ModuleBlockTrait; /** * 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('Favorites'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Favorites” module */ return I18N::translate('Display and manage a family tree’s favorite pages.'); } /** * Generate the HTML content of this block. * * @param Tree $tree * @param int $block_id * @param string $ctype * @param string[] $cfg * * @return string */ public function getBlock(Tree $tree, int $block_id, string $ctype = '', array $cfg = []): string { $content = view('modules/favorites/favorites', [ 'block_id' => $block_id, 'can_edit' => Auth::isManager($tree), 'favorites' => $this->getFavorites($tree), 'module_name' => $this->name(), 'tree' => $tree, ]); if ($ctype !== '') { return view('modules/block-template', [ 'block' => Str::kebab($this->name()), 'id' => $block_id, 'config_url' => '', 'title' => $this->title(), 'content' => $content, ]); } return $content; } /** * Should this block load asynchronously using AJAX? * Simple blocks are faster in-line, more comples ones * can be loaded later. * * @return bool */ public function loadAjax(): bool { return false; } /** * Can this block be shown on the user’s home page? * * @return bool */ public function isUserBlock(): bool { return false; } /** * Can this block be shown on the tree’s home page? * * @return bool */ public function isTreeBlock(): bool { return true; } /** * Update the configuration for a block. * * @param ServerRequestInterface $request * @param int $block_id * * @return void */ public function saveBlockConfiguration(ServerRequestInterface $request, int $block_id): void { } /** * An HTML form to edit block settings * * @param Tree $tree * @param int $block_id * * @return void */ public function editBlockConfiguration(Tree $tree, int $block_id): void { } /** * Get the favorites for a family tree * * @param Tree $tree * * @return stdClass[] */ public function getFavorites(Tree $tree): array { return DB::table('favorite') ->where('gedcom_id', '=', $tree->id()) ->whereNull('user_id') ->get() ->map(static function (stdClass $row) use ($tree): stdClass { if ($row->xref !== null) { $row->record = GedcomRecord::getInstance($row->xref, $tree); } else { $row->record = null; } return $row; }) ->all(); } /** * @param ServerRequestInterface $request * @param Tree $tree * @param UserInterface $user * * @return ResponseInterface */ public function postAddFavoriteAction(ServerRequestInterface $request, Tree $tree, UserInterface $user): ResponseInterface { $note = $request->get('note', ''); $title = $request->get('title', ''); $url = $request->get('url', ''); $type = $request->get('type', ''); $xref = $request->get($type . '-xref', ''); $record = $this->getRecordForType($type, $xref, $tree); if (Auth::isManager($tree, $user)) { if ($type === 'url' && $url !== '') { $this->addUrlFavorite($tree, $url, $title ?: $url, $note); } if ($record instanceof GedcomRecord && $record->canShow()) { $this->addRecordFavorite($tree, $record, $note); } } $url = route('tree-page', ['ged' => $tree->name()]); return redirect($url); } /** * @param ServerRequestInterface $request * @param Tree $tree * @param UserInterface $user * * @return ResponseInterface */ public function postDeleteFavoriteAction(ServerRequestInterface $request, Tree $tree, UserInterface $user): ResponseInterface { $favorite_id = (int) $request->get('favorite_id'); if (Auth::isManager($tree, $user)) { DB::table('favorite') ->where('favorite_id', '=', $favorite_id) ->whereNull('user_id') ->delete(); } $url = route('tree-page', ['ged' => $tree->name()]); return redirect($url); } /** * @param Tree $tree * @param string $url * @param string $title * @param string $note * * @return void */ private function addUrlFavorite(Tree $tree, string $url, string $title, string $note): void { DB::table('favorite')->updateOrInsert([ 'gedcom_id' => $tree->id(), 'user_id' => null, 'url' => $url, ], [ 'favorite_type' => 'URL', 'note' => $note, 'title' => $title, ]); } /** * @param Tree $tree * @param GedcomRecord $record * @param string $note * * @return void */ private function addRecordFavorite(Tree $tree, GedcomRecord $record, string $note): void { DB::table('favorite')->updateOrInsert([ 'gedcom_id' => $tree->id(), 'user_id' => null, 'xref' => $record->xref(), ], [ 'favorite_type' => $record::RECORD_TYPE, 'note' => $note, ]); } /** * @param string $type * @param string $xref * @param Tree $tree * * @return GedcomRecord|null */ private function getRecordForType(string $type, string $xref, Tree $tree): ?GedcomRecord { switch ($type) { case 'indi': return Individual::getInstance($xref, $tree); case 'fam': return Family::getInstance($xref, $tree); case 'sour': return Source::getInstance($xref, $tree); case 'repo': return Repository::getInstance($xref, $tree); case 'obje': return Media::getInstance($xref, $tree); default: return null; } } }