# Paperclip::Qiniu

storage [paperclip](https://github.com/thoughtbot/paperclip/) attachments to http://qiniutek.com

example project: https://github.com/lidaobing/paperclip-qiniu-example

example site: http://paperclip-qiniu-example.herokuapp.com/

if you are using Rails 3, please use version  0.1.0: https://rubygems.org/gems/paperclip-qiniu/versions/0.1.0

## Usage

* confirm you are working on a rails app

* add following line to `Gemfile`

```ruby
gem 'paperclip'
gem 'paperclip-qiniu'
# or get the latest version
# gem 'paperclip-qiniu', :git => "git://github.com/lidaobing/paperclip-qiniu"
```

* create `config/initializers/paperclip.rb`

```ruby
Paperclip::Attachment.default_options[:storage] = :qiniu
Paperclip::Attachment.default_options[:qiniu_credentials] = {
  :access_key => ENV['QINIU_ACCESS_KEY'] || raise("set env QINIU_ACCESS_KEY"),
  :secret_key => ENV['QINIU_SECRET_KEY'] || raise("set env QINIU_SECRET_KEY")
}
Paperclip::Attachment.default_options[:bucket] = 'paperclip-qiniu-example'
Paperclip::Attachment.default_options[:use_timestamp] = false
Paperclip::Attachment.default_options[:qiniu_host] =
  'http://cdn.example.com'
```

for more information on `qiniu_host`, read http://docs.qiniutek.com/v2/sdk/ruby/#publish

* add a model like this

```ruby
class Image < ActiveRecord::Base
  attr_accessible :file
  has_attached_file :file, :path => ":class/:attachment/:id/:basename.:extension"
  validates :file, :attachment_presence => true
  validates_attachment_content_type :file, :content_type => /\Aimage\/.*\Z/
end
```

* show image in your view

```erb
<%= qiniu_image_tag @image.file.url, :thumbnail => '300x300>', :quality => 80 %>
or
<%= image_tag qiniu_image_path(@image.file.url, :thumbnail => '300x300>', :quality => 80) %>
```

support options: `thumbnail`, `gravity`, `crop`, `quality`, `rotate`, `format`, `auto_orient`. for more information on these options, check the document: http://docs.qiniutek.com/v3/api/foimg/#fo-imageMogr

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

## CHANGELOG

### 0.1.1 (2015-01-06)

* upgrade Ruby SDK from `qiniu-rs` to `6.4.1`

### 0.1.0 (2012-09-06)

* add view helper: qiniu_image_tag, qiniu_image_path
* update demo code, style is no longer needed.

### 0.0.3 (2012-09-06)

* support qiniu api v3.

### 0.0.2 (2012-07-17)

* support public host.

### 0.0.1

* it works.