/**
 * This function sets the values of form element variables from an array
 * This is the reverse process of Mark Constable's serialize function
 * It is expected to be used as a call back for an ajax call that retrieves the form data
 * @param data : array or hash containing name,value pairs for elements in the form
 *
 * Examples
 *
 * 1. Deserialize from an array
 *    $('#form-id').deserialize([{'name':'firstname','value':'John'},{'name':'lastname','value':'Resig'}]);
 *
 * 2. Deserialize from a hash(object)
 *    $('#form-id').deserialize({'firstname':'John','lastname':'Resig'});
 *
 * 3. Deserialize multiple config for select/radio/checkbox
 *    $('#form-id').deserialize({'toppings':['capsicum','mushroom','extra_cheese'],'size':'medium'})
 * which will set the corresponding select/radio/checkbox config for toppings
 *
 * 3. Deserialize multiple config for select/radio/checkbox and with isPHPnaming = true
 *    $('#form-id').deserialize({'toppings':['capsicum','mushroom','extra_cheese'],'size':'medium'},{isPHPnaming:true})
 * which will set the corresponding select/radio/checkbox config for toppings, but will ignore select names ending with []
 *
 * @return         the jQuery Object
 * @author         Ashutosh Bijoor (bijoor@reach1to1.com)
 * @version        0.35
 */
$.fn.deserialize = function(d,config) {
  var data= d;
  me  = this;
 
  if (d === undefined) {
    return me;
  }
 
  config = $.extend({ isPHPnaming : false,
            overwrite : true},config);
  
  // check if data is an array, and convert to hash, converting multiple entries of 
  // same name to an array
  if (d.constructor == Array) {
    data={};
    for(var i=0; i<d.length; i++) {
      if (typeof data[d[i].name] != 'undefined') {
        if (data[d[i].name].constructor!= Array) {
          data[d[i].name]=[data[d[i].name],d[i].value];
        } else {
          data[d[i].name].push(d[i].value);
        }
      } else {
        data[d[i].name]=d[i].value;
      }
    }
  }
 
  // now data is a hash. insert each parameter into the form
  $('input,select,textarea',me)
  .each(function() {
        var p=this.name;
        var v = [];
        
        // handle wierd PHP names if required
        if (config.isPHPnaming) {
          p=p.replace(/\[\]$/,'');
        }
        if(p && data[p] != undefined) {
          v = data[p].constructor == Array ? data[p] : [data[p]];
        }
        // Additional parameter overwrite
        if (config.overwrite === true || data[p]) {
          switch(this.type || this.tagName.toLowerCase()) {
          case "radio":
          case "checkbox":
            this.checked=false;
            for(var i=0;i<v.length;i++) {
              this.checked|=(this.value!='' && v[i]==this.value);
            }
            break;
          case "select-multiple" || "select":
            for( i=0;i<this.options.length;i++) {
              this.options[i].selected=false;
              for(var j=0;j<v.length;j++) {
                this.options[i].selected|=(this.options[i].value!='' && this.options[i].value==v[j]);
              }
            }
            break;
          case "button":
          case "submit":
            this.value=v.length>0?v.join(','):this.value;
              break;
          default:
            this.value=v.join(',');
          }
        }
      });
  return me;
};