Payment Icons is a simple Ruby on Rails engine extracted from Shopify. Shopify supports multiple payment methods through gems like Active Merchant and Offsite Payments. This has lead to an accumulation of icons for various payment methods. This gem provides easy access to those icons and helpful methods to integrate them into any Ruby on Rails app.
You can check out the latest source from git:
git clone https://github.com/activemerchant/payment_icons.git
Run gem install payment_icons
in your console.
If you'd like to add it to your existing Rails project, include gem 'payment_icons'
in your Gemfile and run bundle install
.
Once the gem is part of your Rails project, the PaymentIcon frozen record model will be available anywhere in your application. You also have access to all the icons with the path app/assets/images/payment_icons/<icon_name.svg>
.
For example:
<% PaymentIcon.credit_cards.each do |card| %>
<div>
<%= image_tag card.path %>
</div>
<% end %>
For information on adding or updating payment icons, see our CONTRIBUTING.md file.
This information is for project maintainers:
Requirements
- Ruby version: >= 2.5.0
- Bundler 2.0.2 (
gem install bundler:2.0.2
)
Any updates that add new icons, or change the style of existing ones, are to be considered patches (i.e. v1.0.X
).
To create a new release:
git fetch --tags --force
to refresh tagsgit pull origin master
to pull latest changes to your local environment- Change version in
lib/<gem name>/version.rb
- Run
bundle install
git tag -a v<version>
- If prompted, make a comment about this version bump. i.e. "Adds icons X and Y"
- Commit the changes:
git commit -m 'Bump to <version>'
git push --tags origin master
- Contact a maintainer in Shopify to release the new version via ShipIt.
Once deployed via ShipIt, you will see a new release at https://rubygems.org/gems/payment_icons