ImgCloud
ruby gem for img cloud. Uploading images will return image paths that can be then used in a helper tag to transform images.
Installation
Add this line to your application's Gemfile:
gem 'img_cloud'
And then execute:
$ bundle
Or install it yourself as:
$ gem install img_cloud
Usage
you can configure api key and base uri for the gem like this in an initializer
ImgCloud.configure do |config|
config.base_uri = 'http://www.imgcloud.io/' #optional
config.apiKey = 'f837dje0-4c99-11e5-a2ca-27ben7f17568' #required
end
Uploading Images
ImgCloud.upload(image_paths, tags, folder) # parameters => image_paths(required, array of strings), tags (optional, comma separated string) & folder (optional, string)
Deleting an image
ImgCloud.delete(path) #path is the urls(one of the) returned in the response for upload
Helper method for Image tag
img_cloud_tag image_path, options
Options:
parameters | Type |
---|---|
height, width, borderWidth, blur | Integer |
borderColor, class, style, alt, title | String |
sepia, grayscale, crop, scale | Boolean |
for borderColor color name, hex, rgb and rgba values are accepted. eg:- blue, #0000FF, rgb(0,0,255), rgba(0,0,255,0.3)
Example:
img_cloud_tag "/ic_4e1756/1440667545769_1436524274_car1.jpg", :width => 100, :height => 100, :sepia => true, :borderWidth => 5, :borderColor => 'red', :class => 'img_class', :style => "margin:10px"
displays a transformed image, accepts a relative image path and optional parameters. If the parameters are incorrect, it is not applied to the image.
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
to create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
- Fork it ( https://github.com/[my-github-username]/img_cloud/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request