.
*/
namespace Fisharebest\Webtrees\Module;
use Fisharebest\Webtrees\Auth;
use Fisharebest\Webtrees\Bootstrap4;
use Fisharebest\Webtrees\Filter;
use Fisharebest\Webtrees\Functions\FunctionsDate;
use Fisharebest\Webtrees\Functions\FunctionsEdit;
use Fisharebest\Webtrees\Html;
use Fisharebest\Webtrees\I18N;
use Fisharebest\Webtrees\Site;
use Fisharebest\Webtrees\Stats;
use Fisharebest\Webtrees\Tree;
/**
* Class HtmlBlockModule
*/
class HtmlBlockModule extends AbstractModule implements ModuleBlockInterface {
/** {@inheritdoc} */
public function getTitle() {
return /* I18N: Name of a module */
I18N::translate('HTML');
}
/** {@inheritdoc} */
public function getDescription() {
return /* I18N: Description of the “HTML” module */
I18N::translate('Add your own text and graphics.');
}
/**
* Generate the HTML content of this block.
*
* @param int $block_id
* @param bool $template
* @param string[] $cfg
*
* @return string
*/
public function getBlock($block_id, $template = true, $cfg = []): string {
global $ctype, $WT_TREE;
$title = $this->getBlockSetting($block_id, 'title', '');
$content = $this->getBlockSetting($block_id, 'html', '');
$gedcom = $this->getBlockSetting($block_id, 'gedcom');
$show_timestamp = $this->getBlockSetting($block_id, 'show_timestamp', '0');
$languages = $this->getBlockSetting($block_id, 'languages');
// Only show this block for certain languages
if ($languages && !in_array(WT_LOCALE, explode(',', $languages))) {
return '';
}
/*
* Select GEDCOM
*/
switch ($gedcom) {
case '__current__':
$stats = new Stats($WT_TREE);
break;
case '__default__':
$tree = Tree::findByName(Site::getPreference('DEFAULT_GEDCOM'));
if ($tree) {
$stats = new Stats($tree);
} else {
$stats = new Stats($WT_TREE);
}
break;
default:
$tree = Tree::findByName($gedcom);
if ($tree) {
$stats = new Stats($tree);
} else {
$stats = new Stats($WT_TREE);
}
break;
}
/*
* Retrieve text, process embedded variables
*/
$title = $stats->embedTags($title);
$content = $stats->embedTags($content);
if ($show_timestamp === '1') {
$content .= '
' . FunctionsDate::formatTimestamp($this->getBlockSetting($block_id, 'timestamp', WT_TIMESTAMP) + WT_TIMESTAMP_OFFSET);
}
if ($template) {
if ($ctype === 'gedcom' && Auth::isManager($WT_TREE)) {
$config_url = route('tree-page-block-edit', ['block_id' => $block_id, 'ged' => $WT_TREE->getName()]);
} elseif ($ctype === 'user' && Auth::check()) {
$config_url = route('user-page-block-edit', ['block_id' => $block_id, 'ged' => $WT_TREE->getName()]);
} else {
$config_url = '';
}
return view('blocks/template', [
'block' => str_replace('_', '-', $this->getName()),
'id' => $block_id,
'config_url' => $config_url,
'title' => $title,
'content' => $content,
]);
} else {
return $content;
}
}
/** {@inheritdoc} */
public function loadAjax(): bool {
return false;
}
/** {@inheritdoc} */
public function isUserBlock(): bool {
return true;
}
/** {@inheritdoc} */
public function isGedcomBlock(): bool {
return true;
}
/**
* An HTML form to edit block settings
*
* @param int $block_id
*
* @return void
*/
public function configureBlock($block_id) {
global $WT_TREE;
if (Filter::postBool('save') && Filter::checkCsrf()) {
$languages = Filter::postArray('lang');
$this->setBlockSetting($block_id, 'gedcom', Filter::post('gedcom'));
$this->setBlockSetting($block_id, 'title', Filter::post('title'));
$this->setBlockSetting($block_id, 'html', Filter::post('html'));
$this->setBlockSetting($block_id, 'show_timestamp', Filter::postBool('show_timestamp'));
$this->setBlockSetting($block_id, 'timestamp', Filter::post('timestamp'));
$this->setBlockSetting($block_id, 'languages', implode(',', $languages));
}
$templates = [
I18N::translate('Keyword examples') => '#getAllTagsTable#',
I18N::translate('Narrative description') => /* I18N: do not translate the #keywords# */ I18N::translate('This family tree was last updated on #gedcomUpdated#. There are #totalSurnames# surnames in this family tree. The earliest recorded event is the #firstEventType# of #firstEventName# in #firstEventYear#. The most recent event is the #lastEventType# of #lastEventName# in #lastEventYear#.
If you have any comments or feedback please contact #contactWebmaster#.'),
I18N::translate('Statistics') => '
' . I18N::translate('Individuals') . ' | #totalIndividuals# |
---|---|
' . I18N::translate('Males') . ' | #totalSexMales# #totalSexMalesPercentage# |
' . I18N::translate('Females') . ' | #totalSexFemales# #totalSexFemalesPercentage# |
' . I18N::translate('Total surnames') . ' | #totalSurnames# |
' . I18N::translate('Families') . ' | #totalFamilies# |
' . I18N::translate('Sources') . ' | #totalSources# |
' . I18N::translate('Media objects') . ' | #totalMedia# |
' . I18N::translate('Repositories') . ' | #totalRepositories# |
' . I18N::translate('Events') . ' | #totalEvents# |
' . I18N::translate('Users') . ' | #totalUsers# |
' . I18N::translate('Earliest birth') . ' | #firstBirth# |
---|---|
' . I18N::translate('Latest birth') . ' | #lastBirth# |
' . I18N::translate('Earliest death') . ' | #firstDeath# |
' . I18N::translate('Latest death') . ' | #lastDeath# |
' . I18N::translate('Individual who lived the longest') . ' | #longestLife# |
' . I18N::translate('Average age at death') . ' | #averageLifespan# |
' . I18N::translate('Family with the most children') . ' | #largestFamilySize# #largestFamily# |
' . I18N::translate('Average number of children per family') . ' | #averageChildren# |
= I18N::translate('To assist you in getting started with this block, we have created several standard templates. When you select one of these templates, the text area will contain a copy that you can then alter to suit your site’s requirements.') ?>
= I18N::translate('As well as using the toolbar to apply HTML formatting, you can insert database fields which are updated automatically. These special fields are marked with # characters. For example #totalFamilies# will be replaced with the actual number of families in the database. Advanced users may wish to apply CSS classes to their text, so that the formatting matches the currently selected theme.') ?>