Introduction
Setting up a mailer is a relatively straightforward task. It’s very similar to building a new controller and views. Once you’ve made a couple, it should come naturally.
WSL Setup for Letter Opener
If you encounter issues using the letter_opener gem on WSL, you can fix it by defining the file URI scheme for WSL in config/development.rb:
LetterOpener.configure do |config|
config.file_uri_scheme = 'file://wsl.localhost/Ubuntu'
end
You can double-check your file URI scheme using the following command in the WSL terminal:
wslpath -m /
You will also have to create an environment variable called BROWSER that contains the path to your browser of choice, and add it to ~/.bashrc. For example:
export BROWSER=/mnt/c/Program\ Files/Google/Chrome/Application/chrome.exe
This variable should point to your browser, i.e., it should contain the browser path.
Assignment
You’ll be dusting off your Flight Booker project and having it send out a “You have booked your ticket” confirmation email to all Passengers when they are created as part of the booking process. Make sure to send out one email to each Passenger in the Booking, not just one for the whole Booking. (Alternatively, you can use one of your other projects, as long as it has users registering.)
- Locate and load up the project file.
- Do some pushups and jumping jacks. You’ve been spending a bit too much time at the computer lately.
- Generate your new mailer with
$ rails generate mailer PassengerMailer. - Install the Letter Opener gem to open your emails in the browser instead of sending them in the development environment.
- Follow through the steps listed in the Rails Guide to create the action to send the confirmation email.
- Build both an
.html.erband.text.erbversion of your ticket confirmation email. - Test that the email sends by creating a new flight booking (
letter_openershould open it in the browser for you if you’ve set it up properly). -
Try out one other trick – call the mailer directly from the Rails Console using something like:
> PassengerMailer.confirmation_email(Passenger.first).deliver_now! - Extra Credit: Deploy it to a hosting provider and try it out. There will be a bit of additional setup to get something an email provider like SendGrid working and sending emails in production for you.
(One heads up: in order to use an email provider you will probably have to give your credit card information, they do this to deter spammers. You don’t have to pay for the service, but you do have to give your information.)
Additional resources
This section contains helpful links to related content. It isn’t required, so consider it supplemental.