Project

img_cloud

0.0
No commit activity in last 3 years
No release in over 3 years
ruby gem for img cloud, upload/transform images
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 3.2.0, ~> 3.2
~> 1.5
~> 10.0
~> 3.2
>= 1.8.0, ~> 1.8

Runtime

>= 2.0.0, ~> 2.0
 Project Readme

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

  1. Fork it ( https://github.com/[my-github-username]/img_cloud/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request