3 * @copyright Copyright (C) 2010-2022, the Friendica project
5 * @license GNU AGPL version 3 or any later version
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.
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.
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/>.
22 namespace Friendica\Render;
24 use Friendica\Core\Hook;
26 use Friendica\Network\HTTPException\ServiceUnavailableException;
27 use Friendica\Util\Strings;
30 * Smarty implementation of the Friendica template abstraction
32 final class FriendicaSmartyEngine extends TemplateEngine
34 static $name = 'smarty3';
36 const FILE_PREFIX = 'file:';
37 const STRING_PREFIX = 'string:';
39 /** @var FriendicaSmarty */
45 public function __construct(string $theme, array $theme_info)
47 $this->theme = $theme;
48 $this->theme_info = $theme_info;
50 $work_dir = DI::config()->get('smarty3', 'config_dir');
51 $use_sub_dirs = DI::config()->get('smarty3', 'use_sub_dirs');
53 $this->smarty = new FriendicaSmarty($this->theme, $this->theme_info, $work_dir, $use_sub_dirs);
55 if (!is_writable($work_dir)) {
56 $admin_message = DI::l10n()->t('The folder %s must be writable by webserver.', $work_dir);
57 DI::logger()->critical($admin_message);
58 $message = DI::app()->isSiteAdmin() ?
60 DI::l10n()->t('Friendica can\'t display this page at the moment, please contact the administrator.');
61 throw new ServiceUnavailableException($message);
68 public function testInstall(array &$errors = null)
70 $this->smarty->testInstall($errors);
76 public function replaceMacros(string $template, array $vars): string
78 if (!Strings::startsWith($template, self::FILE_PREFIX)) {
79 $template = self::STRING_PREFIX . $template;
82 // "middleware": inject variables into templates
84 'template' => basename($this->smarty->filename ?? ''),
87 Hook::callAll('template_vars', $arr);
90 $this->smarty->clearAllAssign();
92 foreach ($vars as $key => $value) {
93 if ($key[0] === '$') {
94 $key = substr($key, 1);
97 $this->smarty->assign($key, $value);
100 return $this->smarty->fetch($template);
106 public function getTemplateFile(string $file, string $subDir = '')
108 // Make sure $root ends with a slash /
109 if ($subDir !== '' && substr($subDir, -1, 1) !== '/') {
110 $subDir = $subDir . '/';
113 $root = DI::basePath() . '/' . $subDir;
115 $filename = $this->smarty::SMARTY3_TEMPLATE_FOLDER . '/' . $file;
117 if (file_exists("{$root}view/theme/$this->theme/$filename")) {
118 $template_file = "{$root}view/theme/$this->theme/$filename";
119 } elseif (!empty($this->theme_info['extends']) && file_exists(sprintf('%sview/theme/%s}/%s', $root, $this->theme_info['extends'], $filename))) {
120 $template_file = sprintf('%sview/theme/%s}/%s', $root, $this->theme_info['extends'], $filename);
121 } elseif (file_exists("{$root}/$filename")) {
122 $template_file = "{$root}/$filename";
124 $template_file = "{$root}view/$filename";
127 $this->smarty->filename = $template_file;
129 return self::FILE_PREFIX . $template_file;