filepicker-rails 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Max Tilford
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,69 @@
+# Filepicker::Rails
+
+Adds form, image_tag, and download/save helpers to help you get up and running with [filepicker.io](http://filepicker.io) in Rails.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'filepicker-rails'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install filepicker-rails
+
+Add the filepicker.io javascript library to your layout:
+
+    <%= filepicker_js_include_tag %>
+
+Set your API Key in config/application.rb:
+
+    config.filepicker_rails.api_key = "Your filepicker.io API Key"
+
+## Usage
+
+### Adding an upload field to your form:
+
+    <%= form_for @user do |f| %>
+      <div>
+        <%= f.label :avatar_url, "Upload Your Avatar:" %>
+        <%= f.filepicker_field :avatar_url %> <!-- User#avatar_url is a regular string column -->
+      </div>
+
+      <%= f.submit %>
+    <% end %>
+
+Full options list:
+* button_text - The text of the upload button.
+* button_class - The class of the upload button.
+* mimetypes - The file types you want to support for this upload. Ex: "image/png,text/*"
+* container - Where to show the file picker dialog can be "modal", "window" or the
+of an iframe on the page.
+* services - What services your users can upload to. Ex: "BOX, COMPUTER, FACEBOOK".
+
+
+### Displaying an image:
+
+    <%= filepicker_image_tag @user.avatar_url, w: 160, h: 160, fit: 'clip'
+
+See [the filepicker.io documentation](https://developers.filepicker.io/docs/web/#fpurl-images) for the full options list.
+
+
+### Allowing the user to download a file (or upload it to any of the supported services)
+
+    <%= filepicker_save_button "Save", @user.avatar_url, "image/jpg" %>
+
+Full options list:
+
+* container - Where to show the file picker dialog can be "modal", "window" or the
+of an iframe on the page.
+* services - What services your users can upload to. Ex: "BOX, COMPUTER, FACEBOOK".
+* save_as_name - A recommended file name. The user can override this.
+
+### Demo
+
+See a simple demo app [repo](https://github.com/maxtilford/filepicker-rails-demo) and [running on heroku](http://filepicker-rails-demo.herokuapp.com)

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/filepicker-rails.gemspec

@@ -0,0 +1,19 @@
+require File.expand_path('../lib/filepicker/rails/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Max Tilford"]
+  gem.email         = ["maxtilford@gmail.com"]
+  gem.description   = %q{Makes integrating filepicker.io with rails easy}
+  gem.summary       = %q{Makes integrating filepicker.io with rails easy}
+  gem.homepage      = "https://github.com/maxtilford/filepicker-rails"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "filepicker-rails"
+  gem.require_paths = ["lib"]
+  gem.version       = Filepicker::Rails::VERSION
+
+  gem.required_rubygems_version = ">= 1.3.6"
+  gem.add_dependency "railties", ">= 3.1.0", "< 5.0"
+end

data/lib/filepicker/rails/configuration.rb

@@ -0,0 +1,10 @@
+module Filepicker
+  module Rails
+    class Configuration
+      attr_writer :api_key
+      def api_key
+        @api_key or raise "Set config.filepicker_rails.api_key"
+      end
+    end
+  end
+end

data/lib/filepicker/rails/form_builder.rb

@@ -0,0 +1,30 @@
+module Filepicker
+  module Rails
+    module FormBuilder
+
+      def filepicker_field(method, options = {})
+        input_options = {
+          'data-fp-apikey' =>
+          ::Rails.application.config.filepicker_rails.api_key,
+
+          'data-fp-button-text' => options.fetch(:button_text, "Pick File"),
+
+          'data-fp-button-class' => options[:button_class],
+
+          'data-fp-mimetypes' => options[:mimetypes],
+
+          'data-fp-option-container' => options[:container],
+
+          'data-fp-option-multiple' => false,
+
+          'data-fp-option-services' => Array(options[:services]).join(","),
+        }
+
+        type = options[:dragdrop] ? 'filepicker-dragdrop' : 'filepicker'
+
+        ActionView::Helpers::InstanceTag.new(@object_name, method, @template)
+          .to_input_field_tag(type, input_options)
+      end
+    end
+  end
+end

data/lib/filepicker/rails/railtie.rb

@@ -0,0 +1,18 @@
+module Filepicker
+  module Rails
+
+    class Railtie < ::Rails::Railtie
+
+      config.filepicker_rails = Filepicker::Rails::Configuration.new
+
+      initializer "filepicker_rails.view_helpers" do
+        ActionView::Base.send(:include, Filepicker::Rails::ViewHelpers)
+      end
+
+      initializer "filepicker_rails.form_builder" do
+        ActionView::Helpers::FormBuilder.send(:include, Filepicker::Rails::FormBuilder)
+      end
+    end
+
+  end
+end

data/lib/filepicker/rails/version.rb

@@ -0,0 +1,5 @@
+module Filepicker
+  module Rails
+    VERSION = "0.0.1"
+  end
+end

data/lib/filepicker/rails/view_helpers.rb

@@ -0,0 +1,78 @@
+module Filepicker
+  module Rails
+
+    module ViewHelpers
+      def filepicker_js_include_tag
+        javascript_include_tag "//api.filepicker.io/v0/filepicker.js"
+      end
+
+      def filepicker_save_button(text, url, mimetype, options = {})
+        options[:data] ||= {}
+        container = options.delete(:container)
+        services = options.delete(:services)
+        save_as = options.delete(:save_as_name)
+
+        options[:data]['fp-url'] = url
+        options[:data]['fp-apikey'] = ::Rails.application.config.filepicker_rails.api_key
+        options[:data]['fp-mimetype'] = mimetype
+        options[:data]['fp-option-container'] = container if container
+        options[:data]['fp-option-services'] = Array(services).join(",") if services
+        options[:data]['fp-option-defaultSaveasName'] = save_as if save_as
+        button_tag(text, options)
+      end
+
+
+      def filepicker_image_tag(url, options={})
+        image_tag(filepicker_image_url(url, options),
+          width: options[:w],
+          height: options[:h],
+
+          alt: options[:alt])
+      end
+
+      # w - Resize the image to this width.
+      #
+      # h - Resize the image to this height.
+      #
+      # fit - Specifies how to resize the image. Possible values are:
+      #       clip: Resizes the image to fit within the specified parameters without
+      #             distorting, cropping, or changing the aspect ratio
+      #       crop: Resizes the image to fit the specified parameters exactly by
+      #             removing any parts of the image that don't fit within the boundaries
+      #       scales: Resizes the image to fit the specified parameters exactly by
+      #               scaling the image to the desired size
+      #       Defaults to "clip".
+      #
+      # crop - Crops the image to a specified rectangle. The input to this parameter
+      #        should be 4 numbers for 'x,y,width,height' - for example,
+      #        'crop=10,20,200,250' would select the 200x250 pixel rectangle starting
+      #        from 10 pixels from the left edge and 20 pixels from the top edge of the
+      #        image.
+      #
+      # format - Specifies what format the image should be converted to, if any.
+      #          Possible values are "jpg" and "png". For "jpg" conversions, you
+      #          can additionally specify a quality parameter.
+      #
+      # quality - For jpeg conversion, specifies the quality of the resultant image.
+      #           Quality should be an integer between 1 and 100
+      #
+      # watermark - Adds the specified absolute url as a watermark on the image.
+      #
+      # watersize - This size of the watermark, as a percentage of the base
+      #             image (not the original watermark).
+      #
+      # waterposition - Where to put the watermark relative to the base image.
+      #                 Possible values for vertical position are "top","middle",
+      #                 "bottom" and "left","center","right", for horizontal
+      #                 position. The two can be combined by separating vertical
+      #                 and horizontal with a comma. The default behavior
+      #                 is bottom,right
+      def filepicker_image_url(url, options = {})
+        query_params = options.slice(:w,:h,:fit,:crop,:format,:quality,
+          :watermark,:watersize,:waterposition).to_query
+        [url, "/convert?", query_params].join
+      end
+
+    end
+  end
+end

data/lib/filepicker-rails.rb

@@ -0,0 +1,10 @@
+require "filepicker/rails/version"
+require "filepicker/rails/configuration"
+require "filepicker/rails/form_builder"
+require "filepicker/rails/view_helpers"
+require "filepicker/rails/railtie"
+
+module Filepicker
+  module Rails
+  end
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: filepicker-rails
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Max Tilford
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Makes integrating filepicker.io with rails easy
+email:
+- maxtilford@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- filepicker-rails.gemspec
+- lib/filepicker-rails.rb
+- lib/filepicker/rails/configuration.rb
+- lib/filepicker/rails/form_builder.rb
+- lib/filepicker/rails/railtie.rb
+- lib/filepicker/rails/version.rb
+- lib/filepicker/rails/view_helpers.rb
+homepage: https://github.com/maxtilford/filepicker-rails
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Makes integrating filepicker.io with rails easy
+test_files: []