kotovalexarian-likes-github
/
rails--rails
mirror of https://github.com/rails/rails.git
1
0
Fork 0
Code Releases Activity

Merge pull request #42174 from rails/fix-action-mailer-basics-guide

This commit is contained in:
Zachary Scott 2021-05-08 21:31:48 +09:00 committed by GitHub
parent e2e2ed40ef acbecc4ad2
commit cb2ed015a7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
guides/source/action_mailer_basics.md
View File

@ -877,13 +877,14 @@ class SandboxEmailInterceptor
end
```
Before the interceptor can do its job you need to register it using
[`register_interceptor`][]. You can do this in an initializer file like
`config/initializers/sandbox_email_interceptor.rb`:
Before the interceptor can do its job you need to register it using the `interceptors` config option.
You can do this in an initializer file like `config/initializers/mail_interceptors.rb`:
```ruby
if Rails.env.staging?
ActionMailer::Base.register_interceptor(SandboxEmailInterceptor)
Rails.application.configure do
if Rails.env.staging?
config.action_mailer.interceptors = %w[SandboxEmailInterceptor]
end
end
```
@ -892,8 +893,6 @@ production like server but for testing purposes. You can read
[Creating Rails Environments](configuring.html#creating-rails-environments)
for more information about custom Rails environments.
[`register_interceptor`]: https://api.rubyonrails.org/classes/ActionMailer/Base.html#method-c-register_interceptor
### Observing Emails
Observers give you access to the email message after it has been sent. An observer class must implement the `:delivered_email(message)` method, which will be called after the email is sent.
@ -906,11 +905,11 @@ class EmailDeliveryObserver
end
```
Similar to interceptors, you must register observers using [`register_observer`][]. You can do this in an initializer file
like `config/initializers/email_delivery_observer.rb`:
Similar to interceptors, you must register observers using the `observers` config option.
You can do this in an initializer file like `config/initializers/mail_observers.rb`:
```ruby
ActionMailer::Base.register_observer(EmailDeliveryObserver)
Rails.application.configure do
config.action_mailer.observers = %w[EmailDeliveryObserver]
end
```
[`register_observer`]: https://api.rubyonrails.org/classes/ActionMailer/Base.html#method-c-register_observer