we are using service-proxy by default
[mkws-moved-to-github.git] / experiments / spclient / README
index 912f5c3..bcd492c 100644 (file)
@@ -55,8 +55,9 @@ do so many things, but that's not quite trivial.)
 Then the following special <div>s can be added (with no content), and
 will be filled in by MKWS:
     <div id="mkwsSwitch"></div> -- switch between record and target views
+    <div id="mkwsLang"></div>   -- switch between English, Danish and German
     <div id="mkwsSearch"></div> -- search box and button
-    <div id="mkwsRecords"></div> -- result list, including pager/sorting
+    <div id="mkwsResults"></div> -- result list, including pager/sorting
     <div id="mkwsTargets"></div> -- target list, including status
     <div id="mkwsStat"></div> -- summary statistics
 
@@ -70,26 +71,58 @@ You can configure and control the client with the JavaScript mkws_config object.
 Here is an example of all possible options
     <script type="text/javascript">
         var mkws_config = {
-                use_service_proxy: false,   /* true, flase */
-                switch: true,              /* true, false */
+                use_service_proxy: true,    /* true, flase: use service proxy instead pazpar2 */
+               switch_menu: true,          /* true, false: show/hide Records|Targets menu */
+               lang_menu: true,            /* true, false: show/hide language menu */
+               sort_menu: true,            /* true, false: show/hide sort menu */
+               perpage_menu: true,         /* true, false: show/hide perpage menu */
+               lang_display: ["en", "de", "da"], /* display languages links for given
+                                                    languages, [] for all */
+               facets: ["sources", "subjects", "authors"], /* display facets, in this order, [] for none */
                 sort_default: "relevance",  /* "relevance", "title:1", "date:0", "date:1" */
                query_width: 50,            /* 5..50 */
                 perpage_default: 20,       /* 10, 20, 30, 50 */
                 lang: "en",                 /* "en", "de", "da" */
+               debug: 0,                   /* debug level for development: 0..2 */
 
+               responsive_design: false    /* true, false: resize for smaller mobile devices */
                pazpar2_url: "/pazpar2/search.pz2",        /* URL */
                service_proxy_url: "/service-proxy/",      /* URL */
                service_proxy_auth: "/service-proxy-auth", /* URL */
          };
     </script>
 
+Note: the mkws_config object which must be loaded before the mkws.js and pz2api.js files.
+
+Supported Browsers
+------------------
+
+Any modern HTML5 browser will work fine. JavaScript must be enabled.
+
+* IE8 or later
+* Firefox 17 or later
+* Google Chrome 27 or later
+* Safari 6 or later
+* Opera  12 or later
+* iOS 6.x (iPhone, iPad)
+* Android 4.x
+
+Not supported: IE6, IE7
+
+New Features since jsdemo
+--------------------------
+- multilinguality: English (default), Danish, German
+- depends on the new pazpar2 JS library libjs-pz2/pz2api.1.js
+  which will make the development of pazpar2 plugins faster and
+  easier to share code between projects
+- supports basic pazpar2 and service-proxy requests
+- simplified HTML
+- the search page is fully configurable by a JSON object
+
+
 What next?
 ----------
 
 Main areas of work:
-* Fix cross-site issues proper
 * Make MKWS robust to missing widgets
-* Make CSS more tightly targeted at MKWS elements only
-* Make CSS prettier
-* Embed in a real, existing, site
 * Clean up the code