src/Core/Renderer.php

   1 <?php
   2 /**
   3  * @copyright Copyright (C) 2020, Friendica
   4  *
   5  * @license GNU AGPL version 3 or any later version
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU Affero General Public License as
   9  * published by the Free Software Foundation, either version 3 of the
  10  * License, or (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU Affero General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Affero General Public License
  18  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  19  *
  20  */
  21
  22 namespace Friendica\Core;
  23
  24 use Exception;
  25 use Friendica\DI;
  26 use Friendica\Network\HTTPException\InternalServerErrorException;
  27 use Friendica\Render\TemplateEngine;
  28
  29 /**
  30  * This class handles Renderer related functions.
  31  */
  32 class Renderer
  33 {
  34         /**
  35          * An array of registered template engines ('name'=>'class name')
  36          */
  37         public static $template_engines = [];
  38
  39         /**
  40          * An array of instanced template engines ('name'=>'instance')
  41          */
  42         public static $template_engine_instance = [];
  43
  44         /**
  45          * An array for all theme-controllable parameters
  46          *
  47          * Mostly unimplemented yet. Only options 'template_engine' and
  48          * beyond are used.
  49          */
  50         public static $theme = [
  51                 'sourcename' => '',
  52                 'videowidth' => 425,
  53                 'videoheight' => 350,
  54                 'force_max_items' => 0,
  55                 'stylesheet' => '',
  56                 'template_engine' => 'smarty3',
  57         ];
  58
  59         private static $ldelim = [
  60                 'internal' => '',
  61                 'smarty3' => '{{'
  62         ];
  63         private static $rdelim = [
  64                 'internal' => '',
  65                 'smarty3' => '}}'
  66         ];
  67
  68         /**
  69          * Returns the rendered template output from the template string and variables
  70          *
  71          * @param string $template
  72          * @param array  $vars
  73          * @return string
  74          * @throws InternalServerErrorException
  75          */
  76         public static function replaceMacros(string $template, array $vars = [])
  77         {
  78                 $stamp1 = microtime(true);
  79
  80                 // pass $baseurl to all templates if it isn't set
  81                 $vars = array_merge(['$baseurl' => DI::baseUrl()->get(), '$APP' => DI::app()], $vars);
  82
  83                 $t = self::getTemplateEngine();
  84
  85                 try {
  86                         $output = $t->replaceMacros($template, $vars);
  87                 } catch (Exception $e) {
  88                         DI::logger()->critical($e->getMessage(), ['template' => $template, 'vars' => $vars]);
  89                         throw new InternalServerErrorException(DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator or check the Friendica log for errors.'));
  90                 }
  91
  92                 DI::profiler()->saveTimestamp($stamp1, "rendering", System::callstack());
  93
  94                 return $output;
  95         }
  96
  97         /**
  98          * Load a given template $s
  99          *
 100          * @param string $file   Template to load.
 101          * @param string $subDir Subdirectory (Optional)
 102          *
 103          * @return string template.
 104          * @throws InternalServerErrorException
 105          */
 106         public static function getMarkupTemplate($file, $subDir = '')
 107         {
 108                 $stamp1 = microtime(true);
 109                 $t = self::getTemplateEngine();
 110
 111                 try {
 112                         $template = $t->getTemplateFile($file, $subDir);
 113                 } catch (Exception $e) {
 114                         DI::logger()->critical($e->getMessage(), ['file' => $file, 'subDir' => $subDir]);
 115                         throw new InternalServerErrorException(DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator or check the Friendica log for errors.'));
 116                 }
 117
 118                 DI::profiler()->saveTimestamp($stamp1, "file", System::callstack());
 119
 120                 return $template;
 121         }
 122
 123         /**
 124          * Register template engine class
 125          *
 126          * @param string $class
 127          * @throws InternalServerErrorException
 128          */
 129         public static function registerTemplateEngine($class)
 130         {
 131                 $v = get_class_vars($class);
 132
 133                 if (!empty($v['name'])) {
 134                         $name = $v['name'];
 135                         self::$template_engines[$name] = $class;
 136                 } else {
 137                         DI::logger()->critical(DI::l10n()->t('template engine cannot be registered without a name.'), ['class' => $class]);
 138                         throw new InternalServerErrorException(DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator or check the Friendica log for errors.'));
 139                 }
 140         }
 141
 142         /**
 143          * Return template engine instance.
 144          *
 145          * If $name is not defined, return engine defined by theme,
 146          * or default
 147          *
 148          * @return TemplateEngine Template Engine instance
 149          * @throws InternalServerErrorException
 150          */
 151         public static function getTemplateEngine()
 152         {
 153                 $template_engine = (self::$theme['template_engine'] ?? '') ?: 'smarty3';
 154
 155                 if (isset(self::$template_engines[$template_engine])) {
 156                         if (isset(self::$template_engine_instance[$template_engine])) {
 157                                 return self::$template_engine_instance[$template_engine];
 158                         } else {
 159                                 $a = DI::app();
 160                                 $class = self::$template_engines[$template_engine];
 161                                 $obj = new $class($a->getCurrentTheme(), $a->theme_info);
 162                                 self::$template_engine_instance[$template_engine] = $obj;
 163                                 return $obj;
 164                         }
 165                 }
 166
 167                 DI::logger()->critical(DI::l10n()->t('template engine is not registered!'), ['template_engine' => $template_engine]);
 168                 throw new InternalServerErrorException(DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator or check the Friendica log for errors.'));
 169         }
 170
 171         /**
 172          * Returns the active template engine.
 173          *
 174          * @return string the active template engine
 175          */
 176         public static function getActiveTemplateEngine()
 177         {
 178                 return self::$theme['template_engine'];
 179         }
 180
 181         /**
 182          * sets the active template engine
 183          *
 184          * @param string $engine the template engine (default is Smarty3)
 185          */
 186         public static function setActiveTemplateEngine($engine = 'smarty3')
 187         {
 188                 self::$theme['template_engine'] = $engine;
 189         }
 190
 191         /**
 192          * Gets the right delimiter for a template engine
 193          *
 194          * Currently:
 195          * Internal = ''
 196          * Smarty3 = '{{'
 197          *
 198          * @param string $engine The template engine (default is Smarty3)
 199          *
 200          * @return string the right delimiter
 201          */
 202         public static function getTemplateLeftDelimiter($engine = 'smarty3')
 203         {
 204                 return self::$ldelim[$engine];
 205         }
 206
 207         /**
 208          * Gets the left delimiter for a template engine
 209          *
 210          * Currently:
 211          * Internal = ''
 212          * Smarty3 = '}}'
 213          *
 214          * @param string $engine The template engine (default is Smarty3)
 215          *
 216          * @return string the left delimiter
 217          */
 218         public static function getTemplateRightDelimiter($engine = 'smarty3')
 219         {
 220                 return self::$rdelim[$engine];
 221         }
 222 }