From c94e92e2b080ef824bc63dae771173fd4f57e28e Mon Sep 17 00:00:00 2001
From: Aditya Sanghi <asanghi@me.com>
Date: Sat, 25 Sep 2010 14:31:19 +0530
Subject: Add section about multiple recipients

---
 railties/guides/source/action_mailer_basics.textile | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'railties/guides/source/action_mailer_basics.textile')

diff --git a/railties/guides/source/action_mailer_basics.textile b/railties/guides/source/action_mailer_basics.textile
index 8eb48e2751..16e611f285 100644
--- a/railties/guides/source/action_mailer_basics.textile
+++ b/railties/guides/source/action_mailer_basics.textile
@@ -242,6 +242,23 @@ end
                                             :class => 'photos' %>
 </erb>
 
+h5. Sending email to multiple recipients
+
+It is possible to send email to one or more recipients in one email (for e.g. informing all admins of a new signup) by setting the list of emails to the <tt>:to</tt> key. The <tt>to:</tt> key however expects a string so you have join the list of recipients using a comma.
+
+<ruby>
+  Class AdminMailer < ActionMailer::Base
+    default :to => Admin.all.map{|admin| admin.email}.join(", "),
+            :from => "notification@example.com"
+  
+    def new_registration(user)
+      @user = user
+      mail(:subject => "New User Signup: #{@user.email}")
+    end
+  end
+</ruby>
+
+
 h4. Mailer Views
 
 Mailer views are located in the +app/views/name_of_mailer_class+ directory. The specific mailer view is known to the class because it's name is the same as the mailer method. So for example, in our example from above, our mailer view for the +welcome_email+ method will be in +app/views/user_mailer/welcome_email.html.erb+ for the HTML version and +welcome_email.text.erb+ for the plain text version.
-- 
cgit v1.2.3

