Underscore.js

Provides Library API access to the Underscore.js JavaScript library.

Features (7.x-2.x)

• Makes Underscore.js available to other modules and custom code via the Library API
• Provides a drush command (underscore-download) to download and install the latest version of the library

Usage (7.x-2.x)

After enabling this module, install the Underscore.js JavaScript file:

• Without drush: Download underscore.js and store it in your libraries directory. In most cases the resulting path should be sites/all/libraries/underscore/underscore.js
• With drush: Run the command drush underscore-download

In your module code, add the library with libraries_load() and drupal_add_library(). If unsure where, add it in an implementation of hook_init(). Use 'underscore' for both the module and library name arguments, like this:

libraries_load('underscore');
drupal_add_library('underscore', 'underscore');

You can update your version of Underscore.js to the latest version by calling the drush command (drush underscore-download).

Upgrading from 7.x-1.x to 7.x-2.x

The 7.x-2.x branch is a rewrite of the existing module. Upgrading to the 7.x-2.x branch will require changes to your code. Notable changes to the module include:

• The actual Underscore.js JavaScript is no longer bundled with this module. It must be downloaded and installed manually or with the drush command provided in this module.
• The Underscore.js library is no longer enabled automatically. To use it, your code must call libraries_load() and drupal_add_library(). An example is provided in the section above.
• Now uses the library hooks provided by Libraries API module (rather than hook_library() from core).