Open-ILS/web/opac/common/js/opac_utils.js

   1 var IAMXUL = false;
   2 function isXUL() { return IAMXUL; }
   3
   4
   5 /* - Request ------------------------------------------------------------- */
   6 function Request(type) {
   7         var s = type.split(":");
   8         if(s[2] == "1" && isXUL()) s[1] += ".staff";
   9         this.request = new RemoteRequest(s[0], s[1]);
  10         for( var x = 1; x!= arguments.length; x++ )
  11                 this.request.addParam(arguments[x]);
  12 }
  13
  14 Request.prototype.callback = function(cal) { this.request.setCompleteCallback(cal); }
  15 Request.prototype.send          = function(block){this.request.send(block);}
  16 Request.prototype.result        = function(){return this.request.getResultObject();}
  17 /* ----------------------------------------------------------------------- */
  18
  19 function showCanvas() { setTimeout(_showCanvas, 200); }
  20 function _showCanvas() {
  21         for( var x in G.ui.altcanvas ) {
  22                 hideMe(G.ui.altcanvas[x]);
  23         }
  24         hideMe(G.ui.common.loading);
  25         unHideMe(G.ui.common.canvas_main);
  26         G.ui.searchbar.text.focus();
  27 }
  28
  29 var newCanvasNode;
  30 function swapCanvas(newNode) { newCanvasNode = newNode; setTimeout(_swapCanvas, 200); }
  31 function _swapCanvas() {
  32         for( var x in G.ui.altcanvas )
  33                 hideMe(G.ui.altcanvas[x]);
  34
  35         hideMe(G.ui.common.loading);
  36         hideMe(G.ui.common.canvas_main);
  37         unHideMe(newCanvasNode);
  38 }
  39
  40 /* finds the name of the current page */
  41 var currentPage = null;
  42 function findCurrentPage() {
  43         if(currentPage) return currentPage;
  44
  45         var pages = [];
  46         for( var p in config.page ) pages.push(config.page[p]);
  47         pages = pages.sort( function(a,b){ return - (a.length - b.length); } );
  48
  49         var path = location.pathname;
  50         if(!path.match(/.*\.xml$/))
  51                 path += "index.xml"; /* in case they go to  / */
  52
  53         var page = null;
  54         for( var p in pages ) {
  55                 if( path.indexOf(pages[p]) != -1)
  56                         page = pages[p];
  57         }
  58
  59         for( var p in config.page ) {
  60                 if(config.page[p] == page) {
  61                         currentPage = p;
  62                         return p;
  63                 }
  64         }
  65
  66         return null;
  67 }
  68
  69
  70 /* sets all of the params values  ----------------------------- */
  71 var TERM,  STYPE,  LOCATION,  DEPTH,  FORM, OFFSET,  COUNT,
  72          HITCOUNT,  RANKS, SEARCHBAR_EXTRAS;
  73
  74 function initParams() {
  75         var cgi = new CGI();
  76
  77         TERM    = cgi.param(PARAM_TERM);
  78         STYPE   = cgi.param(PARAM_STYPE);
  79         FORM    = cgi.param(PARAM_FORM);
  80
  81         LOCATION        = parseInt(cgi.param(PARAM_LOCATION));
  82         DEPTH           = parseInt(cgi.param(PARAM_DEPTH));
  83         OFFSET  = parseInt(cgi.param(PARAM_OFFSET));
  84         COUNT           = parseInt(cgi.param(PARAM_COUNT));
  85         HITCOUNT        = parseInt(cgi.param(PARAM_HITCOUNT));
  86         MRID            = parseInt(cgi.param(PARAM_MRID));
  87         RID             = parseInt(cgi.param(PARAM_RID));
  88
  89         /* set up some sane defaults */
  90         if(isNaN(LOCATION))     LOCATION        = 1;
  91         if(isNaN(DEPTH))                DEPTH           = 0;
  92         if(isNaN(OFFSET))               OFFSET  = 0;
  93         if(isNaN(COUNT))                COUNT           = 10;
  94         if(isNaN(HITCOUNT))     HITCOUNT        = 0;
  95         if(isNaN(SEARCHBAR_EXTRAS))     SEARCHBAR_EXTRAS        = 0;
  96         if(isNaN(MRID))         MRID            = 0;
  97         if(isNaN(RID))                  RID             = 0;
  98 }
  99
 100 /* URL param accessors */
 101 function getTerm(){return TERM;}
 102 function getStype(){return STYPE;}
 103 function getLocation(){return LOCATION;}
 104 function getDepth(){return DEPTH;}
 105 function getForm(){return FORM;}
 106 function getOffset(){return OFFSET;}
 107 function getDisplayCount(){return COUNT;}
 108 function getHitCount(){return HITCOUNT;}
 109 function getSearchBarExtras(){return SEARCHBAR_EXTRAS;}
 110 function getMrid(){return MRID;};
 111 function getRid(){return RID;};
 112
 113
 114
 115 /* builds an opac URL.  If no page is defined, the current page is used
 116         if slim, then only everything after the ? is returned (no host portion) */
 117 function findBasePath() {
 118         var path = location.pathname;
 119         if(!path.match(/.*\.xml$/)) path += "index.xml";
 120         var idx = path.indexOf(config.page[findCurrentPage()]);
 121         return path.substring(0, idx);
 122 }
 123
 124 function findBaseURL(ssl) {
 125         var path = findBasePath();
 126         var proto = location.protocol;
 127         if(ssl) proto = "https";
 128         return location.protocol + "//" + location.host + path;
 129 }
 130
 131 function buildImageLink(name, ssl) {
 132         return findBaseURL(ssl) + "../../../images/" + name;
 133 }
 134
 135 function  buildOPACLink(args, slim, ssl) {
 136
 137         if(!args) args = {};
 138         var string = "";
 139
 140         if(!slim) {
 141                 string = findBaseURL(ssl);
 142                 if(args.page) string += config.page[args.page];
 143                 else string += config.page[findCurrentPage()];
 144         }
 145
 146         string += "?";
 147
 148         for( var x in args ) {
 149                 if(x == "page" || args[x] == null) continue;
 150                 string += "&" + x + "=" + encodeURIComponent(args[x]);
 151         }
 152
 153         string += _appendParam(TERM,            PARAM_TERM, args, getTerm, string);
 154         string += _appendParam(STYPE,           PARAM_STYPE, args, getStype, string);
 155         string += _appendParam(LOCATION, PARAM_LOCATION, args, getLocation, string);
 156         string += _appendParam(DEPTH,           PARAM_DEPTH, args, getDepth, string);
 157         string += _appendParam(FORM,            PARAM_FORM, args, getForm, string);
 158         string += _appendParam(OFFSET,  PARAM_OFFSET, args, getOffset, string);
 159         string += _appendParam(COUNT,           PARAM_COUNT, args, getDisplayCount, string);
 160         string += _appendParam(HITCOUNT, PARAM_HITCOUNT, args, getHitCount, string);
 161         string += _appendParam(MRID,            PARAM_MRID, args, getMrid, string);
 162         string += _appendParam(RID,             PARAM_RID, args, getRid, string);
 163         return string.replace(/\&$/,'').replace(/\?\&/,"?");
 164 }
 165
 166 function _appendParam( fieldVar, fieldName, overrideArgs, getFunc, string ) {
 167         var ret = "";
 168         if( fieldVar != null && overrideArgs[fieldName] == null )
 169                 ret = "&" + fieldName + "=" + encodeURIComponent(getFunc());
 170         return ret;
 171 }
 172
 173
 174 function EX(message) { this.init(message); }
 175 EX.prototype.init = function(message) { this.message = message; }
 176 EX.prototype.toString = function() { return "\n *** Exception Occured \n" + this.message; }
 177 EXCommunication.prototype              = new EX();
 178 EXCommunication.prototype.constructor  = EXCommunication;
 179 EXCommunication.baseClass              = EX.prototype.constructor;
 180 function EXCommunication(message) { this.init("EXCommunication: " + message); }
 181
 182 /* ----------------------------------------------------------------------- */
 183 function cleanISBN(isbn) {
 184    if(isbn) {
 185       isbn = isbn.toString().replace(/^\s+/,"");
 186       var idx = isbn.indexOf(" ");
 187       if(idx > -1) { isbn = isbn.substring(0, idx); }
 188    } else isbn = "";
 189    return isbn;
 190 }
 191
 192
 193
 194
 195 /* builds a link that goes to the title listings for a metarecord */
 196 function buildTitleLink(rec, link) {
 197         if(!rec) return;
 198         link.appendChild(text(normalize(truncate(rec.title(), 65))));
 199         var args = {};
 200         args.page = RRESULT;
 201         args[PARAM_OFFSET] = 0;
 202         args[PARAM_MRID] = rec.doc_id();
 203         link.setAttribute("href", buildOPACLink(args));
 204 }
 205
 206 function buildTitleDetailLink(rec, link) {
 207         if(!rec) return;
 208         link.appendChild(text(normalize(truncate(rec.title(), 65))));
 209         var args = {};
 210         args.page = RDETAIL;
 211         args[PARAM_OFFSET] = 0;
 212         args[PARAM_RID] = rec.doc_id();
 213         link.setAttribute("href", buildOPACLink(args));
 214 }
 215
 216 /* 'type' is one of STYPE_AUTHOR, STYPE_SUBJECT, ... found in config.js
 217         'trunc' is the number of characters to show in the string, defaults to 65 */
 218 function buildSearchLink(type, string, linknode, trunc) {
 219         if(!trunc) trunc = 65;
 220         var args = {};
 221         args.page = MRESULT;
 222         args[PARAM_OFFSET] = 0;
 223         args[PARAM_TERM] = string;
 224         args[PARAM_STYPE] = type;
 225         linknode.appendChild(text(normalize(truncate(string, trunc))));
 226         linknode.setAttribute("href", buildOPACLink(args));
 227 }
 228
 229
 230 /* ----------------------------------------------------------------------- */
 231 /* user session handling */
 232 /* ----------------------------------------------------------------------- */
 233
 234 /* session is the login session.  If no session is provided, we attempt
 235         to find one in the cookies.  If 'force' is true we retrieve the
 236         user from the server even if there is already a global user present.
 237         if ses != G.user.session, we also force a grab */
 238 var cookie = new cookieObject("ses", 1, "/", COOKIE_SES);
 239 function grabUser(ses, force) {
 240
 241         if(!ses) ses = cookie.get(COOKIE_SES);
 242         if(!ses) return false;
 243
 244         if(!force)
 245                 if(G.user && G.user.session == ses)
 246                         return G.user;
 247
 248         /* first make sure the session is valid */
 249         var request = new Request(FETCH_SESSION, ses );
 250         request.send(true);
 251         var user = request.result();
 252         if( !(typeof user == 'object' && user._isfieldmapper) ) {
 253                 return false;
 254         }
 255
 256         G.user = user;
 257         G.user.fleshed = false;
 258         G.user.session = ses;
 259         cookie.put(COOKIE_SES, ses);
 260         cookie.write();
 261
 262         return G.user;
 263
 264 }
 265
 266 function grabFleshedUser() {
 267
 268         if(!G.user || !G.user.session) {
 269                 grabUser();
 270                 if(!G.user || !G.user.session) return null;
 271         }
 272
 273         if(G.user.fleshed) return G.user;
 274
 275    var req = new Request(FETCH_FLESHED_USER, G.user.session);
 276         req.send(true);
 277
 278         G.user = req.result();
 279
 280         if(!G.user || G.user.length == 0) {
 281                 G.user = null; return false;
 282                 cookie.remove(COOKIE_SES);
 283         }
 284
 285         G.user.session = ses;
 286         G.user.fleshed = true;
 287
 288         cookie.put(COOKIE_SES, ses); /*  update the cookie */
 289         cookie.write();
 290
 291         return G.user;
 292 }
 293
 294
 295 /* returns a fleshed G.user on success, false on failure */
 296 function doLogin() {
 297
 298         var uname = G.ui.login.username.value;
 299         var passwd = G.ui.login.password.value;
 300
 301         var init_request = new Request( LOGIN_INIT, uname );
 302    init_request.send(true);
 303    var seed = init_request.result();
 304
 305    if( ! seed || seed == '0') {
 306       alert( "Error Communicating with Authentication Server" );
 307       return null;
 308    }
 309
 310    var auth_request = new Request( LOGIN_COMPLETE,
 311                 uname, hex_md5(seed + hex_md5(passwd)), "opac");
 312
 313    auth_request.send(true);
 314    var auth_result = auth_request.result();
 315
 316    if(auth_result == '0' || auth_result == null || auth_result.length == 0) { return false; }
 317
 318         var u = grabUser(auth_result, true);
 319         if(u) updateLoc(u.home_ou(), findOrgDepth(u.home_ou()));
 320
 321         return u;
 322 }
 323
 324 function doLogout() {
 325
 326         /* be nice and delete the session from the server */
 327         if(G.user && G.user.session) {
 328                 var req = new Request(LOGIN_DELETE, G.user.session);
 329       req.send(true);
 330                 try { req.result(); } catch(E){}
 331     }
 332
 333         G.user = null;
 334         cookie.remove(COOKIE_SES);
 335
 336         hideMe(G.ui.sidebar.logoutbox);
 337         unHideMe(G.ui.sidebar.loginbox);
 338         hideMe(G.ui.sidebar.logged_in_as);
 339
 340 }
 341
 342
 343 function hideMe(obj) { addCSSClass(obj, config.css.hide_me); }
 344 function unHideMe(obj) { removeCSSClass(obj, config.css.hide_me); }
 345
 346
 347 /* ----------------------------------------------------------------------- */
 348 /* build the org tree */
 349 /* ----------------------------------------------------------------------- */
 350
 351
 352 function drawOrgTree() {
 353         G.ui.common.org_tree.innerHTML = buildOrgSelector().toString();
 354 }
 355
 356 var orgTreeSelector;
 357 function buildOrgSelector() {
 358         var tree = new dTree("orgTreeSelector");
 359         for( var i in orgArraySearcher ) {
 360                 var node = orgArraySearcher[i];
 361                 if( node == null ) continue;
 362                 if(node.parent_ou() == null)
 363                         tree.add(node.id(), -1, node.name(),
 364                                 "javascript:orgSelect(" + node.id() + ");", node.name());
 365                 else {
 366                         tree.add(node.id(), node.parent_ou().id(), node.name(),
 367                                 "javascript:orgSelect(" + node.id() + ");", node.name());
 368                 }
 369         }
 370         orgTreeSelector = tree;
 371         return tree;
 372 }
 373
 374 function orgSelect(id) {
 375         showCanvas();
 376         updateLoc(id, findOrgDepth(id));
 377 }
 378
 379
 380 /* ------------------------------------------------------------------------------------------------------ */
 381 /* org tree utilities */
 382 /* ------------------------------------------------------------------------------------------------------ */
 383
 384 /* takes an org unit or id and return the numeric depth */
 385 function findOrgDepth(org_id_or_node) {
 386         return findOrgType(findOrgUnit(org_id_or_node).ou_type()).depth();
 387 }
 388
 389 /* takes the org type id from orgunit.ou_type() field and returns
 390         the org type object */
 391 function findOrgType(type_id) {
 392         if(typeof type_id == 'object') return type_id;
 393         for(var type in globalOrgTypes) {
 394                 var t =globalOrgTypes[type];
 395                 if( t.id() == type_id || t.id() == parseInt(type_id) )
 396                         return t;
 397         }
 398         return null;
 399 }
 400
 401
 402 /* returns an org unit by id.  if an object is passed in as the id,
 403         then the object is assumed to be an org unit and is returned */
 404 function findOrgUnit(org_id) {
 405         return (typeof org_id == 'object') ? org_id : orgArraySearcher[org_id];
 406 }
 407
 408
 409 /* builds a trail from the top of the org tree to the node provide.
 410         basically fleshes out 'my orgs'
 411         Returns an array of [org0, org1, ..., myorg] */
 412 function orgNodeTrail(node) {
 413         var na = new Array();
 414         while( node ) {
 415                 na.push(node);
 416                 node = findOrgUnit(node.parent_ou());
 417         }
 418         return na.reverse();
 419 }
 420
 421
 422 /* returns an array of sibling org units */
 423 function findSiblingOrgs(node) { return findOrgUnit(node.parent_ou()).children(); }
 424 /* ------------------------------------------------------------------------------------------------------ */
 425
 426
 427
 428
 429
 430
 431