Merge in 5.20
[civicrm-core.git] / CRM / Core / Smarty / plugins / function.crmStyle.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
5 | |
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 |
9 +--------------------------------------------------------------------+
10 */
11
12 /**
13 *
14 * @package CRM
15 * @copyright CiviCRM LLC
16 * $Id$
17 *
18 */
19
20 /**
21 * Add a stylesheet <LINK> to a specific part of the page
22 *
23 * @param array $params
24 * Array with keys:
25 * - ext: string, extension name. see CRM_Core_Resources::addStyleFile
26 * - file: string, relative file path. see CRM_Core_Resources::addStyleFile
27 * - url: string. see CRM_Core_Resources::addStyleURL
28 * - weight: int; default: CRM_Core_Resources::DEFAULT_WEIGHT (0)
29 * - region: string; default: CRM_Core_Resources::DEFAULT_REGION ('html-header')
30 * @param CRM_Core_Smarty $smarty
31 *
32 * @throws Exception
33 */
34 function smarty_function_crmStyle($params, &$smarty) {
35 $res = CRM_Core_Resources::singleton();
36
37 if (empty($params['weight'])) {
38 $params['weight'] = CRM_Core_Resources::DEFAULT_WEIGHT;
39 }
40 if (empty($params['region'])) {
41 $params['region'] = CRM_Core_Resources::DEFAULT_REGION;
42 }
43 if (empty($params['ext'])) {
44 $params['ext'] = 'civicrm';
45 }
46
47 if (array_key_exists('file', $params)) {
48 $res->addStyleFile($params['ext'], $params['file'], $params['weight'], $params['region']);
49 }
50 elseif (array_key_exists('url', $params)) {
51 $res->addStyleUrl($params['url'], $params['weight'], $params['region']);
52 }
53 else {
54 CRM_Core_Error::debug_var('crmStyle_params', $params);
55 throw new Exception("crmStyle requires url or ext+file");
56 }
57 }