2 namespace Civi\Angular
;
5 * Manage Angular resources.
7 * @package Civi\Angular
12 * @var \CRM_Core_Resources
14 protected $res = NULL;
20 * Each item has some combination of these keys:
22 * The Civi extension which defines the Angular module.
23 * - js: array(string $relativeFilePath)
24 * List of JS files (relative to the extension).
25 * - css: array(string $relativeFilePath)
26 * List of CSS files (relative to the extension).
27 * - partials: array(string $relativeFilePath)
28 * A list of partial-HTML folders (relative to the extension).
29 * This will be mapped to "~/moduleName" by crmResource.
30 * - settings: array(string $key => mixed $value)
31 * List of settings to preload.
32 * - settingsFactory: callable
33 * Callback function to fetch settings.
34 * - permissions: array
35 * List of permissions to make available client-side
37 * List of other modules required
39 protected $modules = NULL;
42 * @var \CRM_Utils_Cache_Interface
48 * Array(string $name => ChangeSet $change).
50 protected $changeSets = NULL;
53 * @param \CRM_Core_Resources $res
54 * The resource manager.
57 public function __construct($res, \CRM_Utils_Cache_Interface
$cache = NULL) {
59 $this->cache
= $cache ?
$cache : new \
CRM_Utils_Cache_ArrayCache([]);
63 * Clear out any runtime-cached metadata.
65 * This is useful if, eg, you have recently added or destroyed Angular modules.
69 public function clear() {
70 $this->cache
->clear();
71 $this->modules
= NULL;
72 $this->changeSets
= NULL;
73 // Force-refresh assetBuilder files
74 \Civi
::container()->get('asset_builder')->clear(FALSE);
79 * Get a list of AngularJS modules which should be autoloaded.
82 * Each item has some combination of these keys:
84 * The Civi extension which defines the Angular module.
85 * - js: array(string $relativeFilePath)
86 * List of JS files (relative to the extension).
87 * - css: array(string $relativeFilePath)
88 * List of CSS files (relative to the extension).
89 * - partials: array(string $relativeFilePath)
90 * A list of partial-HTML folders (relative to the extension).
91 * This will be mapped to "~/moduleName" by crmResource.
92 * - settings: array(string $key => mixed $value)
93 * List of settings to preload.
95 public function getModules() {
96 if ($this->modules
=== NULL) {
97 $config = \CRM_Core_Config
::singleton();
100 // Note: It would be nice to just glob("$civicrm_root/ang/*.ang.php"), but at time
101 // of writing CiviMail and CiviCase have special conditionals.
103 $angularModules = [];
104 $angularModules['angularFileUpload'] = include "$civicrm_root/ang/angularFileUpload.ang.php";
105 $angularModules['checklist-model'] = include "$civicrm_root/ang/checklist-model.ang.php";
106 $angularModules['crmApp'] = include "$civicrm_root/ang/crmApp.ang.php";
107 $angularModules['crmAttachment'] = include "$civicrm_root/ang/crmAttachment.ang.php";
108 $angularModules['crmAutosave'] = include "$civicrm_root/ang/crmAutosave.ang.php";
109 $angularModules['crmCxn'] = include "$civicrm_root/ang/crmCxn.ang.php";
110 $angularModules['crmDialog'] = include "$civicrm_root/ang/crmDialog.ang.php";
111 $angularModules['crmMonaco'] = include "$civicrm_root/ang/crmMonaco.ang.php";
112 $angularModules['crmResource'] = include "$civicrm_root/ang/crmResource.ang.php";
113 $angularModules['crmRouteBinder'] = include "$civicrm_root/ang/crmRouteBinder.ang.php";
114 $angularModules['crmUi'] = include "$civicrm_root/ang/crmUi.ang.php";
115 $angularModules['crmUtil'] = include "$civicrm_root/ang/crmUtil.ang.php";
116 $angularModules['dialogService'] = include "$civicrm_root/ang/dialogService.ang.php";
117 $angularModules['jsonFormatter'] = include "$civicrm_root/ang/jsonFormatter.ang.php";
118 $angularModules['ngRoute'] = include "$civicrm_root/ang/ngRoute.ang.php";
119 $angularModules['ngSanitize'] = include "$civicrm_root/ang/ngSanitize.ang.php";
120 $angularModules['ui.utils'] = include "$civicrm_root/ang/ui.utils.ang.php";
121 $angularModules['ui.bootstrap'] = include "$civicrm_root/ang/ui.bootstrap.ang.php";
122 $angularModules['ui.sortable'] = include "$civicrm_root/ang/ui.sortable.ang.php";
123 $angularModules['unsavedChanges'] = include "$civicrm_root/ang/unsavedChanges.ang.php";
124 $angularModules['crmQueueMonitor'] = include "$civicrm_root/ang/crmQueueMonitor.ang.php";
125 $angularModules['crmStatusPage'] = include "$civicrm_root/ang/crmStatusPage.ang.php";
126 $angularModules['exportui'] = include "$civicrm_root/ang/exportui.ang.php";
127 $angularModules['api4Explorer'] = include "$civicrm_root/ang/api4Explorer.ang.php";
128 $angularModules['api4'] = include "$civicrm_root/ang/api4.ang.php";
129 $angularModules['crmDashboard'] = include "$civicrm_root/ang/crmDashboard.ang.php";
130 $angularModules['crmD3'] = include "$civicrm_root/ang/crmD3.ang.php";
132 foreach (\CRM_Core_Component
::getEnabledComponents() as $component) {
133 $angularModules = array_merge($angularModules, $component->getAngularModules());
135 \CRM_Utils_Hook
::angularModules($angularModules);
136 foreach ($angularModules as $module => $info) {
138 $angularModules[$module] +
= ['basePages' => ['civicrm/a']];
139 // Validate settingsFactory callables
140 if (isset($info['settingsFactory'])) {
141 // To keep the cache small, we want `settingsFactory` to contain the string names of class & function, not an object
142 if (!is_array($info['settingsFactory']) && !is_string($info['settingsFactory'])) {
143 throw new \
CRM_Core_Exception($module . ' settingsFactory must be a callable array or string');
145 // To keep the cache small, convert full object to just the class name
146 if (is_array($info['settingsFactory']) && is_object($info['settingsFactory'][0])) {
147 $angularModules[$module]['settingsFactory'][0] = get_class($info['settingsFactory'][0]);
151 $this->modules
= $this->resolvePatterns($angularModules);
154 return $this->modules
;
158 * Get the descriptor for an Angular module.
160 * @param string $name
163 * Details about the module:
164 * - ext: string, the name of the Civi extension which defines the module
165 * - js: array(string $relativeFilePath).
166 * - css: array(string $relativeFilePath).
167 * - partials: array(string $relativeFilePath).
170 public function getModule($name) {
171 $modules = $this->getModules();
172 if (!isset($modules[$name])) {
173 throw new \
Exception("Unrecognized Angular module");
175 return $modules[$name];
179 * Resolve a full list of Angular dependencies.
181 * @param array $names
182 * List of Angular modules.
183 * Ex: array('crmMailing').
185 * List of Angular modules, include all dependencies.
186 * Ex: array('crmMailing', 'crmUi', 'crmUtil', 'ngRoute').
187 * @throws \CRM_Core_Exception
189 public function resolveDependencies($names) {
190 $allModules = $this->getModules();
193 while (($missingModules = array_diff($result, array_keys($visited))) && !empty($missingModules)) {
194 foreach ($missingModules as $module) {
195 $visited[$module] = 1;
196 if (!isset($allModules[$module])) {
197 throw new \
CRM_Core_Exception("Unrecognized Angular module {$module}. Please ensure that all Angular modules are declared.");
199 elseif (isset($allModules[$module]['requires'])) {
200 $result = array_unique(array_merge($result, $allModules[$module]['requires']));
209 * Get a list of Angular modules that should be loaded on the given
212 * @param string $basePage
213 * The name of the base-page for which we want a list of moudles.
215 * List of Angular modules.
216 * Ex: array('crmMailing', 'crmUi', 'crmUtil', 'ngRoute').
218 public function resolveDefaultModules($basePage) {
219 $modules = $this->getModules();
221 foreach ($modules as $moduleName => $module) {
222 if (in_array($basePage, $module['basePages']) ||
in_array('*', $module['basePages'])) {
223 $result[] = $moduleName;
230 * Convert any globs in an Angular module to file names.
232 * @param array $modules
233 * List of Angular modules.
235 * Updated list of Angular modules
237 protected function resolvePatterns($modules) {
240 foreach ($modules as $moduleKey => $module) {
241 foreach (['js', 'css', 'partials'] as $fileset) {
242 if (!isset($module[$fileset])) {
245 $module[$fileset] = $this->res
->glob($module['ext'], $module[$fileset]);
247 $newModules[$moduleKey] = $module;
254 * Get the partial HTML documents for a module (unfiltered).
256 * @param string $name
257 * Angular module name.
259 * Array(string $extFilePath => string $html)
261 * Invalid partials configuration.
263 public function getRawPartials($name) {
264 $module = $this->getModule($name);
265 $result = !empty($module['partialsCallback'])
266 ? \Civi\Core\Resolver
::singleton()->call($module['partialsCallback'], [$name, $module])
268 if (isset($module['partials'])) {
269 foreach ($module['partials'] as $partialDir) {
270 $partialDir = $this->res
->getPath($module['ext']) . '/' . $partialDir;
271 $files = \CRM_Utils_File
::findFiles($partialDir, '*.html', TRUE);
272 foreach ($files as $file) {
273 $filename = '~/' . $name . '/' . $file;
274 $result[$filename] = file_get_contents($partialDir . '/' . $file);
283 * Get the partial HTML documents for a module.
285 * @param string $name
286 * Angular module name.
288 * Array(string $extFilePath => string $html)
290 * Invalid partials configuration.
292 public function getPartials($name) {
293 $cacheKey = "angular-partials_$name";
294 $cacheValue = $this->cache
->get($cacheKey);
295 if ($cacheValue === NULL) {
296 $cacheValue = ChangeSet
::applyResourceFilters($this->getChangeSets(), 'partials', $this->getRawPartials($name));
297 $this->cache
->set($cacheKey, $cacheValue);
303 * Get list of translated strings for a module.
305 * @param string $name
306 * Angular module name.
308 * Translated strings: array(string $orig => string $translated).
310 public function getTranslatedStrings($name) {
311 $module = $this->getModule($name);
313 $strings = $this->getStrings($name);
314 foreach ($strings as $string) {
315 // TODO: should we pass translation domain based on $module[ext] or $module[tsDomain]?
316 // It doesn't look like client side really supports the domain right now...
317 $translated = ts($string, [
318 'domain' => [$module['ext'], NULL],
320 if ($translated != $string) {
321 $result[$string] = $translated;
328 * Get list of translatable strings for a module.
330 * @param string $name
331 * Angular module name.
333 * Translatable strings.
335 public function getStrings($name) {
336 $module = $this->getModule($name);
338 if (isset($module['js'])) {
339 foreach ($module['js'] as $file) {
340 $strings = $this->res
->getStrings()->get(
342 $this->res
->getPath($module['ext'], $file),
345 $result = array_unique(array_merge($result, $strings));
348 $partials = $this->getPartials($name);
349 foreach ($partials as $partial) {
350 $result = array_unique(array_merge($result, \CRM_Utils_JS
::parseStrings($partial)));
356 * Get resources for one or more modules.
358 * @param string|array $moduleNames
359 * List of module names.
360 * @param string $resType
361 * Type of resource ('js', 'css', 'settings').
362 * @param string $refType
363 * Type of reference to the resource ('cacheUrl', 'rawUrl', 'path', 'settings').
365 * List of URLs or paths.
366 * @throws \CRM_Core_Exception
368 public function getResources($moduleNames, $resType, $refType) {
370 $moduleNames = (array) $moduleNames;
371 foreach ($moduleNames as $moduleName) {
372 $module = $this->getModule($moduleName);
373 if (isset($module[$resType])) {
374 foreach ($module[$resType] as $file) {
376 if (is_string($file) && preg_match(';^(assetBuilder|ext)://;', $file)) {
377 $refTypeSuffix = '-' . parse_url($file, PHP_URL_SCHEME
);
380 switch ($refType . $refTypeSuffix) {
382 $result[] = $this->res
->getPath($module['ext'], $file);
386 $result[] = $this->res
->getUrl($module['ext'], $file);
390 $result[] = $this->res
->getUrl($module['ext'], $file, TRUE);
393 case 'path-assetBuilder':
394 $assetName = parse_url($file, PHP_URL_HOST
) . parse_url($file, PHP_URL_PATH
);
396 parse_str('' . parse_url($file, PHP_URL_QUERY
), $assetParams);
397 $result[] = \Civi
::service('asset_builder')->getPath($assetName, $assetParams);
400 case 'rawUrl-assetBuilder':
401 case 'cacheUrl-assetBuilder':
402 $assetName = parse_url($file, PHP_URL_HOST
) . parse_url($file, PHP_URL_PATH
);
404 parse_str('' . parse_url($file, PHP_URL_QUERY
), $assetParams);
405 $result[] = \Civi
::service('asset_builder')->getUrl($assetName, $assetParams);
409 $result[] = $this->res
->getPath(parse_url($file, PHP_URL_HOST
), ltrim(parse_url($file, PHP_URL_PATH
), '/'));
413 $result[] = $this->res
->getUrl(parse_url($file, PHP_URL_HOST
), ltrim(parse_url($file, PHP_URL_PATH
), '/'));
417 $result[] = $this->res
->getUrl(parse_url($file, PHP_URL_HOST
), ltrim(parse_url($file, PHP_URL_PATH
), '/'), TRUE);
421 case 'settingsFactory':
425 if (!empty($module[$resType])) {
426 $result[$moduleName] = $module[$resType];
431 throw new \
CRM_Core_Exception("Unrecognized resource format");
437 return ChangeSet
::applyResourceFilters($this->getChangeSets(), $resType, $result);
442 * Array(string $name => ChangeSet $changeSet).
444 public function getChangeSets() {
445 if ($this->changeSets
=== NULL) {
446 $this->changeSets
= [];
447 \CRM_Utils_Hook
::alterAngular($this);
449 return $this->changeSets
;
453 * @param ChangeSet $changeSet
454 * @return \Civi\Angular\Manager
456 public function add($changeSet) {
457 $this->changeSets
[$changeSet->getName()] = $changeSet;