friendica/src/Core/Renderer.php

237 lines
6.3 KiB
PHP
Raw Normal View History

<?php
/**
2020-02-09 09:45:36 -05:00
* @copyright Copyright (C) 2020, Friendica
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
*/
namespace Friendica\Core;
use Exception;
use Friendica\DI;
use Friendica\Network\HTTPException\InternalServerErrorException;
use Friendica\Render\TemplateEngine;
/**
2020-01-19 01:05:23 -05:00
* This class handles Renderer related functions.
*/
class Renderer
{
2019-04-14 08:05:48 -04:00
/**
2020-01-19 01:05:23 -05:00
* An array of registered template engines ('name'=>'class name')
*/
2019-04-14 08:05:48 -04:00
public static $template_engines = [];
2019-04-14 08:05:48 -04:00
/**
2020-01-19 01:05:23 -05:00
* An array of instanced template engines ('name'=>'instance')
*/
public static $template_engine_instance = [];
2019-04-14 08:05:48 -04:00
/**
2020-01-19 01:05:23 -05:00
* An array for all theme-controllable parameters
*
* Mostly unimplemented yet. Only options 'template_engine' and
* beyond are used.
*/
public static $theme = [
'sourcename' => '',
'videowidth' => 425,
'videoheight' => 350,
'force_max_items' => 0,
'stylesheet' => '',
'template_engine' => 'smarty3',
];
2019-04-14 08:05:48 -04:00
private static $ldelim = [
'internal' => '',
'smarty3' => '{{'
];
private static $rdelim = [
'internal' => '',
'smarty3' => '}}'
2019-04-14 08:05:48 -04:00
];
/**
* Returns the rendered template output from the template string and variables
*
* @param string $template
* @param array $vars
* @return string
* @throws InternalServerErrorException
*/
public static function replaceMacros(string $template, array $vars = [])
2019-04-14 08:05:48 -04:00
{
$stamp1 = microtime(true);
// pass $baseurl to all templates if it isn't set
$vars = array_merge(['$baseurl' => DI::baseUrl()->get(), '$APP' => DI::app()], $vars);
2019-04-14 08:05:48 -04:00
$t = self::getTemplateEngine();
2019-04-14 08:05:48 -04:00
try {
$output = $t->replaceMacros($template, $vars);
2019-04-14 08:05:48 -04:00
} catch (Exception $e) {
DI::logger()->critical($e->getMessage(), ['template' => $template, 'vars' => $vars]);
$message = is_site_admin() ?
$e->getMessage() :
DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator.');
throw new InternalServerErrorException($message);
2019-04-14 08:05:48 -04:00
}
DI::profiler()->saveTimestamp($stamp1, "rendering", System::callstack());
2019-04-14 08:05:48 -04:00
return $output;
}
2019-01-06 16:06:53 -05:00
/**
2020-01-19 01:05:23 -05:00
* Load a given template $s
2019-01-06 16:06:53 -05:00
*
* @param string $file Template to load.
* @param string $subDir Subdirectory (Optional)
2019-01-06 16:06:53 -05:00
*
* @return string template.
* @throws InternalServerErrorException
2019-01-06 16:06:53 -05:00
*/
public static function getMarkupTemplate($file, $subDir = '')
2019-04-14 08:05:48 -04:00
{
$stamp1 = microtime(true);
$t = self::getTemplateEngine();
try {
$template = $t->getTemplateFile($file, $subDir);
2019-04-14 08:05:48 -04:00
} catch (Exception $e) {
DI::logger()->critical($e->getMessage(), ['file' => $file, 'subDir' => $subDir]);
$message = is_site_admin() ?
$e->getMessage() :
DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator.');
throw new InternalServerErrorException($message);
2019-04-14 08:05:48 -04:00
}
DI::profiler()->saveTimestamp($stamp1, "file", System::callstack());
2019-04-14 08:05:48 -04:00
return $template;
}
2019-04-14 08:05:48 -04:00
/**
2020-01-19 01:05:23 -05:00
* Register template engine class
*
* @param string $class
* @throws InternalServerErrorException
*/
public static function registerTemplateEngine($class)
{
2019-04-14 08:05:48 -04:00
$v = get_class_vars($class);
if (!empty($v['name'])) {
$name = $v['name'];
self::$template_engines[$name] = $class;
} else {
$admin_message = DI::l10n()->t('template engine cannot be registered without a name.');
DI::logger()->critical($admin_message, ['class' => $class]);
$message = is_site_admin() ?
$admin_message :
DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator.');
throw new InternalServerErrorException($message);
}
}
/**
2020-01-19 01:05:23 -05:00
* Return template engine instance.
*
* If $name is not defined, return engine defined by theme,
* or default
*
* @return TemplateEngine Template Engine instance
* @throws InternalServerErrorException
*/
public static function getTemplateEngine()
{
$template_engine = (self::$theme['template_engine'] ?? '') ?: 'smarty3';
if (isset(self::$template_engines[$template_engine])) {
if (isset(self::$template_engine_instance[$template_engine])) {
return self::$template_engine_instance[$template_engine];
} else {
$a = DI::app();
$class = self::$template_engines[$template_engine];
$obj = new $class($a->getCurrentTheme(), $a->theme_info);
self::$template_engine_instance[$template_engine] = $obj;
return $obj;
}
}
$admin_message = DI::l10n()->t('template engine is not registered!');
DI::logger()->critical($admin_message, ['template_engine' => $template_engine]);
$message = is_site_admin() ?
$admin_message :
DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator.');
throw new InternalServerErrorException($message);
2019-04-14 08:05:48 -04:00
}
/**
2020-01-19 01:05:23 -05:00
* Returns the active template engine.
*
* @return string the active template engine
*/
public static function getActiveTemplateEngine()
{
return self::$theme['template_engine'];
}
/**
* sets the active template engine
*
* @param string $engine the template engine (default is Smarty3)
*/
public static function setActiveTemplateEngine($engine = 'smarty3')
{
self::$theme['template_engine'] = $engine;
}
2019-04-14 08:05:48 -04:00
/**
* Gets the right delimiter for a template engine
*
* Currently:
* Internal = ''
* Smarty3 = '{{'
*
* @param string $engine The template engine (default is Smarty3)
*
* @return string the right delimiter
*/
public static function getTemplateLeftDelimiter($engine = 'smarty3')
{
return self::$ldelim[$engine];
}
/**
* Gets the left delimiter for a template engine
*
* Currently:
* Internal = ''
* Smarty3 = '}}'
*
* @param string $engine The template engine (default is Smarty3)
*
* @return string the left delimiter
*/
public static function getTemplateRightDelimiter($engine = 'smarty3')
{
return self::$rdelim[$engine];
}
}