<?php
/**
- * @file src/Core/Renderer.php
+ * @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\BaseObject;
-use Friendica\Core\System;
+use Friendica\DI;
use Friendica\Render\FriendicaSmarty;
+use Friendica\Render\ITemplateEngine;
/**
- * @brief This class handles Renderer related functions.
+ * This class handles Renderer related functions.
*/
-class Renderer extends BaseObject
+class Renderer
{
- /**
- * @brief An array of registered template engines ('name'=>'class name')
+ /**
+ * An array of registered template engines ('name'=>'class name')
*/
- public static $template_engines = [];
+ public static $template_engines = [];
- /**
- * @brief An array of instanced template engines ('name'=>'instance')
+ /**
+ * An array of instanced template engines ('name'=>'instance')
*/
public static $template_engine_instance = [];
- /**
- * @brief An array for all theme-controllable parameters
+ /**
+ * An array for all theme-controllable parameters
*
* Mostly unimplemented yet. Only options 'template_engine' and
* beyond are used.
'stylesheet' => '',
'template_engine' => 'smarty3',
];
-
- private static $ldelim = [
+
+ private static $ldelim = [
'internal' => '',
'smarty3' => '{{'
];
private static $rdelim = [
'internal' => '',
'smarty3' => '}}'
- ];
-
- /**
- * @brief This is our template processor
- *
- * @param string|FriendicaSmarty $s The string requiring macro substitution or an instance of FriendicaSmarty
- * @param array $r key value pairs (search => replace)
- *
- * @return string substituted string
- */
- public static function replaceMacros($s, $r)
- {
- $stamp1 = microtime(true);
- $a = self::getApp();
-
- // pass $baseurl to all templates
- $r['$baseurl'] = System::baseUrl();
- $t = self::getTemplateEngine();
-
- try {
- $output = $t->replaceMacros($s, $r);
- } catch (Exception $e) {
- echo "<pre><b>" . __FUNCTION__ . "</b>: " . $e->getMessage() . "</pre>";
- killme();
- }
-
- $a->saveTimestamp($stamp1, "rendering");
-
- return $output;
- }
-
- /**
- * @brief Load a given template $s
- *
- * @param string $s Template to load.
- * @param string $root Optional.
- *
- * @return string template.
- */
- public static function getMarkupTemplate($s, $root = '')
- {
- $stamp1 = microtime(true);
- $a = self::getApp();
- $t = self::getTemplateEngine();
-
- try {
- $template = $t->getTemplateFile($s, $root);
- } catch (Exception $e) {
- echo "<pre><b>" . __FUNCTION__ . "</b>: " . $e->getMessage() . "</pre>";
- killme();
- }
-
- $a->saveTimestamp($stamp1, "file");
-
- return $template;
- }
-
- /**
- * @brief Register template engine class
+ ];
+
+ /**
+ * 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 = [])
+ {
+ $stamp1 = microtime(true);
+
+ // pass $baseurl to all templates if it isn't set
+ $vars = array_merge(['$baseurl' => DI::baseUrl()->get()], $vars);
+
+ $t = self::getTemplateEngine();
+
+ 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());
+
+ return $output;
+ }
+
+ /**
+ * Load a given template $s
+ *
+ * @param string $s Template to load.
+ * @param string $root Optional.
+ *
+ * @return string template.
+ * @throws Exception
+ */
+ public static function getMarkupTemplate($s, $root = '')
+ {
+ $stamp1 = microtime(true);
+ $a = DI::app();
+ $t = self::getTemplateEngine();
+
+ try {
+ $template = $t->getTemplateFile($s, $root);
+ } catch (Exception $e) {
+ echo "<pre><b>" . __FUNCTION__ . "</b>: " . $e->getMessage() . "</pre>";
+ exit();
+ }
+
+ DI::profiler()->saveTimestamp($stamp1, "file", System::callstack());
+
+ return $template;
+ }
+
+ /**
+ * Register template engine class
*
* @param string $class
*/
public static function registerTemplateEngine($class)
{
- $v = get_class_vars($class);
-
- if (!empty($v['name']))
- {
+ $v = get_class_vars($class);
+
+ if (!empty($v['name']))
+ {
$name = $v['name'];
self::$template_engines[$name] = $class;
} else {
}
/**
- * @brief Return template engine instance.
+ * Return template engine instance.
*
* If $name is not defined, return engine defined by theme,
* or default
*
- * @return object Template Engine instance
+ * @return ITemplateEngine Template Engine instance
*/
public static function getTemplateEngine()
{
- $template_engine = defaults(self::$theme, 'template_engine', 'smarty3');
+ $template_engine = (self::$theme['template_engine'] ?? '') ?: 'smarty3';
if (isset(self::$template_engines[$template_engine])) {
if (isset(self::$template_engine_instance[$template_engine])) {
echo "template engine <tt>$template_engine</tt> is not registered!\n";
exit();
- }
-
- /**
- * @brief Returns the active template engine.
+ }
+
+ /**
+ * Returns the active template engine.
*
* @return string the active template engine
*/
self::$theme['template_engine'] = $engine;
}
- /**
+ /**
* Gets the right delimiter for a template engine
*
* Currently: