Merge pull request #23575 from civicrm/5.50
[civicrm-core.git] / ext / afform / core / afform.php
1 <?php
2
3 require_once 'afform.civix.php';
4 use CRM_Afform_ExtensionUtil as E;
5
6 /**
7 * Filter the content of $params to only have supported afform fields.
8 *
9 * @param array $params
10 * @return array
11 */
12 function _afform_fields_filter($params) {
13 $result = [];
14 $fields = \Civi\Api4\Afform::getfields(FALSE)->setAction('create')->execute()->indexBy('name');
15 foreach ($fields as $fieldName => $field) {
16 if (isset($params[$fieldName])) {
17 $result[$fieldName] = $params[$fieldName];
18
19 if ($field['data_type'] === 'Boolean' && !is_bool($params[$fieldName])) {
20 $result[$fieldName] = CRM_Utils_String::strtobool($params[$fieldName]);
21 }
22 }
23 }
24 return $result;
25 }
26
27 /**
28 * @param \Symfony\Component\DependencyInjection\ContainerBuilder $container
29 */
30 function afform_civicrm_container($container) {
31 $container->addResource(new \Symfony\Component\Config\Resource\FileResource(__FILE__));
32 $container->setDefinition('afform_scanner', new \Symfony\Component\DependencyInjection\Definition(
33 'CRM_Afform_AfformScanner',
34 []
35 ))->setPublic(TRUE);
36 }
37
38 /**
39 * Implements hook_civicrm_config().
40 *
41 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_config
42 */
43 function afform_civicrm_config(&$config) {
44 _afform_civix_civicrm_config($config);
45
46 if (isset(Civi::$statics[__FUNCTION__])) {
47 return;
48 }
49 Civi::$statics[__FUNCTION__] = 1;
50
51 $dispatcher = Civi::dispatcher();
52 $dispatcher->addListener('civi.afform.submit', ['\Civi\Api4\Action\Afform\Submit', 'processGenericEntity'], 0);
53 $dispatcher->addListener('civi.afform.submit', ['\Civi\Api4\Action\Afform\Submit', 'preprocessContact'], 10);
54 $dispatcher->addListener('civi.afform.submit', ['\Civi\Api4\Action\Afform\Submit', 'processRelationships'], 1);
55 $dispatcher->addListener('hook_civicrm_angularModules', ['\Civi\Afform\AngularDependencyMapper', 'autoReq'], -1000);
56 $dispatcher->addListener('hook_civicrm_alterAngular', ['\Civi\Afform\AfformMetadataInjector', 'preprocess']);
57 $dispatcher->addListener('hook_civicrm_check', ['\Civi\Afform\StatusChecks', 'hook_civicrm_check']);
58 $dispatcher->addListener('civi.afform.get', ['\Civi\Api4\Action\Afform\Get', 'getCustomGroupBlocks']);
59
60 // Register support for email tokens
61 if (CRM_Extension_System::singleton()->getMapper()->isActiveModule('authx')) {
62 $dispatcher->addListener('hook_civicrm_alterMailContent', ['\Civi\Afform\Tokens', 'applyCkeditorWorkaround']);
63 $dispatcher->addListener('hook_civicrm_tokens', ['\Civi\Afform\Tokens', 'hook_civicrm_tokens']);
64 $dispatcher->addListener('hook_civicrm_tokenValues', ['\Civi\Afform\Tokens', 'hook_civicrm_tokenValues']);
65 }
66 }
67
68 /**
69 * Implements hook_civicrm_install().
70 *
71 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_install
72 */
73 function afform_civicrm_install() {
74 _afform_civix_civicrm_install();
75 }
76
77 /**
78 * Implements hook_civicrm_postInstall().
79 *
80 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_postInstall
81 */
82 function afform_civicrm_postInstall() {
83 _afform_civix_civicrm_postInstall();
84 }
85
86 /**
87 * Implements hook_civicrm_uninstall().
88 *
89 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_uninstall
90 */
91 function afform_civicrm_uninstall() {
92 _afform_civix_civicrm_uninstall();
93 }
94
95 /**
96 * Implements hook_civicrm_enable().
97 *
98 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_enable
99 */
100 function afform_civicrm_enable() {
101 _afform_civix_civicrm_enable();
102 }
103
104 /**
105 * Implements hook_civicrm_disable().
106 *
107 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_disable
108 */
109 function afform_civicrm_disable() {
110 _afform_civix_civicrm_disable();
111 }
112
113 /**
114 * Implements hook_civicrm_upgrade().
115 *
116 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_upgrade
117 */
118 function afform_civicrm_upgrade($op, CRM_Queue_Queue $queue = NULL) {
119 return _afform_civix_civicrm_upgrade($op, $queue);
120 }
121
122 /**
123 * Implements hook_civicrm_managed().
124 *
125 * Generate a list of entities to create/deactivate/delete when this module
126 * is installed, disabled, uninstalled.
127 *
128 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_managed
129 */
130 function afform_civicrm_managed(&$entities, $modules) {
131 if ($modules && !in_array(E::LONG_NAME, $modules, TRUE)) {
132 return;
133 }
134 /** @var \CRM_Afform_AfformScanner $scanner */
135 if (\Civi::container()->has('afform_scanner')) {
136 $scanner = \Civi::service('afform_scanner');
137 }
138 else {
139 // This might happen at oddballs points - e.g. while you're in the middle of re-enabling the ext.
140 // This AfformScanner instance only lives during this method call, and it feeds off the regular cache.
141 $scanner = new CRM_Afform_AfformScanner();
142 }
143
144 foreach ($scanner->getMetas() as $afform) {
145 if (empty($afform['is_dashlet']) || empty($afform['name'])) {
146 continue;
147 }
148 $entities[] = [
149 'module' => E::LONG_NAME,
150 'name' => 'afform_dashlet_' . $afform['name'],
151 'entity' => 'Dashboard',
152 'update' => 'always',
153 // ideal cleanup policy might be to (a) deactivate if used and (b) remove if unused
154 'cleanup' => 'always',
155 'params' => [
156 'version' => 4,
157 'values' => [
158 // Q: Should we loop through all domains?
159 'domain_id' => 'current_domain',
160 'is_active' => TRUE,
161 'name' => $afform['name'],
162 'label' => $afform['title'] ?? E::ts('(Untitled)'),
163 'directive' => _afform_angular_module_name($afform['name'], 'dash'),
164 'permission' => "@afform:" . $afform['name'],
165 'url' => NULL,
166 ],
167 ],
168 ];
169 }
170 }
171
172 /**
173 * Implements hook_civicrm_tabset().
174 *
175 * Adds afforms as contact summary tabs.
176 */
177 function afform_civicrm_tabset($tabsetName, &$tabs, $context) {
178 if ($tabsetName !== 'civicrm/contact/view') {
179 return;
180 }
181 $scanner = \Civi::service('afform_scanner');
182 $weight = 111;
183 foreach ($scanner->getMetas() as $afform) {
184 if (!empty($afform['contact_summary']) && $afform['contact_summary'] === 'tab') {
185 $module = _afform_angular_module_name($afform['name']);
186 $tabs[] = [
187 'id' => $afform['name'],
188 'title' => $afform['title'],
189 'weight' => $weight++,
190 'icon' => 'crm-i fa-list-alt',
191 'is_active' => TRUE,
192 'template' => 'afform/contactSummary/AfformTab.tpl',
193 'module' => $module,
194 'directive' => _afform_angular_module_name($afform['name'], 'dash'),
195 ];
196 // If this is the real contact summary page (and not a callback from ContactLayoutEditor), load module.
197 if (empty($context['caller'])) {
198 Civi::service('angularjs.loader')->addModules($module);
199 }
200 }
201 }
202 }
203
204 /**
205 * Implements hook_civicrm_pageRun().
206 *
207 * Adds afforms as contact summary blocks.
208 */
209 function afform_civicrm_pageRun(&$page) {
210 if (get_class($page) !== 'CRM_Contact_Page_View_Summary') {
211 return;
212 }
213 $scanner = \Civi::service('afform_scanner');
214 $cid = $page->get('cid');
215 $side = 'left';
216 foreach ($scanner->getMetas() as $afform) {
217 if (!empty($afform['contact_summary']) && $afform['contact_summary'] === 'block') {
218 $module = _afform_angular_module_name($afform['name']);
219 $block = [
220 'module' => $module,
221 'directive' => _afform_angular_module_name($afform['name'], 'dash'),
222 ];
223 $content = CRM_Core_Smarty::singleton()->fetchWith('afform/contactSummary/AfformBlock.tpl', ['contactId' => $cid, 'block' => $block]);
224 CRM_Core_Region::instance("contact-basic-info-$side")->add([
225 'markup' => '<div class="crm-summary-block">' . $content . '</div>',
226 'weight' => 1,
227 ]);
228 Civi::service('angularjs.loader')->addModules($module);
229 $side = $side === 'left' ? 'right' : 'left';
230 }
231 }
232 }
233
234 /**
235 * Implements hook_civicrm_contactSummaryBlocks().
236 *
237 * @link https://github.com/civicrm/org.civicrm.contactlayout
238 */
239 function afform_civicrm_contactSummaryBlocks(&$blocks) {
240 $afforms = \Civi\Api4\Afform::get(FALSE)
241 ->setSelect(['name', 'title', 'directive_name', 'module_name', 'type', 'type:icon', 'type:label'])
242 ->addWhere('contact_summary', '=', 'block')
243 ->execute();
244 foreach ($afforms as $index => $afform) {
245 // Create a group per afform type
246 $blocks += [
247 "afform_{$afform['type']}" => [
248 'title' => $afform['type:label'],
249 'icon' => $afform['type:icon'],
250 'blocks' => [],
251 ],
252 ];
253 $blocks["afform_{$afform['type']}"]['blocks'][$afform['name']] = [
254 'title' => $afform['title'],
255 'tpl_file' => 'afform/contactSummary/AfformBlock.tpl',
256 'module' => $afform['module_name'],
257 'directive' => $afform['directive_name'],
258 'sample' => [
259 $afform['type:label'],
260 ],
261 'edit' => 'civicrm/admin/afform#/edit/' . $afform['name'],
262 'system_default' => [0, $index % 2],
263 ];
264 }
265 }
266
267 /**
268 * Implements hook_civicrm_angularModules().
269 *
270 * Generate a list of Afform Angular modules.
271 */
272 function afform_civicrm_angularModules(&$angularModules) {
273 $afforms = \Civi\Api4\Afform::get(FALSE)
274 ->setSelect(['name', 'requires', 'module_name', 'directive_name'])
275 ->execute();
276
277 foreach ($afforms as $afform) {
278 $angularModules[$afform['module_name']] = [
279 'ext' => E::LONG_NAME,
280 'js' => ['assetBuilder://afform.js?name=' . urlencode($afform['name'])],
281 'requires' => $afform['requires'],
282 'basePages' => [],
283 'partialsCallback' => '_afform_get_partials',
284 '_afform' => $afform['name'],
285 // TODO: Allow afforms to declare their own theming requirements
286 'bundles' => ['bootstrap3'],
287 'exports' => [
288 $afform['directive_name'] => 'E',
289 ],
290 ];
291 }
292 }
293
294 /**
295 * Callback to retrieve partials for a given afform/angular module.
296 *
297 * @see afform_civicrm_angularModules
298 *
299 * @param string $moduleName
300 * The module name.
301 * @param array $module
302 * The module definition.
303 * @return array
304 * Array(string $filename => string $html).
305 * @throws API_Exception
306 */
307 function _afform_get_partials($moduleName, $module) {
308 $afform = civicrm_api4('Afform', 'get', [
309 'where' => [['name', '=', $module['_afform']]],
310 'select' => ['layout'],
311 'layoutFormat' => 'html',
312 'checkPermissions' => FALSE,
313 ], 0);
314 return [
315 "~/$moduleName/$moduleName.aff.html" => $afform['layout'],
316 ];
317 }
318
319 /**
320 * Implements hook_civicrm_entityTypes().
321 *
322 * Declare entity types provided by this module.
323 *
324 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_entityTypes
325 */
326 function afform_civicrm_entityTypes(&$entityTypes) {
327 _afform_civix_civicrm_entityTypes($entityTypes);
328 }
329
330 /**
331 * Implements hook_civicrm_buildAsset().
332 */
333 function afform_civicrm_buildAsset($asset, $params, &$mimeType, &$content) {
334 if ($asset !== 'afform.js') {
335 return;
336 }
337
338 if (empty($params['name'])) {
339 throw new RuntimeException("Missing required parameter: afform.js?name=NAME");
340 }
341
342 $moduleName = _afform_angular_module_name($params['name'], 'camel');
343 $formMetaData = (array) civicrm_api4('Afform', 'get', [
344 'checkPermissions' => FALSE,
345 'select' => ['redirect', 'name', 'title'],
346 'where' => [['name', '=', $params['name']]],
347 ], 0);
348 $smarty = CRM_Core_Smarty::singleton();
349 $smarty->assign('afform', [
350 'camel' => $moduleName,
351 'meta' => $formMetaData,
352 'templateUrl' => "~/$moduleName/$moduleName.aff.html",
353 ]);
354 $mimeType = 'text/javascript';
355 $content = $smarty->fetch('afform/AfformAngularModule.tpl');
356 }
357
358 /**
359 * Implements hook_civicrm_alterMenu().
360 */
361 function afform_civicrm_alterMenu(&$items) {
362 try {
363 $afforms = \Civi\Api4\Afform::get(FALSE)
364 ->addWhere('server_route', 'IS NOT EMPTY')
365 ->addSelect('name', 'server_route', 'is_public')
366 ->execute()->indexBy('name');
367 }
368 catch (Exception $e) {
369 // During installation...
370 $scanner = new CRM_Afform_AfformScanner();
371 $afforms = $scanner->getMetas();
372 }
373 foreach ($afforms as $name => $meta) {
374 if (!empty($meta['server_route'])) {
375 $items[$meta['server_route']] = [
376 'page_callback' => 'CRM_Afform_Page_AfformBase',
377 'page_arguments' => 'afform=' . urlencode($name),
378 'access_arguments' => [["@afform:$name"], 'and'],
379 'is_public' => $meta['is_public'],
380 ];
381 }
382 }
383 }
384
385 /**
386 * Implements hook_civicrm_permission_check().
387 *
388 * This extends the list of permissions available in `CRM_Core_Permission:check()`
389 * by introducing virtual-permissions named `@afform:myForm`. The evaluation
390 * of these virtual-permissions is dependent on the settings for `myForm`.
391 * `myForm` may be exposed/integrated through multiple subsystems (routing,
392 * nav-menu, API, etc), and the use of virtual-permissions makes easy to enforce
393 * consistent permissions across any relevant subsystems.
394 *
395 * @see CRM_Utils_Hook::permission_check()
396 */
397 function afform_civicrm_permission_check($permission, &$granted, $contactId) {
398 if ($permission[0] !== '@') {
399 // Micro-optimization - this function may get hit a lot.
400 return;
401 }
402
403 if (preg_match('/^@afform:(.*)/', $permission, $m)) {
404 $name = $m[1];
405
406 $afform = \Civi\Api4\Afform::get()
407 ->setCheckPermissions(FALSE)
408 ->addWhere('name', '=', $name)
409 ->setSelect(['permission'])
410 ->execute()
411 ->first();
412 if ($afform) {
413 $granted = CRM_Core_Permission::check($afform['permission'], $contactId);
414 }
415 }
416 }
417
418 /**
419 * Implements hook_civicrm_permissionList().
420 *
421 * @see CRM_Utils_Hook::permissionList()
422 */
423 function afform_civicrm_permissionList(&$permissions) {
424 $scanner = Civi::service('afform_scanner');
425 foreach ($scanner->getMetas() as $name => $meta) {
426 $permissions['@afform:' . $name] = [
427 'group' => 'afform',
428 'title' => E::ts('Afform: Inherit permission of %1', [
429 1 => $name,
430 ]),
431 ];
432 }
433 }
434
435 /**
436 * Clear any local/in-memory caches based on afform data.
437 */
438 function _afform_clear() {
439 $container = \Civi::container();
440 $container->get('afform_scanner')->clear();
441 $container->get('angular')->clear();
442 }
443
444 /**
445 * @param string $fileBaseName
446 * Ex: foo-bar
447 * @param string $format
448 * 'camel' or 'dash'.
449 * @return string
450 * Ex: 'FooBar' or 'foo-bar'.
451 * @throws \Exception
452 */
453 function _afform_angular_module_name($fileBaseName, $format = 'camel') {
454 switch ($format) {
455 case 'camel':
456 $camelCase = '';
457 foreach (preg_split('/[-_ ]/', $fileBaseName, NULL, PREG_SPLIT_NO_EMPTY) as $shortNamePart) {
458 $camelCase .= ucfirst($shortNamePart);
459 }
460 return strtolower($camelCase[0]) . substr($camelCase, 1);
461
462 case 'dash':
463 return strtolower(implode('-', preg_split('/[-_ ]|(?=[A-Z])/', $fileBaseName, NULL, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE)));
464
465 default:
466 throw new \Exception("Unrecognized format");
467 }
468 }
469
470 /**
471 * Implements hook_civicrm_alterApiRoutePermissions().
472 *
473 * @see CRM_Utils_Hook::alterApiRoutePermissions
474 */
475 function afform_civicrm_alterApiRoutePermissions(&$permissions, $entity, $action) {
476 if ($entity == 'Afform') {
477 // These actions should be accessible to anonymous users; permissions are checked internally
478 $allowedActions = ['prefill', 'submit', 'submitFile', 'getOptions'];
479 if (in_array($action, $allowedActions, TRUE)) {
480 $permissions = CRM_Core_Permission::ALWAYS_ALLOW_PERMISSION;
481 }
482 }
483 }
484
485 /**
486 * Implements hook_civicrm_preProcess().
487 *
488 * Wordpress only: Adds Afforms to the shortcode dialog (when editing pages/posts).
489 */
490 function afform_civicrm_preProcess($formName, &$form) {
491 if ($formName === 'CRM_Core_Form_ShortCode') {
492 $form->components['afform'] = [
493 'label' => E::ts('Form Builder'),
494 'select' => [
495 'key' => 'name',
496 'entity' => 'Afform',
497 'select' => ['minimumInputLength' => 0],
498 'api' => [
499 'params' => ['type' => ['IN' => ['form', 'search']]],
500 ],
501 ],
502 ];
503 }
504 }
505
506 /**
507 * Implements hook_civicrm_pre().
508 */
509 function afform_civicrm_pre($op, $entity, $id, &$params) {
510 // When deleting a searchDisplay, also delete any Afforms the display is embedded within
511 if ($entity === 'SearchDisplay' && $op === 'delete') {
512 $display = \Civi\Api4\SearchDisplay::get(FALSE)
513 ->addSelect('saved_search_id.name', 'name')
514 ->addWhere('id', '=', $id)
515 ->execute()->first();
516 \Civi\Api4\Afform::revert(FALSE)
517 ->addWhere('search_displays', 'CONTAINS', $display['saved_search_id.name'] . ".{$display['name']}")
518 ->execute();
519 }
520 // When deleting a savedSearch, delete any Afforms which use the default display
521 elseif ($entity === 'SavedSearch' && $op === 'delete') {
522 $search = \Civi\Api4\SavedSearch::get(FALSE)
523 ->addSelect('name')
524 ->addWhere('id', '=', $id)
525 ->execute()->first();
526 \Civi\Api4\Afform::revert(FALSE)
527 ->addWhere('search_displays', 'CONTAINS', $search['name'])
528 ->execute();
529 }
530 }
531
532 /**
533 * Implements hook_civicrm_referenceCounts().
534 */
535 function afform_civicrm_referenceCounts($dao, &$counts) {
536 // Count afforms which contain a search display
537 if (is_a($dao, 'CRM_Search_DAO_SearchDisplay') && $dao->id) {
538 if (empty($dao->saved_search_id) || empty($dao->name)) {
539 $dao->find(TRUE);
540 }
541 $search = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_SavedSearch', $dao->saved_search_id);
542 $afforms = \Civi\Api4\Afform::get(FALSE)
543 ->selectRowCount()
544 ->addWhere('search_displays', 'CONTAINS', "$search.$dao->name")
545 ->execute();
546 if ($afforms->count()) {
547 $counts[] = [
548 'name' => 'Afform',
549 'type' => 'Afform',
550 'count' => $afforms->count(),
551 ];
552 }
553 }
554 // Count afforms which contain any displays from a SavedSearch (including the default display)
555 elseif (is_a($dao, 'CRM_Contact_DAO_SavedSearch') && $dao->id) {
556 if (empty($dao->name)) {
557 $dao->find(TRUE);
558 }
559 $clauses = [
560 ['search_displays', 'CONTAINS', $dao->name],
561 ];
562 try {
563 $displays = civicrm_api4('SearchDisplay', 'get', [
564 'where' => [['saved_search_id', '=', $dao->id]],
565 'select' => 'name',
566 ], ['name']);
567 foreach ($displays as $displayName) {
568 $clauses[] = ['search_displays', 'CONTAINS', $dao->name . '.' . $displayName];
569 }
570 }
571 catch (Exception $e) {
572 // In case SearchKit is not installed, the api call would fail
573 }
574 $afforms = \Civi\Api4\Afform::get(FALSE)
575 ->selectRowCount()
576 ->addClause('OR', $clauses)
577 ->execute();
578 if ($afforms->count()) {
579 $counts[] = [
580 'name' => 'Afform',
581 'type' => 'Afform',
582 'count' => $afforms->count(),
583 ];
584 }
585 }
586 }
587
588 // Wordpress only: Register callback for rendering shortcodes
589 if (function_exists('add_filter')) {
590 add_filter('civicrm_shortcode_get_markup', 'afform_shortcode_content', 10, 4);
591 }
592
593 /**
594 * Wordpress only: Render Afform content for shortcodes.
595 *
596 * @param string $content
597 * HTML Markup
598 * @param array $atts
599 * Shortcode attributes.
600 * @param array $args
601 * Existing shortcode arguments.
602 * @param string $context
603 * How many shortcodes are present on the page: 'single' or 'multiple'.
604 * @return string
605 * Modified markup.
606 */
607 function afform_shortcode_content($content, $atts, $args, $context) {
608 if ($atts['component'] === 'afform') {
609 $afform = civicrm_api4('Afform', 'get', [
610 'select' => ['directive_name', 'module_name'],
611 'where' => [['name', '=', $atts['name']]],
612 ])->first();
613 if ($afform) {
614 Civi::service('angularjs.loader')->addModules($afform['module_name']);
615 $content = "
616 <div class='crm-container' id='bootstrap-theme'>
617 <crm-angular-js modules='{$afform['module_name']}'>
618 <{$afform['directive_name']}></{$afform['directive_name']}>
619 </crm-angular-js>
620 </div>";
621 }
622 }
623 return $content;
624 }