Перевод "Rails in a nutshell Chapter 5. Action Mailer"

Rails in a nutshell Chapter 5. Action Mailer

Chapter 5. Action Mailer

Action Mailer is a framework for sending and receiving email. It makes sending templated email, gracefully degrading HTML email, email with attachments, and receiving email simple, while abstracting away complex issues like MIME encoding and quoting. This chapter will cover all the most important aspects of Action Mailer including the generation of mailers, sending email, and the configuration and testing of mailers.

Generating Mailers

Rails provides a generator for creating new mailer models. The generator is passed the mailer name in underscored or camel case format followed by zero or more actions:

script/generate mailer mailer_name [action...]

The generator creates the following files:

*

mailer class in app/models.

*

view templates for each action in app/views/mailer_name.

*

unit test stub in test/unit.

*

test fixtures for each action in test/fixtures/mailer_name.

The following command generates a new mailer model class named OrderMailer with a single action confirmation:

$ script/generate mailer OrderMailer confirmation

create app/models/

create app/views/order_mailer

create test/unit/

create test/fixtures/order_mailer

create app/models/order_mailer.rb

create test/unit/order_mailer_test.rb

create app/views/order_mailer/confirmation.erb

create test/fixtures/order_mailer/confirmation

Sending Email

A mailer model's job is to encapsulate the creation and delivery of the different email messages that you need for a particular component of your application. For example, an OrderMailer would define all of the email messages for communicating with a customer regarding an order they've placed at your online store.

There are two parts to a mailer: the model and the view. The model portion is stored along with the rest of your models in app/models. The mailer's views are stored in a subdirectory, named after the mailer model, underneath app/views with the rest of your application's views. Therefore an OrderMailer model would itself be stored as app/models/order_mailer.rb and would look for its view templates under the directory app/views/order_mailer.