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