ThumborHelpers - WIP
A collection of helpers/overrides to simplify live for use thumbor with rails and alchemy. The concept is to install the gem in a project and without change of code have access to features of thumbor.
Thumbor documentation: https://thumbor.readthedocs.io/en/latest/index.html
Installation
Add this line to your application's Gemfile:
gem 'thumbor_helpers'
And then execute:
$ bundle install
And then install the initializer:
$ bin/rails generate thumbor_helpers:initializer
Now go in config/initializers and configure the thumbors with the server creadentials.
Usage
When enabled the helpers replace de standard url method of picture and create the absolute url to work with and instance of thumbor. You can bypass globaly by setting in the configurations to disable thumbor, or you can pass to url an optional parameter to single disable thumbor. ES:
record.picture.url(thumbor_disable:true)
Configurations WIP
- allowed_image_extensions:
regexp to filter what type of images let thumbor elaborate.
Default:[/(.*\.jpe?g|.*\.png)/
Development
Start a thumbor server with the command:
docker run --network host -e THUMBOR_PORT=8888 -e SECURITY_KEY='1234567890123456' -e AUTO_WEBP='True' -e ALLOW_UNSAFE_URL='False' beeyev/thumbor-s3:7.4-slim-alpine thumbor
Version Release
To release a new version, update the version number in version.rb
, and then run bundle exec rake release
,
which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/thumbor_helpers.
License
The gem is available as open source under the terms of the MIT License.