xref: /webtrees/app/Module/ModuleTabTrait.php (revision cbf4b7fa194b4e336add2747abfccb05fbb0f4da)
149a243cbSGreg Roach<?php
249a243cbSGreg Roach/**
349a243cbSGreg Roach * webtrees: online genealogy
449a243cbSGreg Roach * Copyright (C) 2019 webtrees development team
549a243cbSGreg Roach * This program is free software: you can redistribute it and/or modify
649a243cbSGreg Roach * it under the terms of the GNU General Public License as published by
749a243cbSGreg Roach * the Free Software Foundation, either version 3 of the License, or
849a243cbSGreg Roach * (at your option) any later version.
949a243cbSGreg Roach * This program is distributed in the hope that it will be useful,
1049a243cbSGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
1149a243cbSGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1249a243cbSGreg Roach * GNU General Public License for more details.
1349a243cbSGreg Roach * You should have received a copy of the GNU General Public License
1449a243cbSGreg Roach * along with this program. If not, see <http://www.gnu.org/licenses/>.
1549a243cbSGreg Roach */
1649a243cbSGreg Roachdeclare(strict_types=1);
1749a243cbSGreg Roach
1849a243cbSGreg Roachnamespace Fisharebest\Webtrees\Module;
1949a243cbSGreg Roach
2049a243cbSGreg Roach/**
2149a243cbSGreg Roach * Trait ModuleTabTrait - default implementation of ModuleTabInterface
2249a243cbSGreg Roach */
2349a243cbSGreg Roachtrait ModuleTabTrait
2449a243cbSGreg Roach{
2549a243cbSGreg Roach    /** @var int The default position for this tab.  It can be changed in the control panel. */
2649a243cbSGreg Roach    protected $tab_order = 0;
2749a243cbSGreg Roach
2849a243cbSGreg Roach    /**
2949a243cbSGreg Roach     * Users change change the order of tabs using the control panel.
3049a243cbSGreg Roach     *
3149a243cbSGreg Roach     * @param int $tab_order
3249a243cbSGreg Roach     *
3349a243cbSGreg Roach     * @return void
3449a243cbSGreg Roach     */
3549a243cbSGreg Roach    public function setTabOrder(int $tab_order): void
3649a243cbSGreg Roach    {
3749a243cbSGreg Roach        $this->tab_order = $tab_order;
3849a243cbSGreg Roach    }
3949a243cbSGreg Roach
4049a243cbSGreg Roach    /**
4149a243cbSGreg Roach     * Users change change the order of tabs using the control panel.
4249a243cbSGreg Roach     *
4349a243cbSGreg Roach     * @return int
4449a243cbSGreg Roach     */
4549a243cbSGreg Roach    public function getTabOrder(): int
4649a243cbSGreg Roach    {
4749a243cbSGreg Roach        return $this->tab_order ?: $this->defaultTabOrder();
4849a243cbSGreg Roach    }
4949a243cbSGreg Roach
5049a243cbSGreg Roach    /**
5149a243cbSGreg Roach     * The default position for this tab.  It can be changed in the control panel.
5249a243cbSGreg Roach     *
5349a243cbSGreg Roach     * @return int
5449a243cbSGreg Roach     */
55*cbf4b7faSGreg Roach    public function defaultTabOrder(): int
56*cbf4b7faSGreg Roach    {
5749a243cbSGreg Roach        return 9999;
5849a243cbSGreg Roach    }
5949a243cbSGreg Roach}
60