friendica/src/Core/Renderer.php

222 lines
5.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\Render\FriendicaSmarty;
2019-01-21 16:51:59 -05:00
use Friendica\Render\ITemplateEngine;
/**
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
];
/**
2020-01-19 01:05:23 -05:00
* This is our template processor
*
* @param string|FriendicaSmarty $s The string requiring macro substitution or an instance of FriendicaSmarty
* @param array $vars Key value pairs (search => replace)
*
* @return string substituted string
* @throws Exception
*/
public static function replaceMacros($s, 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()], $vars);
2019-04-14 08:05:48 -04:00
$t = self::getTemplateEngine();
2019-04-14 08:05:48 -04:00
try {
$output = $t->replaceMacros($s, $vars);
} catch (Exception $e) {
echo "<pre><b>" . __FUNCTION__ . "</b>: " . $e->getMessage() . "</pre>";
exit();
}
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 $s Template to load.
* @param string $subDir Subdirectory (Optional)
2019-01-06 16:06:53 -05:00
*
* @return string template.
* @throws Exception
*/
public static function getMarkupTemplate($s, $subDir = '')
2019-04-14 08:05:48 -04:00
{
$stamp1 = microtime(true);
$t = self::getTemplateEngine();
try {
$template = $t->getTemplateFile($s, $subDir);
2019-04-14 08:05:48 -04:00
} catch (Exception $e) {
echo "<pre><b>" . __FUNCTION__ . "</b>: " . $e->getMessage() . "</pre>";
exit();
}
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
*/
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 {
echo "template engine <tt>$class</tt> cannot be registered without a name.\n";
die();
}
}
/**
2020-01-19 01:05:23 -05:00
* Return template engine instance.
*
* If $name is not defined, return engine defined by theme,
* or default
*
2019-01-07 01:07:42 -05:00
* @return ITemplateEngine Template Engine instance
*/
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 {
$class = self::$template_engines[$template_engine];
$obj = new $class;
self::$template_engine_instance[$template_engine] = $obj;
return $obj;
}
}
echo "template engine <tt>$template_engine</tt> is not registered!\n";
exit();
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];
}
}