Title: WP CoffeeScript
Author: tombenner
Published: <strong>January 9, 2012</strong>
Last modified: January 9, 2012

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/wp-coffeescript.svg)

# WP CoffeeScript

 By [tombenner](https://profiles.wordpress.org/tombenner/)

[Download](https://downloads.wordpress.org/plugin/wp-coffeescript.1.0.zip)

 * [Details](https://twd.wordpress.org/plugins/wp-coffeescript/#description)
 * [Reviews](https://twd.wordpress.org/plugins/wp-coffeescript/#reviews)
 *  [Installation](https://twd.wordpress.org/plugins/wp-coffeescript/#installation)
 * [Development](https://twd.wordpress.org/plugins/wp-coffeescript/#developers)

 [Support](https://wordpress.org/support/plugin/wp-coffeescript/)

## Description

WP CoffeeScript is a WordPress plugin that makes enqueueing [CoffeeScript](http://coffeescript.org)
as easy as enqueueing JavaScript. Instead of using [`wp_enqueue_script()`](https://codex.wordpress.org/Function_Reference/wp_enqueue_script),
as you would for JS, you just use `enqueue_coffeescript()`, which takes almost exactly
the same arguments. The only difference is that the second argument should be the
file path instead of the URL. If you’d like to compile multiple CS files into a 
single JS file, you can use an array of file paths as the second argument.

Please note that the [CoffeeScript executable](http://coffeescript.org/#installation)
must be installed on the server. You can also set a custom path to the executable(
see the [examples](https://github.com/tombenner/wp-coffeescript)).

If you’d like to grab development releases, see what new features are being added,
or browse the source code please visit the [GitHub repo](http://github.com/tombenner/wp-coffeescript).

### Examples

Enqueue a CoffeeScript file that’s in the theme directory:

    ```
    enqueue_coffeescript('my-handle', get_template_directory().'/my-script.coffee');
    ```

Enqueue multiple CS files, compiling them into a single output file:

    ```
    $script1 = get_template_directory().'/script1.coffee';
    $script2 = get_template_directory().'/script2.coffee';
    enqueue_coffeescript('my-handle', array($script1, $script2));
    ```

Enqueue a CS file in the footer with dependencies (the arguments are exactly the
same as in [`wp_enqueue_script()`](https://codex.wordpress.org/Function_Reference/wp_enqueue_script)):

    ```
    enqueue_coffeescript('my-handle', get_template_directory().'/my-script.coffee', array('dep1', 'dep2'), false, true);
    ```

Set a custom path to the CS executable (the default value is `coffeescript`):

    ```
    add_filter('wpcs_executable', 'set_wpcs_executable');
    function set_wpcs_executable($path) {
        return '/my/path/to/coffeescript';
    }
    ```

Compile the CS on every page load (the default behavior is to only compile when 
the JS has been modified):

    ```
    add_filter('wpcs_caching_enabled', 'disable_wpcs_caching');
    function disable_wpcs_caching($is_enabled) {
        return false;
    }
    ```

## Installation

 1. Put `wp-coffeescript` into the `wp-content/plugins` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Make sure that the [CoffeeScript executable](http://coffeescript.org/#installation)
    is installed on the server or set a custom path to the executable (see the [examples](https://github.com/tombenner/wp-coffeescript))

## FAQ

  Where should I go for support questions or to ask for a new feature?

Please feel free to either add a topic in the WordPress forum or contact me through
GitHub for any questions:

 * [WordPress Forum](https://wordpress.org/tags/wp-coffeescript?forum_id=10)
 * [GitHub](http://github.com/tombenner)

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WP CoffeeScript” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ tombenner ](https://profiles.wordpress.org/tombenner/)

[Translate “WP CoffeeScript” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-coffeescript)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-coffeescript/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/wp-coffeescript/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-coffeescript/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-coffeescript/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **1.0**
 *  Last updated **14 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **3.3.2**
 *  Language
 * [English (US)](https://wordpress.org/plugins/wp-coffeescript/)
 * Tags
 * [coffeescript](https://twd.wordpress.org/plugins/tags/coffeescript/)[cs](https://twd.wordpress.org/plugins/tags/cs/)
   [development](https://twd.wordpress.org/plugins/tags/development/)[javascript](https://twd.wordpress.org/plugins/tags/javascript/)
   [JS](https://twd.wordpress.org/plugins/tags/js/)
 *  [Advanced View](https://twd.wordpress.org/plugins/wp-coffeescript/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/wp-coffeescript/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-coffeescript/reviews/)

## Contributors

 *   [ tombenner ](https://profiles.wordpress.org/tombenner/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-coffeescript/)