xref: /webtrees/app/Module/ModuleTabInterface.php (revision 225e381f36d59b49c8cdac0060465fa5af2fc308)
1a25f0a04SGreg Roach<?php
2a25f0a04SGreg Roach/**
3a25f0a04SGreg Roach * webtrees: online genealogy
41062a142SGreg Roach * Copyright (C) 2018 webtrees development team
5a25f0a04SGreg Roach * This program is free software: you can redistribute it and/or modify
6a25f0a04SGreg Roach * it under the terms of the GNU General Public License as published by
7a25f0a04SGreg Roach * the Free Software Foundation, either version 3 of the License, or
8a25f0a04SGreg Roach * (at your option) any later version.
9a25f0a04SGreg Roach * This program is distributed in the hope that it will be useful,
10a25f0a04SGreg Roach * but WITHOUT ANY WARRANTY; without even the implied warranty of
11a25f0a04SGreg Roach * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12a25f0a04SGreg Roach * GNU General Public License for more details.
13a25f0a04SGreg Roach * You should have received a copy of the GNU General Public License
14a25f0a04SGreg Roach * along with this program. If not, see <http://www.gnu.org/licenses/>.
15a25f0a04SGreg Roach */
1676692c8bSGreg Roachnamespace Fisharebest\Webtrees\Module;
17*225e381fSGreg Roachuse Fisharebest\Webtrees\Individual;
18a25f0a04SGreg Roach
19a25f0a04SGreg Roach/**
20a25f0a04SGreg Roach * Interface ModuleTabInterface - Classes and libraries for module system
21a25f0a04SGreg Roach */
22a25f0a04SGreg Roachinterface ModuleTabInterface {
23a25f0a04SGreg Roach	/**
24a25f0a04SGreg Roach	 * The user can re-arrange the tab order, but until they do, this
25a25f0a04SGreg Roach	 * is the order in which tabs are shown.
26a25f0a04SGreg Roach	 *
27cbc1590aSGreg Roach	 * @return int
28a25f0a04SGreg Roach	 */
29a25f0a04SGreg Roach	public function defaultTabOrder();
30a25f0a04SGreg Roach
31a25f0a04SGreg Roach	/**
32a25f0a04SGreg Roach	 * Generate the HTML content of this tab.
33a25f0a04SGreg Roach	 *
34*225e381fSGreg Roach	 * @param Individual $individual
35*225e381fSGreg Roach	 *
36a25f0a04SGreg Roach	 * @return string
37a25f0a04SGreg Roach	 */
38*225e381fSGreg Roach	public function getTabContent(Individual $individual);
39a25f0a04SGreg Roach
40a25f0a04SGreg Roach	/**
41a25f0a04SGreg Roach	 * Is this tab empty? If so, we don't always need to display it.
42cbc1590aSGreg Roach	 *
43*225e381fSGreg Roach	 * @param Individual $individual
44*225e381fSGreg Roach	 *
45cbc1590aSGreg Roach	 * @return bool
46a25f0a04SGreg Roach	 */
47*225e381fSGreg Roach	public function hasTabContent(Individual $individual);
48a25f0a04SGreg Roach
49a25f0a04SGreg Roach	/**
50a25f0a04SGreg Roach	 * Can this tab load asynchronously?
51a25f0a04SGreg Roach	 *
52cbc1590aSGreg Roach	 * @return bool
53a25f0a04SGreg Roach	 */
54a25f0a04SGreg Roach	public function canLoadAjax();
55a25f0a04SGreg Roach
56a25f0a04SGreg Roach	/**
57a25f0a04SGreg Roach	 * A greyed out tab has no actual content, but may perhaps have
58a25f0a04SGreg Roach	 * options to create content.
59a25f0a04SGreg Roach	 *
60*225e381fSGreg Roach	 * @param Individual $individual
61*225e381fSGreg Roach	 *
62cbc1590aSGreg Roach	 * @return bool
63a25f0a04SGreg Roach	 */
64*225e381fSGreg Roach	public function isGrayedOut(Individual $individual);
65a25f0a04SGreg Roach}
66