Minor cleanup.
[mkdru-moved-to-drupal.org.git] / mkdru.client.js
index 2881fda..0561a7e 100644 (file)
@@ -1,55 +1,76 @@
 // Set up namespace and some state.
 var mkdru = {
-  // Settings to pass to pz2.js
-  usesessions: Drupal.settings.mkdru.use_sessions === '1',
-  //   showResponseType: 'json',
+  settings: JSON.parse(Drupal.settings.mkdru.settings),
   // Variables
-  submitted: false,
+  active: false,
   pz2: null,
   totalRec: 0,
   pagerRange: 6,
-  sourceMax: Drupal.settings.mkdru.source_max,
-  subjectMax: Drupal.settings.mkdru.subject_max,
-  authorMax: Drupal.settings.mkdru.author_max,
-  pazpar2Path: Drupal.settings.mkdru.pz2_path,
-  // State
+  facetContainerSelector: '#mkdru-raw-facet-container',
   defaultState: {
     page: 1,
     perpage: 20,
     sort: 'relevance',
-    filter: null,
-    query:null,
+    query:'',
     recid:null
   },
-  state: {}
+  state: {},
+  realm: ''
 };
+// Convenient references
+mkdru.facets = mkdru.settings.facets;
 
-
+// Wrapper for jQuery
+(function ($) {
 
 // So we can use jQuery BBQ with Drupal 6 and its 1.2.6 jQuery
 if (!$.isArray) $.isArray = function(obj) {
   return Object.prototype.toString.call(obj) === "[object Array]";
-},
+};
+
+// BBQ has no handy way to remove params without changing the hash.
+// This takes an object to add and an array of keys to delete.
+mkdru.hashAddDelMany = function (add, del) {
+  var newHash = $.deparam.fragment();
+  if (typeof(add) === 'object')
+    $.extend(newHash, add);
+  if ($.isArray(del))
+    for (var i=0; i < del.length; i++)
+      if (newHash[del[i]] !== 'undefined')
+        delete newHash[del[i]];
+  return $.param.fragment("#", newHash);
+}
+
+// It's sometimes cumbersome that object literals can't take variable keys.
+mkdru.hashAddDelOne = function (key, value, del) {
+  var toAdd;
+  var toDel;
+  if (key && value) {
+    var toAdd = {};
+    toAdd[key] = value;
+  }
+  if (del) {
+    var toDel = [];
+    toDel.push(del);
+  }
+  return mkdru.hashAddDelMany(toAdd, toDel);
+}
 
 
 
 // pz2.js event handlers:
 mkdru.pz2Init = function () {
   if (mkdru.state.query) {
-    mkdru.triggerSearch();
+    mkdru.search();
   }
-  //mkdru.pz2.stat();
-  //mkdru.pz2.bytarget();
+  mkdru.pz2.stat();
 };
 
 mkdru.pz2Show = function (data) {
   mkdru.totalRec = data.merged;
   $('.mkdru-pager').html(mkdru.generatePager());
-  var countsHtml = Drupal.t('Displaying: ') + (data.start + 1) + 
-    Drupal.t(' to ') + (data.start + data.num) + Drupal.t(' of ')
-    + data.merged + Drupal.t(' (found: ') + data.total + ')';
-  $('.mkdru-counts').html(countsHtml);
-
+  $('.mkdru-counts').html(Drupal.theme('mkdruCounts', data.start + 1,
+                                      data.num, data.merged, data.total));
   var html = "";
   for (var i = 0; i < data.hits.length; i++) {
     html += Drupal.theme('mkdruResult', data.hits[i], 
@@ -68,55 +89,57 @@ mkdru.pz2Show = function (data) {
 };
 
 mkdru.pz2Status = function (data) {
+  $('.mkdru-status').html(Drupal.theme('mkdruStatus', data.activeclients, data.clients));
 };
 
-mkdru.pz2Term = function (data) {
-  var html = "";
-  for (var i = 0; i < data.xtargets.length && i < mkdru.sourceMax; i++ ) {
-    html += Drupal.theme('mkdruTerm', data.xtargets[i].name, data.xtargets[i].freq, 
-                          'mkdru-facet-source', data.xtargets[i].id);
+mkdru.contains = function (hash, key, value) {
+  if (hash[key]) {
+    if (hash[key].length) {
+      for (var i=0; i<hash[key].length; i++) {
+        if (hash[key][i] === value) {
+          return true;
+        }
+      }
+    } else {
+      return hash[key] === value;
+    }
   }
-  $('.mkdru-facet-sources').html(html);
+  return false;
+}
 
-  html = "";
-  for (var i = 0; i < data.subject.length && i < mkdru.subjectMax; i++ ) {
-    html += Drupal.theme('mkdruTerm', data.subject[i].name, data.subject[i].freq, 
-                          'mkdru-facet-subject', data.subject[i].id);
+mkdru.pz2Term = function (data) {
+  // map all facets against selected, for simple rendering 
+  var hash = $.deparam.fragment();
+  for (var key in hash) {
+    if (key.indexOf('limit') == 0 && hash[key]) 
+      //always wrap in array
+      hash[key.substr(6)] = hash[key].split(/;+/);
+    delete hash[key];
   }
-  $('.mkdru-facet-subjects').html(html);
-
-  html = "";
-  for (var i = 0; i < data.author.length && i < mkdru.authorMax; i++ ) {
-    html += Drupal.theme('mkdruTerm', data.author[i].name, data.author[i].freq, 
-                          'mkdru-facet-author', data.author[i].id);
+  for (var facet in mkdru.facets) {
+    var terms = data[mkdru.facets[facet].pz2Name];
+    for (var i=0; i<terms.length; i++) {
+      var term = terms[i];
+      var value = facet == "source" ? term.id : term.name;
+      if (mkdru.contains(hash, facet, value)) { //enabled
+        term.toggleLink = mkdru.removeLimit(facet, value);
+        term.selected = true;
+      } else { //disabled
+        term.toggleLink = mkdru.addLimit(facet, value);
+        term.selected = false;
+      }
+    }
+    $('.mkdru-facet-' + facet).html(
+        Drupal.theme('mkdruFacet', terms, facet, mkdru.facets[facet].max, 
+          hash[facet]));
   }
-  $('.mkdru-facet-authors').html(html);
-
-  $('.mkdru-facet-source').bind('click', function (e) {
-    mkdru.limitTarget(this.getAttribute('target_id'), this.firstChild.nodeValue);
-    return false;
-  });
-
-  $('.mkdru-facet-subject').bind('click', function (e) {
-    mkdru.limitQuery('su', this.firstChild.nodeValue);
-    return false;
-  });
-
-  $('.mkdru-facet-author').bind('click', function (e) {
-    mkdru.limitQuery('au', this.firstChild.nodeValue);
-    return false;
-  });
-};
-
-mkdru.pz2ByTarget = function (data) {
-  
 };
 
 mkdru.pz2Record = function (data) {
   clearTimeout(mkdru.pz2.showTimer);
   $('.mkdru-results').hide();
-  $('.mkdru-detail').html(Drupal.theme('mkdruDetail', data));
-  $('.mkdru-detail-back').bind('click', function () {$.bbq.removeState('recid');});
+  $('.mkdru-detail').html(Drupal.theme('mkdruDetail', data,
+                                       mkdru.hashAddDelOne(null, null, 'recid')));
   $('.mkdru-detail').show();
   clearTimeout(mkdru.pz2.recordTimer);
 };
@@ -127,14 +150,10 @@ mkdru.pz2Record = function (data) {
 
 // populate state from an object and fill in the blanks with defaults
 mkdru.stateFromObject = function (obj) {
-  for (var key in mkdru.defaultState) {
-    if (typeof(obj[key]) != "undefined") {
+  mkdru.state = $.extend({}, mkdru.defaultState);
+  for (var key in mkdru.defaultState)
+    if (typeof(obj[key]) != "undefined")
       mkdru.state[key] = obj[key];
-    }
-    else {
-      mkdru.state[key] = mkdru.defaultState[key];
-    }
-  }
 };
 
 // populate state from current window's hash string
@@ -151,7 +170,7 @@ mkdru.hashFromState = function () {
       alteredState[key] = mkdru.state[key];
     }
   }
-  $.bbq.pushState(alteredState);
+  $.bbq.pushState(alteredState, 2);
 };
 
 // update mkdru_form theme's ui to match state
@@ -172,78 +191,148 @@ mkdru.uiFromState = function () {
 };
 
 mkdru.hashChange = function () {
+  // TING hack, switching tabs resets the hash but does not re-load the page
+  // simply ignore new hash and set it to the old state
+  var hash = $.param.fragment();
+  if (hash.indexOf("-result") != -1 || hash.indexOf("facets=") != -1) {
+    mkdru.hashFromState();
+    return;
+  }
+  // return to top of page
+  window.scrollTo(0,0);
+  // do we need to restart the search?
+  var searchTrigger = false;
+  // shallow copy of state so we can see what changed.
+  var oldState = $.extend({}, mkdru.state);
   mkdru.stateFromHash();
-  // Request for details
-  if (mkdru.state.recid) {
+  // only have to compare values since all keys are initialised
+  for (key in mkdru.state) {
+    var changed = (mkdru.state[key] != oldState[key]);
+    if (key.substring(0,5) === 'limit' && changed)
+      searchTrigger = true;
+    if (key === 'page' && changed)
+      mkdru.pz2.showPage(mkdru.state.page-1);
+    if (key === 'query' && changed)
+      searchTrigger = true;
+  }
+  if (searchTrigger)
+    mkdru.search();
+  // request for record detail
+  if (mkdru.state.recid && (mkdru.state.recid != oldState.recid)) {
     mkdru.pz2.record(mkdru.state.recid);
   }
-  // Other internal link
   else {
-    mkdru.pz2.showPage(mkdru.state.page-1);
     $('.mkdru-detail').hide();
     $('.mkdru-results').show();
   }
 };
 
+// return link to limit facet
+mkdru.addLimit = function (facet, limit) {
+  var newHash = $.deparam.fragment();
+  delete newHash['page'];
+  if ((typeof(newHash['limit_' + facet]) === 'undefined')
+       || !mkdru.facets[facet].multiLimit) {
+    newHash['limit_' + facet] = limit;
+  }
+  else {
+    newHash['limit_' + facet] += ';' + limit;
+  }
+  return $.param.fragment("#", newHash);
+};
+
+// return link to remove limit from facet
+mkdru.removeLimit = function (facet, limit) {
+  var newHash = $.deparam.fragment();
+  delete newHash['page'];
+  if (!newHash['limit_' + facet].indexOf(';')
+      || !mkdru.facets[facet].multiLimit) {
+    delete newHash['limit_' + facet];
+  }
+  else {
+    var limits = newHash['limit_' + facet].split(';');
+    for (var i = 0; i < limits.length; i++) {
+      if (limits[i] == limit) {
+        limits.splice(i, 1);
+        if (limits.length < 1)
+          delete newHash['limit_' + facet];
+        else
+          newHash['limit_' + facet] = limits.join(';');
+        break;
+      }
+    }
+  }
+  return $.param.fragment("#", newHash);
+};
+
 
 
-// UI functions:
+// form submit handler
 mkdru.submitQuery = function () {
+  // new query, back to defaults (shallow copy)
+  mkdru.state = $.extend({}, mkdru.defaultState);
   mkdru.state.query = $('.mkdru-search input:text').attr('value');
-  mkdru.resetPage();
   mkdru.pollDropDowns();
   mkdru.hashFromState();
   mkdru.search();
-  mkdru.submitted = true;
+  mkdru.active = true;
   return false;
 };
 
-mkdru.triggerSearch = function () {
-  mkdru.search();
-  mkdru.submitted = true;
-};
+// criteria drop-down (perpage, sort) handler
+mkdru.submitCriteria = function () {
+  mkdru.pollDropDowns();
+  //search is not ON, do nothing
+  if (!mkdru.active) return false;
+  // pages mean different things now
+  mkdru.state.page = 1;
+  mkdru.hashFromState();
+  mkdru.pz2.show(0, mkdru.state.perpage, mkdru.state.sort);
+  return false;
+}
 
 mkdru.search = function () {
-  mkdru.pz2.search(mkdru.state.query, mkdru.state.perpage, mkdru.state.sort,
-      mkdru.state.filter);
+  var filter = null;
+  var query = mkdru.state.query;
+
+  // facet limit implementation
+  for (var facet in mkdru.facets) {
+    // facet is limited
+    if (mkdru.state['limit_' + facet]) {
+      if (facet == "source") {
+        filter = 'pz:id=' + mkdru.state.limit_source;
+      }
+      else {
+        var limits = mkdru.state['limit_' + facet].split(/;+/);
+        for (var i = 0; i < limits.length; i++) {
+          // ex. query + and au="{limit_author}"
+          if (limits[i]) 
+            query += ' and ' + mkdru.facets[facet]['limiter'] + '="'
+                  + limits[i] + '"';
+        }
+      }
+    }
+  }
+
+  mkdru.pz2.search(query, mkdru.state.perpage, mkdru.state.sort, filter);
+  mkdru.active = true;
 };
 
 mkdru.pollDropDowns = function () {
   mkdru.state.perpage = $('.mkdru-perpage').attr('value');
   mkdru.state.sort = $('.mkdru-sort').attr('value');
-  if (!mkdru.submitted) return false;
-  mkdru.resetPage();
-  mkdru.hashFromState();
-  mkdru.pz2.show(0, mkdru.state.perpage, mkdru.state.sort);
-  return false;
-};
-
-mkdru.limitQuery = function (field, value) {
-  $('.mkdru-search input:text').attr('value', function () {
-    return this.value += ' and ' + field + '="' + value + '"';
-  });
-  mkdru.submitQuery();
-};
-
-mkdru.limitTarget = function (id, name) {
-  var navi = document.getElementById('mkdru-navi');
-  navi.innerHTML = 
-        'Source: <a class="crossout" href="#" onclick="delimitTarget();return false;">'
-        + name + '</a>';
-  navi.innerHTML += '<hr/>';
-  mkdru.state.filter = 'pz:id=' + id;
-  mkdru.resetPage();
-  mkdru.pollDropDowns();
-  mkdru.search();
-  return false;
 };
 
 mkdru.generatePager = function () {
+  // cast page parameter to numeric so we can add to it
+  if (typeof mkdru.state.page == "string") {
+    mkdru.state.page = Number(mkdru.state.page);
+  }
   var total = Math.ceil(mkdru.totalRec / mkdru.state.perpage);
   var first = (mkdru.state.page - mkdru.pagerRange > 0)
       ? mkdru.state.page - mkdru.pagerRange : 1;
   var last = first + 2 * mkdru.pagerRange < total
-      ? first + 2 * mkdru.pagerRange : total;  
+      ? first + 2 * mkdru.pagerRange : total;
   var prev = null;
   var next = null;
   var pages = [];
@@ -266,11 +355,6 @@ mkdru.generatePager = function () {
                       total, prev, next);
 };
 
-mkdru.resetPage = function () {
-  mkdru.state.page = 1;
-  mkdru.totalRec = 0;
-};
-
 
 
 // wait until the DOM is ready, bind events
@@ -279,21 +363,34 @@ $(document).ready(function () {
   $(window).bind( 'hashchange', mkdru.hashChange);
   $('.mkdru-search').bind('submit', mkdru.submitQuery);
   $('.mkdru-search input:text').attr('value', '');
-  $('.mkdru-perpage').bind('change', function () { mkdru.pollDropDowns() });
-  $('.mkdru-sort').bind('change', function () { mkdru.pollDropDowns() });
+  $('.mkdru-perpage').bind('change', mkdru.submitCriteria);
+  $('.mkdru-sort').bind('change', mkdru.submitCriteria);
+
+  // generate termlist for pz2.js and populate facet limit state
+  var termlist = [];
+  for (var key in mkdru.facets) {
+    termlist.push(mkdru.facets[key].pz2Name);
+    mkdru.defaultState['limit_' + key] = null;
+  }
+
+  // if signaled, prepare facet container client-side
+  if (mkdru.facetContainerSelector) {
+    $(mkdru.facetContainerSelector).html(Drupal.theme('mkdruFacetContainer',
+      mkdru.facets));
+  }
 
   mkdru.pz2 = new pz2( { "onshow": mkdru.pz2Show,
               "showtime": 500, //each timer (show, stat, term, bytarget) can be specified this way
-              "pazpar2path": mkdru.pazpar2path,
+              "pazpar2path": mkdru.settings.pz2_path,
               "oninit": mkdru.pz2Init,
               "onstat": mkdru.pz2Status,
               "onterm": mkdru.pz2Term,
-              "termlist": "xtargets,subject,author",
-              "onbytarget": mkdru.pz2ByTarget,
-              "usesessions" : mkdru.usesessions,
+              "termlist": termlist.join(','),
+              "usesessions" : mkdru.settings.use_sessions,
               "showResponseType": mkdru.showResponseType,
               "onrecord": mkdru.pz2Record,
               "autoInit": false } );
+  mkdru.pz2.showFastCount = 1;
 
   // initialise state to hash string or defaults
   mkdru.stateFromHash();
@@ -303,15 +400,43 @@ $(document).ready(function () {
   // ting thing
   if (typeof(Drupal.settings.mkdru.query) !== "undefined") {
     mkdru.state.query = Drupal.settings.mkdru.query
+    //force the hash to contain query
+    mkdru.hashFromState();
   }
 
-  if (mkdru.usesessions) {
+  //not running against SP? init, otherwise authenticate
+  if (mkdru.settings.use_sessions) {
     mkdru.pz2.init();
-  }
-  else if (mkdru.state.recid) {
-    mkdru.pz2.record(mkdru.state.recid);
-  }
-  else if (mkdru.state.query) {
-    mkdru.triggerSearch();
+  } else {
+    //runnin against SP
+    var user = mkdru.settings.sp.user;
+    var pass = mkdru.settings.sp.pass;
+    var params = {};
+    params['command'] = 'auth';
+    if (user && pass) {
+      params['action'] = 'login';
+      params['username'] = user;
+      params['password'] = pass;
+    } else {
+      params['action'] = 'ipauth';
+    }
+    var authReq = new pzHttpRequest(mkdru.settings.pz2_path, 
+      function (err) {
+        alert("Authentication against metasearch gateway failed: " +err);
+      }
+    );
+    authReq.get(params,
+      function (data) {
+        var s = data.getElementsByTagName('status');
+        if (s.length && Element_getTextContent(s[0]) == "OK") {
+          mkdru.realm = data.getElementsByTagName('realm');
+          mkdru.pz2Init();
+        } else {
+          alert("Malformed response when authenticating against the metasearch"
+            + " gateway");
+        }
+      }
+    );
   }
 });
+})(jQuery);