Thursday, 29 August 2013

Manage features in Rails application with feature_flags

You must have faced situation while developing to turn off/on some features in your rails application. So here is ruby gem feature_flags that provides this functionality.Using this we can maintain different features in rails application.
So to add gem in your Rails application,
Add this line to your application’s Gemfile:
gem 'feature_flags'
 then run command
rails generate feature_flags:install

this will generate 3 files,
1) initializer file in config/initializer/feature_flags.rb
2) migration file for Feature model
3) Feature.rb
also it add routes in your rails application
resources :features
 then do
rake db:migrate
In feature_flags.rb initializer file you can mention which layout to use for view
FeatureFlags.configure do |config|
  config.layout = "application" 
FeatureFlags.enabled?(:feature_name) To check whether feature is enabled or not 

FeatureFlags.enable_all                   To enable all features in your app.

FeatureFlags.disable_all                  To disable all features in your app.

FeatureFlags.set_disabled(:feature_name)  To disable feature in your app.

FeatureFlags.create_and_enable(:feature_name)  To create and enable feature

FeatureFlags.enable(feature_name)         To enable feature

If you want to generate views then use,
rails generate feature_flags:views

It will also solve branching problem in rails application, as we merge branches having different features and then solving conflicts in feature_flags makes it easy, you just turn on/off that feature in app.
for example,
if FeatureFlags.enabled?(:feature_name1)
   # your code for feature_name1

Here are some screenshots, 
 main index view( /feature_flags )

 Adding new feature page,
Blog post for next version (0.1.0) click here

Wednesday, 24 April 2013

Deploying rails application on to OPENSHIFT + via RHC client tool

Want to deploy your Ruby on Rails application on openshift ?
then follow these steps,

1. Go to and create an account

2. Click MY APPS > Create an application ( and select Ruby on rails as the type of the application.

3. Put a name for your application. If this is your first time… make sure that you have  a unique namespace. You can change it here:

4.  Clone your git repo into your local machine via the ssh codes provided…

      Example: git clone ssh://
      cd railsapp/

5. or I recommend to use rhc client tool to create app on openshift

      sudo gem install rhc (first install gem rhc)
      rhc app create -a railsapp -t ruby-1.9

6. Then to add cartridge to your rails application use

      rhc cartridge add -a railsapp -c mysql-5.1

7. Then pull your code from github,

      git remote add upstream -m master git://
      git pull -s recursive -X theirs upstream master

8. Then you will need to change, your database.yml put this config for production only...


      adapter: mysql2
      encoding: utf8
      database: <%=ENV['OPENSHIFT_APP_NAME']%>
      pool: 5
      host: <%=ENV['OPENSHIFT_MYSQL_DB_HOST']%>
      port: <%=ENV['OPENSHIFT_MYSQL_DB_PORT']%>
      username: <%=ENV['OPENSHIFT_MYSQL_DB_USERNAME']%>
      password: <%=ENV['OPENSHIFT_MYSQL_DB_PASSWORD']%>
      socket: <%=ENV['OPENSHIFT_MYSQL_DB_SOCKET']%>

   Leave the development and test ENV under mysql adapter.

9. Now in your application directory look for .openshift folder

    there you will find .openshift/action_hooks/deploy file

     pushd ${OPENSHIFT_REPO_DIR} > /dev/null
       bundle exec rake db:migrate RAILS_ENV="production"
     popd > /dev/null

  commands written between pushd and popd lines will get executed automatically after code is updated on openshift,so if you have any other commands like starting resque, or copying some files after deploy then you can add it here.

10. Now that we have made our changes... push it!

      git add
      git commit -m “configures database.yml,gemfile and adds .openshift files”
      git push

11. That’s all, now check url for your rails app.

      here you will find all enviroment variables details that are available in openshift.

13. If you want to associate your own domain name eg. ( with your openshift rails app url then you will need to create url alias as shown below 

         rhc alias add railsapp

then change cname records in your DNS provider account.

14. If your application require some persistent directory for your data then you can use directory (app-root/data/) you can access this directory in your application using enviroment variable OPENSHIFT_DATA_DIR

15. If you want to remove a cartridge

      $rhc cartridge remove shortname –app appname –confirm

      $rhc cartridge remove mysql2  –app railsapp –confirm

Thursday, 28 February 2013

Stripe payment Integration in Rails

Hi ,
     Here is the simple way to integrate stripe into rails application, If you ever need to process credit card payments through your Rails applications you should take a look at Stripe. Stripe is a payment gateway that is easy to set up and which is very developer friendly. It only charges fees on a per-transaction basis and these are very reasonable. There are no monthly fees or other hidden costs. (By the way we’re not being paid to say this.)

Stripe is currently only available in the United States so you’ll need an account at a U.S. bank if you want to use it in your applications. International support is being worked on, however, and should be available soon. This doesn’t mean that you can’t bill international customers, the only restriction is that the seller must be in the U.S.

1) create stripe account at Stripe

2) add gem to gemfile =>  

 gem 'stripe' 

3) create config/initializers/stripe.rb  and add follwing lines (stripe keys)  to it

  Stripe.api_key : your_stripe_api_key 
  STRIPE_PUBLIC_KEY : your_stripe_public_key 
    You will get these keys from your stripe account


4) add these 2 lines to layouts/application.html.erb

<%= javascript_include_tag "", "application" %>
<%= tag :meta, :name => "stripe-key", :content => STRIPE_PUBLIC_KEY %>

this will add Stripe’s Javascript API and set stripe publishable key

 then create form for payment:

<% form_tag(your_payment_path, :method=>'post',:id=>"stripe-form") do %>
  <div class="field">
    <%= f.label :email %>
    <%= f.text_field :email %>
  <div class="field">
    <%= label_tag :card_number, "Credit Card Number" %>
    <%= text_field_tag :card_number, nil, name: nil,:class=>'credit-number' %>
  <div class="field">
    <%= label_tag :card_code, "Security Code on Card (CVV)" %>
    <%= text_field_tag :card_code, nil, name: nil,:class=>'credit-security' %>
  <div class="field">
    <%= label_tag :card_month, "Card Expiration" %>
    <%= select_month nil, {add_month_numbers: true}, {name: nil, id: "card_month",:class => "card-expiry-month"} %>
    <%= select_year nil, {start_year:, end_year:}, {name: nil, id: "card_year",:class => "card-expiry-year"} %>
<% end %>
<div id="stripe_error">
  <noscript>JavaScript is not enabled and is required for this form. First enable it in your web browser   settings.

  make sure these payment information should not get saved in your database,
  Next, we’ll need Stripe’s Javascript API:

  then add following javascript to handle payment form request to stripe,

function stripeResponseHandler(status, response) {
  if (response.error) {
  else {
    var form$ = $("#stripe-form");
    var token = response['id'];
    form$.append("<input type='hidden' name='stripeToken' value='" + token + "'/>");
  $(document).ready(function() {
    $("#stripe-form").submit(function(event) {
      $('.signup-button').attr("disabled", "disabled");
      Stripe.createToken({ number: $('.credit-number').val(),
                           cvc: $('.credit-security').val(),
                           exp_month: $('.card-expiry-month').val(),
                           exp_year: $('.card-expiry-year').val()
                         }, stripeResponseHandler);
return false;
5)  then on submitting form create stripe customer, that will make user to get subscribed to plan with id 'stripe_plan_id'.
    To create a new plan, go into the dashboard, then, into plans, and, from there, there’s a nice little “wizard” that’ll walk you through the process.
    you can specify a trial period for your users, so, if you want them to have 15 days free, you just have to set it up on the dashboard – no code needed! 

Stripe::Customer.create(email: users email , card: params['stripeToken'], plan: stripe_plan_id)

 after creating customer stripe will send stripe_customer_token. Make sure u store this token in database associating to that particular user, in order to access stripe customer associated with particular user registered in your application.

6) In order to handle stripe errors you can check out this link
7) Next thing you will need to add (as per your application's requirement) catching stripe events which are sent by stripe on every transactions
   you can check all types of events here-
8) in your stripe account add webhook url as http://your-url/stripe_events

    then  in routes.rb
match "/stripe_events", :to => "events#stripe_events", :as => :stripe_events, :via => :post

    and now you can catch stripe events in events_controller/stripe_events
class EventsController < ApplicationController
  protect_from_forgery :except => [ :stripe_events ]
  def stripe_events
    # params['type'] will give u type of stripe event
    using these events you make the changes in your application like activating/deactivating users based on whether payment is done or not. 
9) If in case payment fails due some reason for subscription, you can manage it on stripe as shown in following image

10) or you can also use 'stripe_event' gem , that will also provide a way handle  stripe events.