xref: /webtrees/app/Module/AhnentafelReportModule.php (revision 8f53f488f13e53e44dc48778e8f51ec9f91352dd)
18c2e8227SGreg Roach<?php
28c2e8227SGreg Roach/**
38c2e8227SGreg Roach * webtrees: online genealogy
41062a142SGreg Roach * Copyright (C) 2018 webtrees development team
58c2e8227SGreg Roach * This program is free software: you can redistribute it and/or modify
68c2e8227SGreg Roach * it under the terms of the GNU General Public License as published by
78c2e8227SGreg Roach * the Free Software Foundation, either version 3 of the License, or
88c2e8227SGreg Roach * (at your option) any later version.
98c2e8227SGreg Roach * This program is distributed in the hope that it will be useful,
108c2e8227SGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
118c2e8227SGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
128c2e8227SGreg Roach * GNU General Public License for more details.
138c2e8227SGreg Roach * You should have received a copy of the GNU General Public License
148c2e8227SGreg Roach * along with this program. If not, see <http://www.gnu.org/licenses/>.
158c2e8227SGreg Roach */
1676692c8bSGreg Roachnamespace Fisharebest\Webtrees\Module;
1776692c8bSGreg Roach
180e62c4b8SGreg Roachuse Fisharebest\Webtrees\Auth;
190e62c4b8SGreg Roachuse Fisharebest\Webtrees\I18N;
200e62c4b8SGreg Roachuse Fisharebest\Webtrees\Menu;
21dc809433SGreg Roachuse Fisharebest\Webtrees\Tree;
228c2e8227SGreg Roach
238c2e8227SGreg Roach/**
248c2e8227SGreg Roach * Class AhnentafelReportModule
258c2e8227SGreg Roach */
26c1010edaSGreg Roachclass AhnentafelReportModule extends AbstractModule implements ModuleReportInterface
27c1010edaSGreg Roach{
2876692c8bSGreg Roach    /**
2976692c8bSGreg Roach     * How should this module be labelled on tabs, menus, etc.?
3076692c8bSGreg Roach     *
3176692c8bSGreg Roach     * @return string
3276692c8bSGreg Roach     */
33*8f53f488SRico Sonntag    public function getTitle(): string
34c1010edaSGreg Roach    {
358c2e8227SGreg Roach        // This text also appears in the .XML file - update both together
36bbb76c12SGreg Roach        /* I18N: Name of a module/report */
37bbb76c12SGreg Roach        return I18N::translate('Ancestors');
388c2e8227SGreg Roach    }
398c2e8227SGreg Roach
4076692c8bSGreg Roach    /**
4176692c8bSGreg Roach     * A sentence describing what this module does.
4276692c8bSGreg Roach     *
4376692c8bSGreg Roach     * @return string
4476692c8bSGreg Roach     */
45*8f53f488SRico Sonntag    public function getDescription(): string
46c1010edaSGreg Roach    {
478c2e8227SGreg Roach        // This text also appears in the .XML file - update both together
48bbb76c12SGreg Roach        /* I18N: Description of the “Ancestors” module */
49bbb76c12SGreg Roach        return I18N::translate('A report of an individual’s ancestors, in a narrative style.');
508c2e8227SGreg Roach    }
518c2e8227SGreg Roach
5276692c8bSGreg Roach    /**
5376692c8bSGreg Roach     * What is the default access level for this module?
5476692c8bSGreg Roach     *
5576692c8bSGreg Roach     * Some modules are aimed at admins or managers, and are not generally shown to users.
5676692c8bSGreg Roach     *
5776692c8bSGreg Roach     * @return int
5876692c8bSGreg Roach     */
59*8f53f488SRico Sonntag    public function defaultAccessLevel(): int
60c1010edaSGreg Roach    {
614b9ff166SGreg Roach        return Auth::PRIV_PRIVATE;
628c2e8227SGreg Roach    }
638c2e8227SGreg Roach
6476692c8bSGreg Roach    /**
650ee13198SGreg Roach     * Return a menu item for this report.
6676692c8bSGreg Roach     *
67dc809433SGreg Roach     * @param Tree $tree
68dc809433SGreg Roach     *
690ee13198SGreg Roach     * @return Menu
7076692c8bSGreg Roach     */
71c1010edaSGreg Roach    public function getReportMenu(Tree $tree): Menu
72c1010edaSGreg Roach    {
730ee13198SGreg Roach        return new Menu(
748c2e8227SGreg Roach            $this->getTitle(),
75c1010edaSGreg Roach            route('report-setup', ['ged'    => $tree->getName(),
76c1010edaSGreg Roach                                   'report' => $this->getName(),
77c1010edaSGreg Roach            ]),
780ee13198SGreg Roach            'menu-report-' . $this->getName(),
7913abd6f3SGreg Roach            ['rel' => 'nofollow']
808c2e8227SGreg Roach        );
818c2e8227SGreg Roach    }
828c2e8227SGreg Roach}
83