. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Individual; use Fisharebest\Webtrees\Menu; use Fisharebest\Webtrees\Services\HtmlService; use Fisharebest\Webtrees\Tree; use Illuminate\Database\Capsule\Manager as DB; use InvalidArgumentException; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; use stdClass; use function assert; /** * Class StoriesModule */ class StoriesModule extends AbstractModule implements ModuleConfigInterface, ModuleMenuInterface, ModuleTabInterface { use ModuleTabTrait; use ModuleConfigTrait; use ModuleMenuTrait; /** @var HtmlService */ private $html_service; /** * HtmlBlockModule bootstrap. * * @param HtmlService $html_service */ public function boot(HtmlService $html_service): void { $this->html_service = $html_service; } /** @var int The default access level for this module. It can be changed in the control panel. */ protected $access_level = Auth::PRIV_HIDE; /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Stories” module */ return I18N::translate('Add narrative stories to individuals in the family tree.'); } /** * The default position for this menu. It can be changed in the control panel. * * @return int */ public function defaultMenuOrder(): int { return 7; } /** * The default position for this tab. It can be changed in the control panel. * * @return int */ public function defaultTabOrder(): int { return 9; } /** * Generate the HTML content of this tab. * * @param Individual $individual * * @return string */ public function getTabContent(Individual $individual): string { return view('modules/stories/tab', [ 'is_admin' => Auth::isAdmin(), 'individual' => $individual, 'stories' => $this->getStoriesForIndividual($individual), ]); } /** * @param Individual $individual * * @return stdClass[] */ private function getStoriesForIndividual(Individual $individual): array { $block_ids = DB::table('block') ->where('module_name', '=', $this->name()) ->where('xref', '=', $individual->xref()) ->where('gedcom_id', '=', $individual->tree()->id()) ->pluck('block_id'); $stories = []; foreach ($block_ids as $block_id) { $block_id = (int) $block_id; // Only show this block for certain languages $languages = $this->getBlockSetting($block_id, 'languages'); if ($languages === '' || in_array(WT_LOCALE, explode(',', $languages), true)) { $stories[] = (object) [ 'block_id' => $block_id, 'title' => $this->getBlockSetting($block_id, 'title'), 'story_body' => $this->getBlockSetting($block_id, 'story_body'), ]; } } return $stories; } /** * 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 Auth::isManager($individual->tree()) || $this->getStoriesForIndividual($individual) !== []; } /** * 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->getStoriesForIndividual($individual) !== []; } /** * Can this tab load asynchronously? * * @return bool */ public function canLoadAjax(): bool { return false; } /** * A menu, to be added to the main application menu. * * @param Tree $tree * * @return Menu|null */ public function getMenu(Tree $tree): ?Menu { $menu = new Menu($this->title(), route('module', [ 'module' => $this->name(), 'action' => 'ShowList', 'tree' => $tree->name(), ]), 'menu-story'); return $menu; } /** * 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('Stories'); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getAdminAction(ServerRequestInterface $request): ResponseInterface { $this->layout = 'layouts/administration'; $tree = $request->getAttribute('tree'); assert($tree instanceof Tree, new InvalidArgumentException()); $stories = DB::table('block') ->where('module_name', '=', $this->name()) ->where('gedcom_id', '=', $tree->id()) ->orderBy('xref') ->get(); foreach ($stories as $story) { $block_id = (int) $story->block_id; $story->individual = Individual::getInstance($story->xref, $tree); $story->title = $this->getBlockSetting($block_id, 'title'); $story->languages = $this->getBlockSetting($block_id, 'languages'); } return $this->viewResponse('modules/stories/config', [ 'module' => $this->name(), 'stories' => $stories, 'title' => $this->title() . ' — ' . $tree->title(), 'tree' => $tree, 'tree_names' => Tree::getNameList(), ]); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getAdminEditAction(ServerRequestInterface $request): ResponseInterface { $this->layout = 'layouts/administration'; $tree = $request->getAttribute('tree'); $block_id = (int) ($request->getQueryParams()['block_id'] ?? 0); if ($block_id === 0) { // Creating a new story $individual = null; $story_title = ''; $story_body = ''; $languages = []; $title = I18N::translate('Add a story') . ' — ' . e($tree->title()); } else { // Editing an existing story $xref = (string) DB::table('block') ->where('block_id', '=', $block_id) ->value('xref'); $individual = Individual::getInstance($xref, $tree); $story_title = $this->getBlockSetting($block_id, 'title'); $story_body = $this->getBlockSetting($block_id, 'story_body'); $languages = explode(',', $this->getBlockSetting($block_id, 'languages')); $title = I18N::translate('Edit the story') . ' — ' . e($tree->title()); } return $this->viewResponse('modules/stories/edit', [ 'block_id' => $block_id, 'languages' => $languages, 'story_body' => $story_body, 'story_title' => $story_title, 'title' => $title, 'tree' => $tree, 'individual' => $individual, ]); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function postAdminEditAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); $block_id = (int) ($request->getQueryParams()['block_id'] ?? 0); $params = $request->getParsedBody(); $xref = $params['xref']; $story_body = $params['story_body']; $story_title = $params['story_title']; $languages = $params['languages'] ?? []; $story_body = $this->html_service->sanitize($story_body); $story_title = $this->html_service->sanitize($story_title); if ($block_id !== 0) { DB::table('block') ->where('block_id', '=', $block_id) ->update([ 'gedcom_id' => $tree->id(), 'xref' => $xref, ]); } else { DB::table('block')->insert([ 'gedcom_id' => $tree->id(), 'xref' => $xref, 'module_name' => $this->name(), 'block_order' => 0, ]); $block_id = (int) DB::connection()->getPdo()->lastInsertId(); } $this->setBlockSetting($block_id, 'story_body', $story_body); $this->setBlockSetting($block_id, 'title', $story_title); $this->setBlockSetting($block_id, 'languages', implode(',', $languages)); $url = route('module', [ 'module' => $this->name(), 'action' => 'Admin', 'tree' => $tree->name(), ]); return redirect($url); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function postAdminDeleteAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); $block_id = $request->getQueryParams()['block_id']; DB::table('block_setting') ->where('block_id', '=', $block_id) ->delete(); DB::table('block') ->where('block_id', '=', $block_id) ->delete(); $url = route('module', [ 'module' => $this->name(), 'action' => 'Admin', 'tree' => $tree->name(), ]); return redirect($url); } /** * @param ServerRequestInterface $request * * @return ResponseInterface */ public function getShowListAction(ServerRequestInterface $request): ResponseInterface { $tree = $request->getAttribute('tree'); assert($tree instanceof Tree, new InvalidArgumentException()); $stories = DB::table('block') ->where('module_name', '=', $this->name()) ->where('gedcom_id', '=', $tree->id()) ->get() ->map(function (stdClass $story) use ($tree): stdClass { $block_id = (int) $story->block_id; $story->individual = Individual::getInstance($story->xref, $tree); $story->title = $this->getBlockSetting($block_id, 'title'); $story->languages = $this->getBlockSetting($block_id, 'languages'); return $story; })->filter(static function (stdClass $story): bool { // Filter non-existant and private individuals. return $story->individual instanceof Individual && $story->individual->canShow(); })->filter(static function (stdClass $story): bool { // Filter foreign languages. return $story->languages === '' || in_array(WT_LOCALE, explode(',', $story->languages), true); }); return $this->viewResponse('modules/stories/list', [ 'stories' => $stories, 'title' => $this->title(), ]); } }