0.0
No release in over a year
collection of helpers to simplify live for use thumbor with rails and alchemy
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

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.