Tag release v1.0.0 (re)release
fixed License, minor wording in CHANGELOG, and typo in package.json
4 files changed
tree: 88a59fb749384028ee12abe23cf7348b1ca26686
  1. build/
  2. example/
  3. src/
  4. test/
  5. .babelrc
  6. .eslintrc.json
  7. .gitignore
  8. CHANGELOG.md
  9. DISCLAIMER
  10. doap-userale.js.rdf
  11. gulpfile.js
  12. KEYS
  13. LICENSE
  14. NOTICE
  15. package-lock.json
  16. package.json
  17. README.md
README.md

Apache Flagon UserALE.js (Incubating)

Build Status License

The official JavaScript client for Apache Flagon.

Additional documentation can be found at http://flagon.incubator.apache.org/userale/

Prerequsites

Several dependencies are required, simply execute the following and you are good to go.

npm install

Build

To build UserALE.js:

npm run build

Test

To test UserALE.js:

npm run test

... you should eventually see something as follows

...
  26 passing (837ms)
  1 pending

Any failing tests will also be logged in the terminal. If there are failing tests, please consider logging an issue in JIRA.

Use and Configure

To include UserALE.js in your project:

<script src="/path/to/userale-1.0.0.min.js"></script>

HTML5 Data Parameters are used to configure UserALE.js. For example, to set the logging URL:

<script src="/path/to/userale-1.0.0.min.js" data-url="http://yourLoggingUrl"></script>

The complete list of configurable options is:

ParamDescriptionDefault
data-urlLogging URLhttp://localhost:8000
data-autostartShould UserALE.js start on page loadtrue
data-intervalDelay between transmit checks5000 (ms)
data-thresholdMinimum number of logs to send5
data-userUser identifiernull
data-versionApplication version identifiernull
data-log-detailsToggle detailed logs (keys pressed and input/change values)false
data-resolutionDelay between instances of high frequency logs (mouseover, scroll, etc.)500 (ms)
data-user-from-paramsQuery param in the page URL to fetch userId fromnull
data-toolName of tool being loggednull

Next Up

Our top priority is to improve the testing system and to complete test coverage. After that is complete:

  • Use web workers to remove load from main thread if available
  • Update the example server to present a simple test app/interface
  • Release UserALE.js through channels like NPM, Bower, etc.

Contributing

Contributions are welcome! Simply submit an issue report for problems you encounter or a pull request for your feature or bug fix. The core team will review it and work with you to incorporate it into UserALE.js.

License

Apache Flagon UserALE.js is provided under Apache License version 2.0. See LICENSE file for more details.