Home

Awesome

jQuery Django CSRF Plugin

Build Status

The djangocsrf jQuery plugin makes it easy to use AJAX calls with Django’s CSRF token.

Installation

Download and include the script after the jQuery library and the Cookie library:

<script src="https://code.jquery.com/jquery-1.9.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/gh/js-cookie/js-cookie@1.5.1/src/js.cookie.js"></script>
<script src="https://cdn.jsdelivr.net/gh/bfontaine/jquery-djangocsrf@0.1.1/jquery.djangocsrf.js"></script>

Usage

Enable the plugin:

$.djangocsrf( "enable" );

That’s all! After that, all AJAX calls made through jQuery to the current domain will include an X-CSRFToken header set to the client’s token.

Disable the plugin with $.djangocsrf( "disable" ), and query its current state with $.djangocsrf().

Tests

$ npm install -g grunt-cli
$ npm install -d

Requires Node. Start the server:

$ node test/server.js

Then open http://0.0.0.0:8124/test/index.html in your browser.

Basic tests can also be run with grunt.