. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Module; use Fisharebest\Webtrees\GedcomRecord; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Tree; use Illuminate\Database\Capsule\Manager as DB; use Illuminate\Support\Str; use Psr\Http\Message\ServerRequestInterface; /** * Class TopPageViewsModule */ class TopPageViewsModule 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('Most viewed pages'); } /** * A sentence describing what this module does. * * @return string */ public function description(): string { /* I18N: Description of the “Most viewed pages” module */ return I18N::translate('A list of the pages that have been viewed the most number of times.'); } /** * Generate the HTML content of this block. * * @param Tree $tree * @param int $block_id * @param string $context * @param string[] $config * * @return string */ public function getBlock(Tree $tree, int $block_id, string $context, array $config = []): string { $num = $this->getBlockSetting($block_id, 'num', '10'); $count_placement = $this->getBlockSetting($block_id, 'count_placement', 'before'); extract($config, EXTR_OVERWRITE); $top10 = DB::table('hit_counter') ->where('gedcom_id', '=', $tree->id()) ->whereIn('page_name', ['individual.php','family.php','source.php','repo.php','note.php','mediaviewer.php']) ->orderByDesc('page_count') ->limit((int) $num) ->pluck('page_count', 'page_parameter'); $content = ''; foreach ($top10 as $id => $count) { $record = GedcomRecord::getInstance($id, $tree); if ($record && $record->canShow()) { $content .= ''; if ($count_placement === 'before') { $content .= ''; } $content .= ''; if ($count_placement === 'after') { $content .= ''; } $content .= ''; } } $content .= '

[' . $count . ']

' . $record->fullName() . '

[' . $count . ']

'; if ($context !== self::CONTEXT_EMBED) { return view('modules/block-template', [ 'block' => Str::kebab($this->name()), 'id' => $block_id, 'config_url' => $this->configUrl($tree, $context, $block_id), 'title' => $this->title(), 'content' => $content, ]); } return $content; } /** * Should this block load asynchronously using AJAX? * * Simple blocks are faster in-line, more complex ones can be loaded later. * * @return bool */ public function loadAjax(): bool { return true; } /** * 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 { $params = $request->getParsedBody(); $this->setBlockSetting($block_id, 'num', $params['num']); $this->setBlockSetting($block_id, 'count_placement', $params['count_placement']); } /** * An HTML form to edit block settings * * @param Tree $tree * @param int $block_id * * @return string */ public function editBlockConfiguration(Tree $tree, int $block_id): string { $num = $this->getBlockSetting($block_id, 'num', '10'); $count_placement = $this->getBlockSetting($block_id, 'count_placement', 'before'); $options = [ /* I18N: An option in a list-box */ 'before' => I18N::translate('before'), /* I18N: An option in a list-box */ 'after' => I18N::translate('after'), ]; return view('modules/top10_pageviews/config', [ 'count_placement' => $count_placement, 'num' => $num, 'options' => $options, ]); } }