2 namespace Civi\Angular
;
5 * Manage Angular resources.
7 * @package Civi\Angular
12 * @var \CRM_Core_Resources
14 protected $res = NULL;
18 * Each item has some combination of these keys:
20 * The Civi extension which defines the Angular module.
21 * - js: array(string $relativeFilePath)
22 * List of JS files (relative to the extension).
23 * - css: array(string $relativeFilePath)
24 * List of CSS files (relative to the extension).
25 * - partials: array(string $relativeFilePath)
26 * A list of partial-HTML folders (relative to the extension).
27 * This will be mapped to "~/moduleName" by crmResource.
28 * - settings: array(string $key => mixed $value)
29 * List of settings to preload.
31 protected $modules = NULL;
34 * @param \CRM_Core_Resources $res
35 * The resource manager.
37 public function __construct($res) {
42 * Get a list of AngularJS modules which should be autoloaded.
45 * Each item has some combination of these keys:
47 * The Civi extension which defines the Angular module.
48 * - js: array(string $relativeFilePath)
49 * List of JS files (relative to the extension).
50 * - css: array(string $relativeFilePath)
51 * List of CSS files (relative to the extension).
52 * - partials: array(string $relativeFilePath)
53 * A list of partial-HTML folders (relative to the extension).
54 * This will be mapped to "~/moduleName" by crmResource.
55 * - settings: array(string $key => mixed $value)
56 * List of settings to preload.
58 public function getModules() {
59 if ($this->modules
=== NULL) {
60 $config = \CRM_Core_Config
::singleton();
62 $angularModules = array();
63 $angularModules['angularFileUpload'] = array(
65 'js' => array('bower_components/angular-file-upload/angular-file-upload.min.js'),
67 $angularModules['crmApp'] = array(
69 'js' => array('ang/crmApp.js'),
71 $angularModules['crmAttachment'] = array(
73 'js' => array('ang/crmAttachment.js'),
74 'css' => array('ang/crmAttachment.css'),
75 'partials' => array('ang/crmAttachment'),
77 'token' => \CRM_Core_Page_AJAX_Attachment
::createToken(),
80 $angularModules['crmAutosave'] = array(
82 'js' => array('ang/crmAutosave.js'),
84 $angularModules['crmCxn'] = array(
86 'js' => array('ang/crmCxn.js', 'ang/crmCxn/*.js'),
87 'css' => array('ang/crmCxn.css'),
88 'partials' => array('ang/crmCxn'),
90 //$angularModules['crmExample'] = array(
91 // 'ext' => 'civicrm',
92 // 'js' => array('ang/crmExample.js'),
93 // 'partials' => array('ang/crmExample'),
95 $angularModules['crmResource'] = array(
97 // 'js' => array('js/angular-crmResource/byModule.js'), // One HTTP request per module.
98 'js' => array('js/angular-crmResource/all.js'), // One HTTP request for all modules.
100 $angularModules['crmUi'] = array(
102 'js' => array('ang/crmUi.js'),
103 'partials' => array('ang/crmUi'),
105 'browseUrl' => $config->userFrameworkResourceURL
. 'packages/kcfinder/browse.php',
106 'uploadUrl' => $config->userFrameworkResourceURL
. 'packages/kcfinder/upload.php',
109 $angularModules['crmUtil'] = array(
111 'js' => array('ang/crmUtil.js'),
113 // https://github.com/jwstadler/angular-jquery-dialog-service
114 $angularModules['dialogService'] = array(
116 'js' => array('bower_components/angular-jquery-dialog-service/dialog-service.js'),
118 $angularModules['ngRoute'] = array(
120 'js' => array('bower_components/angular-route/angular-route.min.js'),
122 $angularModules['ngSanitize'] = array(
124 'js' => array('bower_components/angular-sanitize/angular-sanitize.min.js'),
126 $angularModules['ui.utils'] = array(
128 'js' => array('bower_components/angular-ui-utils/ui-utils.min.js'),
130 $angularModules['ui.sortable'] = array(
132 'js' => array('bower_components/angular-ui-sortable/sortable.min.js'),
134 $angularModules['unsavedChanges'] = array(
136 'js' => array('bower_components/angular-unsavedChanges/dist/unsavedChanges.min.js'),
139 foreach (\CRM_Core_Component
::getEnabledComponents() as $component) {
140 $angularModules = array_merge($angularModules, $component->getAngularModules());
142 \CRM_Utils_Hook
::angularModules($angularModules);
143 $this->modules
= $this->resolvePatterns($angularModules);
146 return $this->modules
;
150 * Get the descriptor for an Angular module.
152 * @param string $name
155 * Details about the module:
156 * - ext: string, the name of the Civi extension which defines the module
157 * - js: array(string $relativeFilePath).
158 * - css: array(string $relativeFilePath).
159 * - partials: array(string $relativeFilePath).
162 public function getModule($name) {
163 $modules = $this->getModules();
164 if (!isset($modules[$name])) {
165 throw new \
Exception("Unrecognized Angular module");
167 return $modules[$name];
171 * Convert any globs in an Angular module to file names.
173 * @param array $modules
174 * List of Angular modules.
176 * Updated list of Angular modules
178 protected function resolvePatterns($modules) {
179 $newModules = array();
181 foreach ($modules as $moduleKey => $module) {
182 foreach (array('js', 'css', 'partials') as $fileset) {
183 if (!isset($module[$fileset])) {
186 $module[$fileset] = $this->res
->glob($module['ext'], $module[$fileset]);
188 $newModules[$moduleKey] = $module;
195 * Get the partial HTML documents for a module.
197 * @param string $name
198 * Angular module name.
200 * Array(string $extFilePath => string $html)
202 * Invalid partials configuration.
204 public function getPartials($name) {
205 $module = $this->getModule($name);
207 if (isset($module['partials'])) {
208 foreach ($module['partials'] as $partialDir) {
209 $partialDir = $this->res
->getPath($module['ext']) . '/' . $partialDir;
210 $files = \CRM_Utils_File
::findFiles($partialDir, '*.html', TRUE);
211 foreach ($files as $file) {
212 $filename = '~/' . $name . '/' . $file;
213 $result[$filename] = file_get_contents($partialDir . '/' . $file);
221 * Get list of translated strings for a module.
223 * @param string $name
224 * Angular module name.
226 * Translated strings: array(string $orig => string $translated).
228 public function getTranslatedStrings($name) {
229 $module = $this->getModule($name);
231 $strings = $this->getStrings($name);
232 foreach ($strings as $string) {
233 // TODO: should we pass translation domain based on $module[ext] or $module[tsDomain]?
234 // It doesn't look like client side really supports the domain right now...
235 $translated = ts($string, array(
236 'domain' => array($module['ext'], NULL),
238 if ($translated != $string) {
239 $result[$string] = $translated;
246 * Get list of translatable strings for a module.
248 * @param string $name
249 * Angular module name.
251 * Translatable strings.
253 public function getStrings($name) {
254 $module = $this->getModule($name);
256 if (isset($module['js'])) {
257 foreach ($module['js'] as $file) {
258 $strings = $this->res
->getStrings()->get(
260 $this->res
->getPath($module['ext'], $file),
263 $result = array_unique(array_merge($result, $strings));
266 if (isset($module['partials'])) {
267 foreach ($module['partials'] as $partialDir) {
268 $partialDir = $this->res
->getPath($module['ext']) . '/' . $partialDir;
269 $files = \CRM_Utils_File
::findFiles($partialDir, '*.html');
270 foreach ($files as $file) {
271 $strings = $this->res
->getStrings()->get(
276 $result = array_unique(array_merge($result, $strings));
284 * Get resources for one or more modules.
286 * @param string|array $moduleNames
287 * List of module names.
288 * @param string $resType
289 * Type of resource ('js', 'css', 'settings').
290 * @param string $refType
291 * Type of reference to the resource ('cacheUrl', 'rawUrl', 'path', 'settings').
293 * List of URLs or paths.
294 * @throws \CRM_Core_Exception
296 public function getResources($moduleNames, $resType, $refType) {
298 $moduleNames = (array) $moduleNames;
299 foreach ($moduleNames as $moduleName) {
300 $module = $this->getModule($moduleName);
301 if (isset($module[$resType])) {
302 foreach ($module[$resType] as $file) {
305 $result[] = $this->res
->getPath($module['ext'], $file);
309 $result[] = $this->res
->getUrl($module['ext'], $file);
313 $result[] = $this->res
->getUrl($module['ext'], $file, TRUE);
317 if (!empty($module[$resType])) {
318 $result[$moduleName] = $module[$resType];
323 throw new \
CRM_Core_Exception("Unrecognized resource format");