diff --git a/README.md b/README.md index 186d73e..bb8eb1b 100644 --- a/README.md +++ b/README.md @@ -122,6 +122,15 @@ You can configure the client (the JS part) via `data-` attributes: Make sure to escape the attribute value. +* data-prefix + + Isso usually detects the REST API automatically, but when you serve the JS + script on a different location, this may fail. Use `data-prefix` to + override the API location: + + ```html + + ``` ### Webserver configuration diff --git a/isso/js/app/api.js b/isso/js/app/api.js index 33cab7c..5bbd1c4 100644 --- a/isso/js/app/api.js +++ b/isso/js/app/api.js @@ -22,20 +22,51 @@ define(["q"], function(Q) { "/count": [200] }; - // guess Isso API location + /* + * Detect Isso API endpoint. There are typically two use cases: + * + * 1. use minified, single-file JavaScript. The browser interprets + * scripts sequentially, thus we can safely use the last script + * tag. Then, we chop off some characters -- /js/embed.min.s -- + * and we're done. + * + * If the script is not served by Isso directly, a custom data + * attribute can be used to override the default detection + * mechanism: + * + * .. code-block:: html + * + * + * + * 2. use require.js (during development). When using require.js, we + * assume that the path to the scripts ends with `/js/`. + * + */ + + var script, uri; + var port = window.location.port ? ":" + window.location.port : "", + host = window.location.protocol + "//" + window.location.hostname + port; + var js = document.getElementsByTagName("script"); for (var i = 0; i < js.length; i++) { - if (js[i].src.match("/js/components/requirejs/require\\.js$")) { - endpoint = js[i].src.substring(0, js[i].src.length - 35); - break; - } else if (js[i].src.match("/js/(embed|count)\\.(min|dev)\\.js$")) { - endpoint = js[i].src.substring(0, js[i].src.length - 16); - break; + if (js[i].src.match("require\\.js$") && js[i].dataset.main.match("/js/embed$")) { + uri = js[i].dataset.main; + endpoint = uri.substr(0, uri.length - "/js/main".length); } } if (! endpoint) { - throw "no Isso API location found"; + script = js[js.length - 1]; + + if (script.dataset.prefix) { + endpoint = script.dataset.prefix; + if (endpoint[endpoint.length - 1] === "/") { + endpoint = endpoint.substring(0, endpoint.length - 1); + } + } else { + uri = script.src.substring(host.length); + endpoint = uri.substring(0, uri.length - "/js/embed.min.js".length); + } } var curl = function(method, url, data) {