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     obj.value = procText + " ...";
 162   }
 163   cj(obj).closest('form').attr('data-warn-changes', 'false');
 164   if (document.getElementById) { // disable submit button for newer browsers
 165     obj.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 CRM.utils = CRM.utils || {};
 205 CRM.strings = CRM.strings || {};
 206
 207 (function ($, _, undefined) {
 208   "use strict";
 209   /* jshint validthis: true */
 210
 211   // Theme classes for unattached elements
 212   $.fn.select2.defaults.dropdownCssClass = $.ui.dialog.prototype.options.dialogClass = 'crm-container';
 213
 214   // https://github.com/ivaynberg/select2/pull/2090
 215   $.fn.select2.defaults.width = 'resolve';
 216
 217   // Workaround for https://github.com/ivaynberg/select2/issues/1246
 218   $.ui.dialog.prototype._allowInteraction = function(e) {
 219     return !!$(e.target).closest('.ui-dialog, .ui-datepicker, .select2-drop, .cke_dialog, #civicrm-menu').length;
 220   };
 221
 222   // Implements jQuery hook.prop
 223   $.propHooks.disabled = {
 224     set: function (el, value, name) {
 225       // Sync button enabled status with wrapper css
 226       if ($(el).is('span.crm-button > input.crm-form-submit')) {
 227         $(el).parent().toggleClass('crm-button-disabled', !!value);
 228       }
 229       // Sync button enabled status with dialog button
 230       if ($(el).is('.ui-dialog input.crm-form-submit')) {
 231         $(el).closest('.ui-dialog').find('.ui-dialog-buttonset button[data-identifier='+ $(el).attr('name') +']').prop('disabled', value);
 232       }
 233       if ($(el).is('.crm-form-date-wrapper .crm-hidden-date')) {
 234         $(el).siblings().prop('disabled', value);
 235       }
 236     }
 237   };
 238
 239   /**
 240    * Populate a select list, overwriting the existing options except for the placeholder.
 241    * @param select jquery selector - 1 or more select elements
 242    * @param options array in format returned by api.getoptions
 243    * @param placeholder string|bool - new placeholder or false (default) to keep the old one
 244    * @param value string|array - will silently update the element with new value without triggering change
 245    */
 246   CRM.utils.setOptions = function(select, options, placeholder, value) {
 247     $(select).each(function() {
 248       var
 249         $elect = $(this),
 250         val = value || $elect.val() || [],
 251         opts = placeholder || placeholder === '' ? '' : '[value!=""]';
 252       $elect.find('option' + opts).remove();
 253       var newOptions = CRM.utils.renderOptions(options, val);
 254       if (typeof placeholder === 'string') {
 255         if ($elect.is('[multiple]')) {
 256           select.attr('placeholder', placeholder);
 257         } else {
 258           newOptions = '<option value="">' + placeholder + '</option>' + newOptions;
 259         }
 260       }
 261       $elect.append(newOptions);
 262       if (!value) {
 263         $elect.trigger('crmOptionsUpdated', $.extend({}, options)).trigger('change');
 264       }
 265     });
 266   };
 267
 268   /**
 269    * Render an option list
 270    * @param options {array}
 271    * @param val {string} default value
 272    * @param escapeHtml {bool}
 273    * @return string
 274    */
 275   CRM.utils.renderOptions = function(options, val, escapeHtml) {
 276     var rendered = '',
 277       esc = escapeHtml === false ? _.identity : _.escape;
 278     if (!$.isArray(val)) {
 279       val = [val];
 280     }
 281     _.each(options, function(option) {
 282       if (option.children) {
 283         rendered += '<optgroup label="' + esc(option.value) + '">' +
 284         CRM.utils.renderOptions(option.children, val) +
 285         '</optgroup>';
 286       } else {
 287         var selected = ($.inArray('' + option.key, val) > -1) ? 'selected="selected"' : '';
 288         rendered += '<option value="' + esc(option.key) + '"' + selected + '>' + esc(option.value) + '</option>';
 289       }
 290     });
 291     return rendered;
 292   };
 293
 294   function chainSelect() {
 295     var $form = $(this).closest('form'),
 296       $target = $('select[data-name="' + $(this).data('target') + '"]', $form),
 297       data = $target.data(),
 298       val = $(this).val();
 299     $target.prop('disabled', true);
 300     if ($target.is('select.crm-chain-select-control')) {
 301       $('select[data-name="' + $target.data('target') + '"]', $form).prop('disabled', true).blur();
 302     }
 303     if (!(val && val.length)) {
 304       CRM.utils.setOptions($target.blur(), [], data.emptyPrompt);
 305     } else {
 306       $target.addClass('loading');
 307       $.getJSON(CRM.url(data.callback), {_value: val}, function(vals) {
 308         $target.prop('disabled', false).removeClass('loading');
 309         CRM.utils.setOptions($target, vals || [], (vals && vals.length ? data.selectPrompt : data.nonePrompt));
 310       });
 311     }
 312   }
 313
 314   /**
 315    * Compare Form Input values against cached initial value.
 316    *
 317    * @return {Boolean} true if changes have been made.
 318    */
 319   CRM.utils.initialValueChanged = function(el) {
 320     var isDirty = false;
 321     $(':input:visible, .select2-container:visible+:input:hidden', el).not('[type=submit], [type=button], .crm-action-menu, :disabled').each(function () {
 322       var
 323         initialValue = $(this).data('crm-initial-value'),
 324         currentValue = $(this).is(':checkbox, :radio') ? $(this).prop('checked') : $(this).val();
 325       // skip change of value for submit buttons
 326       if (initialValue !== undefined && !_.isEqual(initialValue, currentValue)) {
 327         isDirty = true;
 328       }
 329     });
 330     return isDirty;
 331   };
 332
 333   /**
 334    * This provides defaults for ui.dialog which either need to be calculated or are different from global defaults
 335    *
 336    * @param settings
 337    * @returns {*}
 338    */
 339   CRM.utils.adjustDialogDefaults = function(settings) {
 340     settings = $.extend({width: '65%', height: '65%', modal: true}, settings || {});
 341     // Support relative height
 342     if (typeof settings.height === 'string' && settings.height.indexOf('%') > 0) {
 343       settings.height = parseInt($(window).height() * (parseFloat(settings.height)/100), 10);
 344     }
 345     // Responsive adjustment - increase percent width on small screens
 346     if (typeof settings.width === 'string' && settings.width.indexOf('%') > 0) {
 347       var screenWidth = $(window).width(),
 348         percentage = parseInt(settings.width.replace('%', ''), 10),
 349         gap = 100-percentage;
 350       if (screenWidth < 701) {
 351         settings.width = '100%';
 352       }
 353       else if (screenWidth < 1400) {
 354         settings.width = '' + parseInt(percentage+gap-((screenWidth - 700)/7*(gap)/100), 10) + '%';
 355       }
 356     }
 357     return settings;
 358   };
 359
 360   /**
 361    * Wrapper for select2 initialization function; supplies defaults
 362    * @param options object
 363    */
 364   $.fn.crmSelect2 = function(options) {
 365     return $(this).each(function () {
 366       var
 367         $el = $(this),
 368         settings = {allowClear: !$el.hasClass('required')};
 369       // quickform doesn't support optgroups so here's a hack :(
 370       $('option[value^=crm_optgroup]', this).each(function () {
 371         $(this).nextUntil('option[value^=crm_optgroup]').wrapAll('<optgroup label="' + $(this).text() + '" />');
 372         $(this).remove();
 373       });
 374
 375       // quickform does not support disabled option, so yet another hack to
 376       // add disabled property for option values
 377       $('option[value^=crm_disabled_opt]', this).attr('disabled', 'disabled');
 378
 379       // Defaults for single-selects
 380       if ($el.is('select:not([multiple])')) {
 381         settings.minimumResultsForSearch = 10;
 382         if ($('option:first', this).val() === '') {
 383           settings.placeholderOption = 'first';
 384         }
 385       }
 386       $.extend(settings, $el.data('select-params') || {}, options || {});
 387       if (settings.ajax) {
 388         $el.addClass('crm-ajax-select');
 389       }
 390       $el.select2(settings);
 391     });
 392   };
 393
 394   /**
 395    * @see CRM_Core_Form::addEntityRef for docs
 396    * @param options object
 397    */
 398   $.fn.crmEntityRef = function(options) {
 399     options = options || {};
 400     options.select = options.select || {};
 401     return $(this).each(function() {
 402       var
 403         $el = $(this).off('.crmEntity'),
 404         entity = options.entity || $el.data('api-entity') || 'contact',
 405         selectParams = {};
 406       $el.data('api-entity', entity);
 407       $el.data('select-params', $.extend({}, $el.data('select-params') || {}, options.select));
 408       $el.data('api-params', $.extend({}, $el.data('api-params') || {}, options.api));
 409       $el.data('create-links', options.create || $el.data('create-links'));
 410       $el.addClass('crm-form-entityref crm-' + entity.toLowerCase() + '-ref');
 411       var settings = {
 412         // Use select2 ajax helper instead of CRM.api3 because it provides more value
 413         ajax: {
 414           url: CRM.url('civicrm/ajax/rest'),
 415           data: function (input, page_num) {
 416             var params = getEntityRefApiParams($el);
 417             params.input = input;
 418             params.page_num = page_num;
 419             return {
 420               entity: $el.data('api-entity'),
 421               action: 'getlist',
 422               json: JSON.stringify(params)
 423             };
 424           },
 425           results: function(data) {
 426             return {more: data.more_results, results: data.values || []};
 427           }
 428         },
 429         minimumInputLength: 1,
 430         formatResult: CRM.utils.formatSelect2Result,
 431         formatSelection: function(row) {
 432           return (row.prefix !== undefined ? row.prefix + ' ' : '') + row.label + (row.suffix !== undefined ? ' ' + row.suffix : '');
 433         },
 434         escapeMarkup: function (m) {return m;},
 435         initSelection: function($el, callback) {
 436           var
 437             multiple = !!$el.data('select-params').multiple,
 438             val = $el.val(),
 439             stored = $el.data('entity-value') || [];
 440           if (val === '') {
 441             return;
 442           }
 443           // If we already have this data, just return it
 444           if (!_.xor(val.split(','), _.pluck(stored, 'id')).length) {
 445             callback(multiple ? stored : stored[0]);
 446           } else {
 447             var params = $.extend({}, $el.data('api-params') || {}, {id: val});
 448             CRM.api3($el.data('api-entity'), 'getlist', params).done(function(result) {
 449               callback(multiple ? result.values : result.values[0]);
 450               // Trigger change (store data to avoid an infinite loop of lookups)
 451               $el.data('entity-value', result.values).trigger('change');
 452             });
 453           }
 454         }
 455       };
 456       // Create new items inline - works for tags
 457       if ($el.data('create-links') && entity.toLowerCase() === 'tag') {
 458         selectParams.createSearchChoice = function(term, data) {
 459           if (!_.findKey(data, {label: term})) {
 460             return {id: "0", term: term, label: term + ' (' + ts('new tag') + ')'};
 461           }
 462         };
 463         selectParams.tokenSeparators = [','];
 464         selectParams.createSearchChoicePosition = 'bottom';
 465         $el.on('select2-selecting.crmEntity', function(e) {
 466           if (e.val === "0") {
 467             // Create a new term
 468             e.object.label = e.object.term;
 469             CRM.api3(entity, 'create', $.extend({name: e.object.term}, $el.data('api-params').params || {}))
 470               .done(function(created) {
 471                 var
 472                   val = $el.select2('val'),
 473                   data = $el.select2('data'),
 474                   item = {id: created.id, label: e.object.term};
 475                 if (val === "0") {
 476                   $el.select2('data', item, true);
 477                 }
 478                 else if ($.isArray(val) && $.inArray("0", val) > -1) {
 479                   _.remove(data, {id: "0"});
 480                   data.push(item);
 481                   $el.select2('data', data, true);
 482                 }
 483               });
 484           }
 485         });
 486       }
 487       else {
 488         selectParams.formatInputTooShort = function() {
 489           var txt = $el.data('select-params').formatInputTooShort || $.fn.select2.defaults.formatInputTooShort.call(this);
 490           txt += renderEntityRefFilters($el) + renderEntityRefCreateLinks($el);
 491           return txt;
 492         };
 493         selectParams.formatNoMatches = function() {
 494           var txt = $el.data('select-params').formatNoMatches || $.fn.select2.defaults.formatNoMatches;
 495           txt += renderEntityRefFilters($el) + renderEntityRefCreateLinks($el);
 496           return txt;
 497         };
 498         $el.on('select2-open.crmEntity', function() {
 499           var $el = $(this);
 500           loadEntityRefFilterOptions($el);
 501           $('#select2-drop')
 502             .off('.crmEntity')
 503             .on('click.crmEntity', 'a.crm-add-entity', function(e) {
 504               $el.select2('close');
 505               CRM.loadForm($(this).attr('href'), {
 506                 dialog: {width: 500, height: 220}
 507               }).on('crmFormSuccess', function(e, data) {
 508                 if (data.status === 'success' && data.id) {
 509                   CRM.status(ts('%1 Created', {1: data.label}));
 510                   if ($el.select2('container').hasClass('select2-container-multi')) {
 511                     var selection = $el.select2('data');
 512                     selection.push(data);
 513                     $el.select2('data', selection, true);
 514                   } else {
 515                     $el.select2('data', data, true);
 516                   }
 517                 }
 518               });
 519               return false;
 520             })
 521             .on('change.crmEntity', 'select.crm-entityref-filter-value', function() {
 522               var filter = $el.data('user-filter') || {};
 523               filter.value = $(this).val();
 524               $(this).toggleClass('active', !!filter.value);
 525               $el.data('user-filter', filter);
 526               if (filter.value) {
 527                 // Once a filter has been chosen, rerender create links and refocus the search box
 528                 $el.select2('close');
 529                 $el.select2('open');
 530               }
 531             })
 532             .on('change.crmEntity', 'select.crm-entityref-filter-key', function() {
 533               var filter = $el.data('user-filter') || {};
 534               filter.key = $(this).val();
 535               $(this).toggleClass('active', !!filter.key);
 536               $el.data('user-filter', filter);
 537               loadEntityRefFilterOptions($el);
 538             });
 539         });
 540       }
 541       $el.crmSelect2($.extend(settings, $el.data('select-params'), selectParams));
 542     });
 543   };
 544
 545   /**
 546    * Combine api-params with user-filter
 547    * @param $el
 548    * @returns {*}
 549    */
 550   function getEntityRefApiParams($el) {
 551     var
 552       params = $.extend({params: {}}, $el.data('api-params') || {}),
 553       // Prevent original data from being modified - $.extend and _.clone don't cut it, they pass nested objects by reference!
 554       combined = _.cloneDeep(params),
 555       filter = $.extend({}, $el.data('user-filter') || {});
 556     if (filter.key && filter.value) {
 557       // Special case for contact type/sub-type combo
 558       if (filter.key === 'contact_type' && (filter.value.indexOf('__') > 0)) {
 559         combined.params.contact_type = filter.value.split('__')[0];
 560         combined.params.contact_sub_type = filter.value.split('__')[1];
 561       } else {
 562         // Allow json-encoded api filters e.g. {"BETWEEN":[123,456]}
 563         combined.params[filter.key] = filter.value.charAt(0) === '{' ? $.parseJSON(filter.value) : filter.value;
 564       }
 565     }
 566     return combined;
 567   }
 568
 569   function copyAttributes($source, $target, attributes) {
 570     _.each(attributes, function(name) {
 571       if ($source.attr(name)) {
 572         $target.attr(name, $source.attr(name));
 573       }
 574     });
 575   }
 576
 577   $.fn.crmDatepicker = function(options) {
 578     return $(this).each(function() {
 579       if ($(this).is('.crm-form-date-wrapper .crm-hidden-date')) {
 580         // Already initialized
 581         return;
 582       }
 583       var
 584         $dataField = $(this).wrap('<span class="crm-form-date-wrapper" />'),
 585         settings = $.extend({}, $dataField.data('datepicker') || {}, options || {}),
 586         $dateField = $(),
 587         $timeField = $(),
 588         $clearLink = $();
 589
 590       if (settings.allowClear !== undefined ? settings.allowClear : !$dataField.hasClass('required')) {
 591         $clearLink = $('<a class="crm-hover-button crm-clear-link" title="'+ ts('Clear') +'"><span class="icon ui-icon-close"></span></a>')
 592           .insertAfter($dataField);
 593       }
 594       if (settings.time !== false) {
 595         $timeField = $('<input>').insertAfter($dataField);
 596         copyAttributes($dataField, $timeField, ['class', 'disabled']);
 597         $timeField
 598           .addClass('crm-form-text crm-form-time')
 599           .attr('placeholder', $dataField.attr('time-placeholder') === undefined ? ts('Time') : $dataField.attr('time-placeholder'))
 600           .change(updateDataField)
 601           .timeEntry({
 602             spinnerImage: '',
 603             show24Hours: settings.time === true || settings.time === undefined ? CRM.config.timeIs24Hr : settings.time == '24'
 604           });
 605       }
 606       if (settings.date !== false) {
 607         $dateField = $('<input>').insertAfter($dataField);
 608         copyAttributes($dataField, $dateField, ['placeholder', 'style', 'class', 'disabled']);
 609         $dateField.addClass('crm-form-text crm-form-date');
 610         settings.dateFormat = settings.dateFormat || CRM.config.dateInputFormat;
 611         settings.changeMonth = _.includes('m', settings.dateFormat);
 612         settings.changeYear = _.includes('y', settings.dateFormat);
 613         $dateField.datepicker(settings).change(updateDataField);
 614       }
 615       // Rudimentary validation. TODO: Roll into use of jQUery validate and ui.datepicker.validation
 616       function isValidDate() {
 617         try {
 618           $.datepicker.parseDate(settings.dateFormat, $dateField.val());
 619           return true;
 620         } catch (e) {
 621           return false;
 622         }
 623       }
 624       function updateInputFields(e, context) {
 625         var val = $dataField.val(),
 626           time = null;
 627         if (context !== 'userInput' && context !== 'crmClear') {
 628           if ($dateField.length) {
 629             $dateField.datepicker('setDate', _.includes(val, '-') ? $.datepicker.parseDate('yy-mm-dd', val) : null);
 630           }
 631           if ($timeField.length) {
 632             if (val.length === 8) {
 633               time = val;
 634             } else if (val.length === 19) {
 635               time = val.split(' ')[1];
 636             }
 637             $timeField.timeEntry('setTime', time);
 638           }
 639         }
 640         $clearLink.css('visibility', val ? 'visible' : 'hidden');
 641       }
 642       function updateDataField(e, context) {
 643         // The crmClear event wipes all the field values anyway, so no need to respond
 644         if (context !== 'crmClear') {
 645           var val = '';
 646           if ($dateField.val()) {
 647             if (isValidDate()) {
 648               val = $.datepicker.formatDate('yy-mm-dd', $dateField.datepicker('getDate'));
 649               $dateField.removeClass('crm-error');
 650             } else {
 651               $dateField.addClass('crm-error');
 652             }
 653           }
 654           if ($timeField.val()) {
 655             val += (val ? ' ' : '') + $timeField.timeEntry('getTime').toTimeString().substr(0, 8);
 656           }
 657           $dataField.val(val).trigger('change', ['userInput']);
 658         }
 659       }
 660       $dataField.hide().addClass('crm-hidden-date').on('change', updateInputFields);
 661       updateInputFields();
 662     });
 663   };
 664
 665   $.fn.crmAjaxTable = function() {
 666     return $(this).each(function() {
 667       //Declare the defaults for DataTables
 668       var defaults = {
 669         "processing": true,
 670         "serverSide": true,
 671         "dom": '<"crm-datatable-pager-top"lfp>rt<"crm-datatable-pager-bottom"ip>',
 672         "pageLength": 25,
 673         "drawCallback": function(settings) {
 674           //Add data attributes to cells
 675           $('thead th', settings.nTable).each( function( index ) {
 676             $.each(this.attributes, function() {
 677               if(this.name.match("^cell-")) {
 678                 var cellAttr = this.name.substring(5);
 679                 var cellValue = this.value;
 680                 $('tbody tr', settings.nTable).each( function() {
 681                   $('td:eq('+ index +')', this).attr( cellAttr, cellValue );
 682                 });
 683               }
 684             });
 685           });
 686           //Reload table after draw
 687           $(settings.nTable).trigger('crmLoad');
 688         }
 689       };
 690       //Include any table specific data
 691       var settings = $.extend(true, defaults, $(this).data('table'));
 692       //Make the DataTables call
 693       $(this).DataTable(settings);
 694     });
 695   };
 696
 697   CRM.utils.formatSelect2Result = function (row) {
 698     var markup = '<div class="crm-select2-row">';
 699     if (row.image !== undefined) {
 700       markup += '<div class="crm-select2-image"><img src="' + row.image + '"/></div>';
 701     }
 702     else if (row.icon_class) {
 703       markup += '<div class="crm-select2-icon"><div class="crm-icon ' + row.icon_class + '-icon"></div></div>';
 704     }
 705     markup += '<div><div class="crm-select2-row-label '+(row.label_class || '')+'">' +
 706       (row.prefix !== undefined ? row.prefix + ' ' : '') + row.label + (row.suffix !== undefined ? ' ' + row.suffix : '') +
 707       '</div>' +
 708       '<div class="crm-select2-row-description">';
 709     $.each(row.description || [], function(k, text) {
 710       markup += '<p>' + text + '</p>';
 711     });
 712     markup += '</div></div></div>';
 713     return markup;
 714   };
 715
 716   function renderEntityRefCreateLinks($el) {
 717     var
 718       createLinks = $el.data('create-links'),
 719       params = getEntityRefApiParams($el).params,
 720       markup = '<div class="crm-entityref-links">';
 721     if (!createLinks || $el.data('api-entity').toLowerCase() !== 'contact') {
 722       return '';
 723     }
 724     if (createLinks === true) {
 725       createLinks = params.contact_type ? _.where(CRM.config.entityRef.contactCreate, {type: params.contact_type}) : CRM.config.entityRef.contactCreate;
 726     }
 727     _.each(createLinks, function(link) {
 728       markup += ' <a class="crm-add-entity crm-hover-button" href="' + link.url + '">';
 729       if (link.type) {
 730         markup += '<span class="icon ' + link.type + '-profile-icon"></span> ';
 731       }
 732       markup += link.label + '</a>';
 733     });
 734     markup += '</div>';
 735     return markup;
 736   }
 737
 738   function getEntityRefFilters($el) {
 739     var
 740       entity = $el.data('api-entity').toLowerCase(),
 741       filters = $.extend([], CRM.config.entityRef.filters[entity] || []),
 742       filter = $el.data('user-filter') || {},
 743       params = $.extend({params: {}}, $el.data('api-params') || {}).params,
 744       result = [];
 745     $.each(filters, function() {
 746       if (typeof params[this.key] === 'undefined') {
 747         result.push(this);
 748       }
 749       else if (this.key == 'contact_type' && typeof params.contact_sub_type === 'undefined') {
 750         this.options = _.remove(this.options, function(option) {
 751           return option.key.indexOf(params.contact_type + '__') === 0;
 752         });
 753         result.push(this);
 754       }
 755     });
 756     return result;
 757   }
 758
 759   function renderEntityRefFilters($el) {
 760     var
 761       filters = getEntityRefFilters($el),
 762       filter = $el.data('user-filter') || {},
 763       filterSpec = filter.key ? _.find(filters, {key: filter.key}) : null;
 764     if (!filters.length) {
 765       return '';
 766     }
 767     var markup = '<div class="crm-entityref-filters">' +
 768       '<select class="crm-entityref-filter-key' + (filter.key ? ' active' : '') + '">' +
 769       '<option value="">' + ts('Refine search...') + '</option>' +
 770       CRM.utils.renderOptions(filters, filter.key) +
 771       '</select> &nbsp; ' +
 772       '<select class="crm-entityref-filter-value' + (filter.key ? ' active"' : '"') + (filter.key ? '' : ' style="display:none;"') + '>' +
 773       '<option value="">' + ts('- select -') + '</option>';
 774     if (filterSpec && filterSpec.options) {
 775       markup += CRM.utils.renderOptions(filterSpec.options, filter.value);
 776     }
 777     markup += '</select></div>';
 778     return markup;
 779   }
 780
 781   /**
 782    * Fetch options for a filter (via ajax if necessary) and populate the appropriate select list
 783    * @param $el
 784    */
 785   function loadEntityRefFilterOptions($el) {
 786     var
 787       filters = getEntityRefFilters($el),
 788       filter = $el.data('user-filter') || {},
 789       filterSpec = filter.key ? _.find(filters, {key: filter.key}) : null,
 790       $valField = $('.crm-entityref-filter-value', '#select2-drop');
 791     if (filterSpec) {
 792       $valField.show().val('');
 793       if (filterSpec.options) {
 794         CRM.utils.setOptions($valField, filterSpec.options, false, filter.value);
 795       } else {
 796         $valField.prop('disabled', true);
 797         CRM.api3(filterSpec.entity || $el.data('api-entity'), 'getoptions', {field: filter.key, context: 'search', sequential: 1})
 798           .done(function(result) {
 799             var entity = $el.data('api-entity').toLowerCase(),
 800               globalFilterSpec = _.find(CRM.config.entityRef.filters[entity], {key: filter.key}) || {};
 801             // Store options globally so we don't have to look them up again
 802             globalFilterSpec.options = result.values;
 803             $valField.prop('disabled', false);
 804             CRM.utils.setOptions($valField, result.values);
 805             $valField.val(filter.value || '');
 806           });
 807       }
 808     } else {
 809       $valField.hide();
 810     }
 811   }
 812
 813   //CRM-15598 - Override url validator method to allow relative url's (e.g. /index.htm)
 814   $.validator.addMethod("url", function(value, element) {
 815     if (/^\//.test(value)) {
 816       // Relative url: prepend dummy path for validation.
 817       value = 'http://domain.tld' + value;
 818     }
 819     // From jQuery Validation Plugin v1.12.0
 820     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);
 821   });
 822
 823   /**
 824    * Wrapper for jQuery validate initialization function; supplies defaults
 825    */
 826   $.fn.crmValidate = function(params) {
 827     return $(this).each(function () {
 828       var that = this,
 829         settings = $.extend({}, CRM.validate._defaults, CRM.validate.params);
 830       $(this).validate(settings);
 831       // Call any post-initialization callbacks
 832       if (CRM.validate.functions && CRM.validate.functions.length) {
 833         $.each(CRM.validate.functions, function(i, func) {
 834           func.call(that);
 835         });
 836       }
 837     });
 838   };
 839
 840   // Initialize widgets
 841   $(document)
 842     .on('crmLoad', function(e) {
 843       $('table.row-highlight', e.target)
 844         .off('.rowHighlight')
 845         .on('change.rowHighlight', 'input.select-row, input.select-rows', function (e, data) {
 846           var filter, $table = $(this).closest('table');
 847           if ($(this).hasClass('select-rows')) {
 848             filter = $(this).prop('checked') ? ':not(:checked)' : ':checked';
 849             $('input.select-row' + filter, $table).prop('checked', $(this).prop('checked')).trigger('change', 'master-selected');
 850           }
 851           else {
 852             $(this).closest('tr').toggleClass('crm-row-selected', $(this).prop('checked'));
 853             if (data !== 'master-selected') {
 854               $('input.select-rows', $table).prop('checked', $(".select-row:not(':checked')", $table).length < 1);
 855             }
 856           }
 857         })
 858         .find('input.select-row:checked').parents('tr').addClass('crm-row-selected');
 859       $('table.crm-sortable', e.target).DataTable();
 860       $('table.crm-ajax-table', e.target).crmAjaxTable();
 861       if ($("input:radio[name=radio_ts]").size() == 1) {
 862         $("input:radio[name=radio_ts]").prop("checked", true);
 863       }
 864       $('.crm-select2:not(.select2-offscreen, .select2-container)', e.target).crmSelect2();
 865       $('.crm-form-entityref:not(.select2-offscreen, .select2-container)', e.target).crmEntityRef();
 866       $('select.crm-chain-select-control', e.target).off('.chainSelect').on('change.chainSelect', chainSelect);
 867       // Cache Form Input initial values
 868       $('form[data-warn-changes] :input', e.target).each(function() {
 869         $(this).data('crm-initial-value', $(this).is(':checkbox, :radio') ? $(this).prop('checked') : $(this).val());
 870       });
 871       $('textarea.crm-form-wysiwyg', e.target)
 872         .not('.crm-wysiwyg-enabled')
 873         .addClass('crm-wysiwyg-enabled')
 874         .each(function() {
 875           if ($(this).hasClass("collapsed")) {
 876             CRM.wysiwyg.createCollapsed(this);
 877           } else {
 878             CRM.wysiwyg.create(this);
 879           }
 880         });
 881     })
 882     .on('dialogopen', function(e) {
 883       var $el = $(e.target);
 884       // Modal dialogs should disable scrollbars
 885       if ($el.dialog('option', 'modal')) {
 886         $el.addClass('modal-dialog');
 887         $('body').css({overflow: 'hidden'});
 888       }
 889       // Add resize button
 890       if ($el.parent().hasClass('crm-container') && $el.dialog('option', 'resizable')) {
 891         $el.parent().find('.ui-dialog-titlebar').append($('<button class="crm-dialog-titlebar-resize ui-dialog-titlebar-close" title="'+ts('Toggle fullscreen')+'" style="right:2em;"/>').button({icons: {primary: 'ui-icon-newwin'}, text: false}));
 892         $('.crm-dialog-titlebar-resize', $el.parent()).click(function(e) {
 893           if ($el.data('origSize')) {
 894             $el.dialog('option', $el.data('origSize'));
 895             $el.data('origSize', null);
 896           } else {
 897             var menuHeight = $('#civicrm-menu').outerHeight();
 898             $el.data('origSize', {
 899               position: {my: 'center', at: 'center center+' + (menuHeight / 2), of: window},
 900               width: $el.dialog('option', 'width'),
 901               height: $el.dialog('option', 'height')
 902             });
 903             $el.dialog('option', {width: '100%', height: ($(window).height() - menuHeight), position: {my: "top", at: "top+"+menuHeight, of: window}});
 904           }
 905           $el.trigger('dialogresize');
 906           e.preventDefault();
 907         });
 908       }
 909     })
 910     .on('dialogclose', function(e) {
 911       // Restore scrollbars when closing modal
 912       if ($('.ui-dialog .modal-dialog:visible').not(e.target).length < 1) {
 913         $('body').css({overflow: ''});
 914       }
 915     })
 916     .on('submit', function(e) {
 917       // CRM-14353 - disable changes warn when submitting a form
 918       $('[data-warn-changes]').attr('data-warn-changes', 'false');
 919     });
 920
 921   // CRM-14353 - Warn of unsaved changes for forms which have opted in
 922   window.onbeforeunload = function() {
 923     if (CRM.utils.initialValueChanged($('form[data-warn-changes=true]:visible'))) {
 924       return ts('You have unsaved changes.');
 925     }
 926   };
 927
 928   $.fn.crmtooltip = function () {
 929     $(document)
 930       .on('mouseover', 'a.crm-summary-link:not(.crm-processed)', function (e) {
 931         $(this).addClass('crm-processed');
 932         $(this).addClass('crm-tooltip-active');
 933         var topDistance = e.pageY - $(window).scrollTop();
 934         if (topDistance < 300 || topDistance < $(this).children('.crm-tooltip-wrapper').height()) {
 935           $(this).addClass('crm-tooltip-down');
 936         }
 937         if (!$(this).children('.crm-tooltip-wrapper').length) {
 938           $(this).append('<div class="crm-tooltip-wrapper"><div class="crm-tooltip"></div></div>');
 939           $(this).children().children('.crm-tooltip')
 940             .html('<div class="crm-loading-element"></div>')
 941             .load(this.href);
 942         }
 943       })
 944       .on('mouseout', 'a.crm-summary-link', function () {
 945         $(this).removeClass('crm-processed');
 946         $(this).removeClass('crm-tooltip-active crm-tooltip-down');
 947       })
 948       .on('click', 'a.crm-summary-link', false);
 949   };
 950
 951   var helpDisplay, helpPrevious;
 952   CRM.help = function (title, params, url) {
 953     if (helpDisplay && helpDisplay.close) {
 954       // If the same link is clicked twice, just close the display - todo use underscore method for this comparison
 955       if (helpDisplay.isOpen && helpPrevious === JSON.stringify(params)) {
 956         helpDisplay.close();
 957         return;
 958       }
 959       helpDisplay.close();
 960     }
 961     helpPrevious = JSON.stringify(params);
 962     params.class_name = 'CRM_Core_Page_Inline_Help';
 963     params.type = 'page';
 964     helpDisplay = CRM.alert('...', title, 'crm-help crm-msg-loading', {expires: 0});
 965     $.ajax(url || CRM.url('civicrm/ajax/inline'),
 966       {
 967         data: params,
 968         dataType: 'html',
 969         success: function (data) {
 970           $('#crm-notification-container .crm-help .notify-content:last').html(data);
 971           $('#crm-notification-container .crm-help').removeClass('crm-msg-loading').addClass('info');
 972         },
 973         error: function () {
 974           $('#crm-notification-container .crm-help .notify-content:last').html('Unable to load help file.');
 975           $('#crm-notification-container .crm-help').removeClass('crm-msg-loading').addClass('error');
 976         }
 977       }
 978     );
 979   };
 980   /**
 981    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
 982    */
 983   CRM.status = function(options, deferred) {
 984     // 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.
 985     if (typeof options === 'string') {
 986       return CRM.status({start: options, success: options, error: options})[deferred === 'error' ? 'reject' : 'resolve']();
 987     }
 988     var opts = $.extend({
 989       start: ts('Saving...'),
 990       success: ts('Saved'),
 991       error: function(data) {
 992         var msg = $.isPlainObject(data) && data.error_message;
 993         CRM.alert(msg || ts('Sorry an error occurred and your information was not saved'), ts('Error'), 'error');
 994       }
 995     }, options || {});
 996     var $msg = $('<div class="crm-status-box-outer status-start"><div class="crm-status-box-inner"><div class="crm-status-box-msg">' + opts.start + '</div></div></div>')
 997       .appendTo('body');
 998     $msg.css('min-width', $msg.width());
 999     function handle(status, data) {
1000       var endMsg = typeof(opts[status]) === 'function' ? opts[status](data) : opts[status];
1001       if (endMsg) {
1002         $msg.removeClass('status-start').addClass('status-' + status).find('.crm-status-box-msg').html(endMsg);
1003         window.setTimeout(function() {
1004           $msg.fadeOut('slow', function() {
1005             $msg.remove();
1006           });
1007         }, 2000);
1008       } else {
1009         $msg.remove();
1010       }
1011     }
1012     return (deferred || new $.Deferred())
1013       .done(function(data) {
1014         // If the server returns an error msg call the error handler
1015         var status = $.isPlainObject(data) && (data.is_error || data.status === 'error') ? 'error' : 'success';
1016         handle(status, data);
1017       })
1018       .fail(function(data) {
1019         handle('error', data);
1020       });
1021   };
1022
1023   // Convert an Angular promise to a jQuery promise
1024   CRM.toJqPromise = function(aPromise) {
1025     var jqDeferred = $.Deferred();
1026     aPromise.then(
1027       function(data) { jqDeferred.resolve(data); },
1028       function(data) { jqDeferred.reject(data); }
1029       // should we also handle progress events?
1030     );
1031     return jqDeferred.promise();
1032   };
1033
1034   CRM.toAPromise = function($q, jqPromise) {
1035     var aDeferred = $q.defer();
1036     jqPromise.then(
1037       function(data) { aDeferred.resolve(data); },
1038       function(data) { aDeferred.reject(data); }
1039       // should we also handle progress events?
1040     );
1041     return aDeferred.promise;
1042   };
1043
1044   /**
1045    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1046    */
1047   CRM.alert = function (text, title, type, options) {
1048     type = type || 'alert';
1049     title = title || '';
1050     options = options || {};
1051     if ($('#crm-notification-container').length) {
1052       var params = {
1053         text: text,
1054         title: title,
1055         type: type
1056       };
1057       // By default, don't expire errors and messages containing links
1058       var extra = {
1059         expires: (type == 'error' || text.indexOf('<a ') > -1) ? 0 : (text ? 10000 : 5000),
1060         unique: true
1061       };
1062       options = $.extend(extra, options);
1063       options.expires = options.expires === false ? 0 : parseInt(options.expires, 10);
1064       if (options.unique && options.unique !== '0') {
1065         $('#crm-notification-container .ui-notify-message').each(function () {
1066           if (title === $('h1', this).html() && text === $('.notify-content', this).html()) {
1067             $('.icon.ui-notify-close', this).click();
1068           }
1069         });
1070       }
1071       return $('#crm-notification-container').notify('create', params, options);
1072     }
1073     else {
1074       if (title.length) {
1075         text = title + "\n" + text;
1076       }
1077       alert(text);
1078       return null;
1079     }
1080   };
1081
1082   /**
1083    * Close whichever alert contains the given node
1084    *
1085    * @param node
1086    */
1087   CRM.closeAlertByChild = function (node) {
1088     $(node).closest('.ui-notify-message').find('.icon.ui-notify-close').click();
1089   };
1090
1091   /**
1092    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1093    */
1094   CRM.confirm = function (options) {
1095     var dialog, url, msg, buttons = [], settings = {
1096       title: ts('Confirm'),
1097       message: ts('Are you sure you want to continue?'),
1098       url: null,
1099       width: 'auto',
1100       height: 'auto',
1101       resizable: false,
1102       dialogClass: 'crm-container crm-confirm',
1103       close: function () {
1104         $(this).dialog('destroy').remove();
1105       },
1106       options: {
1107         no: ts('Cancel'),
1108         yes: ts('Continue')
1109       }
1110     };
1111     if (options && options.url) {
1112       settings.resizable = true;
1113       settings.height = '50%';
1114     }
1115     $.extend(settings, ($.isFunction(options) ? arguments[1] : options) || {});
1116     settings = CRM.utils.adjustDialogDefaults(settings);
1117     if (!settings.buttons && $.isPlainObject(settings.options)) {
1118       $.each(settings.options, function(op, label) {
1119         buttons.push({
1120           text: label,
1121           'data-op': op,
1122           icons: {primary: op === 'no' ? 'ui-icon-close' : 'ui-icon-check'},
1123           click: function() {
1124             var event = $.Event('crmConfirm:' + op);
1125             $(this).trigger(event);
1126             if (!event.isDefaultPrevented()) {
1127               dialog.dialog('close');
1128             }
1129           }
1130         });
1131       });
1132       // Order buttons so that "no" goes on the right-hand side
1133       settings.buttons = _.sortBy(buttons, 'data-op').reverse();
1134     }
1135     url = settings.url;
1136     msg = url ? '' : settings.message;
1137     delete settings.options;
1138     delete settings.message;
1139     delete settings.url;
1140     dialog = $('<div class="crm-confirm-dialog"></div>').html(msg || '').dialog(settings);
1141     if ($.isFunction(options)) {
1142       dialog.on('crmConfirm:yes', options);
1143     }
1144     if (url) {
1145       CRM.loadPage(url, {target: dialog});
1146     }
1147     else {
1148       dialog.trigger('crmLoad');
1149     }
1150     return dialog;
1151   };
1152
1153   /** provides a local copy of ts for a domain */
1154   CRM.ts = function(domain) {
1155     return function(message, options) {
1156       if (domain) {
1157         options = $.extend(options || {}, {domain: domain});
1158       }
1159       return ts(message, options);
1160     };
1161   };
1162
1163   CRM.addStrings = function(domain, strings) {
1164     var bucket = (domain == 'civicrm' ? 'strings' : 'strings::' + domain);
1165     CRM[bucket] = CRM[bucket] || {};
1166     _.extend(CRM[bucket], strings);
1167   };
1168
1169   /**
1170    * @see https://wiki.civicrm.org/confluence/display/CRMDOC/Notification+Reference
1171    */
1172   $.fn.crmError = function (text, title, options) {
1173     title = title || '';
1174     text = text || '';
1175     options = options || {};
1176
1177     var extra = {
1178       expires: 0
1179     };
1180     if ($(this).length) {
1181       if (title === '') {
1182         var label = $('label[for="' + $(this).attr('name') + '"], label[for="' + $(this).attr('id') + '"]').not('[generated=true]');
1183         if (label.length) {
1184           label.addClass('crm-error');
1185           var $label = label.clone();
1186           if (text === '' && $('.crm-marker', $label).length > 0) {
1187             text = $('.crm-marker', $label).attr('title');
1188           }
1189           $('.crm-marker', $label).remove();
1190           title = $label.text();
1191         }
1192       }
1193       $(this).addClass('crm-error');
1194     }
1195     var msg = CRM.alert(text, title, 'error', $.extend(extra, options));
1196     if ($(this).length) {
1197       var ele = $(this);
1198       setTimeout(function () {
1199         ele.one('change', function () {
1200           if (msg && msg.close) msg.close();
1201           ele.removeClass('error');
1202           label.removeClass('crm-error');
1203         });
1204       }, 1000);
1205     }
1206     return msg;
1207   };
1208
1209   // Display system alerts through js notifications
1210   function messagesFromMarkup() {
1211     $('div.messages:visible', this).not('.help').not('.no-popup').each(function () {
1212       var text, title = '';
1213       $(this).removeClass('status messages');
1214       var type = $(this).attr('class').split(' ')[0] || 'alert';
1215       type = type.replace('crm-', '');
1216       $('.icon', this).remove();
1217       if ($('.msg-text', this).length > 0) {
1218         text = $('.msg-text', this).html();
1219         title = $('.msg-title', this).html();
1220       }
1221       else {
1222         text = $(this).html();
1223       }
1224       var options = $(this).data('options') || {};
1225       $(this).remove();
1226       // Duplicates were already removed server-side
1227       options.unique = false;
1228       CRM.alert(text, title, type, options);
1229     });
1230     // Handle qf form errors
1231     $('form :input.error', this).one('blur', function() {
1232       $('.ui-notify-message.error a.ui-notify-close').click();
1233       $(this).removeClass('error');
1234       $(this).next('span.crm-error').remove();
1235       $('label[for="' + $(this).attr('name') + '"], label[for="' + $(this).attr('id') + '"]')
1236         .removeClass('crm-error')
1237         .find('.crm-error').removeClass('crm-error');
1238     });
1239   }
1240
1241   /**
1242    * Improve blockUI when used with jQuery dialog
1243    */
1244   var originalBlock = $.fn.block,
1245     originalUnblock = $.fn.unblock;
1246
1247   $.fn.block = function(opts) {
1248     if ($(this).is('.ui-dialog-content')) {
1249       originalBlock.call($(this).parents('.ui-dialog'), opts);
1250       return $(this);
1251     }
1252     return originalBlock.call(this, opts);
1253   };
1254   $.fn.unblock = function(opts) {
1255     if ($(this).is('.ui-dialog-content')) {
1256       originalUnblock.call($(this).parents('.ui-dialog'), opts);
1257       return $(this);
1258     }
1259     return originalUnblock.call(this, opts);
1260   };
1261
1262   // Preprocess all CRM ajax calls to display messages
1263   $(document).ajaxSuccess(function(event, xhr, settings) {
1264     try {
1265       if ((!settings.dataType || settings.dataType == 'json') && xhr.responseText) {
1266         var response = $.parseJSON(xhr.responseText);
1267         if (typeof(response.crmMessages) == 'object') {
1268           $.each(response.crmMessages, function(n, msg) {
1269             CRM.alert(msg.text, msg.title, msg.type, msg.options);
1270           });
1271         }
1272         if (response.backtrace) {
1273           CRM.console('log', response.backtrace);
1274         }
1275         if (typeof response.deprecated === 'string') {
1276           CRM.console('warn', response.deprecated);
1277         }
1278       }
1279     }
1280     // Ignore errors thrown by parseJSON
1281     catch (e) {}
1282   });
1283
1284   $(function () {
1285     $.blockUI.defaults.message = null;
1286     $.blockUI.defaults.ignoreIfBlocked = true;
1287
1288     if ($('#crm-container').hasClass('crm-public')) {
1289       $.fn.select2.defaults.dropdownCssClass = $.ui.dialog.prototype.options.dialogClass = 'crm-container crm-public';
1290     }
1291
1292     // Trigger crmLoad on initial content for consistency. It will also be triggered for ajax-loaded content.
1293     $('.crm-container').trigger('crmLoad');
1294
1295     if ($('#crm-notification-container').length) {
1296       // Initialize notifications
1297       $('#crm-notification-container').notify();
1298       messagesFromMarkup.call($('#crm-container'));
1299     }
1300
1301     // Hide CiviCRM menubar when editor is fullscreen
1302     if (window.CKEDITOR) {
1303       CKEDITOR.on('instanceCreated', function (e) {
1304         e.editor.on('maximize', function (e) {
1305           $('#civicrm-menu').toggle(e.data === 2);
1306         });
1307       });
1308     }
1309
1310     $('body')
1311       // bind the event for image popup
1312       .on('click', 'a.crm-image-popup', function(e) {
1313         CRM.confirm({
1314           title: ts('Preview'),
1315           resizable: true,
1316           message: '<div class="crm-custom-image-popup"><img style="max-width: 100%" src="' + $(this).attr('href') + '"></div>',
1317           options: null
1318         });
1319         e.preventDefault();
1320       })
1321
1322       .on('click', function (event) {
1323         $('.btn-slide-active').removeClass('btn-slide-active').find('.panel').hide();
1324         if ($(event.target).is('.btn-slide')) {
1325           $(event.target).addClass('btn-slide-active').find('.panel').show();
1326         }
1327       })
1328
1329       // Handle clear button for form elements
1330       .on('click', 'a.crm-clear-link', function() {
1331         $(this).css({visibility: 'hidden'}).siblings('.crm-form-radio:checked').prop('checked', false).trigger('change', ['crmClear']);
1332         $(this).siblings('input:text').val('').trigger('change', ['crmClear']);
1333         return false;
1334       })
1335       .on('change', 'input.crm-form-radio:checked', function() {
1336         $(this).siblings('.crm-clear-link').css({visibility: ''});
1337       })
1338
1339       // Allow normal clicking of links within accordions
1340       .on('click.crmAccordions', 'div.crm-accordion-header a', function (e) {
1341         e.stopPropagation();
1342       })
1343       // Handle accordions
1344       .on('click.crmAccordions', '.crm-accordion-header, .crm-collapsible .collapsible-title', function (e) {
1345         if ($(this).parent().hasClass('collapsed')) {
1346           $(this).next().css('display', 'none').slideDown(200);
1347         }
1348         else {
1349           $(this).next().css('display', 'block').slideUp(200);
1350         }
1351         $(this).parent().toggleClass('collapsed');
1352         e.preventDefault();
1353       });
1354
1355     $().crmtooltip();
1356   });
1357
1358   /**
1359    * Collapse or expand an accordion
1360    * @param speed
1361    */
1362   $.fn.crmAccordionToggle = function (speed) {
1363     $(this).each(function () {
1364       if ($(this).hasClass('collapsed')) {
1365         $('.crm-accordion-body', this).first().css('display', 'none').slideDown(speed);
1366       }
1367       else {
1368         $('.crm-accordion-body', this).first().css('display', 'block').slideUp(speed);
1369       }
1370       $(this).toggleClass('collapsed');
1371     });
1372   };
1373
1374   /**
1375    * Clientside currency formatting
1376    * @param number value
1377    * @param [optional] boolean onlyNumber - if true, we return formatted amount without currency sign
1378    * @param [optional] string format - currency representation of the number 1234.56
1379    * @return string
1380    */
1381   var currencyTemplate;
1382   CRM.formatMoney = function(value, onlyNumber, format) {
1383     var decimal, separator, sign, i, j, result;
1384     if (value === 'init' && format) {
1385       currencyTemplate = format;
1386       return;
1387     }
1388     format = format || currencyTemplate;
1389     result = /1(.?)234(.?)56/.exec(format);
1390     if (result === null) {
1391       return 'Invalid format passed to CRM.formatMoney';
1392     }
1393     separator = result[1];
1394     decimal = result[2];
1395     sign = (value < 0) ? '-' : '';
1396     //extracting the absolute value of the integer part of the number and converting to string
1397     i = parseInt(value = Math.abs(value).toFixed(2)) + '';
1398     j = ((j = i.length) > 3) ? j % 3 : 0;
1399     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) : '');
1400     if ( onlyNumber ) {
1401       return result;
1402     }
1403     return format.replace(/1.*234.*56/, result);
1404   };
1405
1406   CRM.console = function(method, title, msg) {
1407     if (window.console) {
1408       method = $.isFunction(console[method]) ? method : 'log';
1409       if (msg === undefined) {
1410         return console[method](title);
1411       } else {
1412         return console[method](title, msg);
1413       }
1414     }
1415   };
1416
1417   // Determine if a user has a given permission.
1418   // @see CRM_Core_Resources::addPermissions
1419   CRM.checkPerm = function(perm) {
1420     return CRM.permissions[perm];
1421   };
1422
1423   // Round while preserving sigfigs
1424   CRM.utils.sigfig = function(n, digits) {
1425     var len = ("" + n).length;
1426     var scale = Math.pow(10.0, len-digits);
1427     return Math.round(n / scale) * scale;
1428   };
1429 })(jQuery, _);