'class name') */ public static $template_engines = []; /** * @brief An array of instanced template engines ('name'=>'instance') */ public static $template_engine_instance = []; /** * @brief 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', ]; 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 $vars key value pairs (search => replace) * @param bool $overwriteURL Overwrite the base url with the system wide set base url * * @return string substituted string * @throws \Friendica\Network\HTTPException\InternalServerErrorException */ public static function replaceMacros($s, $vars, $overwriteURL = true) { $stamp1 = microtime(true); $a = self::getApp(); // pass $baseurl to all templates if ($overwriteURL) { $vars['$baseurl'] = System::baseUrl(); } $t = self::getTemplateEngine(); try { $output = $t->replaceMacros($s, $vars); } catch (Exception $e) { echo "
" . __FUNCTION__ . ": " . $e->getMessage() . ""; exit(); } $a->getProfiler()->saveTimestamp($stamp1, "rendering", System::callstack()); return $output; } /** * @brief 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 = self::getApp(); $t = self::getTemplateEngine(); try { $template = $t->getTemplateFile($s, $root); } catch (Exception $e) { echo "
" . __FUNCTION__ . ": " . $e->getMessage() . ""; exit(); } $a->getProfiler()->saveTimestamp($stamp1, "file", System::callstack()); return $template; } /** * @brief Register template engine class * * @param string $class */ public static function registerTemplateEngine($class) { $v = get_class_vars($class); if (!empty($v['name'])) { $name = $v['name']; self::$template_engines[$name] = $class; } else { echo "template engine $class cannot be registered without a name.\n"; die(); } } /** * @brief Return template engine instance. * * If $name is not defined, return engine defined by theme, * or default * * @return ITemplateEngine Template Engine instance */ public static function getTemplateEngine() { $template_engine = defaults(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 $template_engine is not registered!\n"; exit(); } /** * @brief 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; } /** * 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]; } }