Move utility function findnode() to near the end.
[mkws-moved-to-github.git] / tools / htdocs / mkws.js
1 /*! MKWS, the MasterKey Widget Set.
2  *  Copyright (C) 2013-2014 Index Data
3  *  See the file LICENSE for details
4  */
5
6 "use strict"; // HTML5: disable for debug_level >= 2
7
8
9 // Handlebars helpers
10 Handlebars.registerHelper('json', function(obj) {
11     return $.toJSON(obj);
12 });
13
14
15 Handlebars.registerHelper('translate', function(s) {
16     return mkws.M(s);
17 });
18
19
20 // We need {{attr '@name'}} because Handlebars can't parse {{@name}}
21 Handlebars.registerHelper('attr', function(attrName) {
22     return this[attrName];
23 });
24
25
26 /*
27  * Use as follows: {{#if-any NAME1 having="NAME2"}}
28  * Applicable when NAME1 is the name of an array
29  * The guarded code runs only if at least one element of the NAME1
30  * array has a subelement called NAME2.
31  */
32 Handlebars.registerHelper('if-any', function(items, options) {
33     var having = options.hash.having;
34     for (var i in items) {
35         var item = items[i]
36         if (!having || item[having]) {
37             return options.fn(this);
38         }
39     }
40     return "";
41 });
42
43
44 Handlebars.registerHelper('first', function(items, options) {
45     var having = options.hash.having;
46     for (var i in items) {
47         var item = items[i]
48         if (!having || item[having]) {
49             return options.fn(item);
50         }
51     }
52     return "";
53 });
54
55
56 Handlebars.registerHelper('commaList', function(items, options) {
57     var out = "";
58
59     for (var i in items) {
60         if (i > 0) out += ", ";
61         out += options.fn(items[i])
62     }
63
64     return out;
65 });
66
67
68 Handlebars.registerHelper('index1', function(obj) {
69     return obj.data.index + 1;
70 });
71
72
73
74 // Set up global mkws object. Contains truly global state such as SP
75 // authentication, and a hash of team objects, indexed by team-name.
76 //
77 var mkws = {
78     authenticated: false,
79     debug_level: 1, // Will be overridden from mkws_config, but
80                     // initial value allows jQuery popup to use logging.
81     paz: undefined, // will be set up during initialisation
82     teams: {},
83     locale_lang: {
84         "de": {
85             "Authors": "Autoren",
86             "Subjects": "Schlagwörter",
87             "Sources": "Daten und Quellen",
88             "source": "datenquelle",
89             "Termlists": "Termlisten",
90             "Next": "Weiter",
91             "Prev": "Zurück",
92             "Search": "Suche",
93             "Sort by": "Sortieren nach",
94             "and show": "und zeige",
95             "per page": "pro Seite",
96             "Displaying": "Zeige",
97             "to": "von",
98             "of": "aus",
99             "found": "gefunden",
100             "Title": "Titel",
101             "Author": "Autor",
102             "author": "autor",
103             "Date": "Datum",
104             "Subject": "Schlagwort",
105             "subject": "schlagwort",
106             "Location": "Ort",
107             "Records": "Datensätze",
108             "Targets": "Datenbanken",
109
110             "dummy": "dummy"
111         },
112
113         "da": {
114             "Authors": "Forfattere",
115             "Subjects": "Emner",
116             "Sources": "Kilder",
117             "source": "kilder",
118             "Termlists": "Termlists",
119             "Next": "Næste",
120             "Prev": "Forrige",
121             "Search": "Søg",
122             "Sort by": "Sorter efter",
123             "and show": "og vis",
124             "per page": "per side",
125             "Displaying": "Viser",
126             "to": "til",
127             "of": "ud af",
128             "found": "fandt",
129             "Title": "Title",
130             "Author": "Forfatter",
131             "author": "forfatter",
132             "Date": "Dato",
133             "Subject": "Emneord",
134             "subject": "emneord",
135             "Location": "Lokation",
136             "Records": "Poster",
137             "Targets": "Baser",
138
139             "dummy": "dummy"
140         }
141     }
142 };
143
144
145 // The following PubSub code is modified from the jQuery manual:
146 // https://api.jquery.com/jQuery.Callbacks/
147 //
148 // Use as:
149 //      mkws.queue("eventName").subscribe(function(param1, param2 ...) { ... });
150 //      mkws.queue("eventName").publish(arg1, arg2, ...);
151
152 (function() {
153   var queues = {};
154   mkws.queue = function(id) {
155     if (!queues[id]) {
156       var callbacks = $.Callbacks();
157       queues[id] = {
158         publish: callbacks.fire,
159         subscribe: callbacks.add,
160         unsubscribe: callbacks.remove
161       };
162     }
163     return queues[id];
164   }
165 }());
166
167
168 // Define empty mkws_config for simple applications that don't define it.
169 if (mkws_config == null || typeof mkws_config != 'object') {
170     var mkws_config = {};
171 }
172
173
174 // Factory function for widget objects.
175 function widget($, team, type, node) {
176     var that = {
177         team: team,
178         type: type,
179         node: node
180     };
181
182     // ### More to do here, surely: e.g. wiring into the team
183     mkws.debug("made widget(team=" + team + ", type=" + type + ", node=" + node);
184
185     return that;
186 }
187
188
189 // Factory function for team objects. As much as possible, this uses
190 // only member variables (prefixed "m_") and inner functions with
191 // private scope. Some functions are visibl as member-functions to be
192 // called from outside code -- specifically, from generated
193 // HTML. These functions are that.switchView(), showDetails(),
194 // limitTarget(), limitQuery(), delimitTarget(), delimitQuery(),
195 // pagerPrev(), pagerNext(), showPage().
196 //
197 function team($, teamName) {
198     var that = {};
199     var m_teamName = teamName;
200     var m_submitted = false;
201     var m_query; // initially undefined
202     var m_sort; // will be set below
203     var m_perpage; // will be set below
204     var m_filters = [];
205     var m_totalRec = 0;
206     var m_curPage = 1;
207     var m_curDetRecId = '';
208     var m_curDetRecData = null;
209     var m_debug_time = {
210         // Timestamps for logging
211         "start": $.now(),
212         "last": $.now()
213     };
214     var m_paz; // will be initialised below
215     var m_template = {};
216
217
218     var debug = function (s) {
219         var now = $.now();
220         var timestamp = ((now - m_debug_time.start)/1000).toFixed(3) + " (+" + ((now - m_debug_time.last)/1000).toFixed(3) + ") "
221         m_debug_time.last = now;
222
223         mkws.debug(m_teamName + ": " + timestamp + s);
224     }
225
226     debug("start running MKWS");
227
228     m_sort = mkws_config.sort_default;
229     debug("copied mkws_config.sort_default '" + mkws_config.sort_default + "' to m_sort");
230
231     if (!isNaN(parseInt(mkws_config.perpage_default))) {
232         m_perpage = parseInt(mkws_config.perpage_default);
233     }
234
235     // protocol independent link for pazpar2: "//mkws/sp" -> "https://mkws/sp"
236     if (mkws_config.pazpar2_url.match(/^\/\//)) {
237         mkws_config.pazpar2_url = document.location.protocol + mkws_config.pazpar2_url;
238         debug("adjust protocol independent links: " + mkws_config.pazpar2_url);
239     }
240
241     debug("Create main pz2 object");
242     // create a parameters array and pass it to the pz2's constructor
243     // then register the form submit event with the pz2.search function
244     // autoInit is set to true on default
245     m_paz = new pz2({ "windowid": teamName,
246                       "pazpar2path": mkws_config.pazpar2_url,
247                       "usesessions" : mkws_config.use_service_proxy ? false : true,
248                       "oninit": onInit,
249                       "onbytarget": onBytarget,
250                       "onstat": onStat,
251                       "onterm": (mkws_config.facets.length ? onTerm : undefined),
252                       "onshow": onShow,
253                       "onrecord": onRecord,
254                       "showtime": 500,            //each timer (show, stat, term, bytarget) can be specified this way
255                       "termlist": mkws_config.facets.join(',')
256                     });
257
258
259     //
260     // pz2.js event handlers:
261     //
262     function onInit(teamName) {
263         debug("init");
264         m_paz.stat();
265         m_paz.bytarget();
266     }
267
268
269     function onBytarget(data, teamName) {
270         debug("target");
271         var targetDiv = findnode('.mkwsBytarget');
272         if (!targetDiv) {
273             return;
274         }
275
276         var table ='<table><thead><tr>' +
277             '<td>' + M('Target ID') + '</td>' +
278             '<td>' + M('Hits') + '</td>' +
279             '<td>' + M('Diags') + '</td>' +
280             '<td>' + M('Records') + '</td>' +
281             '<td>' + M('State') + '</td>' +
282             '</tr></thead><tbody>';
283
284         for (var i = 0; i < data.length; i++) {
285             table += "<tr><td>" + data[i].id +
286                 "</td><td>" + data[i].hits +
287                 "</td><td>" + data[i].diagnostic +
288                 "</td><td>" + data[i].records +
289                 "</td><td>" + data[i].state + "</td></tr>";
290         }
291
292         table += '</tbody></table>';
293         targetDiv.html(table);
294     }
295
296
297     function onStat(data, teamName) {
298         debug("stat");
299         var stat = findnode('.mkwsStat');
300         if (stat.length === 0)
301             return;
302
303         stat.html('<span class="head">' + M('Status info') + '</span>' +
304             ' -- ' +
305             '<span class="clients">' + M('Active clients') + ': ' + data.activeclients + '/' + data.clients + '</span>' +
306             ' -- ' +
307             '<span class="records">' + M('Retrieved records') + ': ' + data.records + '/' + data.hits + '</span>');
308     }
309
310
311     function onTerm(data, teamName) {
312         debug("term");
313         var node = findnode(".mkwsTermlists");
314         if (node.length == 0) return;
315
316         // no facets: this should never happen
317         if (!mkws_config.facets || mkws_config.facets.length == 0) {
318             alert("onTerm called even though we have no facets: " + $.toJSON(data));
319             node.hide();
320             return;
321         }
322
323         // display if we first got results
324         node.show();
325
326         var acc = [];
327         acc.push('<div class="title">' + M('Termlists') + '</div>');
328         var facets = mkws_config.facets;
329
330         for(var i = 0; i < facets.length; i++) {
331             if (facets[i] == "xtargets") {
332                 addSingleFacet(acc, "Sources",  data.xtargets, 16, null);
333             } else if (facets[i] == "subject") {
334                 addSingleFacet(acc, "Subjects", data.subject,  10, "subject");
335             } else if (facets[i] == "author") {
336                 addSingleFacet(acc, "Authors",  data.author,   10, "author");
337             } else {
338                 alert("bad facet configuration: '" + facets[i] + "'");
339             }
340         }
341
342         node.html(acc.join(''));
343     }
344
345
346     function onShow(data, teamName) {
347         debug("show");
348         m_totalRec = data.merged;
349
350         var pager = findnode(".mkwsPager");
351         if (pager.length) {
352             pager.html(drawPager(data))
353         }
354
355         var results = findnode(".mkwsRecords");
356         if (!results.length)
357             return;
358
359         var html = [];
360         for (var i = 0; i < data.hits.length; i++) {
361             var hit = data.hits[i];
362             html.push('<div class="record" id="mkwsRecdiv_' + teamName + '_' + hit.recid + '" >',
363                       renderSummary(hit),
364                       '</div>');
365             if (hit.recid == m_curDetRecId) {
366                 if (m_curDetRecData)
367                     html.push(renderDetails(m_curDetRecData));
368             }
369         }
370         results.html(html.join(''));
371     }
372
373
374     function onRecord(data, args, teamName) {
375         debug("record: teamName=" + teamName + ", m_teamName=" + m_teamName);
376         // FIXME: record is async!!
377         clearTimeout(m_paz.recordTimer);
378         // in case on_show was faster to redraw element
379         var detRecordDiv = document.getElementById('mkwsDet_' + teamName + '_' + data.recid);
380         if (detRecordDiv) return;
381         m_curDetRecData = data;
382         var recordDiv = document.getElementById('mkwsRecdiv_' + teamName + '_' + m_curDetRecData.recid);
383         var html = renderDetails(m_curDetRecData);
384         recordDiv.innerHTML += html;
385     }
386
387
388     function renderSummary(hit)
389     {
390         var template = loadTemplate("Summary");
391         hit._id = "mkwsRec_" + hit.recid;
392         hit._onclick = "mkws.showDetails('" + m_teamName + "', this.id);return false;"
393         return template(hit);
394     }
395
396
397     function addSingleFacet(acc, caption, data, max, pzIndex) {
398         acc.push('<div class="facet mkwsFacet' + caption + ' mkwsTeam_' + m_teamName + '">');
399         acc.push('<div class="termtitle">' + M(caption) + '</div>');
400         for (var i = 0; i < data.length && i < max; i++) {
401             acc.push('<div class="term">');
402             acc.push('<a href="#" ');
403             var action = '';
404             if (!pzIndex) {
405                 // Special case: target selection
406                 acc.push('target_id='+data[i].id+' ');
407                 if (!targetFiltered(data[i].id)) {
408                     action = 'mkws.limitTarget(\'' + m_teamName + '\', this.getAttribute(\'target_id\'),this.firstChild.nodeValue)';
409                 }
410             } else {
411                 action = 'mkws.limitQuery(\'' + m_teamName + '\', \'' + pzIndex + '\', this.firstChild.nodeValue)';
412             }
413             acc.push('onclick="' + action + ';return false;">' + data[i].name + '</a>'
414                      + ' <span>' + data[i].freq + '</span>');
415             acc.push('</div>');
416         }
417         acc.push('</div>');
418     }
419
420
421     function targetFiltered(id) {
422         for (var i = 0; i < m_filters.length; i++) {
423             if (m_filters[i].id === id ||
424                 m_filters[i].id === 'pz:id=' + id) {
425                 return true;
426             }
427         }
428         return false;
429     }
430
431
432     ////////////////////////////////////////////////////////////////////////////////
433     ////////////////////////////////////////////////////////////////////////////////
434
435
436     // when search button pressed
437     function onFormSubmitEventHandler()
438     {
439         var val = findnode('.mkwsQuery').val();
440         newSearch(val);
441         return false;
442     }
443
444
445     function newSearch(query, sort, targets)
446     {
447         debug("newSearch: " + query);
448
449         if (mkws_config.use_service_proxy && !mkws.authenticated) {
450             alert("searching before authentication");
451             return;
452         }
453
454         m_filters = []
455         redrawNavi();
456         resetPage();
457         loadSelect();
458         triggerSearch(query, sort, targets);
459         switchView('records'); // In case it's configured to start off as hidden
460         m_submitted = true;
461     }
462
463
464     function onSelectDdChange()
465     {
466         if (!m_submitted) return false;
467         resetPage();
468         loadSelect();
469         m_paz.show(0, m_perpage, m_sort);
470         return false;
471     }
472
473
474     function resetPage()
475     {
476         m_curPage = 1;
477         m_totalRec = 0;
478     }
479
480
481     function triggerSearch (query, sort, targets)
482     {
483         var pp2filter = "";
484         var pp2limit = "";
485
486         // Re-use previous query/sort if new ones are not specified
487         if (query) {
488             m_query = query;
489         }
490         if (sort) {
491             m_sort = sort;
492         }
493         if (targets) {
494             m_filters.push({ id: targets, name: targets });
495         }
496
497         for (var i in m_filters) {
498             var filter = m_filters[i];
499             if (filter.id) {
500                 if (pp2filter)
501                     pp2filter += ",";
502                 if (filter.id.match(/^[a-z:]+[=~]/)) {
503                     debug("filter '" + filter.id + "' already begins with SETTING OP");
504                 } else {
505                     filter.id = 'pz:id=' + filter.id;
506                 }
507                 pp2filter += filter.id;
508             } else {
509                 if (pp2limit)
510                     pp2limit += ",";
511                 pp2limit += filter.field + "=" + filter.value.replace(/[\\|,]/g, '\\$&');
512             }
513         }
514
515         var params = {};
516         if (pp2limit) {
517             params.limit = pp2limit;
518         }
519
520         debug("triggerSearch(" + m_query + "): filters = " + $.toJSON(m_filters) + ", pp2filter = " + pp2filter + ", params = " + $.toJSON(params));
521
522         // We can use: params.torusquery = "udb=NAME"
523         // Note: that won't work when running against raw pazpar2
524         m_paz.search(m_query, m_perpage, m_sort, pp2filter, undefined, params);
525     }
526
527
528     function loadSelect ()
529     {
530         var node = findnode('.mkwsSort');
531         if (node.length && node.val() != m_sort) {
532             debug("changing m_sort from " + m_sort + " to " + node.val());
533             m_sort = node.val();
534         }
535         node = findnode('.mkwsPerpage');
536         if (node.length && node.val() != m_perpage) {
537             debug("changing m_perpage from " + m_perpage + " to " + node.val());
538             m_perpage = node.val();
539         }
540     }
541
542
543     // limit by target functions
544     that.limitTarget  = function (id, name)
545     {
546         debug("limitTarget(id=" + id + ", name=" + name + ")");
547         m_filters.push({ id: id, name: name });
548         redrawNavi();
549         resetPage();
550         loadSelect();
551         triggerSearch();
552         return false;
553     }
554
555
556     // limit the query after clicking the facet
557     that.limitQuery = function (field, value)
558     {
559         debug("limitQuery(field=" + field + ", value=" + value + ")");
560         m_filters.push({ field: field, value: value });
561         redrawNavi();
562         resetPage();
563         loadSelect();
564         triggerSearch();
565         return false;
566     }
567
568
569     that.delimitTarget = function (id)
570     {
571         debug("delimitTarget(id=" + id + ")");
572         var newFilters = [];
573         for (var i in m_filters) {
574             var filter = m_filters[i];
575             if (filter.id) {
576                 debug("delimitTarget() removing filter " + $.toJSON(filter));
577             } else {
578                 debug("delimitTarget() keeping filter " + $.toJSON(filter));
579                 newFilters.push(filter);
580             }
581         }
582         m_filters = newFilters;
583
584         redrawNavi();
585         resetPage();
586         loadSelect();
587         triggerSearch();
588         return false;
589     }
590
591
592     that.delimitQuery = function (field, value)
593     {
594         debug("delimitQuery(field=" + field + ", value=" + value + ")");
595         var newFilters = [];
596         for (var i in m_filters) {
597             var filter = m_filters[i];
598             if (filter.field &&
599                 field == filter.field &&
600                 value == filter.value) {
601                 debug("delimitQuery() removing filter " + $.toJSON(filter));
602             } else {
603                 debug("delimitQuery() keeping filter " + $.toJSON(filter));
604                 newFilters.push(filter);
605             }
606         }
607         m_filters = newFilters;
608
609         redrawNavi();
610         resetPage();
611         loadSelect();
612         triggerSearch();
613         return false;
614     }
615
616
617     function redrawNavi ()
618     {
619         var navi = findnode('.mkwsNavi');
620         if (!navi) return;
621
622         var text = "";
623         for (var i in m_filters) {
624             if (text) {
625                 text += " | ";
626             }
627             var filter = m_filters[i];
628             if (filter.id) {
629                 text += M('source') + ': <a class="crossout" href="#" onclick="mkws.delimitTarget(\'' + m_teamName +
630                     "', '" + filter.id + "'" + ');return false;">' + filter.name + '</a>';
631             } else {
632                 text += M(filter.field) + ': <a class="crossout" href="#" onclick="mkws.delimitQuery(\'' + m_teamName +
633                     "', '" + filter.field + "', '" + filter.value + "'" +
634                     ');return false;">' + filter.value + '</a>';
635             }
636         }
637
638         navi.html(text);
639     }
640
641
642     function drawPager (data)
643     {
644         var s = '<div style="float: right">' + M('Displaying') + ': '
645             + (data.start + 1) + ' ' + M('to') + ' ' + (data.start + data.num) +
646             ' ' + M('of') + ' ' + data.merged + ' (' + M('found') + ': '
647             + data.total + ')</div>';
648
649         //client indexes pages from 1 but pz2 from 0
650         var onsides = 6;
651         var pages = Math.ceil(m_totalRec / m_perpage);
652
653         var firstClkbl = (m_curPage - onsides > 0)
654             ? m_curPage - onsides
655             : 1;
656
657         var lastClkbl = firstClkbl + 2*onsides < pages
658             ? firstClkbl + 2*onsides
659             : pages;
660
661         var prev = '<span class="mkwsPrev">&#60;&#60; ' + M('Prev') + '</span><b> | </b>';
662         if (m_curPage > 1)
663             prev = '<a href="#" class="mkwsPrev" onclick="mkws.pagerPrev(\'' + m_teamName + '\');">'
664             +'&#60;&#60; ' + M('Prev') + '</a><b> | </b>';
665
666         var middle = '';
667         for(var i = firstClkbl; i <= lastClkbl; i++) {
668             var numLabel = i;
669             if(i == m_curPage)
670                 numLabel = '<b>' + i + '</b>';
671
672             middle += '<a href="#" onclick="mkws.showPage(\'' + m_teamName + '\', ' + i + ')"> '
673                 + numLabel + ' </a>';
674         }
675
676         var next = '<b> | </b><span class="mkwsNext">' + M('Next') + ' &#62;&#62;</span>';
677         if (pages - m_curPage > 0)
678             next = '<b> | </b><a href="#" class="mkwsNext" onclick="mkws.pagerNext(\'' + m_teamName + '\')">'
679             + M('Next') + ' &#62;&#62;</a>';
680
681         var predots = '';
682         if (firstClkbl > 1)
683             predots = '...';
684
685         var postdots = '';
686         if (lastClkbl < pages)
687             postdots = '...';
688
689         s += '<div style="float: clear">'
690             + prev + predots + middle + postdots + next + '</div>';
691
692         return s;
693     }
694
695
696     that.showPage = function (pageNum)
697     {
698         m_curPage = pageNum;
699         m_paz.showPage(m_curPage - 1);
700     }
701
702
703     // simple paging functions
704     that.pagerNext = function () {
705         if (m_totalRec - m_perpage*m_curPage > 0) {
706             m_paz.showNext();
707             m_curPage++;
708         }
709     }
710
711
712     that.pagerPrev = function () {
713         if (m_paz.showPrev() != false)
714             m_curPage--;
715     }
716
717
718     // switching view between targets and records
719     function switchView(view) {
720         var targets = findnode('.mkwsTargets');
721         var results = findnode('.mkwsResults,.mkwsRecords');
722         var blanket = findnode('.mkwsBlanket');
723         var motd    = findnode('.mkwsMOTD');
724
725         switch(view) {
726         case 'targets':
727             if (targets) targets.css('display', 'block');
728             if (results) results.css('display', 'none');
729             if (blanket) blanket.css('display', 'none');
730             if (motd) motd.css('display', 'none');
731             break;
732         case 'records':
733             if (targets) targets.css('display', 'none');
734             if (results) results.css('display', 'block');
735             if (blanket) blanket.css('display', 'block');
736             if (motd) motd.css('display', 'none');
737             break;
738         case 'none':
739             alert("mkws.switchView(" + m_teamName + ", 'none') shouldn't happen");
740             if (targets) targets.css('display', 'none');
741             if (results) results.css('display', 'none');
742             if (blanket) blanket.css('display', 'none');
743             if (motd) motd.css('display', 'none');
744             break;
745         default:
746             alert("Unknown view '" + view + "'");
747         }
748     }
749
750
751     that.switchView = switchView;
752
753
754     // detailed record drawing
755     that.showDetails = function (prefixRecId) {
756         var recId = prefixRecId.replace('mkwsRec_', '');
757         var oldRecId = m_curDetRecId;
758         m_curDetRecId = recId;
759
760         // remove current detailed view if any
761         var detRecordDiv = document.getElementById('mkwsDet_' + m_teamName + '_' + oldRecId);
762         // lovin DOM!
763         if (detRecordDiv)
764             detRecordDiv.parentNode.removeChild(detRecordDiv);
765
766         // if the same clicked, just hide
767         if (recId == oldRecId) {
768             m_curDetRecId = '';
769             m_curDetRecData = null;
770             return;
771         }
772         // request the record
773         debug("showDetails() requesting record '" + recId + "'");
774         m_paz.record(recId);
775     }
776
777
778     function renderDetails(data, marker)
779     {
780         var template = loadTemplate("Record");
781         var details = template(data);
782         return '<div class="details" id="mkwsDet_' + m_teamName + '_' + data.recid + '">' + details + '</div>';
783     }
784
785
786     function loadTemplate(name)
787     {
788         var template = m_template[name];
789
790         if (template === undefined) {
791             // Fall back to generic template if there is no team-specific one
792             var node = findnode(".mkwsTemplate_" + name);
793             if (!node.length) {
794                 node = findnode(".mkwsTemplate_" + name, "ALL");
795             }
796
797             var source = node.html();
798             if (!source) {
799                 source = defaultTemplate(name);
800             }
801
802             template = Handlebars.compile(source);
803             debug("compiled template '" + name + "'");
804             m_template[name] = template;
805         }
806
807         return template;
808     }
809
810
811     function defaultTemplate(name)
812     {
813         if (name === 'Record') {
814             return '\
815 <table>\
816   <tr>\
817     <th>{{translate "Title"}}</th>\
818     <td>\
819       {{md-title}}\
820       {{#if md-title-remainder}}\
821         ({{md-title-remainder}})\
822       {{/if}}\
823       {{#if md-title-responsibility}}\
824         <i>{{md-title-responsibility}}</i>\
825       {{/if}}\
826     </td>\
827   </tr>\
828   {{#if md-date}}\
829   <tr>\
830     <th>{{translate "Date"}}</th>\
831     <td>{{md-date}}</td>\
832   </tr>\
833   {{/if}}\
834   {{#if md-author}}\
835   <tr>\
836     <th>{{translate "Author"}}</th>\
837     <td>{{md-author}}</td>\
838   </tr>\
839   {{/if}}\
840   {{#if md-electronic-url}}\
841   <tr>\
842     <th>{{translate "Links"}}</th>\
843     <td>\
844       {{#each md-electronic-url}}\
845         <a href="{{this}}">Link{{index1}}</a>\
846       {{/each}}\
847     </td>\
848   </tr>\
849   {{/if}}\
850   {{#if-any location having="md-subject"}}\
851   <tr>\
852     <th>{{translate "Subject"}}</th>\
853     <td>\
854       {{#first location having="md-subject"}}\
855         {{#if md-subject}}\
856           {{#commaList md-subject}}\
857             {{this}}{{/commaList}}\
858         {{/if}}\
859       {{/first}}\
860     </td>\
861   </tr>\
862   {{/if-any}}\
863   <tr>\
864     <th>{{translate "Locations"}}</th>\
865     <td>\
866       {{#commaList location}}\
867         {{attr "@name"}}{{/commaList}}\
868     </td>\
869   </tr>\
870 </table>\
871 ';
872         } else if (name === "Summary") {
873             return '\
874 <a href="#" id="{{_id}}" onclick="{{_onclick}}">\
875   <b>{{md-title}}</b>\
876 </a>\
877 {{#if md-title-remainder}}\
878   <span>{{md-title-remainder}}</span>\
879 {{/if}}\
880 {{#if md-title-responsibility}}\
881   <span><i>{{md-title-responsibility}}</i></span>\
882 {{/if}}\
883 ';
884         }
885
886         var s = "There is no default '" + name +"' template!";
887         alert(s);
888         return s;
889     }
890
891
892     /*
893      * All the HTML stuff to render the search forms and
894      * result pages.
895      */
896     function mkwsHtmlAll() {
897         mkwsSetLang();
898         if (mkws_config.show_lang)
899             mkwsHtmlLang();
900
901         debug("HTML search form");
902         mkws.handleNodeWithTeam(findnode('.mkwsSearch'), function(tname) {
903             this.html('\
904 <form name="mkwsSearchForm" class="mkwsSearchForm mkwsTeam_' + tname + '" action="" >\
905   <input class="mkwsQuery mkwsTeam_' + tname + '" type="text" size="' + mkws_config.query_width + '" />\
906   <input class="mkwsButton mkwsTeam_' + tname + '" type="submit" value="' + M('Search') + '" />\
907 </form>');
908         });
909
910         debug("HTML records");
911         // If the team has a .mkwsResults, populate it in the usual
912         // way. If not, assume that it's a smarter application that
913         // defines its own subcomponents, some or all of the
914         // following:
915         //      .mkwsTermlists
916         //      .mkwsRanking
917         //      .mkwsPager
918         //      .mkwsNavi
919         //      .mkwsRecords
920         if (findnode(".mkwsResults").length) {
921             findnode(".mkwsResults").html('\
922 <table width="100%" border="0" cellpadding="6" cellspacing="0">\
923   <tr>\
924     <td class="mkwsTermlistContainer1 mkwsTeam_' + m_teamName + '" width="250" valign="top">\
925       <div class="mkwsTermlists mkwsTeam_' + m_teamName + '"></div>\
926     </td>\
927     <td class="mkwsMOTDContainer mkwsTeam_' + m_teamName + '" valign="top">\
928       <div class="mkwsRanking mkwsTeam_' + m_teamName + '"></div>\
929       <div class="mkwsPager mkwsTeam_' + m_teamName + '"></div>\
930       <div class="mkwsNavi mkwsTeam_' + m_teamName + '"></div>\
931       <div class="mkwsRecords mkwsTeam_' + m_teamName + '"></div>\
932     </td>\
933   </tr>\
934   <tr>\
935     <td colspan="2">\
936       <div class="mkwsTermlistContainer2 mkwsTeam_' + m_teamName + '"></div>\
937     </td>\
938   </tr>\
939 </table>');
940         }
941
942         var node = findnode(".mkwsRanking");
943         if (node.length) {
944             var ranking_data = '';
945             ranking_data += '<form name="mkwsSelect" class="mkwsSelect mkwsTeam_' + m_teamName + '" action="" >';
946             if (mkws_config.show_sort) {
947                 ranking_data +=  M('Sort by') + ' ' + mkwsHtmlSort() + ' ';
948             }
949             if (mkws_config.show_perpage) {
950                 ranking_data += M('and show') + ' ' + mkwsHtmlPerpage() + ' ' + M('per page') + '.';
951             }
952             ranking_data += '</form>';
953
954             node.html(ranking_data);
955         }
956
957         mkwsHtmlSwitch();
958
959         var node;
960         node = findnode('.mkwsSearchForm');
961         if (node.length)
962             node.submit(onFormSubmitEventHandler);
963         node = findnode('.mkwsSort');
964         if (node.length)
965             node.change(onSelectDdChange);
966         node = findnode('.mkwsPerpage');
967         if (node.length)
968             node.change(onSelectDdChange);
969
970         // on first page, hide the termlist
971         $(document).ready(function() { findnode(".mkwsTermlists").hide(); });
972         var motd = findnode(".mkwsMOTD");
973         var container = findnode(".mkwsMOTDContainer");
974         if (motd.length && container.length) {
975             // Move the MOTD from the provided element down into the container
976             motd.appendTo(container);
977         }
978     }
979
980
981     // implement $.parseQuerystring() for parsing URL parameters
982     function parseQuerystring() {
983         var nvpair = {};
984         var qs = window.location.search.replace('?', '');
985         var pairs = qs.split('&');
986         $.each(pairs, function(i, v){
987             var pair = v.split('=');
988             nvpair[pair[0]] = pair[1];
989         });
990         return nvpair;
991     }
992
993
994     function mkwsSetLang()  {
995         var lang = parseQuerystring().lang || mkws_config.lang;
996         if (!lang || !mkws.locale_lang[lang]) {
997             mkws_config.lang = ""
998         } else {
999             mkws_config.lang = lang;
1000         }
1001
1002         debug("Locale language: " + (mkws_config.lang ? mkws_config.lang : "none"));
1003         return mkws_config.lang;
1004     }
1005
1006
1007     function mkwsHtmlSwitch() {
1008         debug("HTML switch for team " + m_teamName);
1009
1010         var node = findnode(".mkwsSwitch");
1011         node.append($('<a href="#" onclick="mkws.switchView(\'' + m_teamName + '\', \'records\')">' + M('Records') + '</a>'));
1012         node.append($("<span/>", { text: " | " }));
1013         node.append($('<a href="#" onclick="mkws.switchView(\'' + m_teamName + '\', \'targets\')">' + M('Targets') + '</a>'));
1014
1015         debug("HTML targets");
1016         var node = findnode(".mkwsTargets");
1017         node.html('\
1018 <div class="mkwsBytarget mkwsTeam_' + m_teamName + '">\
1019   No information available yet.\
1020 </div>');
1021         node.css("display", "none");
1022     }
1023
1024
1025     function mkwsHtmlSort() {
1026         debug("HTML sort, m_sort = '" + m_sort + "'");
1027         var sort_html = '<select class="mkwsSort mkwsTeam_' + m_teamName + '">';
1028
1029         for(var i = 0; i < mkws_config.sort_options.length; i++) {
1030             var opt = mkws_config.sort_options[i];
1031             var key = opt[0];
1032             var val = opt.length == 1 ? opt[0] : opt[1];
1033
1034             sort_html += '<option value="' + key + '"';
1035             if (m_sort == key || m_sort == val) {
1036                 sort_html += ' selected="selected"';
1037             }
1038             sort_html += '>' + M(val) + '</option>';
1039         }
1040         sort_html += '</select>';
1041
1042         return sort_html;
1043     }
1044
1045
1046     function mkwsHtmlPerpage() {
1047         debug("HTML perpage, m_perpage = " + m_perpage);
1048         var perpage_html = '<select class="mkwsPerpage mkwsTeam_' + m_teamName + '">';
1049
1050         for(var i = 0; i < mkws_config.perpage_options.length; i++) {
1051             var key = mkws_config.perpage_options[i];
1052
1053             perpage_html += '<option value="' + key + '"';
1054             if (key == m_perpage) {
1055                 perpage_html += ' selected="selected"';
1056             }
1057             perpage_html += '>' + key + '</option>';
1058         }
1059         perpage_html += '</select>';
1060
1061         return perpage_html;
1062     }
1063
1064
1065     /* create locale language menu */
1066     function mkwsHtmlLang() {
1067         var lang_default = "en";
1068         var lang = mkws_config.lang || lang_default;
1069         var list = [];
1070
1071         /* display a list of configured languages, or all */
1072         var lang_options = mkws_config.lang_options || [];
1073         var toBeIncluded = {};
1074         for (var i = 0; i < lang_options.length; i++) {
1075             toBeIncluded[lang_options[i]] = true;
1076         }
1077
1078         for (var k in mkws.locale_lang) {
1079             if (toBeIncluded[k] || lang_options.length == 0)
1080                 list.push(k);
1081         }
1082
1083         // add english link
1084         if (lang_options.length == 0 || toBeIncluded[lang_default])
1085             list.push(lang_default);
1086
1087         debug("Language menu for: " + list.join(", "));
1088
1089         /* the HTML part */
1090         var data = "";
1091         for(var i = 0; i < list.length; i++) {
1092             var l = list[i];
1093
1094             if (data)
1095                 data += ' | ';
1096
1097             if (lang == l) {
1098                 data += ' <span>' + l + '</span> ';
1099             } else {
1100                 data += ' <a href="?lang=' + l + '">' + l + '</a> '
1101             }
1102         }
1103
1104         findnode(".mkwsLang").html(data);
1105     }
1106
1107
1108     that.runAutoSearch = function() {
1109         // ### should check mkwsTermlist as well, for facet-only teams
1110         var node = findnode('.mkwsRecords');
1111         var query = node.attr('autosearch');
1112         if (!query)
1113             return;
1114
1115         if (query.match(/^!param!/)) {
1116             var param = query.replace(/^!param!/, '');
1117             query = getParameterByName(param);
1118             debug("obtained query '" + query + "' from param '" + param + "'");
1119             if (!query) {
1120                 alert("This page has a MasterKey widget that needs a query specified by the '" + param + "' parameter");
1121             }
1122         } else if (query.match(/^!path!/)) {
1123             var index = query.replace(/^!path!/, '');
1124             var path = window.location.pathname.split('/');
1125             query = path[path.length - index];
1126             debug("obtained query '" + query + "' from path-component '" + index + "'");
1127             if (!query) {
1128                 alert("This page has a MasterKey widget that needs a query specified by the path-component " + index);
1129             }
1130         }
1131
1132         debug("node=" + node + ", class='" + node.className + "', query=" + query);
1133
1134         var sort = node.attr('sort');
1135         var targets = node.attr('targets');
1136         var s = "running auto search: '" + query + "'";
1137         if (sort) s += " sorted by '" + sort + "'";
1138         if (targets) s += " in targets '" + targets + "'";
1139         debug(s);
1140
1141         newSearch(query, sort, targets);
1142     }
1143
1144
1145     // This function is taken from a StackOverflow answer
1146     // http://stackoverflow.com/questions/901115/how-can-i-get-query-string-values-in-javascript/901144#901144
1147     // ### should we unify this and parseQuerystring()?
1148     function getParameterByName(name) {
1149         name = name.replace(/[\[]/, "\\[").replace(/[\]]/, "\\]");
1150         var regex = new RegExp("[\\?&]" + name + "=([^&#]*)"),
1151             results = regex.exec(location.search);
1152         return results == null ? "" : decodeURIComponent(results[1].replace(/\+/g, " "));
1153     }
1154
1155
1156     /* locale */
1157     function M(word) {
1158         var lang = mkws_config.lang;
1159
1160         if (!lang || !mkws.locale_lang[lang])
1161             return word;
1162
1163         return mkws.locale_lang[lang][word] || word;
1164     }
1165     mkws.M = M; // so the Handlebars helper can use it
1166
1167
1168     // Finds the node of the specified class within the current team
1169     // Multiple OR-clauses separated by commas are handled
1170     // More complex cases may not work
1171     //
1172     function findnode(selector, teamName) {
1173         teamName = teamName || m_teamName;
1174
1175         selector = selector.split(',').map(function(s) {
1176             return s + '.mkwsTeam_' + teamName;
1177         }).join(',');
1178
1179         return $(selector);
1180     }
1181
1182
1183     // main
1184     (function() {
1185         try {
1186             mkwsHtmlAll()
1187         }
1188
1189         catch (e) {
1190             mkws_config.error = e.message;
1191             // alert(e.message);
1192         }
1193     })();
1194
1195     // Bizarrely, 'that' is just an empty hash. All its state is in
1196     // the closure variables defined earlier in this function.
1197     return that;
1198 };
1199
1200
1201 // wrapper to call team() after page load
1202 (function (j) {
1203     mkws.debug = function (string) {
1204         if (!mkws.debug_level)
1205             return;
1206
1207         if (typeof console === "undefined" || typeof console.log === "undefined") { /* ARGH!!! old IE */
1208             return;
1209         }
1210
1211         // you need to disable use strict at the top of the file!!!
1212         if (mkws.debug_level >= 3) {
1213             console.log(arguments.callee.caller);
1214         } else if (mkws.debug_level >= 2) {
1215             console.log(">>> called from function " + arguments.callee.caller.name + ' <<<');
1216         }
1217         console.log(string);
1218     }
1219     var debug = mkws.debug;
1220
1221
1222     mkws.handleNodeWithTeam = function(node, callback) {
1223         // First branch for DOM objects; second branch for jQuery objects
1224         var classes = node.className || node.attr('class');
1225         if (!classes) {
1226             // For some reason, if we try to proceed when classes is
1227             // undefined, we don't get an error message, but this
1228             // function and its callers, up several stack level,
1229             // silently return. What a crock.
1230             mkws.debug("handleNodeWithTeam() called on node with no classes");
1231             return;
1232         }
1233         var list = classes.split(/\s+/)
1234         var teamName, type;
1235
1236         for (var i = 0; i < list.length; i++) {
1237             var cname = list[i];
1238             if (cname.match(/^mkwsTeam_/)) {
1239                 teamName = cname.replace(/^mkwsTeam_/, '');
1240             } else if (cname.match(/^mkws/)) {
1241                 type = cname.replace(/^mkws/, '');
1242             }
1243         }
1244         callback.call(node, teamName, type);
1245     }
1246
1247
1248     mkws.resizePage = function () {
1249         var list = ["mkwsSwitch", "mkwsLang"];
1250
1251         var width = mkws_config.responsive_design_width;
1252         var parent = $(".mkwsTermlists").parent();
1253
1254         if ($(window).width() <= width &&
1255             parent.hasClass("mkwsTermlistContainer1")) {
1256             debug("changing from wide to narrow: " + $(window).width());
1257             $(".mkwsTermlistContainer1").hide();
1258             $(".mkwsTermlistContainer2").show();
1259             for (var tname in mkws.teams) {
1260                 $(".mkwsTermlists.mkwsTeam_" + tname).appendTo($(".mkwsTermlistContainer2.mkwsTeam_" + tname));
1261                 for(var i = 0; i < list.length; i++) {
1262                     $("." + list[i] + ".mkwsTeam_" + tname).hide();
1263                 }
1264             }
1265         } else if ($(window).width() > width &&
1266                    parent.hasClass("mkwsTermlistContainer2")) {
1267             debug("changing from narrow to wide: " + $(window).width());
1268             $(".mkwsTermlistContainer1").show();
1269             $(".mkwsTermlistContainer2").hide();
1270             for (var tname in mkws.teams) {
1271                 $(".mkwsTermlists.mkwsTeam_" + tname).appendTo($(".mkwsTermlistContainer1.mkwsTeam_" + tname));
1272                 for(var i = 0; i < list.length; i++) {
1273                     $("." + list[i] + ".mkwsTeam_" + tname).show();
1274                 }
1275             }
1276         }
1277     };
1278
1279
1280     mkws.switchView = function(tname, view) {
1281         mkws.teams[tname].switchView(view);
1282     }
1283
1284     mkws.showDetails = function (tname, prefixRecId) {
1285         mkws.teams[tname].showDetails(prefixRecId);
1286     }
1287
1288     mkws.limitTarget  = function (tname, id, name) {
1289         mkws.teams[tname].limitTarget(id, name);
1290     }
1291
1292     mkws.limitQuery  = function (tname, field, value) {
1293         mkws.teams[tname].limitQuery(field, value);
1294     }
1295
1296     mkws.delimitTarget = function (tname, id) {
1297         mkws.teams[tname].delimitTarget(id);
1298     }
1299
1300     mkws.delimitQuery = function (tname, field, value) {
1301         mkws.teams[tname].delimitQuery(field, value);
1302     }
1303
1304     mkws.showPage = function (tname, pageNum) {
1305         mkws.teams[tname].showPage(pageNum);
1306     }
1307
1308     mkws.pagerPrev = function (tname) {
1309         mkws.teams[tname].pagerPrev();
1310     }
1311
1312     mkws.pagerNext = function (tname) {
1313         mkws.teams[tname].pagerNext();
1314     }
1315
1316
1317     function defaultMkwsConfig() {
1318         /* default mkws config */
1319         var config_default = {
1320             use_service_proxy: true,
1321             pazpar2_url: "//mkws.indexdata.com/service-proxy/",
1322             service_proxy_auth: "//mkws.indexdata.com/service-proxy-auth",
1323             lang: "",
1324             sort_options: [["relevance"], ["title:1", "title"], ["date:0", "newest"], ["date:1", "oldest"]],
1325             perpage_options: [10, 20, 30, 50],
1326             sort_default: "relevance",
1327             perpage_default: 20,
1328             query_width: 50,
1329             show_lang: true,    /* show/hide language menu */
1330             show_sort: true,    /* show/hide sort menu */
1331             show_perpage: true,         /* show/hide perpage menu */
1332             lang_options: [],   /* display languages links for given languages, [] for all */
1333             facets: ["xtargets", "subject", "author"], /* display facets, in this order, [] for none */
1334             responsive_design_width: undefined, /* a page with less pixel width considered as narrow */
1335             debug_level: 1,     /* debug level for development: 0..2 */
1336
1337             dummy: "dummy"
1338         };
1339
1340         /* Set global debug_level flag early so that debug() works */
1341         if (typeof mkws_config.debug_level !== 'undefined') {
1342             mkws.debug_level = mkws_config.debug_level;
1343         } else if (typeof config_default.debug_level !== 'undefined') {
1344             mkws.debug_level = config_default.debug_level;
1345         }
1346
1347         // make sure the mkws_config is a valid hash
1348         if (!$.isPlainObject(mkws_config)) {
1349             debug("ERROR: mkws_config is not an JS object, ignore it....");
1350             mkws_config = {};
1351         }
1352
1353         /* override standard config values by function parameters */
1354         for (var k in config_default) {
1355             if (typeof mkws_config[k] === 'undefined')
1356                 mkws_config[k] = config_default[k];
1357             //debug("Set config: " + k + ' => ' + mkws_config[k]);
1358         }
1359     }
1360
1361
1362     /*
1363      * Run service-proxy authentication in background (after page load).
1364      * The username/password is configured in the apache config file
1365      * for the site.
1366      */
1367     function authenticateSession(auth_url, auth_domain, pp2_url) {
1368         debug("Run service proxy auth URL: " + auth_url);
1369
1370         if (!auth_domain) {
1371             auth_domain = pp2_url.replace(/^(https?:)?\/\/(.*?)\/.*/, '$2');
1372             debug("guessed auth_domain '" + auth_domain + "' from pp2_url '" + pp2_url + "'");
1373         }
1374
1375         var request = new pzHttpRequest(auth_url, function(err) {
1376             alert("HTTP call for authentication failed: " + err)
1377             return;
1378         }, auth_domain);
1379
1380         request.get(null, function(data) {
1381             if (!$.isXMLDoc(data)) {
1382                 alert("service proxy auth response document is not valid XML document, give up!");
1383                 return;
1384             }
1385             var status = $(data).find("status");
1386             if (status.text() != "OK") {
1387                 alert("service proxy auth repsonse status: " + status.text() + ", give up!");
1388                 return;
1389             }
1390
1391             debug("Service proxy auth successfully done");
1392             mkws.authenticated = true;
1393             runAutoSearches();
1394         });
1395     }
1396
1397
1398     function runAutoSearches() {
1399         debug("running auto searches");
1400
1401         for (var teamName in mkws.teams) {
1402             mkws.teams[teamName].runAutoSearch();
1403         }
1404     }
1405
1406
1407     $(document).ready(function() {
1408         debug("on load ready");
1409         defaultMkwsConfig();
1410
1411         if (mkws_config.query_width < 5 || mkws_config.query_width > 150) {
1412             debug("Reset query width: " + mkws_config.query_width);
1413             mkws_config.query_width = 50;
1414         }
1415
1416         for (var key in mkws_config) {
1417             if (mkws_config.hasOwnProperty(key)) {
1418                 if (key.match(/^language_/)) {
1419                     var lang = key.replace(/^language_/, "");
1420                     // Copy custom languages into list
1421                     mkws.locale_lang[lang] = mkws_config[key];
1422                     debug("Added locally configured language '" + lang + "'");
1423                 }
1424             }
1425         }
1426
1427         if (mkws_config.responsive_design_width) {
1428             // Responsive web design - change layout on the fly based on
1429             // current screen width. Required for mobile devices.
1430             $(window).resize(function(e) { mkws.resizePage() });
1431             // initial check after page load
1432             $(document).ready(function() { mkws.resizePage() });
1433         }
1434
1435         // Backwards compatibility: set new magic class names on any
1436         // elements that have the old magic IDs.
1437         var ids = [ "Switch", "Lang", "Search", "Pager", "Navi",
1438                     "Results", "Records", "Targets", "Ranking",
1439                     "Termlists", "Stat", "MOTD" ];
1440         for (var i = 0; i < ids.length; i++) {
1441             var id = 'mkws' + ids[i];
1442             var node = $('#' + id);
1443             if (node.attr('id')) {
1444                 node.addClass(id);
1445                 debug("added magic class to '" + node.attr('id') + "'");
1446             }
1447         }
1448
1449         // For all MKWS-classed nodes that don't have a team
1450         // specified, set the team to AUTO.
1451         $('[class^="mkws"],[class*=" mkws"]').each(function () {
1452             if (!this.className.match(/mkwsTeam_/)) {
1453                 debug("adding AUTO team to node with class '" + this.className + "'");
1454                 $(this).addClass('mkwsTeam_AUTO');
1455             }
1456         });
1457
1458         // Find all nodes with an class, and determine their team from
1459         // the mkwsTeam_* class. Make all team objects.
1460         var then = $.now();
1461         $('[class^="mkws"],[class*=" mkws"]').each(function () {
1462             mkws.handleNodeWithTeam(this, function(tname, type) {
1463                 if (!mkws.teams[tname]) {
1464                     mkws.teams[tname] = team(j, tname);
1465                     debug("Made MKWS team '" + tname + "'");
1466                 }
1467                 var myTeam = mkws.teams[tname];
1468                 var myWidget = widget(j, myTeam, type, this);
1469             });
1470         });
1471         var now = $.now();
1472         debug("Walking MKWS nodes took " + (now-then) + " ms");
1473
1474         if (mkws_config.use_service_proxy) {
1475             authenticateSession(mkws_config.service_proxy_auth,
1476                                 mkws_config.service_proxy_auth_domain,
1477                                 mkws_config.pazpar2_url);
1478         } else {
1479             // raw pp2
1480             runAutoSearches();
1481         }
1482     });
1483 })(jQuery);