Integration of Plupload with the Rails asset pipeline
Ruby HTML
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app/assets/javascripts
lib
vendor/assets
.gitignore first commit Oct 4, 2011
GPL-LICENSE.txt
Gemfile
MIT-LICENSE.txt
README.md
Rakefile
plupload-rails.gemspec

README.md

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:

//= require moxie
//= require plupload.dev

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

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

// optional, only if you want to use the jquery integration
//= require jquery.plupload.queue

Add to your application stylesheet:

//= require jquery.plupload.queue

For Rails 4, add to config/initializors/assets.rb:

Rails.application.config.assets.precompile += %w( Moxie.swf Moxie.xap )

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