.
*/
namespace Fisharebest\Webtrees\Module;
use Fisharebest\Webtrees\Auth;
use Fisharebest\Webtrees\Controller\PageController;
use Fisharebest\Webtrees\Filter;
use Fisharebest\Webtrees\FlashMessages;
use Fisharebest\Webtrees\Functions\FunctionsEdit;
use Fisharebest\Webtrees\I18N;
use Fisharebest\Webtrees\Individual;
use Fisharebest\Webtrees\Menu;
use Fisharebest\Webtrees\Tree;
/**
* Class RelationshipsChartModule
*/
class RelationshipsChartModule extends AbstractModule implements ModuleConfigInterface, ModuleChartInterface {
/** It would be more correct to use PHP_INT_MAX, but this isn't friendly in URLs */
const UNLIMITED_RECURSION = 99;
/** By default new trees allow unlimited recursion */
const DEFAULT_RECURSION = self::UNLIMITED_RECURSION;
/**
* How should this module be labelled on tabs, menus, etc.?
*
* @return string
*/
public function getTitle() {
return /* I18N: Name of a module/chart */ I18N::translate('Relationships');
}
/**
* A sentence describing what this module does.
*
* @return string
*/
public function getDescription() {
return /* I18N: Description of the “RelationshipsChart” module */ I18N::translate('A chart displaying relationships between two individuals.');
}
/**
* What is the default access level for this module?
*
* Some modules are aimed at admins or managers, and are not generally shown to users.
*
* @return int
*/
public function defaultAccessLevel() {
return Auth::PRIV_PRIVATE;
}
/**
* Return a menu item for this chart.
*
* @return Menu|null
*/
public function getChartMenu(Individual $individual) {
$tree = $individual->getTree();
$gedcomid = $tree->getUserPreference(Auth::user(), 'gedcomid');
if ($gedcomid) {
return new Menu(
I18N::translate('Relationship to me'),
'relationship.php?pid1=' . $gedcomid . '&pid2=' . $individual->getXref() . '&ged=' . $tree->getNameUrl(),
'menu-chart-relationship',
array('rel' => 'nofollow')
);
} else {
return new Menu(
I18N::translate('Relationships'),
'relationship.php?pid1=' . $individual->getXref() . '&ged=' . $tree->getNameUrl(),
'menu-chart-relationship',
array('rel' => 'nofollow')
);
}
}
/**
* Return a menu item for this chart - for use in individual boxes.
*
* @return Menu|null
*/
public function getBoxChartMenu(Individual $individual) {
return $this->getChartMenu($individual);
}
/**
* This is a general purpose hook, allowing modules to respond to routes
* of the form module.php?mod=FOO&mod_action=BAR
*
* @param string $mod_action
*/
public function modAction($mod_action) {
switch ($mod_action) {
case 'admin':
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$this->saveConfig();
} else {
$this->editConfig();
}
break;
default:
http_response_code(404);
}
}
/**
* Possible options for the recursion option
*/
private function recursionOptions() {
return array(
0 => I18N::translate('none'),
1 => I18N::number(1),
2 => I18N::number(2),
3 => I18N::number(3),
PHP_INT_MAX => I18N::translate('unlimited'),
);
}
/**
* Display a form to edit configuration settings.
*/
private function editConfig() {
$controller = new PageController;
$controller
->restrictAccess(Auth::isAdmin())
->setPageTitle(I18N::translate('Chart preferences') . ' — ' . $this->getTitle())
->pageHeader();
?>
getPageTitle(); ?>
getPageTitle(); ?>
setPreference('RELATIONSHIP_RECURSION', Filter::post('relationship-recursion-' . $tree->getTreeId()));
}
FlashMessages::addMessage(I18N::translate('The preferences for the chart “%s” have been updated.', $this->getTitle()), 'success');
}
header('Location: ' . WT_BASE_URL . 'module.php?mod=' . $this->getName() . '&mod_action=admin');
}
/**
* The URL to a page where the user can modify the configuration of this module.
*
* @return string
*/
public function getConfigLink() {
return 'module.php?mod=' . $this->getName() . '&mod_action=admin';
}
}