alooma-js

Alooma JavaScript Library

The Alooma JavaScript Library is a set of methods attached to a global Alooma object intended to be used by websites wishing to send data to Alooma projects. A full reference is available here.

Alternative installation via Bower

alooma-js is also available via front-end package manager Bower. After installing Bower, fetch into your project's bower_components dir with:

bower install alooma

Using Bower to load the snippet

You can then load the lib via the embed code (snippet) with a script reference:

<script src="bower_components/alooma/alooma-jslib-snippet.min.js"></script>

which loads the latest library version from the Alooma CDN (http://cdn.alooma.com/libs/alooma-latest.min.js).

Using Bower to load the entire library

If you wish to load the specific version downloaded in your Bower package, there are two options.

• Override the CDN library location with the global ALOOMA_CUSTOM_LIB_URL var:

<script>
  window.ALOOMA_CUSTOM_LIB_URL = 'bower_components/alooma/alooma.js';
</script>
<script src="bower_components/alooma/alooma-jslib-snippet.min.js"></script>

or

• Recompile the snippet with a custom ALOOMA_LIB_URL using Closure Compiler:

java -jar compiler.jar --js alooma-jslib-snippet.js --js_output_file alooma-jslib-snippet.min.js --compilation_level ADVANCED_OPTIMIZATIONS --define='ALOOMA_LIB_URL="bower_components/alooma/alooma.js"'

Running tests

• Install development dependencies: npm install
• Start test server: npm start
• Browse to http://localhost:3000/tests/ and choose a scenario to run

In the future we plan to automate the last step with a headless browser to streamline development (although Alooma production releases are tested against a large matrix of browsers and operating systems).