js/Common.js

   1 // https://civicrm.org/licensing
   2 /* global CRM:true */
   3 var CRM = CRM || {};
   4 var cj = CRM.$ = jQuery;
   5 CRM._ = _;
   6
   7 /**
   8  * Short-named function for string translation, defined in global scope so it's available everywhere.
   9  *
  10  * @param text string for translating
  11  * @param params object key:value of additional parameters
  12  *
  13  * @return string
  14  */
  15 function ts(text, params) {
  16   "use strict";
  17   var d = (params && params.domain) ? ('strings::' + params.domain) : null;
  18   if (d && CRM[d] && CRM[d][text]) {
  19     text = CRM[d][text];
  20   }
  21   else if (CRM.strings[text]) {
  22     text = CRM.strings[text];
  23   }
  24   if (typeof(params) === 'object') {
  25     for (var i in params) {
  26       if (typeof(params[i]) === 'string' || typeof(params[i]) === 'number') {
  27         // sprintf emulation: escape % characters in the replacements to avoid conflicts
  28         text = text.replace(new RegExp('%' + i, 'g'), String(params[i]).replace(/%/g, '%-crmescaped-'));
  29       }
  30     }
  31     return text.replace(/%-crmescaped-/g, '%');
  32   }
  33   return text;
  34 }
  35
  36 // Legacy code - ignore warnings
  37 /* jshint ignore:start */
  38
  39 /**
  40  *  This function is called by default at the bottom of template files which have forms that have
  41  *  conditionally displayed/hidden sections and elements. The PHP is responsible for generating
  42  *  a list of 'blocks to show' and 'blocks to hide' and the template passes these parameters to
  43  *  this function.
  44  *
  45  * @deprecated
  46  * @param  showBlocks Array of element Id's to be displayed
  47  * @param  hideBlocks Array of element Id's to be hidden
  48  * @param elementType Value to set display style to for showBlocks (e.g. 'block' or 'table-row' or ...)
  49  */
  50 function on_load_init_blocks(showBlocks, hideBlocks, elementType) {
  51   if (elementType == null) {
  52     elementType = 'block';
  53   }
  54
  55   var myElement, i;
  56
  57   /* This loop is used to display the blocks whose IDs are present within the showBlocks array */
  58   for (i = 0; i < showBlocks.length; i++) {
  59     myElement = document.getElementById(showBlocks[i]);
  60     /* getElementById returns null if element id doesn't exist in the document */
  61     if (myElement != null) {
  62       myElement.style.display = elementType;
  63     }
  64     else {
  65       alert('showBlocks array item not in .tpl = ' + showBlocks[i]);
  66     }
  67   }
  68
  69   /* This loop is used to hide the blocks whose IDs are present within the hideBlocks array */
  70   for (i = 0; i < hideBlocks.length; i++) {
  71     myElement = document.getElementById(hideBlocks[i]);
  72     /* getElementById returns null if element id doesn't exist in the document */
  73     if (myElement != null) {
  74       myElement.style.display = 'none';
  75     }
  76     else {
  77       alert('showBlocks array item not in .tpl = ' + hideBlocks[i]);
  78     }
  79   }
  80 }
  81
  82 /**
  83  *  This function is called when we need to show or hide a related form element (target_element)
  84  *  based on the value (trigger_value) of another form field (trigger_field).
  85  *
  86  * @deprecated
  87  * @param  trigger_field_id     HTML id of field whose onchange is the trigger
  88  * @param  trigger_value        List of integers - option value(s) which trigger show-element action for target_field
  89  * @param  target_element_id    HTML id of element to be shown or hidden
  90  * @param  target_element_type  Type of element to be shown or hidden ('block' or 'table-row')
  91  * @param  field_type           Type of element radio/select
  92  * @param  invert               Boolean - if true, we HIDE target on value match; if false, we SHOW target on value match
  93  */
  94 function showHideByValue(trigger_field_id, trigger_value, target_element_id, target_element_type, field_type, invert) {
  95   var target, j;
  96
  97   if (field_type == 'select') {
  98     var trigger = trigger_value.split("|");
  99     var selectedOptionValue = cj('#' + trigger_field_id).val();
 100
 101     target = target_element_id.split("|");
 102     for (j = 0; j < target.length; j++) {
 103       if (invert) {
 104         cj('#' + target[j]).show();
 105       }
 106       else {
 107         cj('#' + target[j]).hide();
 108       }
 109       for (var i = 0; i < trigger.length; i++) {
 110         if (selectedOptionValue == trigger[i]) {
 111           if (invert) {
 112             cj('#' + target[j]).hide();
 113           }
 114           else {
 115             cj('#' + target[j]).show();
 116           }
 117         }
 118       }
 119     }
 120
 121   }
 122   else {
 123     if (field_type == 'radio') {
 124       target = target_element_id.split("|");
 125       for (j = 0; j < target.length; j++) {
 126         if (cj('[name="' + trigger_field_id + '"]:first').is(':checked')) {
 127           if (invert) {
 128             cj('#' + target[j]).hide();
 129           }
 130           else {
 131             cj('#' + target[j]).show();
 132           }
 133         }
 134         else {
 135           if (invert) {
 136             cj('#' + target[j]).show();
 137           }
 138           else {
 139             cj('#' + target[j]).hide();
 140           }
 141         }
 142       }
 143     }
 144   }
 145 }
 146
 147 /**
 148  * Function to change button text and disable one it is clicked
 149  * @deprecated
 150  * @param obj object - the button clicked
 151  * @param formID string - the id of the form being submitted
 152  * @param string procText - button text after user clicks it
 153  * @return bool
 154  */
 155 var submitcount = 0;
 156 /* Changes button label on submit, and disables button after submit for newer browsers.
 157  Puts up alert for older browsers. */
 158 function submitOnce(obj, formId, procText) {
 159   // if named button clicked, change text
 160   if (obj.value != null) {
 161     cj('input[name=' + obj.name + ']').val(procText + " ...");
 162   }
 163   cj(obj).closest('form').attr('data-warn-changes', 'false');
 164   if (document.getElementById) { // disable submit button for newer browsers
 165     cj('input[name=' + obj.name + ']').attr("disabled", true);
 166     document.getElementById(formId).submit();
 167     return true;
 168   }
 169   else { // for older browsers
 170     if (submitcount == 0) {
 171       submitcount++;
 172       return true;
 173     }
 174     else {
 175       alert("Your request is currently being processed ... Please wait.");
 176       return false;
 177     }
 178   }
 179 }
 180
 181 /**
 182  * Function to show / hide the row in optionFields
 183  * @deprecated
 184  * @param index string, element whose innerHTML is to hide else will show the hidden row.
 185  */
 186 function showHideRow(index) {
 187   if (index) {
 188     cj('tr#optionField_' + index).hide();
 189     if (cj('table#optionField tr:hidden:first').length) {
 190       cj('div#optionFieldLink').show();
 191     }
 192   }
 193   else {
 194     cj('table#optionField tr:hidden:first').show();
 195     if (!cj('table#optionField tr:hidden:last').length) {
 196       cj('div#optionFieldLink').hide();
 197     }
 198   }
 199   return false;
 200 }
 201
 202 /* jshint ignore:end */
 203
 204 if (!CRM.utils) CRM.utils = {};
 205 if (!CRM.strings) CRM.strings = {};
 206 if (!CRM.vars) CRM.vars = {};
 207
 208 (function ($, _, undefined) {
 209   "use strict";
 210   /* jshint validthis: true */
 211
 212   // Theme classes for unattached elements
 213   $.fn.select2.defaults.dropdownCssClass = $.ui.dialog.prototype.options.dialogClass = 'crm-container';
 214
 215   // https://github.com/ivaynberg/select2/pull/2090
 216   $.fn.select2.defaults.width = 'resolve';
 217
 218   // Workaround for https://github.com/ivaynberg/select2/issues/1246
 219   $.ui.dialog.prototype._allowInteraction = function(e) {
 220     return !!$(e.target).closest('.ui-dialog, .ui-datepicker, .select2-drop, .cke_dialog, #civicrm-menu').length;
 221   };
 222
 223   // Implements jQuery hook.prop
 224   $.propHooks.disabled = {
 225     set: function (el, value, name) {
 226       // Sync button enabled status with wrapper css
 227       if ($(el).is('span.crm-button > input.crm-form-submit')) {
 228         $(el).parent().toggleClass('crm-button-disabled', !!value);
 229       }
 230       // Sync button enabled status with dialog button
 231       if ($(el).is('.ui-dialog input.crm-form-submit')) {
 232         $(el).closest('.ui-dialog').find('.ui-dialog-buttonset button[data-identifier='+ $(el).attr('name') +']').prop('disabled', value);
 233       }
 234       if ($(el).is('.crm-form-date-wrapper .crm-hidden-date')) {
 235         $(el).siblings().prop('disabled', value);
 236       }
 237     }
 238   };
 239
 240   var scriptsLoaded = {};
 241   CRM.loadScript = function(url) {
 242     if (!scriptsLoaded[url]) {
 243       var script = document.createElement('script');
 244       scriptsLoaded[url] = $.Deferred();
 245       script.onload = function () {
 246         scriptsLoaded[url].resolve();
 247       };
 248       script.src = url;
 249       document.getElementsByTagName("head")[0].appendChild(script);
 250     }
 251     return scriptsLoaded[url];
 252   };
 253
 254   /**
 255    * Populate a select list, overwriting the existing options except for the placeholder.
 256    * @param select jquery selector - 1 or more select elements
 257    * @param options array in format returned by api.getoptions
 258    * @param placeholder string|bool - new placeholder or false (default) to keep the old one
 259    * @param value string|array - will silently update the element with new value without triggering change
 260    */
 261   CRM.utils.setOptions = function(select, options, placeholder, value) {
 262     $(select).each(function() {
 263       var
 264         $elect = $(this),
 265         val = value || $elect.val() || [],
 266         opts = placeholder || placeholder === '' ? '' : '[value!=""]';
 267       $elect.find('option' + opts).remove();
 268       var newOptions = CRM.utils.renderOptions(options, val);
 269       if (typeof placeholder === 'string') {
 270         if ($elect.is('[multiple]')) {
 271           select.attr('placeholder', placeholder);
 272         } else {
 273           newOptions = '<option value="">' + placeholder + '</option>' + newOptions;
 274         }
 275       }
 276       $elect.append(newOptions);
 277       if (!value) {
 278         $elect.trigger('crmOptionsUpdated', $.extend({}, options)).trigger('change');
 279       }
 280     });
 281   };
 282
 283   /**
 284    * Render an option list
 285    * @param options {array}
 286    * @param val {string} default value
 287    * @param escapeHtml {bool}
 288    * @return string
 289    */
 290   CRM.utils.renderOptions = function(options, val, escapeHtml) {
 291     var rendered = '',
 292       esc = escapeHtml === false ? _.identity : _.escape;
 293     if (!$.isArray(val)) {
 294       val = [val];
 295     }
 296     _.each(options, function(option) {
 297       if (option.children) {
 298         rendered += '<optgroup label="' + esc(option.value) + '">' +
 299         CRM.utils.renderOptions(option.children, val) +
 300         '</optgroup>';
 301       } else {
 302         var selected = ($.inArray('' + option.key, val) > -1) ? 'selected="selected"' : '';
 303         rendered += '<option value="' + esc(option.key) + '"' + selected + '>' + esc(option.value) + '</option>';
 304       }
 305     });
 306     return rendered;
 307   };
 308
 309   function chainSelect() {
 310     var $form = $(this).closest('form'),
 311       $target = $('select[data-name="' + $(this).data('target') + '"]', $form),
 312       data = $target.data(),
 313       val = $(this).val();
 314     $target.prop('disabled', true);
 315     if ($target.is('select.crm-chain-select-control')) {
 316       $('select[data-name="' + $target.data('target') + '"]', $form).prop('disabled', true).blur();
 317     }
 318     if (!(val && val.length)) {
 319       CRM.utils.setOptions($target.blur(), [], data.emptyPrompt);
 320     } else {
 321       $target.addClass('loading');
 322       $.getJSON(CRM.url(data.callback), {_value: val}, function(vals) {
 323         $target.prop('disabled', false).removeClass('loading');
 324         CRM.utils.setOptions($target, vals || [], (vals && vals.length ? data.selectPrompt : data.nonePrompt));
 325       });
 326     }
 327   }
 328
 329   /**
 330    * Compare Form Input values against cached initial value.
 331    *
 332    * @return {Boolean} true if changes have been made.
 333    */
 334   CRM.utils.initialValueChanged = function(el) {
 335     var isDirty = false;
 336     $(':input:visible, .select2-container:visible+:input:hidden', el).not('[type=submit], [type=button], .crm-action-menu, :disabled').each(function () {
 337       var
 338         initialValue = $(this).data('crm-initial-value'),
 339         currentValue = $(this).is(':checkbox, :radio') ? $(this).prop('checked') : $(this).val();
 340       // skip change of value for submit buttons
 341       if (initialValue !== undefined && !_.isEqual(initialValue, currentValue)) {
 342         isDirty = true;
 343       }
 344     });
 345     return isDirty;
 346   };
 347
 348   /**
 349    * This provides defaults for ui.dialog which either need to be calculated or are different from global defaults
 350    *
 351    * @param settings
 352    * @returns {*}
 353    */
 354   CRM.utils.adjustDialogDefaults = function(settings) {
 355     settings = $.extend({width: '65%', height: '65%', modal: true}, settings || {});
 356     // Support relative height
 357     if (typeof settings.height === 'string' && settings.height.indexOf('%') > 0) {
 358       settings.height = parseInt($(window).height() * (parseFloat(settings.height)/100), 10);
 359     }
 360     // Responsive adjustment - increase percent width on small screens
 361     if (typeof settings.width === 'string' && settings.width.indexOf('%') > 0) {
 362       var screenWidth = $(window).width(),
 363         percentage = parseInt(settings.width.replace('%', ''), 10),
 364         gap = 100-percentage;
 365       if (screenWidth < 701) {
 366         settings.width = '100%';
 367       }
 368       else if (screenWidth < 1400) {
 369         settings.width = '' + parseInt(percentage+gap-((screenWidth - 700)/7*(gap)/100), 10) + '%';
 370       }
 371     }
 372     return settings;
 373   };
 374
 375   function formatCrmSelect2(row) {
 376     var icon = $(row.element).data('icon');
 377     return (icon ? '<i class="crm-i ' + icon + '"></i> ' : '') + _.escape(row.text);
 378   }
 379
 380   /**
 381    * Wrapper for select2 initialization function; supplies defaults
 382    * @param options object
 383    */
 384   $.fn.crmSelect2 = function(options) {
 385     if (options === 'destroy') {
 386       return $(this).each(function() {
 387         $(this)
 388           .removeClass('crm-ajax-select')
 389           .select2('destroy');
 390       });
 391     }
 392     return $(this).each(function () {
 393       var
 394         $el = $(this),
 395         iconClass,
 396         settings = {
 397           allowClear: !$el.hasClass('required'),
 398           formatResult: formatCrmSelect2,
 399           formatSelection: formatCrmSelect2
 400         };
 401       // quickform doesn't support optgroups so here's a hack :(
 402       $('option[value^=crm_optgroup]', this).each(function () {
 403         $(this).nextUntil('option[value^=crm_optgroup]').wrapAll('<optgroup label="' + $(this).text() + '" />');
 404         $(this).remove();
 405       });
 406
 407       // quickform does not support disabled option, so yet another hack to
 408       // add disabled property for option values
 409       $('option[value^=crm_disabled_opt]', this).attr('disabled', 'disabled');
 410
 411       // Placeholder icon - total hack hikacking the escapeMarkup function but select2 3.5 dosn't have any other callbacks for this :(
 412       if ($el.is('[class*=fa-]')) {
 413         settings.escapeMarkup = function (m) {
 414           var out = _.escape(m),
 415             placeholder = settings.placeholder || $el.data('placeholder') || $el.attr('placeholder') || $('option[value=""]', $el).text();
 416           if (m.length && placeholder === m) {
 417             iconClass = $el.attr('class').match(/(fa-\S*)/)[1];
 418             out = '<i class="crm-i ' + iconClass + '"></i> ' + out;
 419           }
 420           return out;
 421         };
 422       }
 423
 424       // Defaults for single-selects
 425       if ($el.is('select:not([multiple])')) {
 426         settings.minimumResultsForSearch = 10;
 427         if ($('option:first', this).val() === '') {
 428           settings.placeholderOption = 'first';
 429         }
 430       }
 431       $.extend(settings, $el.data('select-params') || {}, options || {});
 432       if (settings.ajax) {
 433         $el.addClass('crm-ajax-select');
 434       }
 435       $el.select2(settings);
 436     });
 437   };
 438
 439   /**
 440    * @see CRM_Core_Form::addEntityRef for docs
 441    * @param options object
 442    */
 443   $.fn.crmEntityRef = function(options) {
 444     if (options === 'destroy') {
 445       return $(this).each(function() {
 446         var entity = $(this).data('api-entity') || '';
 447         $(this)
 448           .off('.crmEntity')
 449           .removeClass('crm-form-entityref crm-' + entity.toLowerCase() + '-ref')
 450           .crmSelect2('destroy');
 451       });
 452     }
 453     options = options || {};
 454     options.select = options.select || {};
 455     return $(this).each(function() {
 456       var
 457         $el = $(this).off('.crmEntity'),
 458         entity = options.entity || $el.data('api-entity') || 'contact',
 459         selectParams = {};
 460       $el.data('api-entity', entity);
 461       $el.data('select-params', $.extend({}, $el.data('select-params') || {}, options.select));
 462       $el.data('api-params', $.extend(true, {}, $el.data('api-params') || {}, options.api));
 463       $el.data('create-links', options.create || $el.data('create-links'));
 464       $el.addClass('crm-form-entityref crm-' + entity.toLowerCase() + '-ref');
 465       var settings = {
 466         // Use select2 ajax helper instead of CRM.api3 because it provides more value
 467         ajax: {
 468           url: CRM.url('civicrm/ajax/rest'),
 469           quietMillis: 300,
 470           data: function (input, page_num) {
 471             var params = getEntityRefApiParams($el);
 472             params.input = input;
 473             params.page_num = page_num;
 474             return {
 475               entity: $el.data('api-entity'),
 476               action: 'getlist',
 477               json: JSON.stringify(params)
 478             };
 479           },
 480           results: function(data) {
 481             return {more: data.more_results, results: data.values || []};
 482           }
 483         },
 484         minimumInputLength: 1,
 485         formatResult: CRM.utils.formatSelect2Result,
 486         formatSelection: function(row) {
 487           return _.escape((row.prefix !== undefined ? row.prefix + ' ' : '') + row.label + (row.suffix !== undefined ? ' ' + row.suffix : ''));
 488         },
 489         escapeMarkup: _.identity,
 490         initSelection: function($el, callback) {
 491           var
 492             multiple = !!$el.data('select-params').multiple,
 493             val = $el.val(),
 494             stored = $el.data('entity-value') || [];
 495           if (val === '') {
 496             return;
 497           }
 498           // If we already have this data, just return it
 499           if (!_.xor(val.split(','), _.pluck(stored, 'id')).length) {
 500             callback(multiple ? stored : stored[0]);
 501           } else {
 502             var params = $.extend({}, $el.data('api-params') || {}, {id: val});
 503             CRM.api3($el.data('api-entity'), 'getlist', params).done(function(result) {
 504               callback(multiple ? result.values : result.values[0]);
 505               // Trigger change (store data to avoid an infinite loop of lookups)
 506               $el.data('entity-value', result.values).trigger('change');
 507             });
 508           }
 509         }
 510       };
 511       // Create new items inline - works for tags
 512       if ($el.data('create-links') && entity.toLowerCase() === 'tag') {
 513         selectParams.createSearchChoice = function(term, data) {
 514           if (!_.findKey(data, {label: term})) {
 515             return {id: "0", term: term, label: term + ' (' + ts('new tag') + ')'};
 516           }
 517         };
 518         selectParams.tokenSeparators = [','];
 519         selectParams.createSearchChoicePosition = 'bottom';
 520         $el.on('select2-selecting.crmEntity', function(e) {
 521           if (e.val === "0") {
 522             // Create a new term
 523             e.object.label = e.object.term;
 524             CRM.api3(entity, 'create', $.extend({name: e.object.term}, $el.data('api-params').params || {}))
 525               .done(function(created) {
 526                 var
 527                   val = $el.select2('val'),
 528                   data = $el.select2('data'),
 529                   item = {id: created.id, label: e.object.term};
 530                 if (val === "0") {
 531                   $el.select2('data', item, true);
 532                 }
 533                 else if ($.isArray(val) && $.inArray("0", val) > -1) {
 534                   _.remove(data, {id: "0"});
 535                   data.push(item);
 536                   $el.select2('data', data, true);
 537                 }
 538               });
 539           }
 540         });
 541       }
 542       else {
 543         selectParams.formatInputTooShort = function() {
 544           var txt = $el.data('select-params').formatInputTooShort || $.fn.select2.defaults.formatInputTooShort.call(this);
 545           txt += entityRefFiltersMarkup($el) + renderEntityRefCreateLinks($el);
 546           return txt;
 547         };
 548         selectParams.formatNoMatches = function() {
 549           var txt = $el.data('select-params').formatNoMatches || $.fn.select2.defaults.formatNoMatches;
 550           txt += entityRefFiltersMarkup($el) + renderEntityRefCreateLinks($el);
 551           return txt;
 552         };
 553         $el.on('select2-open.crmEntity', function() {
 554           var $el = $(this);
 555           renderEntityRefFilterValue($el);
 556           $('#select2-drop')
 557             .off('.crmEntity')
 558             .on('click.crmEntity', 'a.crm-add-entity', function(e) {
 559               var extra = $el.data('api-params').extra,
 560                 formUrl = $(this).attr('href') + '&returnExtra=display_name,sort_name' + (extra ? (',' + extra) : '');
 561               $el.select2('close');
 562               CRM.loadForm(formUrl, {
 563                 dialog: {width: 500, height: 220}
 564               }).on('crmFormSuccess', function(e, data) {
 565                 if (data.status === 'success' && data.id) {
 566                   data.label = data.extra.sort_name;
 567                   CRM.status(ts('%1 Created', {1: data.extra.display_name}));
 568                   if ($el.select2('container').hasClass('select2-container-multi')) {
 569                     var selection = $el.select2('data');
 570                     selection.push(data);
 571                     $el.select2('data', selection, true);
 572                   } else {
 573                     $el.select2('data', data, true);
 574                   }
 575                 }
 576               });
 577               return false;
 578             })
 579             .on('change.crmEntity', '.crm-entityref-filter-value', function() {
 580               var filter = $el.data('user-filter') || {};
 581               filter.value = $(this).val();
 582               $(this).toggleClass('active', !!filter.value);
 583               $el.data('user-filter', filter);
 584               if (filter.value) {
 585                 // Once a filter has been chosen, rerender create links and refocus the search box
 586                 $el.select2('close');
 587                 $el.select2('open');
 588               } else {
 589                 $('.crm-entityref-links', '#select2-drop').replaceWith(renderEntityRefCreateLinks($el));
 590               }
 591             })
 592             .on('change.crmEntity', 'select.crm-entityref-filter-key', function() {
 593               var filter = {key: $(this).val()};
 594               $(this).toggleClass('active', !!filter.key);
 595               $el.data('user-filter', filter);
 596               renderEntityRefFilterValue($el);
 597               $('.crm-entityref-filter-key', '#select2-drop').focus();
 598             });
 599         });
 600       }
 601       $el.crmSelect2($.extend(settings, $el.data('select-params'), selectParams));
 602     });
 603   };
 604
 605   /**
 606    * Combine api-params with user-filter
 607    * @param $el
 608    * @returns {*}
 609    */
 610   function getEntityRefApiParams($el) {
 611     var
 612       params = $.extend({params: {}}, $el.data('api-params') || {}),
 613       // Prevent original data from being modified - $.extend and _.clone don't cut it, they pass nested objects by reference!
 614       combined = _.cloneDeep(params),
 615       filter = $.extend({}, $el.data('user-filter') || {});
 616     if (filter.key && filter.value) {
 617       // Fieldname may be prefixed with joins
 618       var fieldName = _.last(filter.key.split('.'));
 619       // Special case for contact type/sub-type combo
 620       if (fieldName === 'contact_type' && (filter.value.indexOf('__') > 0)) {
 621         combined.params[filter.key] = filter.value.split('__')[0];
 622         combined.params[filter.key.replace('contact_type', 'contact_sub_type')] = filter.value.split('__')[1];
 623       } else {
 624         // Allow json-encoded api filters e.g. {"BETWEEN":[123,456]}
 625         combined.params[filter.key] = filter.value.charAt(0) === '{' ? $.parseJSON(filter.value) : filter.value;
 626       }
 627     }
 628     return combined;
 629   }
 630
 631   function copyAttributes($source, $target, attributes) {
 632     _.each(attributes, function(name) {
 633       if ($source.attr(name) !== undefined) {
 634         $target.attr(name, $source.attr(name));
 635       }
 636     });
 637   }
 638
 639   /**
 640    * @see http://wiki.civicrm.org/confluence/display/CRMDOC/crmDatepicker
 641    */
 642   $.fn.crmDatepicker = function(options) {
 643     return $(this).each(function() {
 644       if ($(this).is('.crm-form-date-wrapper .crm-hidden-date')) {
 645         // Already initialized - destroy
 646         $(this)
 647           .off('.crmDatepicker')
 648           .css('display', '')
 649           .removeClass('crm-hidden-date')
 650           .siblings().remove();
 651         $(this).unwrap();
 652       }
 653       if (options === 'destroy') {
 654         return;
 655       }
 656       var
 657         $dataField = $(this).wrap('<span class="crm-form-date-wrapper" />'),
 658         settings = _.cloneDeep(options || {}),
 659         $dateField = $(),
 660         $timeField = $(),
 661         $clearLink = $(),
 662         hasDatepicker = settings.date !== false && settings.date !== 'yy',
 663         type = hasDatepicker ? 'text' : 'number';
 664
 665       if (settings.allowClear !== undefined ? settings.allowClear : !$dataField.is('.required, [required]')) {
 666         $clearLink = $('<a class="crm-hover-button crm-clear-link" title="'+ _.escape(ts('Clear')) +'"><i class="crm-i fa-times"></i></a>')
 667           .insertAfter($dataField);
 668       }
 669       if (settings.time !== false) {
 670         $timeField = $('<input>').insertAfter($dataField);
 671         copyAttributes($dataField, $timeField, ['class', 'disabled']);
 672         $timeField
 673           .addClass('crm-form-text crm-form-time')
 674           .attr('placeholder', $dataField.attr('time-placeholder') === undefined ? ts('Time') : $dataField.attr('time-placeholder'))
 675           .change(updateDataField)
 676           .timeEntry({
 677             spinnerImage: '',
 678             show24Hours: settings.time === true || settings.time === undefined ? CRM.config.timeIs24Hr : settings.time == '24'
 679           });
 680       }
 681       if (settings.date !== false) {
 682         // Render "number" field for year-only format, calendar popup for all other formats
 683         $dateField = $('<input type="' + type + '">').insertAfter($dataField);
 684         copyAttributes($dataField, $dateField, ['placeholder', 'style', 'class', 'disabled']);
 685         $dateField.addClass('crm-form-' + type);
 686         if (hasDatepicker) {
 687           settings.minDate = settings.minDate ? CRM.utils.makeDate(settings.minDate) : null;
 688           settings.maxDate = settings.maxDate ? CRM.utils.makeDate(settings.maxDate) : null;
 689           settings.dateFormat = typeof settings.date === 'string' ? settings.date : CRM.config.dateInputFormat;
 690           settings.changeMonth = _.includes(settings.dateFormat, 'm');
 691           settings.changeYear = _.includes(settings.dateFormat, 'y');
 692           if (!settings.yearRange && settings.minDate !== null && settings.maxDate !== null) {
 693             settings.yearRange = '' + CRM.utils.formatDate(settings.minDate, 'yy') + ':' + CRM.utils.formatDate(settings.maxDate, 'yy');
 694           }
 695           $dateField.addClass('crm-form-date').datepicker(settings);
 696         } else {
 697           $dateField.attr('min', settings.minDate ? CRM.utils.formatDate(settings.minDate, 'yy') : '1000');
 698           $dateField.attr('max', settings.maxDate ? CRM.utils.formatDate(settings.maxDate, 'yy') : '4000');
 699         }
 700         $dateField.change(updateDataField);
 701       }
 702       // Rudimentary validation. TODO: Roll into use of jQUery validate and ui.datepicker.validation
 703       function isValidDate() {
 704         // FIXME: parseDate doesn't work with incomplete date formats; skip validation if no month, day or year in format
 705         var lowerFormat = settings.dateFormat.toLowerCase();
 706         if (lowerFormat.indexOf('y') < 0 || lowerFormat.indexOf('m') < 0 || lowerFormat.indexOf('d') < 0) {
 707           return true;
 708         }
 709         try {
 710           $.datepicker.parseDate(settings.dateFormat, $dateField.val());
 711           return true;
 712         } catch (e) {
 713           return false;
 714         }
 715       }
 716       function updateInputFields(e, context) {
 717         var val = $dataField.val(),
 718           time = null;
 719         if (context !== 'userInput' && context !== 'crmClear') {
 720           if (hasDatepicker) {
 721             $dateField.datepicker('setDate', _.includes(val, '-') ? $.datepicker.parseDate('yy-mm-dd', val) : null);
 722           } else if ($dateField.length) {
 723             $dateField.val(val.slice(0, 4));
 724           }
 725           if ($timeField.length) {
 726             if (val.length === 8) {
 727               time = val;
 728             } else if (val.length === 19) {
 729               time = val.split(' ')[1];
 730             }
 731             $timeField.timeEntry('setTime', time);
 732           }
 733         }
 734         $clearLink.css('visibility', val ? 'visible' : 'hidden');
 735       }
 736       function updateDataField(e, context) {
 737         // The crmClear event wipes all the field values anyway, so no need to respond
 738         if (context !== 'crmClear') {
 739           var val = '';
 740           if ($dateField.val()) {
 741             if (hasDatepicker && isValidDate()) {
 742               val = $.datepicker.formatDate('yy-mm-dd', $dateField.datepicker('getDate'));
 743               $dateField.removeClass('crm-error');
 744             } else if (!hasDatepicker) {
 745               val = $dateField.val() + '-01-01';
 746             } else {
 747               $dateField.addClass('crm-error');
 748             }
 749           }
 750           if ($timeField.val()) {
 751             val += (val ? ' ' : '') + $timeField.timeEntry('getTime').toTimeString().substr(0, 8);
 752           }
 753           $dataField.val(val).trigger('change', ['userInput']);
 754         }
 755       }
 756       $dataField.hide().addClass('crm-hidden-date').on('change.crmDatepicker', updateInputFields);
 757       updateInputFields();
 758     });
 759   };
 760
 761   $.fn.crmAjaxTable = function() {
 762     // Strip the ids from ajax urls to make pageLength storage more generic
 763     function simplifyUrl(ajax) {
 764       // Datatables ajax prop could be a url string or an object containing the url
 765       var url = typeof ajax === 'object' ? ajax.url : ajax;
 766       return typeof url === 'string' ? url.replace(/[&?]\w*id=\d+/g, '') : null;
 767     }
 768
 769     return $(this).each(function() {
 770       // Recall pageLength for this table
 771       var url = simplifyUrl($(this).data('ajax'));
 772       if (url && window.localStorage && localStorage['dataTablePageLength:' + url]) {
 773         $(this).data('pageLength', localStorage['dataTablePageLength:' + url]);
 774       }
 775       // Declare the defaults for DataTables
 776       var defaults = {
 777         "processing": true,
 778         "serverSide": true,
 779         "order": [],
 780         "dom": '<"crm-datatable-pager-top"lfp>rt<"crm-datatable-pager-bottom"ip>',
 781         "pageLength": 25,
 782         "pagingType": "full_numbers",
 783         "drawCallback": function(settings) {
 784           //Add data attributes to cells
 785           $('thead th', settings.nTable).each( function( index ) {
 786             $.each(this.attributes, function() {
 787               if(this.name.match("^cell-")) {
 788                 var cellAttr = this.name.substring(5);
 789                 var cellValue = this.value;
 790                 $('tbody tr', settings.nTable).each( function() {
 791                   $('td:eq('+ index +')', this).attr( cellAttr, cellValue );
 792                 });
 793               }
 794             });
 795           });
 796           //Reload table after draw
 797           $(settings.nTable).trigger('crmLoad');
 798         }
 799       };
 800       //Include any table specific data
 801       var settings = $.extend(true, defaults, $(this).data('table'));
 802       // Remember pageLength
 803       $(this).on('length.dt', function(e, settings, len) {
 804         if (settings.ajax && window.localStorage) {
 805           localStorage['dataTablePageLength:' + simplifyUrl(settings.ajax)] = len;
 806         }
 807       });
 808       //Make the DataTables call
 809       $(this).DataTable(settings);
 810     });
 811   };
 812
 813   CRM.utils.formatSelect2Result = function (row) {
 814     var markup = '<div class="crm-select2-row">';
 815     if (row.image !== undefined) {
 816       markup += '<div class="crm-select2-image"><img src="' + row.image + '"/></div>';
 817     }
 818     else if (row.icon_class) {
 819       markup += '<div class="crm-select2-icon"><div class="crm-icon ' + row.icon_class + '-icon"></div></div>';
 820     }
 821     markup += '<div><div class="crm-select2-row-label '+(row.label_class || '')+'">' +
 822       _.escape((row.prefix !== undefined ? row.prefix + ' ' : '') + row.label + (row.suffix !== undefined ? ' ' + row.suffix : '')) +
 823       '</div>' +
 824       '<div class="crm-select2-row-description">';
 825     $.each(row.description || [], function(k, text) {
 826       markup += '<p>' + _.escape(text) + '</p>';
 827     });
 828     markup += '</div></div></div>';
 829     return markup;
 830   };
 831
 832   function renderEntityRefCreateLinks($el) {
 833     var
 834       createLinks = $el.data('create-links'),
 835       params = getEntityRefApiParams($el).params,
 836       markup = '<div class="crm-entityref-links">';
 837     if (!createLinks || $el.data('api-entity').toLowerCase() !== 'contact') {
 838       return '';
 839     }
 840     if (createLinks === true) {
 841       createLinks = params.contact_type ? _.where(CRM.config.entityRef.contactCreate, {type: params.contact_type}) : CRM.config.entityRef.contactCreate;
 842     }
 843     _.each(createLinks, function(link) {
 844       var icon;
 845       switch (link.type) {
 846         case 'Individual':
 847           icon = 'fa-user';
 848           break;
 849
 850         case 'Organization':
 851           icon = 'fa-building';
 852           break;
 853
 854         case 'Household':
 855           icon = 'fa-home';
 856           break;
 857       }
 858       markup += ' <a class="crm-add-entity crm-hover-button" href="' + link.url + '">';
 859       if (icon) {
 860         markup += '<i class="crm-i ' + icon + '"></i> ';
 861       }
 862       markup += _.escape(link.label) + '</a>';
 863     });
 864     markup += '</div>';
 865     return markup;
 866   }
 867
 868   function getEntityRefFilters($el) {
 869     var
 870       entity = $el.data('api-entity').toLowerCase(),
 871       filters = $.extend([], CRM.config.entityRef.filters[entity] || []),
 872       params = $.extend({params: {}}, $el.data('api-params') || {}).params,
 873       result = [];
 874     $.each(filters, function() {
 875       var filter = $.extend({type: 'select', 'attributes': {}, entity: entity}, this);
 876       if (typeof params[filter.key] === 'undefined') {
 877         result.push(filter);
 878       }
 879       else if (filter.key == 'contact_type' && typeof params.contact_sub_type === 'undefined') {
 880         filter.options = _.remove(filter.options, function(option) {
 881           return option.key.indexOf(params.contact_type + '__') === 0;
 882         });
 883         result.push(filter);
 884       }
 885     });
 886     return result;
 887   }
 888
 889   /**
 890    * Provide markup for entity ref filters
 891    */
 892   function entityRefFiltersMarkup($el) {
 893     var
 894       filters = getEntityRefFilters($el),
 895       filter = $el.data('user-filter') || {},
 896       filterSpec = filter.key ? _.find(filters, {key: filter.key}) : null;
 897     if (!filters.length) {
 898       return '';
 899     }
 900     var markup = '<div class="crm-entityref-filters">' +
 901       '<select class="crm-entityref-filter-key' + (filter.key ? ' active' : '') + '">' +
 902       '<option value="">' + _.escape(ts('Refine search...')) + '</option>' +
 903       CRM.utils.renderOptions(filters, filter.key) +
 904       '</select>' + entityRefFilterValueMarkup(filter, filterSpec) + '</div>';
 905     return markup;
 906   }
 907
 908   /**
 909    * Provide markup for entity ref filter value field
 910    */
 911   function entityRefFilterValueMarkup(filter, filterSpec) {
 912     var markup = '';
 913     if (filterSpec) {
 914       var attrs = '',
 915         attributes = _.cloneDeep(filterSpec.attributes);
 916       if (filterSpec.type !== 'select') {
 917         attributes.type = filterSpec.type;
 918         attributes.value = typeof filter.value !== 'undefined' ? filter.value : '';
 919       }
 920       attributes.class = 'crm-entityref-filter-value' + (filter.value ? ' active' : '');
 921       $.each(attributes, function (attr, val) {
 922         attrs += ' ' + attr + '="' + val + '"';
 923       });
 924       if (filterSpec.type === 'select') {
 925         markup = '<select' + attrs + '><option value="">' + _.escape(ts('- select -')) + '</option>';
 926         if (filterSpec.options) {
 927           markup += CRM.utils.renderOptions(filterSpec.options, filter.value);
 928         }
 929         markup += '</select>';
 930       } else {
 931         markup = '<input' + attrs + '/>';
 932       }
 933     }
 934     return markup;
 935   }
 936
 937   /**
 938    * Render the entity ref filter value field
 939    */
 940   function renderEntityRefFilterValue($el) {
 941     var
 942       filter = $el.data('user-filter') || {},
 943       filterSpec = filter.key ? _.find(getEntityRefFilters($el), {key: filter.key}) : null,
 944       $keyField = $('.crm-entityref-filter-key', '#select2-drop'),
 945       $valField = null;
 946     if (filterSpec) {
 947       $('.crm-entityref-filter-value', '#select2-drop').remove();
 948       $valField = $(entityRefFilterValueMarkup(filter, filterSpec));
 949       $keyField.after($valField);
 950       if (filterSpec.type === 'select' && !filterSpec.options) {
 951         loadEntityRefFilterOptions(filter, filterSpec, $valField, $el);
 952       }
 953     } else {
 954       $('.crm-entityref-filter-value', '#select2-drop').hide().val('').change();
 955     }
 956   }
 957
 958   /**
 959    * Fetch options for a filter via ajax api
 960    */
 961   function loadEntityRefFilterOptions(filter, filterSpec, $valField, $el) {
 962     $valField.prop('disabled', true);
 963     // Fieldname may be prefixed with joins - strip those out
 964     var fieldName = _.last(filter.key.split('.'));
 965     CRM.api3(filterSpec.entity, 'getoptions', {field: fieldName, context: 'search', sequential: 1})
 966       .done(function(result) {
 967         var entity = $el.data('api-entity').toLowerCase(),
 968           globalFilterSpec = _.find(CRM.config.entityRef.filters[entity], {key: filter.key}) || {};
 969         // Store options globally so we don't have to look them up again
 970         globalFilterSpec.options = result.values;
 971         $valField.prop('disabled', false);
 972         CRM.utils.setOptions($valField, result.values);
 973         $valField.val(filter.value || '');
 974       });
 975   }
 976
 977   //CRM-15598 - Override url validator method to allow relative url's (e.g. /index.htm)
 978   $.validator.addMethod("url", function(value, element) {
 979     if (/^\//.test(value)) {
 980       // Relative url: prepend dummy path for validation.
 981       value = 'http://domain.tld' + value;
 982     }
 983     // From jQuery Validation Plugin v1.12.0
 984     return this.optional(element) || /^(https?|s?ftp):\/\/(((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:)*@)?(((\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5]))|((([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.)+(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.?)(:\d*)?)(\/((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)+(\/(([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)*)*)?)?(\?((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)|[\uE000-\uF8FF]|\/|\?)*)?(#((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)|\/|\?)*)?$/i.test(value);
 985   });
 986
 987   /**
 988    * Wrapper for jQuery validate initialization function; supplies defaults
 989    */
 990   $.fn.crmValidate = function(params) {
 991     return $(this).each(function () {
 992       var that = this,
 993         settings = $.extend({}, CRM.validate._defaults, CRM.validate.params);
 994       $(this).validate(settings);
 995       // Call any post-initialization callbacks
 996       if (CRM.validate.functions && CRM.validate.functions.length) {
 997         $.each(CRM.validate.functions, function(i, func) {
 998           func.call(that);
 999         });
1000       }
1001     });
1002   };
1003
1004   // Initialize widgets
1005   $(document)
1006     .on('crmLoad', function(e) {
1007       $('table.row-highlight', e.target)
1008         .off('.rowHighlight')
1009         .on('change.rowHighlight', 'input.select-row, input.select-rows', function (e, data) {
1010           var filter, $table = $(this).closest('table');
1011           if ($(this).hasClass('select-rows')) {
1012             filter = $(this).prop('checked') ? ':not(:checked)' : ':checked';
1013             $('input.select-row' + filter, $table).prop('checked', $(this).prop('checked')).trigger('change', 'master-selected');
1014           }
1015           else {
1016             $(this).closest('tr').toggleClass('crm-row-selected', $(this).prop('checked'));
1017             if (data !== 'master-selected') {
1018               $('input.select-rows', $table).prop('checked', $(".select-row:not(':checked')", $table).length < 1);
1019             }
1020           }
1021         })
1022         .find('input.select-row:checked').parents('tr').addClass('crm-row-selected');
1023       $('table.crm-sortable', e.target).DataTable();
1024       $('table.crm-ajax-table', e.target).each(function() {
1025         var
1026           $table = $(this),
1027           $accordion = $table.closest('.crm-accordion-wrapper.collapsed, .crm-collapsible.collapsed');
1028         // For tables hidden by collapsed accordions, wait.
1029         if ($accordion.length) {
1030           $accordion.one('crmAccordion:open', function() {
1031             $table.crmAjaxTable();
1032           });
1033         } else {
1034           $table.crmAjaxTable();
1035         }
1036       });
1037       if ($("input:radio[name=radio_ts]").size() == 1) {
1038         $("input:radio[name=radio_ts]").prop("checked", true);
1039       }
1040       $('.crm-select2:not(.select2-offscreen, .select2-container)', e.target).crmSelect2();
1041       $('.crm-form-entityref:not(.select2-offscreen, .select2-container)', e.target).crmEntityRef();
1042       $('select.crm-chain-select-control', e.target).off('.chainSelect').on('change.chainSelect', chainSelect);
1043       $('.crm-form-text[data-crm-datepicker]', e.target).each(function() {
1044         $(this).crmDatepicker($(this).data('crmDatepicker'));
1045       });
1046       // Cache Form Input initial values
1047       $('form[data-warn-changes] :input', e.target).each(function() {
1048         $(this).data('crm-initial-value', $(this).is(':checkbox, :radio') ? $(this).prop('checked') : $(this).val());
1049       });
1050       $('textarea.crm-form-wysiwyg', e.target).each(function() {
1051         if ($(this).hasClass("collapsed")) {
1052           CRM.wysiwyg.createCollapsed(this);
1053         } else {
1054           CRM.wysiwyg.create(this);
1055         }
1056       });
1057     })
1058     .on('dialogopen', function(e) {
1059       var $el = $(e.target);
1060       // Modal dialogs should disable scrollbars
1061       if ($el.dialog('option', 'modal')) {
1062         $el.addClass('modal-dialog');
1063         $('body').css({overflow: 'hidden'});
1064       }
1065       $el.parent().find('.ui-dialog-titlebar .ui-icon-closethick').removeClass('ui-icon-closethick').addClass('fa-times');
1066       // Add resize button
1067       if ($el.parent().hasClass('crm-container') && $el.dialog('option', 'resizable')) {
1068         $el.parent().find('.ui-dialog-titlebar').append($('<button class="crm-dialog-titlebar-resize ui-dialog-titlebar-close" title="'+ _.escape(ts('Toggle fullscreen'))+'" style="right:2em;"/>').button({icons: {primary: 'fa-expand'}, text: false}));
1069         $('.crm-dialog-titlebar-resize', $el.parent()).click(function(e) {
1070           if ($el.data('origSize')) {
1071             $el.dialog('option', $el.data('origSize'));
1072             $el.data('origSize', null);
1073           } else {
1074             var menuHeight = $('#civicrm-menu').outerHeight();
1075             $el.data('origSize', {
1076               position: {my: 'center', at: 'center center+' + (menuHeight / 2), of: window},
1077               width: $el.dialog('option', 'width'),
1078               height: $el.dialog('option', 'height')
1079             });
1080             $el.dialog('option', {width: '100%', height: ($(window).height() - menuHeight), position: {my: "top", at: "top+"+menuHeight, of: window}});
1081           }
1082           $el.trigger('dialogresize');
1083           e.preventDefault();
1084         });
1085       }
1086     })
1087     .on('dialogclose', function(e) {
1088       // Restore scrollbars when closing modal
1089       if ($('.ui-dialog .modal-dialog:visible').not(e.target).length < 1) {
1090         $('body').css({overflow: ''});
1091       }
1092     })
1093     .on('submit', function(e) {
1094       // CRM-14353 - disable changes warn when submitting a form
1095       $('[data-warn-changes]').attr('data-warn-changes', 'false');
1096     });
1097
1098   // CRM-14353 - Warn of unsaved changes for forms which have opted in
1099   window.onbeforeunload = function() {
1100     if (CRM.utils.initialValueChanged($('form[data-warn-changes=true]:visible'))) {
1101       return ts('You have unsaved changes.');
1102     }
1103   };
1104
1105   $.fn.crmtooltip = function () {
1106     $(document)
1107       .on('mouseover', 'a.crm-summary-link:not(.crm-processed)', function (e) {
1108         $(this).addClass('crm-processed crm-tooltip-active');
1109         var topDistance = e.pageY - $(window).scrollTop();
1110         if (topDistance < 300 || topDistance < $(this).children('.crm-tooltip-wrapper').height()) {
1111           $(this).addClass('crm-tooltip-down');
1112         }
1113         if (!$(this).children('.crm-tooltip-wrapper').length) {
1114           $(this).append('<div class="crm-tooltip-wrapper"><div class="crm-tooltip"></div></div>');
1115           $(this).children().children('.crm-tooltip')
1116             .html('<div class="crm-loading-element"></div>')
1117             .load(this.href);
1118         }
1119       })
1120       .on('mouseout', 'a.crm-summary-link', function () {
1121         $(this).removeClass('crm-processed crm-tooltip-active crm-tooltip-down');
1122       })
1123       .on('click', 'a.crm-summary-link', false);
1124   };
1125
1126   var helpDisplay, helpPrevious;
1127   // Non-ajax example:
1128   //   CRM.help('Example title', 'Here is some text to describe this example');
1129   // Ajax example (will load help id "foo" from templates/CRM/bar.tpl):
1130   //   CRM.help('Example title', {id: 'foo', file: 'CRM/bar'});
1131   CRM.help = function (title, params, url) {
1132     var ajax = typeof params !== 'string';
1133     if (helpDisplay && helpDisplay.close) {
1134       // If the same link is clicked twice, just close the display
1135       if (helpDisplay.isOpen && _.isEqual(helpPrevious, params)) {
1136         helpDisplay.close();
1137         return;
1138       }
1139       helpDisplay.close();
1140     }
1141     helpPrevious = _.cloneDeep(params);
1142     helpDisplay = CRM.alert(ajax ? '...' : params, title, 'crm-help ' + (ajax ? 'crm-msg-loading' : 'info'), {expires: 0});
1143     if (ajax) {
1144       if (!url) {
1145         url = CRM.url('civicrm/ajax/inline');
1146         params.class_name = 'CRM_Core_Page_Inline_Help';
1147         params.type = 'page';
1148       }
1149       $.ajax(url, {
1150         data: params,
1151         dataType: 'html',
1152         success: function (data) {
1153           $('#crm-notification-container .crm-help .notify-content:last').html(data);
1154           $('#crm-notification-container .crm-help').removeClass('crm-msg-loading').addClass('info');
1155         },
1156         error: function () {
1157           $('#crm-notification-container .crm-help .notify-content:last').html('Unable to load help file.');
1158           $('#crm-notification-container .crm-help').removeClass('crm-msg-loading').addClass('error');
1159         }
1160       });
1161     }
1162   };
1163   /**
1164    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1165    */
1166   CRM.status = function(options, deferred) {
1167     // For simple usage without async operations you can pass in a string. 2nd param is optional string 'error' if this is not a success msg.
1168     if (typeof options === 'string') {
1169       return CRM.status({start: options, success: options, error: options})[deferred === 'error' ? 'reject' : 'resolve']();
1170     }
1171     var opts = $.extend({
1172       start: ts('Saving...'),
1173       success: ts('Saved'),
1174       error: function(data) {
1175         var msg = $.isPlainObject(data) && data.error_message;
1176         CRM.alert(msg || ts('Sorry an error occurred and your information was not saved'), ts('Error'), 'error');
1177       }
1178     }, options || {});
1179     var $msg = $('<div class="crm-status-box-outer status-start"><div class="crm-status-box-inner"><div class="crm-status-box-msg">' + _.escape(opts.start) + '</div></div></div>')
1180       .appendTo('body');
1181     $msg.css('min-width', $msg.width());
1182     function handle(status, data) {
1183       var endMsg = typeof(opts[status]) === 'function' ? opts[status](data) : opts[status];
1184       if (endMsg) {
1185         $msg.removeClass('status-start').addClass('status-' + status).find('.crm-status-box-msg').text(endMsg);
1186         window.setTimeout(function() {
1187           $msg.fadeOut('slow', function() {
1188             $msg.remove();
1189           });
1190         }, 2000);
1191       } else {
1192         $msg.remove();
1193       }
1194     }
1195     return (deferred || new $.Deferred())
1196       .done(function(data) {
1197         // If the server returns an error msg call the error handler
1198         var status = $.isPlainObject(data) && (data.is_error || data.status === 'error') ? 'error' : 'success';
1199         handle(status, data);
1200       })
1201       .fail(function(data) {
1202         handle('error', data);
1203       });
1204   };
1205
1206   // Convert an Angular promise to a jQuery promise
1207   CRM.toJqPromise = function(aPromise) {
1208     var jqDeferred = $.Deferred();
1209     aPromise.then(
1210       function(data) { jqDeferred.resolve(data); },
1211       function(data) { jqDeferred.reject(data); }
1212       // should we also handle progress events?
1213     );
1214     return jqDeferred.promise();
1215   };
1216
1217   CRM.toAPromise = function($q, jqPromise) {
1218     var aDeferred = $q.defer();
1219     jqPromise.then(
1220       function(data) { aDeferred.resolve(data); },
1221       function(data) { aDeferred.reject(data); }
1222       // should we also handle progress events?
1223     );
1224     return aDeferred.promise;
1225   };
1226
1227   /**
1228    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1229    */
1230   CRM.alert = function (text, title, type, options) {
1231     type = type || 'alert';
1232     title = title || '';
1233     options = options || {};
1234     if ($('#crm-notification-container').length) {
1235       var params = {
1236         text: text,
1237         title: title,
1238         type: type
1239       };
1240       // By default, don't expire errors and messages containing links
1241       var extra = {
1242         expires: (type == 'error' || text.indexOf('<a ') > -1) ? 0 : (text ? 10000 : 5000),
1243         unique: true
1244       };
1245       options = $.extend(extra, options);
1246       options.expires = options.expires === false ? 0 : parseInt(options.expires, 10);
1247       if (options.unique && options.unique !== '0') {
1248         $('#crm-notification-container .ui-notify-message').each(function () {
1249           if (title === $('h1', this).html() && text === $('.notify-content', this).html()) {
1250             $('.icon.ui-notify-close', this).click();
1251           }
1252         });
1253       }
1254       return $('#crm-notification-container').notify('create', params, options);
1255     }
1256     else {
1257       if (title.length) {
1258         text = title + "\n" + text;
1259       }
1260       alert(text);
1261       return null;
1262     }
1263   };
1264
1265   /**
1266    * Close whichever alert contains the given node
1267    *
1268    * @param node
1269    */
1270   CRM.closeAlertByChild = function (node) {
1271     $(node).closest('.ui-notify-message').find('.icon.ui-notify-close').click();
1272   };
1273
1274   /**
1275    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1276    */
1277   CRM.confirm = function (options) {
1278     var dialog, url, msg, buttons = [], settings = {
1279       title: ts('Confirm'),
1280       message: ts('Are you sure you want to continue?'),
1281       url: null,
1282       width: 'auto',
1283       height: 'auto',
1284       resizable: false,
1285       dialogClass: 'crm-container crm-confirm',
1286       close: function () {
1287         $(this).dialog('destroy').remove();
1288       },
1289       options: {
1290         no: ts('Cancel'),
1291         yes: ts('Continue')
1292       }
1293     };
1294     if (options && options.url) {
1295       settings.resizable = true;
1296       settings.height = '50%';
1297     }
1298     $.extend(settings, ($.isFunction(options) ? arguments[1] : options) || {});
1299     settings = CRM.utils.adjustDialogDefaults(settings);
1300     if (!settings.buttons && $.isPlainObject(settings.options)) {
1301       $.each(settings.options, function(op, label) {
1302         buttons.push({
1303           text: label,
1304           'data-op': op,
1305           icons: {primary: op === 'no' ? 'fa-times' : 'fa-check'},
1306           click: function() {
1307             var event = $.Event('crmConfirm:' + op);
1308             $(this).trigger(event);
1309             if (!event.isDefaultPrevented()) {
1310               dialog.dialog('close');
1311             }
1312           }
1313         });
1314       });
1315       // Order buttons so that "no" goes on the right-hand side
1316       settings.buttons = _.sortBy(buttons, 'data-op').reverse();
1317     }
1318     url = settings.url;
1319     msg = url ? '' : settings.message;
1320     delete settings.options;
1321     delete settings.message;
1322     delete settings.url;
1323     dialog = $('<div class="crm-confirm-dialog"></div>').html(msg || '').dialog(settings);
1324     if ($.isFunction(options)) {
1325       dialog.on('crmConfirm:yes', options);
1326     }
1327     if (url) {
1328       CRM.loadPage(url, {target: dialog});
1329     }
1330     else {
1331       dialog.trigger('crmLoad');
1332     }
1333     return dialog;
1334   };
1335
1336   /** provides a local copy of ts for a domain */
1337   CRM.ts = function(domain) {
1338     return function(message, options) {
1339       if (domain) {
1340         options = $.extend(options || {}, {domain: domain});
1341       }
1342       return ts(message, options);
1343     };
1344   };
1345
1346   CRM.addStrings = function(domain, strings) {
1347     var bucket = (domain == 'civicrm' ? 'strings' : 'strings::' + domain);
1348     CRM[bucket] = CRM[bucket] || {};
1349     _.extend(CRM[bucket], strings);
1350   };
1351
1352   /**
1353    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1354    */
1355   $.fn.crmError = function (text, title, options) {
1356     title = title || '';
1357     text = text || '';
1358     options = options || {};
1359
1360     var extra = {
1361       expires: 0
1362     };
1363     if ($(this).length) {
1364       if (title === '') {
1365         var label = $('label[for="' + $(this).attr('name') + '"], label[for="' + $(this).attr('id') + '"]').not('[generated=true]');
1366         if (label.length) {
1367           label.addClass('crm-error');
1368           var $label = label.clone();
1369           if (text === '' && $('.crm-marker', $label).length > 0) {
1370             text = $('.crm-marker', $label).attr('title');
1371           }
1372           $('.crm-marker', $label).remove();
1373           title = $label.text();
1374         }
1375       }
1376       $(this).addClass('crm-error');
1377     }
1378     var msg = CRM.alert(text, title, 'error', $.extend(extra, options));
1379     if ($(this).length) {
1380       var ele = $(this);
1381       setTimeout(function () {
1382         ele.one('change', function () {
1383           if (msg && msg.close) msg.close();
1384           ele.removeClass('error');
1385           label.removeClass('crm-error');
1386         });
1387       }, 1000);
1388     }
1389     return msg;
1390   };
1391
1392   // Display system alerts through js notifications
1393   function messagesFromMarkup() {
1394     $('div.messages:visible', this).not('.help').not('.no-popup').each(function () {
1395       var text, title = '';
1396       $(this).removeClass('status messages');
1397       var type = $(this).attr('class').split(' ')[0] || 'alert';
1398       type = type.replace('crm-', '');
1399       $('.icon', this).remove();
1400       if ($('.msg-text', this).length > 0) {
1401         text = $('.msg-text', this).html();
1402         title = $('.msg-title', this).html();
1403       }
1404       else {
1405         text = $(this).html();
1406       }
1407       var options = $(this).data('options') || {};
1408       $(this).remove();
1409       // Duplicates were already removed server-side
1410       options.unique = false;
1411       CRM.alert(text, title, type, options);
1412     });
1413     // Handle qf form errors
1414     $('form :input.error', this).one('blur', function() {
1415       $('.ui-notify-message.error a.ui-notify-close').click();
1416       $(this).removeClass('error');
1417       $(this).next('span.crm-error').remove();
1418       $('label[for="' + $(this).attr('name') + '"], label[for="' + $(this).attr('id') + '"]')
1419         .removeClass('crm-error')
1420         .find('.crm-error').removeClass('crm-error');
1421     });
1422   }
1423
1424   /**
1425    * Improve blockUI when used with jQuery dialog
1426    */
1427   var originalBlock = $.fn.block,
1428     originalUnblock = $.fn.unblock;
1429
1430   $.fn.block = function(opts) {
1431     if ($(this).is('.ui-dialog-content')) {
1432       originalBlock.call($(this).parents('.ui-dialog'), opts);
1433       return $(this);
1434     }
1435     return originalBlock.call(this, opts);
1436   };
1437   $.fn.unblock = function(opts) {
1438     if ($(this).is('.ui-dialog-content')) {
1439       originalUnblock.call($(this).parents('.ui-dialog'), opts);
1440       return $(this);
1441     }
1442     return originalUnblock.call(this, opts);
1443   };
1444
1445   // Preprocess all CRM ajax calls to display messages
1446   $(document).ajaxSuccess(function(event, xhr, settings) {
1447     try {
1448       if ((!settings.dataType || settings.dataType == 'json') && xhr.responseText) {
1449         var response = $.parseJSON(xhr.responseText);
1450         if (typeof(response.crmMessages) == 'object') {
1451           $.each(response.crmMessages, function(n, msg) {
1452             CRM.alert(msg.text, msg.title, msg.type, msg.options);
1453           });
1454         }
1455         if (response.backtrace) {
1456           CRM.console('log', response.backtrace);
1457         }
1458         if (typeof response.deprecated === 'string') {
1459           CRM.console('warn', response.deprecated);
1460         }
1461       }
1462     }
1463     // Ignore errors thrown by parseJSON
1464     catch (e) {}
1465   });
1466
1467   $(function () {
1468     $.blockUI.defaults.message = null;
1469     $.blockUI.defaults.ignoreIfBlocked = true;
1470
1471     if ($('#crm-container').hasClass('crm-public')) {
1472       $.fn.select2.defaults.dropdownCssClass = $.ui.dialog.prototype.options.dialogClass = 'crm-container crm-public';
1473     }
1474
1475     // Trigger crmLoad on initial content for consistency. It will also be triggered for ajax-loaded content.
1476     $('.crm-container').trigger('crmLoad');
1477
1478     if ($('#crm-notification-container').length) {
1479       // Initialize notifications
1480       $('#crm-notification-container').notify();
1481       messagesFromMarkup.call($('#crm-container'));
1482     }
1483
1484     $('body')
1485       // bind the event for image popup
1486       .on('click', 'a.crm-image-popup', function(e) {
1487         CRM.confirm({
1488           title: ts('Preview'),
1489           resizable: true,
1490           // Prevent overlap with the menubar
1491           maxHeight: $(window).height() - 30,
1492           position: {my: 'center', at: 'center center+15', of: window},
1493           message: '<div class="crm-custom-image-popup"><img style="max-width: 100%" src="' + $(this).attr('href') + '"></div>',
1494           options: null
1495         });
1496         e.preventDefault();
1497       })
1498
1499       .on('click', function (event) {
1500         $('.btn-slide-active').removeClass('btn-slide-active').find('.panel').hide();
1501         if ($(event.target).is('.btn-slide')) {
1502           $(event.target).addClass('btn-slide-active').find('.panel').show();
1503         }
1504       })
1505
1506       // Handle clear button for form elements
1507       .on('click', 'a.crm-clear-link', function() {
1508         $(this).css({visibility: 'hidden'}).siblings('.crm-form-radio:checked').prop('checked', false).trigger('change', ['crmClear']);
1509         $(this).siblings('input:text').val('').trigger('change', ['crmClear']);
1510         return false;
1511       })
1512       .on('change', 'input.crm-form-radio:checked, input[allowclear=1]', function(e, context) {
1513         if (context !== 'crmClear' && ($(this).is(':checked') || ($(this).is('[allowclear=1]') && $(this).val()))) {
1514           $(this).siblings('.crm-clear-link').css({visibility: ''});
1515         }
1516       })
1517
1518       // Allow normal clicking of links within accordions
1519       .on('click.crmAccordions', 'div.crm-accordion-header a, .collapsible-title a', function (e) {
1520         e.stopPropagation();
1521       })
1522       // Handle accordions
1523       .on('click.crmAccordions', '.crm-accordion-header, .crm-collapsible .collapsible-title', function (e) {
1524         var action = 'open';
1525         if ($(this).parent().hasClass('collapsed')) {
1526           $(this).next().css('display', 'none').slideDown(200);
1527         }
1528         else {
1529           $(this).next().css('display', 'block').slideUp(200);
1530           action = 'close';
1531         }
1532         $(this).parent().toggleClass('collapsed').trigger('crmAccordion:' + action);
1533         e.preventDefault();
1534       });
1535
1536     $().crmtooltip();
1537   });
1538
1539   /**
1540    * Collapse or expand an accordion
1541    * @param speed
1542    */
1543   $.fn.crmAccordionToggle = function (speed) {
1544     $(this).each(function () {
1545       var action = 'open';
1546       if ($(this).hasClass('collapsed')) {
1547         $('.crm-accordion-body', this).first().css('display', 'none').slideDown(speed);
1548       }
1549       else {
1550         $('.crm-accordion-body', this).first().css('display', 'block').slideUp(speed);
1551         action = 'close';
1552       }
1553       $(this).toggleClass('collapsed').trigger('crmAccordion:' + action);
1554     });
1555   };
1556
1557   /**
1558    * Clientside currency formatting
1559    * @param number value
1560    * @param [optional] boolean onlyNumber - if true, we return formatted amount without currency sign
1561    * @param [optional] string format - currency representation of the number 1234.56
1562    * @return string
1563    */
1564   var currencyTemplate;
1565   CRM.formatMoney = function(value, onlyNumber, format) {
1566     var decimal, separator, sign, i, j, result;
1567     if (value === 'init' && format) {
1568       currencyTemplate = format;
1569       return;
1570     }
1571     format = format || currencyTemplate;
1572     result = /1(.?)234(.?)56/.exec(format);
1573     if (result === null) {
1574       return 'Invalid format passed to CRM.formatMoney';
1575     }
1576     separator = result[1];
1577     decimal = result[2];
1578     sign = (value < 0) ? '-' : '';
1579     //extracting the absolute value of the integer part of the number and converting to string
1580     i = parseInt(value = Math.abs(value).toFixed(2)) + '';
1581     j = ((j = i.length) > 3) ? j % 3 : 0;
1582     result = sign + (j ? i.substr(0, j) + separator : '') + i.substr(j).replace(/(\d{3})(?=\d)/g, "$1" + separator) + (2 ? decimal + Math.abs(value - i).toFixed(2).slice(2) : '');
1583     if ( onlyNumber ) {
1584       return result;
1585     }
1586     return format.replace(/1.*234.*56/, result);
1587   };
1588
1589   CRM.console = function(method, title, msg) {
1590     if (window.console) {
1591       method = $.isFunction(console[method]) ? method : 'log';
1592       if (msg === undefined) {
1593         return console[method](title);
1594       } else {
1595         return console[method](title, msg);
1596       }
1597     }
1598   };
1599
1600   // Determine if a user has a given permission.
1601   // @see CRM_Core_Resources::addPermissions
1602   CRM.checkPerm = function(perm) {
1603     return CRM.permissions[perm];
1604   };
1605
1606   // Round while preserving sigfigs
1607   CRM.utils.sigfig = function(n, digits) {
1608     var len = ("" + n).length;
1609     var scale = Math.pow(10.0, len-digits);
1610     return Math.round(n / scale) * scale;
1611   };
1612
1613   // Create a js Date object from a unix timestamp or a yyyy-mm-dd string
1614   CRM.utils.makeDate = function(input) {
1615     switch (typeof input) {
1616       case 'object':
1617         // already a date object
1618         return input;
1619
1620       case 'string':
1621         // convert iso format
1622         return $.datepicker.parseDate('yy-mm-dd', input.substr(0, 10));
1623
1624       case 'number':
1625         // convert unix timestamp
1626         return new Date(input * 1000);
1627     }
1628     throw 'Invalid input passed to CRM.utils.makeDate';
1629   };
1630
1631   // Format a date for output to the user
1632   // Input may be a js Date object, a unix timestamp or a yyyy-mm-dd string
1633   CRM.utils.formatDate = function(input, outputFormat) {
1634     return input ? $.datepicker.formatDate(outputFormat || CRM.config.dateInputFormat, CRM.utils.makeDate(input)) : '';
1635   };
1636 })(jQuery, _);