Rails Integration for Plupload

This gem integrates Plupload with Rails. It's been tested with Rails 3.1, 3.2 and 4.0.

Install

Just add it got your Gemfile:

gem 'plupload-rails'

Quick Start

Add to your application.js:

// plupload.js => plupload-2.1.0/js/plupload.full.min.js
//= require plupload

// optional, only needed if you'd like to use plupload localized
//= require plupload/i18n/zh_CN

// optional, but recommended. it sets generic settings like flash url, etc.
//= require plupload.settings

// optional, only if you want to use the jquery pluploadQueue
// jquery.plupload.queue.js => plupload-2.1.0/js/jquery.plupload.queue/jquery.plupload.queue.min.js
//= require jquery.plupload.queue

// optional, only if you want to use the jquery ui plupload
// jquery.ui.plupload.js => plupload-2.1.0/js/jquery.ui.plupload.jquery.ui.plupload.min.js
//= require jquery.ui.plupload

Add to your application stylesheet:

//= require jquery.plupload.queue

Simple example Haml for your views:

div#uploader
:javascript
  $(function(){
    $("#uploader").pluploadQueue({
      runtimes: 'gears,flash,silverlight,browserplus,html5',
      url: '#{images_path}',
      multipart_params: {
        '#{request_forgery_protection_token}': '#{form_authenticity_token}',
        '#{Rails.application.config.session_options[:key]}': '#{request.session_options[:id]}'
      }
    });
  });

And the same in ERB:

<script>
  $(function(){
    $("#uploader").pluploadQueue({
      runtimes: 'html5,flash,silverlight',
      url: '<%= sink_hole_path %>',
      multipart_params: {
        '<%= request_forgery_protection_token %>': '<%= form_authenticity_token %>',
        '<%= Rails.application.config.session_options[:key] %>': '<%= request.session_options[:id] %>'
      }
    });
  });
</script>

Updating

When new versions of Plupload are released, simply update the gem to the latest version. When you notice that there's no gem for the latest plupload, please contact me (or even better, create an issue/ pull request).

License

Dual licensed under the GPLv2 license and the MIT license. Plupload itself (including the JS, CSS, images, the Silverlight and Flash components) is licensed under GPLv2, unless you have acquired a commercial license.

Copyright © 2011-2013 Corin Langosch and contributors