Move all state variable declarations together.
[mkws-moved-to-github.git] / tools / htdocs / mkws.js
index f632a57..4579c8e 100644 (file)
 
 "use strict"; // HTML5: disable for debug_level >= 2
 
+
+// Handlebars helpers
+Handlebars.registerHelper('json', function(obj) {
+    return $.toJSON(obj);
+});
+
+
+Handlebars.registerHelper('translate', function(s) {
+    debug("translating '" + s + "'");
+    return mkws.M(s);
+});
+
+
+// We need {{attr '@name'}} because Handlebars can't parse {{@name}}
+Handlebars.registerHelper('attr', function(attrName) {
+    return this[attrName];
+});
+
+
+/*
+ * Use as follows: {{#if-any NAME1 having="NAME2"}}
+ * Applicable when NAME1 is the name of an array
+ * The guarded code runs only if at least one element of the NAME1
+ * array has a subelement called NAME2.
+ */
+Handlebars.registerHelper('if-any', function(items, options) {
+    var having = options.hash.having;
+    for (var i in items) {
+       var item = items[i]
+       if (!having || item[having]) {
+           return options.fn(this);
+       }
+    }
+    return "";
+});
+
+
+Handlebars.registerHelper('first', function(items, options) {
+    var having = options.hash.having;
+    for (var i in items) {
+       var item = items[i]
+       if (!having || item[having]) {
+           return options.fn(item);
+       }
+    }
+    return "";
+});
+
+
+Handlebars.registerHelper('commaList', function(items, options) {
+    var out = "";
+
+    for (var i in items) {
+       if (i > 0) out += ", ";
+       out += options.fn(items[i])
+    }
+
+    return out;
+});
+
+
+
 // Some functions are visible to be called from outside code, namely
 // generated HTML: mkws.switchView(), showDetails(), limitTarget(),
 // limitQuery(), delimitTarget(), delimitQuery(), pagerPrev(),
-// pagerNext(), showPage()
+// pagerNext(), showPage(). Also mkws.M() is made available for the
+// Handlebars helper 'translate'
+
 
 // Set up global mkws object. Contains a hash of session objects,
 // indexed by windowid.
 var mkws = {
     authenticated: false,
-    sessions: {}
-};
-
-mkws.locale_lang = {
-    "de": {
-       "Authors": "Autoren",
-       "Subjects": "Schlagwörter",
-       "Sources": "Daten und Quellen",
-       "Termlists": "Termlisten",
-       "Next": "Weiter",
-       "Prev": "Zurück",
-       "Search": "Suche",
-       "Sort by": "Sortieren nach",
-       "and show": "und zeige",
-       "per page": "pro Seite",
-       "Displaying": "Zeige",
-       "to": "von",
-       "of": "aus",
-       "found": "gefunden",
-       "Title": "Titel",
-       "Author": "Autor",
-       "Date": "Datum",
-       "Subject": "Schlagwort",
-       "Location": "Ort",
-       "Records": "Datensätze",
-       "Targets": "Datenbanken",
-
-       "dummy": "dummy"
-    },
-
-    "da": {
-       "Authors": "Forfattere",
-       "Subjects": "Emner",
-       "Sources": "Kilder",
-       "Termlists": "Termlists",
-       "Next": "Næste",
-       "Prev": "Forrige",
-       "Search": "Søg",
-       "Sort by": "Sorter efter",
-       "and show": "og vis",
-       "per page": "per side",
-       "Displaying": "Viser",
-       "to": "til",
-       "of": "ud af",
-       "found": "fandt",
-       "Title": "Title",
-       "Author": "Forfatter",
-       "Date": "Dato",
-       "Subject": "Emneord",
-       "Location": "Lokation",
-       "Records": "Poster",
-       "Targets": "Baser",
-
-       "dummy": "dummy"
+    init: false,
+    debug_function: undefined, // will be set during initialisation
+    debug_level: undefined, // will be initialised from mkws_config
+    sessions: {},
+    locale_lang: {
+       "de": {
+           "Authors": "Autoren",
+           "Subjects": "Schlagwörter",
+           "Sources": "Daten und Quellen",
+           "Termlists": "Termlisten",
+           "Next": "Weiter",
+           "Prev": "Zurück",
+           "Search": "Suche",
+           "Sort by": "Sortieren nach",
+           "and show": "und zeige",
+           "per page": "pro Seite",
+           "Displaying": "Zeige",
+           "to": "von",
+           "of": "aus",
+           "found": "gefunden",
+           "Title": "Titel",
+           "Author": "Autor",
+           "Date": "Datum",
+           "Subject": "Schlagwort",
+           "Location": "Ort",
+           "Records": "Datensätze",
+           "Targets": "Datenbanken",
+
+           "dummy": "dummy"
+       },
+
+       "da": {
+           "Authors": "Forfattere",
+           "Subjects": "Emner",
+           "Sources": "Kilder",
+           "Termlists": "Termlists",
+           "Next": "Næste",
+           "Prev": "Forrige",
+           "Search": "Søg",
+           "Sort by": "Sorter efter",
+           "and show": "og vis",
+           "per page": "per side",
+           "Displaying": "Viser",
+           "to": "til",
+           "of": "ud af",
+           "found": "fandt",
+           "Title": "Title",
+           "Author": "Forfatter",
+           "Date": "Dato",
+           "Subject": "Emneord",
+           "Location": "Lokation",
+           "Records": "Poster",
+           "Targets": "Baser",
+
+           "dummy": "dummy"
+       }
     }
 };
 
+
 // Define empty mkws_config for simple applications that don't define it.
 if (mkws_config == null || typeof mkws_config != 'object') {
     var mkws_config = {};
 }
 
+
 // wrapper for jQuery lib
 function _make_mkws_team($, teamName) {
-    if (console && console.log)
-       console.log("run _make_mkws_team(" + (teamName ? teamName : "") + ")");
+    // if (console && console.log) // disabled, will fail in IE8
+    // console.log("run _make_mkws_team(" + (teamName ? teamName : "") + ")");
 
     // call this function only once
     if (mkws.init) {
@@ -86,6 +154,17 @@ function _make_mkws_team($, teamName) {
 
     var m_sort = 'relevance';
     var m_filters = [];
+    var curPage = 1;
+    var recPerPage = 20;
+    var totalRec = 0;
+    var curDetRecId = '';
+    var curDetRecData = null;
+    var submitted = false;
+    var SourceMax = 16;
+    var SubjectMax = 10;
+    var AuthorMax = 10;
+    var m_query; // initially undefined
+
 
     // keep time state for debugging
     var m_debug_time = {
@@ -93,6 +172,8 @@ function _make_mkws_team($, teamName) {
        "last": $.now()
     };
 
+
+    // Needs to be defined inside _make_mkws_team() so it can see m_debug_time
     mkws.debug_function = function (string) {
        if (!mkws.debug_level)
            return;
@@ -117,65 +198,6 @@ function _make_mkws_team($, teamName) {
     debug("start running MKWS");
 
 
-    Handlebars.registerHelper('json', function(obj) {
-       return $.toJSON(obj);
-    });
-
-
-    Handlebars.registerHelper('translate', function(s) {
-       debug("translating '" + s + "'");
-       return M(s);
-    });
-
-
-    // We need {{attr '@name'}} because Handlebars can't parse {{@name}}
-    Handlebars.registerHelper('attr', function(attrName) {
-       return this[attrName];
-    });
-
-
-    /*
-     * Use as follows: {{#if-any NAME1 having="NAME2"}}
-     * Applicable when NAME1 is the name of an array
-     * The guarded code runs only if at least one element of the NAME1
-     * array has a subelement called NAME2.
-     */
-    Handlebars.registerHelper('if-any', function(items, options) {
-       var having = options.hash.having;
-       for (var i in items) {
-           var item = items[i]
-           if (!having || item[having]) {
-               return options.fn(this);
-           }
-       }
-       return "";
-    });
-
-
-    Handlebars.registerHelper('first', function(items, options) {
-       var having = options.hash.having;
-       for (var i in items) {
-           var item = items[i]
-           if (!having || item[having]) {
-               return options.fn(item);
-           }
-       }
-       return "";
-    });
-
-
-    Handlebars.registerHelper('commaList', function(items, options) {
-       var out = "";
-
-       for (var i in items) {
-           if (i > 0) out += ", ";
-           out += options.fn(items[i])
-       }
-
-       return out;
-    });
-
-
     {
 
        /* default mkws config */
@@ -263,22 +285,11 @@ function _make_mkws_team($, teamName) {
                           "showResponseType": '', // or "json" (for debugging?)
                           "onrecord": my_onrecord } );
 
-    // some state vars
-    var curPage = 1;
-    var recPerPage = 20;
-    var totalRec = 0;
-    var curDetRecId = '';
-    var curDetRecData = null;
-    var submitted = false;
-    var SourceMax = 16;
-    var SubjectMax = 10;
-    var AuthorMax = 10;
-    var m_query; // initially undefined
-
     if (!isNaN(parseInt(mkws_config.perpage_default))) {
        recPerPage = parseInt(mkws_config.perpage_default);
     }
 
+
     //
     // pz2.js event handlers:
     //
@@ -287,6 +298,7 @@ function _make_mkws_team($, teamName) {
        m_paz.bytarget();
     }
 
+
     function my_onshow(data) {
        totalRec = data.merged;
        // move it out
@@ -338,6 +350,7 @@ function _make_mkws_team($, teamName) {
             '<span class="records">' + M('Retrieved records') + ': ' + data.records + '/' + data.hits + '</span>';
     }
 
+
     function my_onterm(data) {
        // no facets
        if (!mkws_config.facets || mkws_config.facets.length == 0) {
@@ -369,6 +382,7 @@ function _make_mkws_team($, teamName) {
            replaceHtml(termlist, acc.join(''));
     }
 
+
     function add_single_facet(acc, caption, data, max, pzIndex) {
        acc.push('<div class="facet" id="mkwsFacet' + caption + '">');
        acc.push('<div class="termtitle">' + M(caption) + '</div>');
@@ -390,6 +404,7 @@ function _make_mkws_team($, teamName) {
        acc.push('</div>');
     }
 
+
     function my_onrecord(data) {
        // FIXME: record is async!!
        clearTimeout(m_paz.recordTimer);
@@ -402,6 +417,7 @@ function _make_mkws_team($, teamName) {
        recordDiv.innerHTML += html;
     }
 
+
     function my_onbytarget(data) {
        var targetDiv = document.getElementById("mkwsBytarget");
        if (!targetDiv) {
@@ -432,6 +448,7 @@ function _make_mkws_team($, teamName) {
     ////////////////////////////////////////////////////////////////////////////////
     ////////////////////////////////////////////////////////////////////////////////
 
+
     // wait until the DOM is ready
     function domReady ()
     {
@@ -445,6 +462,7 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     // when search button pressed
     function onFormSubmitEventHandler()
     {
@@ -452,6 +470,7 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     function newSearch(query, sort, targets, windowid)
     {
        debug("newSearch: " + query);
@@ -470,6 +489,7 @@ function _make_mkws_team($, teamName) {
        submitted = true;
     }
 
+
     function onSelectDdChange()
     {
        if (!submitted) return false;
@@ -479,12 +499,14 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     function resetPage()
     {
        curPage = 1;
        totalRec = 0;
     }
 
+
     function triggerSearch (query, sort, targets, windowid)
     {
        var pp2filter = "";
@@ -532,6 +554,7 @@ function _make_mkws_team($, teamName) {
        m_paz.search(m_query, recPerPage, m_sort, pp2filter, undefined, params);
     }
 
+
     function loadSelect ()
     {
        if (document.mkwsSelect) {
@@ -542,6 +565,7 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     // limit the query after clicking the facet
     mkws.limitQuery = function (field, value)
     {
@@ -554,6 +578,7 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     // limit by target functions
     mkws.limitTarget  = function (id, name)
     {
@@ -566,6 +591,7 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     mkws.delimitQuery = function (field, value)
     {
        debug("delimitQuery(field=" + field + ", value=" + value + ")");
@@ -685,14 +711,15 @@ function _make_mkws_team($, teamName) {
             + prev + predots + middle + postdots + next + '</div>';
     }
 
+
     mkws.showPage = function (pageNum)
     {
        curPage = pageNum;
        m_paz.showPage( curPage - 1 );
     }
 
-    // simple paging functions
 
+    // simple paging functions
     mkws.pagerNext = function () {
        if ( totalRec - recPerPage*curPage > 0) {
             m_paz.showNext();
@@ -700,13 +727,14 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     mkws.pagerPrev = function () {
        if ( m_paz.showPrev() != false )
             curPage--;
     }
 
-    // switching view between targets and records
 
+    // switching view between targets and records
     mkws.switchView = function(view) {
        debug("switchView: " + view);
 
@@ -740,6 +768,7 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     // detailed record drawing
     mkws.showDetails = function (prefixRecId) {
        var recId = prefixRecId.replace('mkwsRec_', '');
@@ -762,6 +791,7 @@ function _make_mkws_team($, teamName) {
        m_paz.record(recId);
     }
 
+
     function replaceHtml(el, html) {
        var oldEl = typeof el === "string" ? document.getElementById(el) : el;
        /*@cc_on // Pure innerHTML is slightly faster in IE
@@ -776,6 +806,7 @@ function _make_mkws_team($, teamName) {
        return newEl;
     };
 
+
     function renderDetails(data, marker)
     {
        var template = loadTemplate("Record");
@@ -1018,6 +1049,7 @@ function _make_mkws_team($, teamName) {
        return nvpair;
     }
 
+
     function mkws_set_lang()  {
        var lang = parseQuerystring().lang || mkws_config.lang;
        if (!lang || !mkws.locale_lang[lang]) {
@@ -1030,6 +1062,7 @@ function _make_mkws_team($, teamName) {
        return mkws_config.lang;
     }
 
+
     function mkws_html_switch() {
        debug("HTML switch");
 
@@ -1045,6 +1078,7 @@ function _make_mkws_team($, teamName) {
        $("#mkwsTargets").css("display", "none");
     }
 
+
     function mkws_html_sort() {
        debug("HTML sort, m_sort = '" + m_sort + "'");
        var sort_html = '<select name="mkwsSort" id="mkwsSort">';
@@ -1065,6 +1099,7 @@ function _make_mkws_team($, teamName) {
        return sort_html;
     }
 
+
     function mkws_html_perpage() {
        debug("HTML perpage");
        var perpage_html = '<select name="mkwsPerpage" id="mkwsPerpage">';
@@ -1083,6 +1118,7 @@ function _make_mkws_team($, teamName) {
        return perpage_html;
     }
 
+
     /*
      * Run service-proxy authentication in background (after page load).
      * The username/password is configured in the apache config file
@@ -1118,6 +1154,7 @@ function _make_mkws_team($, teamName) {
        });
     }
 
+
     /* create locale language menu */
     function mkws_html_lang() {
        var lang_default = "en";
@@ -1160,6 +1197,7 @@ function _make_mkws_team($, teamName) {
        $("#mkwsLang").html(data);
     }
 
+
     function mkws_resize_page () {
        var list = ["mkwsSwitch"];
 
@@ -1187,6 +1225,7 @@ function _make_mkws_team($, teamName) {
        }
     };
 
+
     /* locale */
     function M(word) {
        var lang = mkws_config.lang;
@@ -1196,6 +1235,8 @@ function _make_mkws_team($, teamName) {
 
        return mkws.locale_lang[lang][word] || word;
     }
+    mkws.M = M; // so the Handlebars helper can use it
+
 
     // main
     (function() {