Commit | Line | Data |
---|---|---|
6a488035 TO |
1 | <?php |
2 | /* | |
3 | +--------------------------------------------------------------------+ | |
bc77d7c0 | 4 | | Copyright CiviCRM LLC. All rights reserved. | |
6a488035 | 5 | | | |
bc77d7c0 TO |
6 | | This work is published under the GNU AGPLv3 license with some | |
7 | | permitted exceptions and without any warranty. For full license | | |
8 | | and copyright information, see https://civicrm.org/licensing | | |
6a488035 | 9 | +--------------------------------------------------------------------+ |
d25dd0ee | 10 | */ |
6a488035 TO |
11 | |
12 | /** | |
13 | * | |
14 | * @package CRM | |
ca5cec67 | 15 | * @copyright CiviCRM LLC https://civicrm.org/licensing |
6a488035 TO |
16 | * $Id$ |
17 | * | |
18 | */ | |
19 | ||
20 | /** | |
21 | * Fix for bug CRM-392. Not sure if this is the best fix or it will impact | |
22 | * other similar PEAR packages. doubt it | |
23 | */ | |
24 | if (!class_exists('Smarty')) { | |
25 | require_once 'Smarty/Smarty.class.php'; | |
26 | } | |
27 | ||
28 | /** | |
29 | * | |
30 | */ | |
31 | class CRM_Core_Smarty extends Smarty { | |
7da04cde | 32 | const |
6a488035 TO |
33 | // use print.tpl and bypass the CMS. Civi prints a valid html file |
34 | PRINT_PAGE = 1, | |
da3c7979 | 35 | // this and all the below bypasses the CMS html surrounding it and assumes we will embed this within other pages |
6a488035 TO |
36 | PRINT_SNIPPET = 2, |
37 | // sends the generated html to the chosen pdf engine | |
38 | PRINT_PDF = 3, | |
39 | // this options also skips the enclosing form html and does not | |
40 | // generate any of the hidden fields, most notably qfKey | |
41 | // this is typically used in ajax scripts to embed form snippets based on user choices | |
42 | PRINT_NOFORM = 4, | |
43 | // this prints a complete form and also generates a qfKey, can we replace this with | |
44 | // snippet = 2?? Does the constant _NOFFORM do anything? | |
45 | PRINT_QFKEY = 5, | |
fc05b8da CW |
46 | // Note: added in v 4.3 with the value '6' |
47 | // Value changed in 4.5 to 'json' for better readability | |
48 | // @see CRM_Core_Page_AJAX::returnJsonResponse | |
49 | PRINT_JSON = 'json'; | |
6a488035 TO |
50 | |
51 | /** | |
52 | * We only need one instance of this object. So we use the singleton | |
53 | * pattern and cache the instance in this variable | |
54 | * | |
55 | * @var object | |
6a488035 TO |
56 | */ |
57 | static private $_singleton = NULL; | |
58 | ||
17f267d6 | 59 | /** |
e97c66ff | 60 | * Backup frames. |
61 | * | |
62 | * A list of variables ot save temporarily in format (string $name => mixed $value). | |
63 | * | |
64 | * @var array | |
17f267d6 | 65 | */ |
be2fb01f | 66 | private $backupFrames = []; |
17f267d6 | 67 | |
6a488035 | 68 | /** |
f9e31d7f | 69 | * Class constructor. |
6a488035 TO |
70 | * |
71 | * @return CRM_Core_Smarty | |
6a488035 | 72 | */ |
6ef04c72 | 73 | public function __construct() { |
6a488035 TO |
74 | parent::__construct(); |
75 | } | |
76 | ||
2aa397bc | 77 | private function initialize() { |
6a488035 TO |
78 | $config = CRM_Core_Config::singleton(); |
79 | ||
80 | if (isset($config->customTemplateDir) && $config->customTemplateDir) { | |
be2fb01f | 81 | $this->template_dir = array_merge([$config->customTemplateDir], |
6a488035 TO |
82 | $config->templateDir |
83 | ); | |
84 | } | |
85 | else { | |
86 | $this->template_dir = $config->templateDir; | |
87 | } | |
635f0b86 TO |
88 | $this->compile_dir = CRM_Utils_File::addTrailingSlash(CRM_Utils_File::addTrailingSlash($config->templateCompileDir) . $this->getLocale()); |
89 | CRM_Utils_File::createDir($this->compile_dir); | |
90 | CRM_Utils_File::restrictAccess($this->compile_dir); | |
6a488035 TO |
91 | |
92 | // check and ensure it is writable | |
93 | // else we sometime suppress errors quietly and this results | |
94 | // in blank emails etc | |
95 | if (!is_writable($this->compile_dir)) { | |
96 | echo "CiviCRM does not have permission to write temp files in {$this->compile_dir}, Exiting"; | |
97 | exit(); | |
98 | } | |
99 | ||
100 | //Check for safe mode CRM-2207 | |
101 | if (ini_get('safe_mode')) { | |
102 | $this->use_sub_dirs = FALSE; | |
103 | } | |
104 | else { | |
105 | $this->use_sub_dirs = TRUE; | |
106 | } | |
107 | ||
108 | $customPluginsDir = NULL; | |
109 | if (isset($config->customPHPPathDir)) { | |
e7483cbe J |
110 | $customPluginsDir |
111 | = $config->customPHPPathDir . DIRECTORY_SEPARATOR . | |
353ffa53 TO |
112 | 'CRM' . DIRECTORY_SEPARATOR . |
113 | 'Core' . DIRECTORY_SEPARATOR . | |
114 | 'Smarty' . DIRECTORY_SEPARATOR . | |
115 | 'plugins' . DIRECTORY_SEPARATOR; | |
6a488035 TO |
116 | if (!file_exists($customPluginsDir)) { |
117 | $customPluginsDir = NULL; | |
118 | } | |
119 | } | |
120 | ||
94dbed1f TO |
121 | $smartyDir = dirname(dirname(__DIR__)) . DIRECTORY_SEPARATOR . 'packages' . DIRECTORY_SEPARATOR . 'Smarty' . DIRECTORY_SEPARATOR; |
122 | $pluginsDir = __DIR__ . DIRECTORY_SEPARATOR . 'Smarty' . DIRECTORY_SEPARATOR . 'plugins' . DIRECTORY_SEPARATOR; | |
123 | ||
6a488035 | 124 | if ($customPluginsDir) { |
be2fb01f | 125 | $this->plugins_dir = [$customPluginsDir, $smartyDir . 'plugins', $pluginsDir]; |
6a488035 TO |
126 | } |
127 | else { | |
be2fb01f | 128 | $this->plugins_dir = [$smartyDir . 'plugins', $pluginsDir]; |
6a488035 TO |
129 | } |
130 | ||
d938f496 LS |
131 | $this->compile_check = $this->isCheckSmartyIsCompiled(); |
132 | ||
6a488035 TO |
133 | // add the session and the config here |
134 | $session = CRM_Core_Session::singleton(); | |
135 | ||
136 | $this->assign_by_ref('config', $config); | |
137 | $this->assign_by_ref('session', $session); | |
138 | ||
98466ff9 | 139 | $tsLocale = CRM_Core_I18n::getLocale(); |
6a488035 TO |
140 | $this->assign('tsLocale', $tsLocale); |
141 | ||
142 | // CRM-7163 hack: we don’t display langSwitch on upgrades anyway | |
143 | if (!CRM_Core_Config::isUpgradeMode()) { | |
921ed8ae | 144 | $this->assign('langSwitch', CRM_Core_I18n::uiLanguages()); |
6a488035 TO |
145 | } |
146 | ||
be2fb01f | 147 | $this->register_function('crmURL', ['CRM_Utils_System', 'crmURL']); |
d9aa1c6b | 148 | $this->load_filter('pre', 'resetExtScope'); |
abbf7b48 TO |
149 | |
150 | $this->assign('crmPermissions', new CRM_Core_Smarty_Permissions()); | |
6a488035 TO |
151 | } |
152 | ||
153 | /** | |
154 | * Static instance provider. | |
155 | * | |
156 | * Method providing static instance of SmartTemplate, as | |
157 | * in Singleton pattern. | |
158 | */ | |
00be9182 | 159 | public static function &singleton() { |
6a488035 | 160 | if (!isset(self::$_singleton)) { |
481a74f4 TO |
161 | self::$_singleton = new CRM_Core_Smarty(); |
162 | self::$_singleton->initialize(); | |
6a488035 TO |
163 | |
164 | self::registerStringResource(); | |
165 | } | |
166 | return self::$_singleton; | |
167 | } | |
168 | ||
169 | /** | |
100fef9d | 170 | * Executes & returns or displays the template results |
6a488035 TO |
171 | * |
172 | * @param string $resource_name | |
173 | * @param string $cache_id | |
174 | * @param string $compile_id | |
6a0b768e | 175 | * @param bool $display |
77b97be7 EM |
176 | * |
177 | * @return bool|mixed|string | |
6a488035 | 178 | */ |
00be9182 | 179 | public function fetch($resource_name, $cache_id = NULL, $compile_id = NULL, $display = FALSE) { |
481a74f4 | 180 | if (preg_match('/^(\s+)?string:/', $resource_name)) { |
7155133f ND |
181 | $old_security = $this->security; |
182 | $this->security = TRUE; | |
183 | } | |
184 | $output = parent::fetch($resource_name, $cache_id, $compile_id, $display); | |
185 | if (isset($old_security)) { | |
186 | $this->security = $old_security; | |
187 | } | |
188 | return $output; | |
6a488035 TO |
189 | } |
190 | ||
9b7526a8 TO |
191 | /** |
192 | * Fetch a template (while using certain variables) | |
193 | * | |
194 | * @param string $resource_name | |
6a0b768e TO |
195 | * @param array $vars |
196 | * (string $name => mixed $value) variables to export to Smarty. | |
9b7526a8 TO |
197 | * @throws Exception |
198 | * @return bool|mixed|string | |
199 | */ | |
00be9182 | 200 | public function fetchWith($resource_name, $vars) { |
9b7526a8 TO |
201 | $this->pushScope($vars); |
202 | try { | |
203 | $result = $this->fetch($resource_name); | |
0db6c3e1 TO |
204 | } |
205 | catch (Exception $e) { | |
9b7526a8 TO |
206 | // simulate try { ... } finally { ... } |
207 | $this->popScope(); | |
208 | throw $e; | |
209 | } | |
210 | $this->popScope(); | |
211 | return $result; | |
212 | } | |
213 | ||
a0ee3941 | 214 | /** |
100fef9d | 215 | * @param string $name |
a0ee3941 EM |
216 | * @param $value |
217 | */ | |
00be9182 | 218 | public function appendValue($name, $value) { |
6a488035 TO |
219 | $currentValue = $this->get_template_vars($name); |
220 | if (!$currentValue) { | |
221 | $this->assign($name, $value); | |
222 | } | |
223 | else { | |
224 | if (strpos($currentValue, $value) === FALSE) { | |
225 | $this->assign($name, $currentValue . $value); | |
226 | } | |
227 | } | |
228 | } | |
229 | ||
00be9182 | 230 | public function clearTemplateVars() { |
6a488035 TO |
231 | foreach (array_keys($this->_tpl_vars) as $key) { |
232 | if ($key == 'config' || $key == 'session') { | |
233 | continue; | |
234 | } | |
235 | unset($this->_tpl_vars[$key]); | |
236 | } | |
237 | } | |
238 | ||
00be9182 | 239 | public static function registerStringResource() { |
6a488035 TO |
240 | require_once 'CRM/Core/Smarty/resources/String.php'; |
241 | civicrm_smarty_register_string_resource(); | |
242 | } | |
243 | ||
a0ee3941 EM |
244 | /** |
245 | * @param $path | |
246 | */ | |
00be9182 | 247 | public function addTemplateDir($path) { |
481a74f4 TO |
248 | if (is_array($this->template_dir)) { |
249 | array_unshift($this->template_dir, $path); | |
0db6c3e1 TO |
250 | } |
251 | else { | |
be2fb01f | 252 | $this->template_dir = [$path, $this->template_dir]; |
6a488035 TO |
253 | } |
254 | ||
255 | } | |
17f267d6 TO |
256 | |
257 | /** | |
258 | * Temporarily assign a list of variables. | |
259 | * | |
260 | * @code | |
261 | * $smarty->pushScope(array( | |
262 | * 'first_name' => 'Alice', | |
263 | * 'last_name' => 'roberts', | |
264 | * )); | |
265 | * $html = $smarty->fetch('view-contact.tpl'); | |
266 | * $smarty->popScope(); | |
267 | * @endcode | |
268 | * | |
6a0b768e TO |
269 | * @param array $vars |
270 | * (string $name => mixed $value). | |
17f267d6 TO |
271 | * @return CRM_Core_Smarty |
272 | * @see popScope | |
273 | */ | |
274 | public function pushScope($vars) { | |
275 | $oldVars = $this->get_template_vars(); | |
be2fb01f | 276 | $backupFrame = []; |
17f267d6 TO |
277 | foreach ($vars as $key => $value) { |
278 | $backupFrame[$key] = isset($oldVars[$key]) ? $oldVars[$key] : NULL; | |
279 | } | |
280 | $this->backupFrames[] = $backupFrame; | |
281 | ||
282 | $this->assignAll($vars); | |
283 | ||
284 | return $this; | |
285 | } | |
286 | ||
287 | /** | |
288 | * Remove any values that were previously pushed. | |
289 | * | |
290 | * @return CRM_Core_Smarty | |
291 | * @see pushScope | |
292 | */ | |
293 | public function popScope() { | |
294 | $this->assignAll(array_pop($this->backupFrames)); | |
295 | return $this; | |
296 | } | |
297 | ||
298 | /** | |
6a0b768e TO |
299 | * @param array $vars |
300 | * (string $name => mixed $value). | |
17f267d6 TO |
301 | * @return CRM_Core_Smarty |
302 | */ | |
303 | public function assignAll($vars) { | |
304 | foreach ($vars as $key => $value) { | |
305 | $this->assign($key, $value); | |
306 | } | |
307 | return $this; | |
308 | } | |
96025800 | 309 | |
f2ac86d1 | 310 | /** |
311 | * Get the locale for translation. | |
312 | * | |
313 | * @return string | |
314 | */ | |
635f0b86 | 315 | private function getLocale() { |
98466ff9 | 316 | $tsLocale = CRM_Core_I18n::getLocale(); |
635f0b86 TO |
317 | if (!empty($tsLocale)) { |
318 | return $tsLocale; | |
319 | } | |
320 | ||
321 | $config = CRM_Core_Config::singleton(); | |
322 | if (!empty($config->lcMessages)) { | |
323 | return $config->lcMessages; | |
324 | } | |
325 | ||
326 | return 'en_US'; | |
327 | } | |
328 | ||
d938f496 LS |
329 | /** |
330 | * Get the compile_check value. | |
331 | * | |
332 | * @return bool | |
333 | */ | |
334 | private function isCheckSmartyIsCompiled() { | |
335 | // check for define in civicrm.settings.php as FALSE, otherwise returns TRUE | |
336 | return CRM_Utils_Constant::value('CIVICRM_TEMPLATE_COMPILE_CHECK', TRUE); | |
337 | } | |
338 | ||
6a488035 | 339 | } |