rails

ROR: Sending mail via MailGun

nikam.abhay1 — Sat, 12 Mar 2016 10:27:49 +0000

Introduction:

Send mail is the basic requirement of every web application. To start with setting up mailer for your ruby on rails project using Mailgun we should have a account of Mailgun to deliver messages.

To use Mailgun for sending mail visit: http://www.mailgun.com/ and create a account for your business requirement.

Creating a demo project:

Creating a sample project to setup mailer:

rails new sample_app

rails g scaffold user name:string email:string

rake db:migrate

now we have are web app ready to setup Action Mailer

Walkthrough to Generating a Mailer:

To create a mailer:

rails generate mailer UserMailer

create app/mailers/user_mailer.rb

create app/mailers/application_mailer.rb

invoke erb

create    app/views/user_mailer

create    app/views/layouts/mailer.text.erb

create    app/views/layouts/mailer.html.erb

invoke test_unit

create    test/mailers/user_mailer_test.rb

create    test/mailers/previews/user_mailer_preview.rb

Edit mailer file and a method to send mail to user:

classUserMailer < ApplicationMailer

# NOTE: Add default from mailer id

  default from: 'notifications@example.com'

  def welcome_email(user)

    mail(to: user.email, subject: 'Welcome to My Awesome Site')

  end

end

now create a view for mailer , this template will used for the email, formatted in HTML.

File: app/views/user_mailer/welcome_email_view.html.erb









    Welcome to example.com, <%= @user.name %>



      You have successfully signed up to example.com,

      your username is: <%= @user.login %>.





      To login to the site, just follow this link: <%= @url %>.



    Thanks for joining and have a great day!

now we are all set to send mail. We need a method where we can trigger or send mail.

classUsersController < ApplicationController

  # POST /users

  # POST /users.json

  defcreate

    @user= User.new(params[:user])

    respond_to do|format|

      if@user.save

        # Tell the UserMailer to send a welcome email after save

        UserMailer.welcome_email(@user).deliver_now

        format.html { redirect_to(@user, notice: 'User was successfully created.') }

        format.json { render json: @user, status: :created, location: @user}

      else

        format.html { render action: 'new'}

        format.json { render json: @user.errors, status: :unprocessable_entity}

      end

    end

  end

end

Send mail using Gmail:

To send mail using gmail we should have set some configuration. Before we proceed we need to save sensitive information such as username and password as environment variables. We will do so by using the gem figaro.

# File: /config/application.yml

username: ‘username@gmail.com’

password: ‘Gmail password’

Set config to send mail using SMTP:

# File: /config/environments/production.rb

config.action_mailer.delivery_method = :smtp

config.action_mailer.smtp_settings = {

  address:              'smtp.gmail.com',

  port:                 587,

  domain:               'example.com',

  user_name: ENV['username'],

  password:   ENV['password'],

  authentication:       'plain',

  enable_starttls_auto: true

}

When a new user is created we are sending out an email via the welcome_email method in mailer UserMailer.

Sending Email via MailGun:

As discussed above sending mail via mailgun require a mailgun account and its credentials so that we can send mail via mailgun smtp. Create a account with mailgun and we are all set to send mail.

# File: /config/application.yml

api_key: ‘API Key’

domain: ‘Domain’

username: ‘Default SMTP Login’

password: ‘Default Password’

username: ‘username@gmail.com’

password: ‘gmail password’

Now add config for mailgun:

config.action_mailer.delivery_method = :smtp
# SMTP settings for mailgun
config.action_mailer.smtp_settings = {
port: 587,
address: ”smtp.mailgun.org”,
domain: ENV['domain'],
user_name: ENV['username'],
password: ENV['password'],
authentication: :plain,
}

Sending mail via Mailgun API:

We need to first add a gem for using mailgun API:

# NOTE: File: gemfile.rb

gem ‘mailgun-ruby’, ‘~>1.0.2′, require: ‘mailgun’

bundle install

Setup welcome method for sending mail via API:

def sample_email(user)
@user = user
mg_client = Mailgun::Client.new ENV['api_key']
message_params = { from: ENV['username'],
to: @user.email,
subject: ‘Sample Mail using Mailgun API’,
text: ‘This mail is sent using Mailgun API via mailgun-ruby’

}
mg_client.send_message ENV['domain'], message_params
end

Conclusion:

We have setup ActionMailer to send welcome mail via gmail, mailgun and mailgun API. Now are basic mailer is setup and we are good to send mail.

ROR: Setting up devise and OmniAuth for Facebook

nikam.abhay1 — Sat, 05 Mar 2016 13:05:09 +0000

Introduction

I am a newbie to ruby on rails and I learned how to authenticate a user using devise and oauth so I thought i could share this with all of you. Before starting with how to start with user authentication using oauth for Facebook. We have some prerequisite that you should now and have in your system.

You should have ROR setup in your system(obviously you do have that why you here) and if you don’t visit https://www.digitalocean.com/community/tutorials/how-to-install-ruby-on-rails-on-ubuntu-12-04-lts-precise-pangolin-with-rvm

For user authentication from facebook, you need to have you app registered on facebook (https://developers.facebook.com/).

Creating new app

First, create a rails app:

rails new oauth_demo

You need to add oauth and devise gem to application:

# Devise gem gem 'devise' # OmniAuth gem gem 'omniauth' gem 'omniauth-facebook'

Install the gem by:

bundle install

Okay, now you are set to start to setup your user authentication using devise.

Setting up devise with oauth

To start with we need to install devise and create some view for devise(devise has a generators which build this file in no time for you).

rails generate devise:install rails generate devise user rake db:migrate rails generate devise:views users

Add apps/controller/application_controller.rb before filter to authenticate user by devise if (s)he is logged in the system.

before_filter :authenticate_user!

Run the rails server using rails s and hit http://localhost:3000/users/sign_in and check whether you sign in form or not.

Now, OAUTH

For oauth using facebook, as mentioned above you need to register your project to facebook.
In config/devise.rb you need to add:

config.omniauth :facebook, 'APP_ID', 'APP_SECRET'

Adding callback after successfully signed in. After sign in we have to add a callback methods which would be added in CallbackController. For that we need to change the routes to:

devise_for :users, controllers: { omniauth_callbacks: 'callbacks' }

This callback will basically get a auth json from facebook which we’ll have the required data need for authentication.

create a apps/controller/callbacks_controller.rb to handle the callback from facebook where you get the json from facebook.

class CallbacksController < Devise::OmniauthCallbacksController def facebook @user = User.from_omniauth(request.env["omniauth.auth"]) sign_in_and_redirect @user end end

Now using that json we can create a user

def self.from_omniauth(auth) where(provider: auth.provider, uid: auth.uid).first_or_create do |user| user.provider = auth.provider user.uid = auth.uid user.email = auth.info.email user.password = Devise.friendly_token[0,20] end end

Start your rails server and your good to go

Conclusion

We can have authentication using facebook, twitter, etc. so that user can log in with any of the social sites. If we are using twitter, facebook, etc. We need to care of few things like user can log in first using facebook and next time using something else. We need to manage that.