<?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\Render\FriendicaSmarty;
+use Friendica\DI;
+use Friendica\Network\HTTPException\InternalServerErrorException;
+use Friendica\Render\TemplateEngine;
/**
- * @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
+ * Returns the rendered template output from the template string and variables
*
- * @param string|FriendicaSmarty $s The string requiring macro substitution or an instance of FriendicaSmarty
- * @param array $vars key value pairs (search => replace)
+ * @param string $template
+ * @param array $vars
+ * @return string
+ * @throws InternalServerErrorException
+ */
+ public static function replaceMacros(string $template, array $vars = [])
+ {
+ $stamp1 = microtime(true);
+
+ // pass $baseurl to all templates if it isn't set
+ $vars = array_merge(['$baseurl' => DI::baseUrl()->get(), '$APP' => DI::app()], $vars);
+
+ $t = self::getTemplateEngine();
+
+ try {
+ $output = $t->replaceMacros($template, $vars);
+ } 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);
+ }
+
+ DI::profiler()->saveTimestamp($stamp1, "rendering", System::callstack());
+
+ return $output;
+ }
+
+ /**
+ * Load a given template $s
+ *
+ * @param string $file Template to load.
+ * @param string $subDir Subdirectory (Optional)
*
- * @return string substituted string
+ * @return string template.
+ * @throws InternalServerErrorException
*/
- public static function replaceMacros($s, $vars)
- {
- $stamp1 = microtime(true);
- $a = self::getApp();
-
- // pass $baseurl to all templates
- $vars['$baseurl'] = System::baseUrl();
- $t = self::getTemplateEngine();
-
- try {
- $output = $t->replaceMacros($s, $vars);
- } catch (Exception $e) {
- echo "<pre><b>" . __FUNCTION__ . "</b>: " . $e->getMessage() . "</pre>";
- exit();
- }
-
- $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
+ public static function getMarkupTemplate($file, $subDir = '')
+ {
+ $stamp1 = microtime(true);
+ $t = self::getTemplateEngine();
+
+ try {
+ $template = $t->getTemplateFile($file, $subDir);
+ } 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);
+ }
+
+ DI::profiler()->saveTimestamp($stamp1, "file", System::callstack());
+
+ return $template;
+ }
+
+ /**
+ * Register template engine class
*
* @param string $class
+ * @throws InternalServerErrorException
*/
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 {
- echo "template engine <tt>$class</tt> cannot be registered without a name.\n";
- die();
+ $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);
}
}
/**
- * @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 TemplateEngine Template Engine instance
+ * @throws InternalServerErrorException
*/
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])) {
return self::$template_engine_instance[$template_engine];
} else {
+ $a = DI::app();
$class = self::$template_engines[$template_engine];
- $obj = new $class;
+ $obj = new $class($a->getCurrentTheme(), $a->theme_info);
self::$template_engine_instance[$template_engine] = $obj;
return $obj;
}
}
- echo "template engine <tt>$template_engine</tt> is not registered!\n";
- exit();
- }
-
- /**
- * @brief Returns the active template engine.
+ $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);
+ }
+
+ /**
+ * 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: