Skip to content
Newer
Older
100644 761 lines (712 sloc) 31.9 KB
616ebb8 @josevalim Remove unused code paths and require mail only when it's needed.
josevalim authored Dec 28, 2009
1 require 'mail'
c985a0e Add some tests to collector with templates and any.
José Valim and Mikel Lindsaar authored Jan 23, 2010
2 require 'action_mailer/collector'
76f024a @fxn adds missing requires for Object#blank? and Object#present?
fxn authored Mar 28, 2010
3 require 'active_support/core_ext/object/blank'
284ca81 @joshk remove AM delegating register_observer and register_interceptor to Ma…
joshk authored Apr 2, 2011
4 require 'active_support/core_ext/string/inflections'
0f8a6eb @sikachu Fix missing requires in Action Mailer
sikachu authored Apr 14, 2011
5 require 'active_support/core_ext/hash/except'
6788db8 @josevalim Move Rails::LogSubscriber to ActiveSupport::LogSubscriber, allowing f…
josevalim authored Jun 24, 2010
6 require 'action_mailer/log_subscriber'
a63caa4 Get tests to run (with failures) without old base around
Yehuda Katz + Carl Lerche authored Jun 15, 2009
7
c4590d5 @dhh Fixed docs
dhh authored Mar 28, 2006
8 module ActionMailer #:nodoc:
98dc582 @lifo Merge docrails.
lifo authored May 25, 2008
9 # Action Mailer allows you to send email from your application using a mailer model and views.
db045db @dhh Initial
dhh authored Nov 24, 2004
10 #
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
11 # = Mailer Models
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
12 #
98dc582 @lifo Merge docrails.
lifo authored May 25, 2008
13 # To use Action Mailer, you need to create a mailer model.
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
14 #
f44a0b1 @romdi fix usage examples and more to use new invocations
romdi authored Feb 6, 2010
15 # $ rails generate mailer Notifier
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
16 #
c291195 Updates ActionMailer Base summary and fixes space in code example.
Charles Brian Quinn authored Mar 19, 2012
17 # The generated model inherits from <tt>ActionMailer::Base</tt>. A mailer model defines methods
18 # used to generate an email message. In these methods, you can setup variables to be used in
19 # the mailer views, options on the mail itself such as the <tt>:from</tt> address, and attachments.
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
20 #
21 # Examples:
22 #
0f0213f @siong1987 minor spacing fix in code example in ActionMailer::Base.
siong1987 authored May 28, 2011
23 # class Notifier < ActionMailer::Base
24 # default :from => 'no-reply@example.com',
c291195 Updates ActionMailer Base summary and fixes space in code example.
Charles Brian Quinn authored Mar 20, 2012
25 # :return_path => 'system@example.com'
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
26 #
0f0213f @siong1987 minor spacing fix in code example in ActionMailer::Base.
siong1987 authored May 28, 2011
27 # def welcome(recipient)
28 # @account = recipient
29 # mail(:to => recipient.email_address_with_name,
30 # :bcc => ["bcc@example.com", "Order Watcher <watcher@example.com>"])
31 # end
32 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
33 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
34 # Within the mailer method, you have access to the following methods:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
35 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
36 # * <tt>attachments[]=</tt> - Allows you to add attachments to your email in an intuitive
37 # manner; <tt>attachments['filename.png'] = File.read('path/to/filename.png')</tt>
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
38 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 7, 2010
39 # * <tt>attachments.inline[]=</tt> - Allows you to add an inline attachment to your email
40 # in the same manner as <tt>attachments[]=</tt>
41 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
42 # * <tt>headers[]=</tt> - Allows you to specify any header field in your email such
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 28, 2010
43 # as <tt>headers['X-No-Spam'] = 'True'</tt>. Note, while most fields like <tt>To:</tt>
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
44 # <tt>From:</tt> can only appear once in an email header, other fields like <tt>X-Anything</tt>
45 # can appear multiple times. If you want to change a field that can appear multiple times,
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 29, 2010
46 # you need to set it to nil first so that Mail knows you are replacing it and not adding
47 # another field of the same name.
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
48 #
9520166 @mikel Fixed up being able to pass random headers in with headers, or mail. …
mikel authored Jan 27, 2010
49 # * <tt>headers(hash)</tt> - Allows you to specify multiple headers in your email such
50 # as <tt>headers({'X-No-Spam' => 'True', 'In-Reply-To' => '1234@message.id'})</tt>
51 #
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 29, 2010
52 # * <tt>mail</tt> - Allows you to specify email to be sent.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
53 #
9520166 @mikel Fixed up being able to pass random headers in with headers, or mail. …
mikel authored Jan 26, 2010
54 # The hash passed to the mail method allows you to specify any header that a Mail::Message
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
55 # will accept (any valid Email header including optional fields).
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
56 #
57 # The mail method, if not passed a block, will inspect your views and send all the views with
b62c549 @jasonfox The name for the plain text template in Rails3 appears to be method.t…
jasonfox authored Jun 15, 2011
58 # the same name as the method, so the above action would send the +welcome.text.erb+ view
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
59 # file as well as the +welcome.text.html.erb+ view file in a +multipart/alternative+ email.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
60 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
61 # If you want to explicitly render only certain templates, pass a block:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
62 #
c125116 @dchelimsky docfix (email instead of emai)
dchelimsky authored Jun 12, 2010
63 # mail(:to => user.email) do |format|
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
64 # format.text
65 # format.html
66 # end
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
67 #
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 29, 2010
68 # The block syntax is also useful in providing information specific to a part:
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
69 #
c125116 @dchelimsky docfix (email instead of emai)
dchelimsky authored Jun 12, 2010
70 # mail(:to => user.email) do |format|
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
71 # format.text(:content_transfer_encoding => "base64")
72 # format.html
73 # end
74 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
75 # Or even to render a special view:
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
76 #
c125116 @dchelimsky docfix (email instead of emai)
dchelimsky authored Jun 12, 2010
77 # mail(:to => user.email) do |format|
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
78 # format.text
79 # format.html { render "some_other_template" }
80 # end
81 #
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
82 # = Mailer views
83 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
84 # Like Action Controller, each mailer class has a corresponding view directory in which each
85 # method of the class looks for a template with its name.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
86 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
87 # To define a template to be used with a mailing, create an <tt>.erb</tt> file with the same
88 # name as the method in your mailer model. For example, in the mailer defined above, the template at
b62c549 @jasonfox The name for the plain text template in Rails3 appears to be method.t…
jasonfox authored Jun 15, 2011
89 # <tt>app/views/notifier/welcome.text.erb</tt> would be used to generate the email.
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
90 #
91 # Variables defined in the model are accessible as instance variables in the view.
92 #
93 # Emails by default are sent in plain text, so a sample view for our model example might look like this:
94 #
95 # Hi <%= @account.name %>,
96 # Thanks for joining our service! Please check back often.
97 #
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
98 # You can even use Action Pack helpers in these views. For example:
99 #
100 # You got a new note!
80f1d40 @avakhov update ActionMailer example using last truncate helper method signature
avakhov authored Sep 26, 2011
101 # <%= truncate(@note.body, :length => 25) %>
ee70d1b @josevalim adv_attr_accessors in ActionMailer are not sent to the views, use the…
josevalim authored Dec 25, 2009
102 #
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
103 # If you need to access the subject, from or the recipients in the view, you can do that through message object:
ee70d1b @josevalim adv_attr_accessors in ActionMailer are not sent to the views, use the…
josevalim authored Dec 25, 2009
104 #
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
105 # You got a new note from <%= message.from %>!
80f1d40 @avakhov update ActionMailer example using last truncate helper method signature
avakhov authored Sep 26, 2011
106 # <%= truncate(@note.body, :length => 25) %>
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
107 #
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
108 #
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
109 # = Generating URLs
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
110 #
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
111 # URLs can be generated in mailer views using <tt>url_for</tt> or named routes. Unlike controllers from
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
112 # Action Pack, the mailer instance doesn't have any context about the incoming request, so you'll need
113 # to provide all of the details needed to generate a URL.
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
114 #
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
115 # When using <tt>url_for</tt> you'll need to provide the <tt>:host</tt>, <tt>:controller</tt>, and <tt>:action</tt>:
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
116 #
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
117 # <%= url_for(:host => "example.com", :controller => "welcome", :action => "greeting") %>
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
118 #
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
119 # When using named routes you only need to supply the <tt>:host</tt>:
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
120 #
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
121 # <%= users_url(:host => "example.com") %>
122 #
3438f6c @rafaelfranca Array.wrap is no longer needed here
rafaelfranca authored Jan 5, 2012
123 # You should use the <tt>named_route_url</tt> style (which generates absolute URLs) and avoid using the
124 # <tt>named_route_path</tt> style (which generates relative URLs), since clients reading the mail will
1f4fb6f @mjankowski elaborate details on why to use _url instead of _path in mailers
mjankowski authored Jun 21, 2011
125 # have no concept of a current URL from which to determine a relative path.
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
126 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
127 # It is also possible to set a default host that will be used in all mailers by setting the <tt>:host</tt>
ab62aa1 @jeroenvandijk Mention that ActionMailer::Base.default_url_options is now deprecated
jeroenvandijk authored Jul 21, 2010
128 # option as a configuration option in <tt>config/application.rb</tt>:
4809dcc * Remove default_url_options from mailer generator
Cody Fauser authored Apr 21, 2008
129 #
130 # config.action_mailer.default_url_options = { :host => "example.com" }
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
131 #
4f433bc @mjankowski clarify why the only_path => false option is needed when default :hos…
mjankowski authored Jun 21, 2011
132 # When you decide to set a default <tt>:host</tt> for your mailers, then you need to make sure to use the
3438f6c @rafaelfranca Array.wrap is no longer needed here
rafaelfranca authored Jan 5, 2012
133 # <tt>:only_path => false</tt> option when using <tt>url_for</tt>. Since the <tt>url_for</tt> view helper
4f433bc @mjankowski clarify why the only_path => false option is needed when default :hos…
mjankowski authored Jun 21, 2011
134 # will generate relative URLs by default when a <tt>:host</tt> option isn't explicitly provided, passing
135 # <tt>:only_path => false</tt> will ensure that absolute URLs are generated.
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
136 #
137 # = Sending mail
138 #
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
139 # Once a mailer action and template are defined, you can deliver your message or create it and save it
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
140 # for delivery later:
141 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
142 # Notifier.welcome(david).deliver # sends the email
143 # mail = Notifier.welcome(david) # => a Mail::Message object
144 # mail.deliver # sends the email
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
145 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
146 # You never instantiate your mailer class. Rather, you just call the method you defined on the class itself.
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
147 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
148 # = Multipart Emails
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
149 #
3438f6c @rafaelfranca Array.wrap is no longer needed here
rafaelfranca authored Jan 5, 2012
150 # Multipart messages can also be used implicitly because Action Mailer will automatically detect and use
151 # multipart templates, where each template is named after the name of the action, followed by the content
f3db04f @mjankowski grammar (missing "a") and formatting
mjankowski authored Jun 21, 2011
152 # type. Each such detected template will be added as a separate part to the message.
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
153 #
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 29, 2010
154 # For example, if the following templates exist:
b62c549 @jasonfox The name for the plain text template in Rails3 appears to be method.t…
jasonfox authored Jun 15, 2011
155 # * signup_notification.text.erb
21187c0 @dhh Apply the rest of Chads patch
dhh authored Feb 21, 2007
156 # * signup_notification.text.html.erb
157 # * signup_notification.text.xml.builder
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
158 # * signup_notification.text.yaml.erb
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
159 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
160 # Each would be rendered and added as a separate part to the message, with the corresponding content
161 # type. The content type for the entire message is automatically set to <tt>multipart/alternative</tt>,
162 # which indicates that the email contains multiple different representations of the same email
163 # body. The same instance variables defined in the action are passed to all email templates.
359caef @jamis A very thorough refactoring, resulting in new mail property setters a…
jamis authored May 29, 2005
164 #
46f30f9 @lifo Merge documentation changes from docrails.
lifo authored May 16, 2008
165 # Implicit template rendering is not performed if any attachments or parts have been added to the email.
166 # This means that you'll have to manually add each part to the email and set the content type of the email
167 # to <tt>multipart/alternative</tt>.
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
168 #
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
169 # = Attachments
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
170 #
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 29, 2010
171 # Sending attachment in emails is easy:
0a407bc ActionMailer::Base documentation rewrite. Closes #4991 [Kevin Clark, …
Marcel Molina authored May 10, 2006
172 #
173 # class ApplicationMailer < ActionMailer::Base
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
174 # def welcome(recipient)
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
175 # attachments['free_book.pdf'] = File.read('path/to/file.pdf')
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
176 # mail(:to => recipient, :subject => "New account information")
db045db @dhh Initial
dhh authored Nov 24, 2004
177 # end
3b0e1d9 @josh Prefer string core_ext inflector methods over directly accessing Infl…
josh authored May 14, 2008
178 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
179 #
b62c549 @jasonfox The name for the plain text template in Rails3 appears to be method.t…
jasonfox authored Jun 15, 2011
180 # Which will (if it had both a <tt>welcome.text.erb</tt> and <tt>welcome.text.html.erb</tt>
ccf9577 @dolzenko Fix a bunch of minor spelling mistakes
dolzenko authored Jun 11, 2010
181 # template in the view directory), send a complete <tt>multipart/mixed</tt> email with two parts,
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
182 # the first part being a <tt>multipart/alternative</tt> with the text and HTML email parts inside,
183 # and the second being a <tt>application/pdf</tt> with a Base64 encoded copy of the file.pdf book
184 # with the filename +free_book.pdf+.
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
185 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
186 # = Inline Attachments
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
187 #
188 # You can also specify that a file should be displayed inline with other HTML. This is useful
daad445 itsy bitsy changes to ActionMailer documentation
Neeraj Singh authored Jul 29, 2010
189 # if you want to display a corporate logo or a photo.
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
190 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
191 # class ApplicationMailer < ActionMailer::Base
192 # def welcome(recipient)
193 # attachments.inline['photo.png'] = File.read('path/to/photo.png')
194 # mail(:to => recipient, :subject => "Here is what we look like")
195 # end
196 # end
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
197 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
198 # And then to reference the image in the view, you create a <tt>welcome.html.erb</tt> file and
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
199 # make a call to +image_tag+ passing in the attachment you want to display and then call
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
200 # +url+ on the attachment to get the relative content id path for the image source:
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
201 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
202 # <h1>Please Don't Cringe</h1>
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
203 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
204 # <%= image_tag attachments['photo.png'].url -%>
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
205 #
f17159b @fxn edit pass: the names of Rails components have a space, ie, "Active Re…
fxn authored Jun 14, 2010
206 # As we are using Action View's +image_tag+ method, you can pass in any other options you want:
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
207 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
208 # <h1>Please Don't Cringe</h1>
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
209 #
3762362 @mikel Updating readme for ActionMailer::Base
mikel authored Jun 8, 2010
210 # <%= image_tag attachments['photo.png'].url, :alt => 'Our Photo', :class => 'photo' -%>
b451de0 @spastorino Deletes trailing whitespaces (over text files only find * -type f -ex…
spastorino authored Aug 14, 2010
211 #
cefc136 @mikel Adding options to register observers and interceptors through ActionM…
mikel authored Feb 22, 2010
212 # = Observing and Intercepting Mails
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
213 #
5d0d4d8 @smartinez87 Remove extra white spaces on ActionMailer docs.
smartinez87 authored May 23, 2011
214 # Action Mailer provides hooks into the Mail observer and interceptor methods. These allow you to
5acf76d Add action_mailer observer and interceptors configuration options
Paco Guzman authored Jun 7, 2011
215 # register classes that are called during the mail delivery life cycle.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
216 #
5acf76d Add action_mailer observer and interceptors configuration options
Paco Guzman authored Jun 7, 2011
217 # An observer class must implement the <tt>:delivered_email(message)</tt> method which will be
cefc136 @mikel Adding options to register observers and interceptors through ActionM…
mikel authored Feb 22, 2010
218 # called once for every email sent after the email has been sent.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
219 #
5acf76d Add action_mailer observer and interceptors configuration options
Paco Guzman authored Jun 7, 2011
220 # An interceptor class must implement the <tt>:delivering_email(message)</tt> method which will be
cefc136 @mikel Adding options to register observers and interceptors through ActionM…
mikel authored Feb 22, 2010
221 # called before the email is sent, allowing you to make modifications to the email before it hits
5acf76d Add action_mailer observer and interceptors configuration options
Paco Guzman authored Jun 7, 2011
222 # the delivery agents. Your class should make any needed modifications directly to the passed
cefc136 @mikel Adding options to register observers and interceptors through ActionM…
mikel authored Feb 22, 2010
223 # in Mail::Message instance.
20bd4bd @dhh Updated docs and otherwise
dhh authored Sep 2, 2006
224 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
225 # = Default Hash
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
226 #
058f7fe @mikel Cleaning up Action Mailer spelling with and without the space
mikel authored May 2, 2010
227 # Action Mailer provides some intelligent defaults for your emails, these are usually specified in a
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
228 # default method inside the class definition:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
229 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
230 # class Notifier < ActionMailer::Base
231 # default :sender => 'system@example.com'
232 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
233 #
ad8e1ba @chuyeow Fix missing word in ActionMailer::Base documentation.
chuyeow authored Nov 25, 2010
234 # You can pass in any header value that a <tt>Mail::Message</tt> accepts. Out of the box,
235 # <tt>ActionMailer::Base</tt> sets the following:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
236 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
237 # * <tt>:mime_version => "1.0"</tt>
238 # * <tt>:charset => "UTF-8",</tt>
239 # * <tt>:content_type => "text/plain",</tt>
240 # * <tt>:parts_order => [ "text/plain", "text/enriched", "text/html" ]</tt>
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
241 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
242 # <tt>parts_order</tt> and <tt>charset</tt> are not actually valid <tt>Mail::Message</tt> header fields,
058f7fe @mikel Cleaning up Action Mailer spelling with and without the space
mikel authored May 2, 2010
243 # but Action Mailer translates them appropriately and sets the correct values.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
244 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
245 # As you can pass in any header, you need to either quote the header as a string, or pass it in as
b72cd29 @mikel Fixing spelling
mikel authored Jan 18, 2011
246 # an underscored symbol, so the following will work:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
247 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
248 # class Notifier < ActionMailer::Base
249 # default 'Content-Transfer-Encoding' => '7bit',
250 # :content_description => 'This is a description'
251 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
252 #
058f7fe @mikel Cleaning up Action Mailer spelling with and without the space
mikel authored May 2, 2010
253 # Finally, Action Mailer also supports passing <tt>Proc</tt> objects into the default hash, so you
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
254 # can define methods that evaluate as the message is being generated:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
255 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
256 # class Notifier < ActionMailer::Base
257 # default 'X-Special-Header' => Proc.new { my_method }
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
258 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
259 # private
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
260 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
261 # def my_method
262 # 'some complex call'
263 # end
264 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
265 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
266 # Note that the proc is evaluated right at the start of the mail message generation, so if you
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
267 # set something in the defaults using a proc, and then set the same thing inside of your
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
268 # mailer method, it will get over written by the mailer method.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
269 #
4f28c4f @jsl Add ability to define callbacks in ActionMailer using AbstractControl…
jsl authored Mar 10, 2012
270 # = Callbacks
271 #
272 # You can specify callbacks using before_filter and after_filter for configuring your messages.
273 # This may be useful, for example, when you want to add default inline attachments for all
274 # messages sent out by a certain mailer class:
275 #
276 # class Notifier < ActionMailer::Base
277 # before_filter :add_inline_attachment!
278 #
279 # def welcome
280 # mail
281 # end
282 #
283 # private
284 #
285 # def add_inline_attachment!
286 # attachments.inline["footer.jpg"] = File.read('/path/to/filename.jpg')
287 # end
288 # end
289 #
290 # Callbacks in ActionMailer are implemented using AbstractController::Callbacks, so you
291 # can define and configure callbacks in the same manner that you would use callbacks in
292 # classes that inherit from ActionController::Base.
293 #
294 # Note that unless you have a specific reason to do so, you should prefer using before_filter
295 # rather than after_filter in your ActionMailer classes so that headers are parsed properly.
296 #
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
297 # = Configuration options
298 #
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
299 # These options are specified on the class level, like
e968acc @radar Update ActionMailer documentation to not use deprecated template_root…
radar authored Nov 26, 2010
300 # <tt>ActionMailer::Base.raise_delivery_errors = true</tt>
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
301 #
fb30feb @mikel Adding more docs to ActionMailer
mikel authored May 2, 2010
302 # * <tt>default</tt> - You can pass this in at a class level as well as within the class itself as
303 # per the above section.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
304 #
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
305 # * <tt>logger</tt> - the logger is used for generating information on the mailing run if available.
306 # Can be set to nil for no logging. Compatible with both Ruby's own Logger and Log4r loggers.
307 #
64092de @fxn Improve documentation coverage and markup
fxn authored May 2, 2008
308 # * <tt>smtp_settings</tt> - Allows detailed configuration for <tt>:smtp</tt> delivery method:
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
309 # * <tt>:address</tt> - Allows you to use a remote mail server. Just change it from its default
310 # "localhost" setting.
dc4eec1 @lifo Merge docrails:
lifo authored May 9, 2008
311 # * <tt>:port</tt> - On the off chance that your mail server doesn't run on port 25, you can change it.
312 # * <tt>:domain</tt> - If you need to specify a HELO domain, you can do it here.
313 # * <tt>:user_name</tt> - If your mail server requires authentication, set the username in this setting.
314 # * <tt>:password</tt> - If your mail server requires authentication, set the password in this setting.
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
315 # * <tt>:authentication</tt> - If your mail server requires authentication, you need to specify the
316 # authentication type here.
5a898e1 Explain actionamailer authentication types
Peter Baker authored Oct 14, 2010
317 # This is a symbol and one of <tt>:plain</tt> (will send the password in the clear), <tt>:login</tt> (will
3457db7 @dalibor Correct spelling for Base64 in action_mailer
dalibor authored Mar 3, 2011
318 # send password Base64 encoded) or <tt>:cram_md5</tt> (combines a Challenge/Response mechanism to exchange
5a898e1 Explain actionamailer authentication types
Peter Baker authored Oct 14, 2010
319 # information and a cryptographic Message Digest 5 algorithm to hash important information)
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
320 # * <tt>:enable_starttls_auto</tt> - When set to true, detects if STARTTLS is enabled in your SMTP server
321 # and starts to use it.
d500ad3 @joshk Removed deprecated ActionMailer API and related tests
joshk authored May 24, 2011
322 # * <tt>:openssl_verify_mode</tt> - When using TLS, you can set how OpenSSL checks the certificate. This is
323 # really useful if you need to validate a self-signed and/or a wildcard certificate. You can use the name
324 # of an OpenSSL verify constant ('none', 'peer', 'client_once','fail_if_no_peer_cert') or directly the
a1639ad @flop Undocumented :openssl_verify_mode option for smtp_settings
flop authored Apr 19, 2011
325 # constant (OpenSSL::SSL::VERIFY_NONE, OpenSSL::SSL::VERIFY_PEER,...).
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
326 #
46f30f9 @lifo Merge documentation changes from docrails.
lifo authored May 16, 2008
327 # * <tt>sendmail_settings</tt> - Allows you to override options for the <tt>:sendmail</tt> delivery method.
328 # * <tt>:location</tt> - The location of the sendmail executable. Defaults to <tt>/usr/sbin/sendmail</tt>.
b72cd29 @mikel Fixing spelling
mikel authored Jan 18, 2011
329 # * <tt>:arguments</tt> - The command line arguments. Defaults to <tt>-i -t</tt> with <tt>-f sender@address</tt>
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
330 # added automatically before the message is sent.
dc4eec1 @lifo Merge docrails:
lifo authored May 9, 2008
331 #
fbe6c3c @edavis10 Adds a :file delivery_method to save email to a file on disk
edavis10 authored Aug 7, 2009
332 # * <tt>file_settings</tt> - Allows you to override options for the <tt>:file</tt> delivery method.
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
333 # * <tt>:location</tt> - The directory into which emails will be written. Defaults to the application
334 # <tt>tmp/mails</tt>.
fbe6c3c @edavis10 Adds a :file delivery_method to save email to a file on disk
edavis10 authored Aug 8, 2009
335 #
dc4eec1 @lifo Merge docrails:
lifo authored May 9, 2008
336 # * <tt>raise_delivery_errors</tt> - Whether or not errors should be raised if the email fails to be delivered.
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
337 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
338 # * <tt>delivery_method</tt> - Defines a delivery method. Possible values are <tt>:smtp</tt> (default),
339 # <tt>:sendmail</tt>, <tt>:test</tt>, and <tt>:file</tt>. Or you may provide a custom delivery method
5d0d4d8 @smartinez87 Remove extra white spaces on ActionMailer docs.
smartinez87 authored May 23, 2011
340 # object eg. MyOwnDeliveryMethodClass.new. See the Mail gem documentation on the interface you need to
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
341 # implement for a custom delivery agent.
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
342 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
343 # * <tt>perform_deliveries</tt> - Determines whether emails are actually sent from Action Mailer when you
5d0d4d8 @smartinez87 Remove extra white spaces on ActionMailer docs.
smartinez87 authored May 23, 2011
344 # call <tt>.deliver</tt> on an mail message or on an Action Mailer method. This is on by default but can
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
345 # be turned off to aid in functional testing.
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
346 #
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
347 # * <tt>deliveries</tt> - Keeps an array of all the emails sent out through the Action Mailer with
348 # <tt>delivery_method :test</tt>. Most useful for unit and functional testing.
af56c80 @dhh Updated documentation
dhh authored Feb 24, 2005
349 #
4964d3b @josevalim Make ActionMailer::Base inherit from AbstractController::Base
josevalim authored Dec 22, 2009
350 class Base < AbstractController::Base
dbcf01e @mikel Removing quoting.rb, upgrade to 2.1.3.6, changing all utf-8 reference…
mikel authored Apr 8, 2010
351 include DeliveryMethods
f30d73b Add new class delivery method API.
José Valim and Mikel Lindsaar authored Jan 24, 2010
352 abstract!
353
c03c40b @josevalim Expose a _render_partial hook as thhe _render_template one and make u…
josevalim authored Dec 31, 2009
354 include AbstractController::Logger
83f4d86 @dhh Rename the RenderingController module to just plain Rendering
dhh authored Dec 20, 2009
355 include AbstractController::Rendering
a9751a7 @josevalim Refactor ActionMailer layout and remove legacy one.
josevalim authored Oct 17, 2009
356 include AbstractController::Layouts
684c2dc @josevalim Remove ActionMailer helpers and rely on AbstractController one.
josevalim authored Oct 18, 2009
357 include AbstractController::Helpers
48a3985 @josevalim Also include translation in ActionMailer.
josevalim authored Jan 26, 2010
358 include AbstractController::Translation
08baa34 @dhh Extract assets paths and make them available to Action Mailer as well
dhh authored Jun 2, 2010
359 include AbstractController::AssetPaths
4f28c4f @jsl Add ability to define callbacks in ActionMailer using AbstractControl…
jsl authored Mar 10, 2012
360 include AbstractController::Callbacks
359caef @jamis A very thorough refactoring, resulting in new mail property setters a…
jamis authored May 29, 2005
361
7d86235 @lest get rid of using instance_variable_names method from AS
lest authored Jan 7, 2012
362 self.protected_instance_variables = [:@_action_has_layout]
d42bb68 @josevalim More updates to ivars list.
josevalim authored May 6, 2011
363
972efa1 @josevalim Deprecate the old mailer API that was not deprecated yet.
josevalim authored Aug 29, 2010
364 helper ActionMailer::MailHelper
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
365
c927aa0 @dhh Updated documentation
dhh authored Dec 16, 2004
366 private_class_method :new #:nodoc:
db045db @dhh Initial
dhh authored Nov 24, 2004
367
e5ab4b0 @jeremy Convert to class_attribute
jeremy authored Jan 31, 2010
368 class_attribute :default_params
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
369 self.default_params = {
370 :mime_version => "1.0",
dbcf01e @mikel Removing quoting.rb, upgrade to 2.1.3.6, changing all utf-8 reference…
mikel authored Apr 8, 2010
371 :charset => "UTF-8",
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
372 :content_type => "text/plain",
373 :parts_order => [ "text/plain", "text/enriched", "text/html" ]
e5ab4b0 @jeremy Convert to class_attribute
jeremy authored Feb 1, 2010
374 }.freeze
e1c1318 Added delivers_from.
José Valim and Mikel Lindsaar authored Jan 25, 2010
375
eda1719 @jamis ActionMailer::Base.deliver(email) had been accidentally removed, but …
jamis authored Jul 31, 2005
376 class << self
284ca81 @joshk remove AM delegating register_observer and register_interceptor to Ma…
joshk authored Apr 2, 2011
377 # Register one or more Observers which will be notified when mail is delivered.
378 def register_observers(*observers)
379 observers.flatten.compact.each { |observer| register_observer(observer) }
380 end
381
382 # Register one or more Interceptors which will be called before mail is sent.
383 def register_interceptors(*interceptors)
384 interceptors.flatten.compact.each { |interceptor| register_interceptor(interceptor) }
385 end
386
387 # Register an Observer which will be notified when mail is delivered.
388 # Either a class or a string can be passed in as the Observer. If a string is passed in
389 # it will be <tt>constantize</tt>d.
390 def register_observer(observer)
cb9e501 @joshk AM register_interceptor and register_observer only constantize if the…
joshk authored Apr 4, 2011
391 delivery_observer = (observer.is_a?(String) ? observer.constantize : observer)
284ca81 @joshk remove AM delegating register_observer and register_interceptor to Ma…
joshk authored Apr 2, 2011
392 Mail.register_observer(delivery_observer)
393 end
394
a467983 @vijaydev fix typo
vijaydev authored Jun 8, 2011
395 # Register an Interceptor which will be called before mail is sent.
9a67a11 @siong1987 minor typo in the rdoc about Interceptor.
siong1987 authored May 28, 2011
396 # Either a class or a string can be passed in as the Interceptor. If a string is passed in
284ca81 @joshk remove AM delegating register_observer and register_interceptor to Ma…
joshk authored Apr 2, 2011
397 # it will be <tt>constantize</tt>d.
398 def register_interceptor(interceptor)
cb9e501 @joshk AM register_interceptor and register_observer only constantize if the…
joshk authored Apr 4, 2011
399 delivery_interceptor = (interceptor.is_a?(String) ? interceptor.constantize : interceptor)
284ca81 @joshk remove AM delegating register_observer and register_interceptor to Ma…
joshk authored Apr 2, 2011
400 Mail.register_interceptor(delivery_interceptor)
401 end
402
bd5ed65 @technoweenie Update ActionMailer so it treats ActionView the same way that ActionC…
technoweenie authored Nov 26, 2007
403 def mailer_name
404 @mailer_name ||= name.underscore
405 end
0750304 @mikel Migrated over to Mail doing delivery.
mikel authored Jan 16, 2010
406 attr_writer :mailer_name
407 alias :controller_path :mailer_name
81c416b @josevalim More refactoring on ActionMailer::Base.
josevalim authored Oct 28, 2009
408
e5ab4b0 @jeremy Convert to class_attribute
jeremy authored Feb 1, 2010
409 def default(value = nil)
410 self.default_params = default_params.merge(value).freeze if value
411 default_params
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
412 end
413
59f1df1 @jamis Update/extend ActionMailer documentation (rdoc)
jamis authored Oct 16, 2005
414 # Receives a raw email, parses it into an email object, decodes it,
415 # instantiates a new mailer, and passes the email object to the mailer
98dc582 @lifo Merge docrails.
lifo authored May 25, 2008
416 # object's +receive+ method. If you want your mailer to be able to
417 # process incoming messages, you'll need to implement a +receive+
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
418 # method that accepts the raw email string as a parameter:
59f1df1 @jamis Update/extend ActionMailer documentation (rdoc)
jamis authored Oct 16, 2005
419 #
420 # class MyMailer < ActionMailer::Base
421 # def receive(mail)
422 # ...
423 # end
424 # end
704daad @josevalim Ensure we just send Ruby Stdlib objects in ActionMailer notifications.
josevalim authored Jan 15, 2010
425 def receive(raw_mail)
731d439 @jaggederest Change event namespace ordering to most-significant first [#4504 stat…
jaggederest authored Apr 27, 2010
426 ActiveSupport::Notifications.instrument("receive.action_mailer") do |payload|
704daad @josevalim Ensure we just send Ruby Stdlib objects in ActionMailer notifications.
josevalim authored Jan 15, 2010
427 mail = Mail.new(raw_mail)
428 set_payload_for_mail(payload, mail)
2a6bc12 @josevalim Add subscriber to ActionMailer.
josevalim authored Jan 13, 2010
429 new.receive(mail)
430 end
eda1719 @jamis ActionMailer::Base.deliver(email) had been accidentally removed, but …
jamis authored Jul 31, 2005
431 end
432
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
433 # Wraps an email delivery inside of Active Support Notifications instrumentation. This
de65c82 @rizwanreza Changes call backs to callbacks.
rizwanreza authored Jun 15, 2010
434 # method is actually called by the <tt>Mail::Message</tt> object itself through a callback
bb2c7b4 @mikel Updating Action Mailer documentation
mikel authored Jan 29, 2010
435 # when you call <tt>:deliver</tt> on the Mail::Message, calling +deliver_mail+ directly
436 # and passing a Mail::Message will do nothing except tell the logger you sent the email.
e4a989e Added delivery_handler method to mail and implemented in ActionMailer…
José Valim and Mikel Lindsaar authored Jan 25, 2010
437 def deliver_mail(mail) #:nodoc:
731d439 @jaggederest Change event namespace ordering to most-significant first [#4504 stat…
jaggederest authored Apr 28, 2010
438 ActiveSupport::Notifications.instrument("deliver.action_mailer") do |payload|
c176397 @sachin87 some modifications in action_mailer/base.rb
sachin87 authored Jan 22, 2012
439 set_payload_for_mail(payload, mail)
ace7497 Got AM working with Mail yield on delivery_handler and updated tests
José Valim and Mikel Lindsaar authored Jan 25, 2010
440 yield # Let Mail do the delivery actions
258ca14 Delegated ActionMailer::Base.deliveries to Mail.deliveries, added cal…
José Valim and Mikel Lindsaar authored Jan 24, 2010
441 end
442 end
443
ad8dc5a @mikel Should use standard ruby signature for respond_to
mikel authored Jan 18, 2011
444 def respond_to?(method, include_private = false) #:nodoc:
99f960a Handle some TODOs and deprecations.
José Valim and Mikel Lindsaar authored Jan 24, 2010
445 super || action_methods.include?(method.to_s)
446 end
447
448 protected
449
704daad @josevalim Ensure we just send Ruby Stdlib objects in ActionMailer notifications.
josevalim authored Jan 15, 2010
450 def set_payload_for_mail(payload, mail) #:nodoc:
e8c9cac @tenderlove self is implied, so remove self
tenderlove authored Sep 29, 2010
451 payload[:mailer] = name
c905fce @josevalim Add message_id to AM payload and don't send bcc and cc if they were n…
josevalim authored Jan 15, 2010
452 payload[:message_id] = mail.message_id
453 payload[:subject] = mail.subject
454 payload[:to] = mail.to
455 payload[:from] = mail.from
456 payload[:bcc] = mail.bcc if mail.bcc.present?
457 payload[:cc] = mail.cc if mail.cc.present?
458 payload[:date] = mail.date
459 payload[:mail] = mail.encoded
704daad @josevalim Ensure we just send Ruby Stdlib objects in ActionMailer notifications.
josevalim authored Jan 15, 2010
460 end
f30d73b Add new class delivery method API.
José Valim and Mikel Lindsaar authored Jan 24, 2010
461
99f960a Handle some TODOs and deprecations.
José Valim and Mikel Lindsaar authored Jan 24, 2010
462 def method_missing(method, *args) #:nodoc:
4d7b2ee @tenderlove dry up method missing
tenderlove authored Sep 29, 2010
463 return super unless respond_to?(method)
464 new(method, *args).message
f30d73b Add new class delivery method API.
José Valim and Mikel Lindsaar authored Jan 24, 2010
465 end
eda1719 @jamis ActionMailer::Base.deliver(email) had been accidentally removed, but …
jamis authored Jul 31, 2005
466 end
467
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
468 attr_internal :message
469
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
470 # Instantiate a new mailer object. If +method_name+ is not +nil+, the mailer
471 # will be initialized according to the named method. If not, the mailer will
472 # remain uninitialized (useful when you only need to invoke the "receive"
473 # method, for instance).
474 def initialize(method_name=nil, *args)
475 super()
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
476 @_message = Mail.new
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
477 process(method_name, *args) if method_name
478 end
479
3fc609e @josevalim Fix ActionMailer test broken in 99d5459
josevalim authored Apr 12, 2010
480 def process(*args) #:nodoc:
481 lookup_context.skip_default_locale!
482 super
483 end
484
972efa1 @josevalim Deprecate the old mailer API that was not deprecated yet.
josevalim authored Aug 29, 2010
485 def mailer_name
486 self.class.mailer_name
487 end
488
8cc4159 @mark-rushakoff Use <tt>Foo::Bar</tt> instead of +Foo::Bar+
mark-rushakoff authored Apr 27, 2012
489 # Allows you to pass random and unusual headers to the new <tt>Mail::Message</tt> object
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
490 # which will add them to itself.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
491 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
492 # headers['X-Special-Domain-Specific-Header'] = "SecretValue"
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
493 #
9520166 @mikel Fixed up being able to pass random headers in with headers, or mail. …
mikel authored Jan 26, 2010
494 # You can also pass a hash into headers of header field names and values, which
495 # will then be set on the Mail::Message object:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
496 #
05c4ad9 Tidy up tests and docs.
José Valim and Mikel Lindsaar authored Jan 26, 2010
497 # headers 'X-Special-Domain-Specific-Header' => "SecretValue",
498 # 'In-Reply-To' => incoming.message_id
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
499 #
ff44c33 @mark-rushakoff Fix it's -> its
mark-rushakoff authored Apr 27, 2012
500 # The resulting Mail::Message will have the following in its header:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
501 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
502 # X-Special-Domain-Specific-Header: SecretValue
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
503 def headers(args=nil)
504 if args
9520166 @mikel Fixed up being able to pass random headers in with headers, or mail. …
mikel authored Jan 26, 2010
505 @_message.headers(args)
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
506 else
507 @_message
508 end
509 end
c34cfcc @mikel Created mail method for new API
mikel authored Jan 20, 2010
510
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
511 # Allows you to add attachments to an email, like so:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
512 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
513 # mail.attachments['filename.jpg'] = File.read('/path/to/filename.jpg')
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
514 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
515 # If you do this, then Mail will take the file name and work out the mime type
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
516 # set the Content-Type, Content-Disposition, Content-Transfer-Encoding and
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
517 # base64 encode the contents of the attachment all for you.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
518 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
519 # You can also specify overrides if you want by passing a hash instead of a string:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
520 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
521 # mail.attachments['filename.jpg'] = {:mime_type => 'application/x-gzip',
522 # :content => File.read('/path/to/filename.jpg')}
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
523 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
524 # If you want to use a different encoding than Base64, you can pass an encoding in,
525 # but then it is up to you to pass in the content pre-encoded, and don't expect
526 # Mail to know how to decode this data:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
527 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
528 # file_content = SpecialEncode(File.read('/path/to/filename.jpg'))
529 # mail.attachments['filename.jpg'] = {:mime_type => 'application/x-gzip',
530 # :encoding => 'SpecialEncoding',
531 # :content => file_content }
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
532 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
533 # You can also search for specific attachments:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
534 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
535 # # By Filename
755af49 @fxn edit pass to apply API guideline wrt the use of "# =>" in example code
fxn authored Jul 30, 2010
536 # mail.attachments['filename.jpg'] # => Mail::Part object or nil
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
537 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
538 # # or by index
755af49 @fxn edit pass to apply API guideline wrt the use of "# =>" in example code
fxn authored Jul 30, 2010
539 # mail.attachments[0] # => Mail::Part (first attachment)
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
540 #
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
541 def attachments
542 @_message.attachments
543 end
dcb9253 Add basic template rendering to new DSL.
José Valim and Mikel Lindsaar authored Jan 22, 2010
544
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
545 # The main method that creates the message and renders the email templates. There are
546 # two ways to call this method, with a block, or without a block.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
547 #
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
548 # Both methods accept a headers hash. This hash allows you to specify the most used headers
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
549 # in an email message, these are:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
550 #
058f7fe @mikel Cleaning up Action Mailer spelling with and without the space
mikel authored May 2, 2010
551 # * <tt>:subject</tt> - The subject of the message, if this is omitted, Action Mailer will
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
552 # ask the Rails I18n class for a translated <tt>:subject</tt> in the scope of
66880cf @Odaeus Correct ActionMailer subject i18n lookup scope.
Odaeus authored Oct 20, 2011
553 # <tt>[mailer_scope, action_name]</tt> or if this is missing, will translate the
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
554 # humanized version of the <tt>action_name</tt>
555 # * <tt>:to</tt> - Who the message is destined for, can be a string of addresses, or an array
556 # of addresses.
0b05acd @mikel Implementing class level :defaults hash, instead of delivers_from et al
mikel authored Jan 26, 2010
557 # * <tt>:from</tt> - Who the message is from
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
558 # * <tt>:cc</tt> - Who you would like to Carbon-Copy on this email, can be a string of addresses,
559 # or an array of addresses.
560 # * <tt>:bcc</tt> - Who you would like to Blind-Carbon-Copy on this email, can be a string of
561 # addresses, or an array of addresses.
562 # * <tt>:reply_to</tt> - Who to set the Reply-To header of the email to.
563 # * <tt>:date</tt> - The date to say the email was sent on.
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
564 #
565 # You can set default values for any of the above headers (except :date) by using the <tt>default</tt>
0b05acd @mikel Implementing class level :defaults hash, instead of delivers_from et al
mikel authored Jan 26, 2010
566 # class method:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
567 #
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
568 # class Notifier < ActionMailer::Base
452bb1e @jeremy Rename 'defaults' class method to 'default' to reflect that it's a de…
jeremy authored Jan 27, 2010
569 # self.default :from => 'no-reply@test.lindsaar.net',
570 # :bcc => 'email_logger@test.lindsaar.net',
571 # :reply_to => 'bounces@test.lindsaar.net'
0b05acd @mikel Implementing class level :defaults hash, instead of delivers_from et al
mikel authored Jan 26, 2010
572 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
573 #
52c56f9 @wincent docs: note that mail() accepts arbitrary headers
wincent authored Jun 29, 2010
574 # If you need other headers not listed above, you can either pass them in
575 # as part of the headers hash or use the <tt>headers['name'] = value</tt>
576 # method.
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
577 #
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
578 # When a <tt>:return_path</tt> is specified as header, that value will be used as the 'envelope from'
5d0d4d8 @smartinez87 Remove extra white spaces on ActionMailer docs.
smartinez87 authored May 23, 2011
579 # address for the Mail message. Setting this is useful when you want delivery notifications
580 # sent to a different address than the one in <tt>:from</tt>. Mail will actually use the
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
581 # <tt>:return_path</tt> in preference to the <tt>:sender</tt> in preference to the <tt>:from</tt>
582 # field for the 'envelope from' value.
583 #
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
584 # If you do not pass a block to the +mail+ method, it will find all templates in the
be35a15 @josevalim Allow to choose the template path and template name used in implicit …
josevalim authored Feb 19, 2010
585 # view paths using by default the mailer name and the method name that it is being
586 # called from, it will then create parts for each of these templates intelligently,
587 # making educated guesses on correct content type and sequence, and return a fully
588 # prepared Mail::Message ready to call <tt>:deliver</tt> on to send.
589 #
590 # For example:
591 #
592 # class Notifier < ActionMailer::Base
593 # default :from => 'no-reply@test.lindsaar.net',
594 #
595 # def welcome
596 # mail(:to => 'mikel@test.lindsaar.net')
597 # end
598 # end
599 #
600 # Will look for all templates at "app/views/notifier" with name "welcome". However, those
601 # can be customized:
602 #
603 # mail(:template_path => 'notifications', :template_name => 'another')
604 #
605 # And now it will look for all templates at "app/views/notifications" with name "another".
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
606 #
607 # If you do pass a block, you can render specific templates of your choice:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
608 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
609 # mail(:to => 'mikel@test.lindsaar.net') do |format|
610 # format.text
611 # format.html
612 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
613 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
614 # You can even render text directly without using a template:
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
615 #
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
616 # mail(:to => 'mikel@test.lindsaar.net') do |format|
617 # format.text { render :text => "Hello Mikel!" }
618 # format.html { render :text => "<h1>Hello Mikel!</h1>" }
619 # end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
620 #
74a5889 Refactor content type setting, added tests to ensure boundary exists …
José Valim and Mikel Lindsaar authored Jan 26, 2010
621 # Which will render a <tt>multipart/alternative</tt> email with <tt>text/plain</tt> and
4a6eba3 Added initial documentation for the new API
José Valim and Mikel Lindsaar authored Jan 25, 2010
622 # <tt>text/html</tt> parts.
6589976 Remove old files, add some information to docs and improve test suite.
José Valim and Mikel Lindsaar authored Jan 26, 2010
623 #
624 # The block syntax also allows you to customize the part headers if desired:
625 #
626 # mail(:to => 'mikel@test.lindsaar.net') do |format|
627 # format.text(:content_transfer_encoding => "base64")
628 # format.html
629 # end
630 #
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
631 def mail(headers={}, &block)
632 m = @_message
258ca14 Delegated ActionMailer::Base.deliveries to Mail.deliveries, added cal…
José Valim and Mikel Lindsaar authored Jan 24, 2010
633
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
634 # At the beginning, do not consider class default for parts order neither content_type
635 content_type = headers[:content_type]
636 parts_order = headers[:parts_order]
1cd5592 First work on implicit multipart.
José Valim and Mikel Lindsaar authored Jan 22, 2010
637
08b07b6 @mikel Adding ability to pass proc's to the ActionMailer class default method
mikel authored May 2, 2010
638 # Call all the procs (if any)
c176397 @sachin87 some modifications in action_mailer/base.rb
sachin87 authored Jan 21, 2012
639 class_default = self.class.default
640 default_values = class_default.merge(class_default) do |k,v|
3fbc042 @lest Use instance_eval instead of Proc#bind
lest authored Jan 23, 2012
641 v.respond_to?(:to_proc) ? instance_eval(&v) : v
08b07b6 @mikel Adding ability to pass proc's to the ActionMailer class default method
mikel authored May 2, 2010
642 end
458f571 @wycats Remove the need for a special action_mailer.url_for initializer that …
wycats authored May 15, 2010
643
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
644 # Handle defaults
08b07b6 @mikel Adding ability to pass proc's to the ActionMailer class default method
mikel authored May 2, 2010
645 headers = headers.reverse_merge(default_values)
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
646 headers[:subject] ||= default_i18n_subject
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
647
648 # Apply charset at the beginning so all fields are properly quoted
649 m.charset = charset = headers[:charset]
650
651 # Set configure delivery behavior
652 wrap_delivery_behavior!(headers.delete(:delivery_method))
653
654 # Assign all headers except parts_order, content_type and body
b4fd5e6 @josevalim template_name and template_path should not be added to mail headers.
josevalim authored Apr 13, 2010
655 assignable = headers.except(:parts_order, :content_type, :body, :template_name, :template_path)
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
656 assignable.each { |k, v| m[k] = v }
951397b Get implicit multipart and attachments working together.
José Valim and Mikel Lindsaar authored Jan 22, 2010
657
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
658 # Render the templates and blocks
39a1b06 Deprecate old defaults API.
José Valim and Mikel Lindsaar authored Jan 26, 2010
659 responses, explicit_order = collect_responses_and_parts_order(headers, &block)
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
660 create_parts_from_responses(m, responses)
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
661
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
662 # Setup content type, reapply charset and handle parts order
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
663 m.content_type = set_content_type(m, content_type, headers[:content_type])
951397b Get implicit multipart and attachments working together.
José Valim and Mikel Lindsaar authored Jan 22, 2010
664 m.charset = charset
665
e7e4ed4 Set sort order for explicit parts from the collector's template sequence
José Valim and Mikel Lindsaar authored Jan 24, 2010
666 if m.multipart?
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
667 parts_order ||= explicit_order || headers[:parts_order]
668 m.body.set_sort_order(parts_order)
951397b Get implicit multipart and attachments working together.
José Valim and Mikel Lindsaar authored Jan 22, 2010
669 m.body.sort_parts!
670 end
bb9d71f Move class methods to deprecated stuff.
José Valim and Mikel Lindsaar authored Jan 22, 2010
671
c34cfcc @mikel Created mail method for new API
mikel authored Jan 20, 2010
672 m
673 end
674
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
675 protected
676
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
677 def set_content_type(m, user_content_type, class_default)
74a5889 Refactor content type setting, added tests to ensure boundary exists …
José Valim and Mikel Lindsaar authored Jan 26, 2010
678 params = m.content_type_parameters || {}
679 case
680 when user_content_type.present?
681 user_content_type
682 when m.has_attachments?
311d99e @mikel Adding inline attachment support to ActionMailer
mikel authored Jun 7, 2010
683 if m.attachments.detect { |a| a.inline? }
684 ["multipart", "related", params]
685 else
686 ["multipart", "mixed", params]
687 end
74a5889 Refactor content type setting, added tests to ensure boundary exists …
José Valim and Mikel Lindsaar authored Jan 26, 2010
688 when m.multipart?
689 ["multipart", "alternative", params]
690 else
b6b3db6 @mikel Fixed bug on HTML only emails getting set to text/plain
mikel authored Jan 28, 2010
691 m.content_type || class_default
74a5889 Refactor content type setting, added tests to ensure boundary exists …
José Valim and Mikel Lindsaar authored Jan 26, 2010
692 end
693 end
694
11b67b3 @indrekj fix default_i18n_subject comment in ActionMailer::Base
indrekj authored Dec 20, 2011
695 # Translates the +subject+ using Rails I18n class under <tt>[mailer_scope, action_name]</tt> scope.
082e299 @smartinez87 docs for ActionMailer::Base.default_i18n_subject
smartinez87 authored Apr 18, 2011
696 # If it does not find a translation for the +subject+ under the specified scope it will default to a
697 # humanized version of the <tt>action_name</tt>.
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
698 def default_i18n_subject #:nodoc:
2d8396f @jurriaan Updated/changed useless tr/gsubs
jurriaan authored Apr 3, 2012
699 mailer_scope = self.class.mailer_name.tr('/', '.')
30eaecb @josevalim subject is automatically looked up on I18n using mailer_name and acti…
josevalim authored Jun 12, 2010
700 I18n.t(:subject, :scope => [mailer_scope, action_name], :default => action_name.humanize)
5c3ef8c Refactor subject with i18n.
José Valim and Mikel Lindsaar authored Jan 23, 2010
701 end
702
39a1b06 Deprecate old defaults API.
José Valim and Mikel Lindsaar authored Jan 26, 2010
703 def collect_responses_and_parts_order(headers) #:nodoc:
704 responses, parts_order = [], nil
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
705
706 if block_given?
a09e992 @josevalim Ensure details are frozen after @details_keys lookup. The implementat…
josevalim authored Mar 27, 2010
707 collector = ActionMailer::Collector.new(lookup_context) { render(action_name) }
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
708 yield(collector)
39a1b06 Deprecate old defaults API.
José Valim and Mikel Lindsaar authored Jan 26, 2010
709 parts_order = collector.responses.map { |r| r[:content_type] }
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
710 responses = collector.responses
711 elsif headers[:body]
712 responses << {
be35a15 @josevalim Allow to choose the template path and template name used in implicit …
josevalim authored Feb 19, 2010
713 :body => headers.delete(:body),
452bb1e @jeremy Rename 'defaults' class method to 'default' to reflect that it's a de…
jeremy authored Jan 28, 2010
714 :content_type => self.class.default[:content_type] || "text/plain"
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
715 }
716 else
be35a15 @josevalim Allow to choose the template path and template name used in implicit …
josevalim authored Feb 19, 2010
717 templates_path = headers.delete(:template_path) || self.class.mailer_name
718 templates_name = headers.delete(:template_name) || action_name
719
720 each_template(templates_path, templates_name) do |template|
f28d856 @josevalim Improve performance of the rendering stack by freezing formats as a s…
josevalim authored Mar 19, 2010
721 self.formats = template.formats
722
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
723 responses << {
2a12686 @josevalim Allow anything that responds to render to be given as :template and u…
josevalim authored Mar 12, 2010
724 :body => render(:template => template),
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
725 :content_type => template.mime_type.to_s
726 }
727 end
728 end
729
39a1b06 Deprecate old defaults API.
José Valim and Mikel Lindsaar authored Jan 26, 2010
730 [responses, parts_order]
7409b73 Some refactoring.
José Valim and Mikel Lindsaar authored Jan 24, 2010
731 end
732
be35a15 @josevalim Allow to choose the template path and template name used in implicit …
josevalim authored Feb 19, 2010
733 def each_template(paths, name, &block) #:nodoc:
3438f6c @rafaelfranca Array.wrap is no longer needed here
rafaelfranca authored Jan 5, 2012
734 templates = lookup_context.find_all(name, Array(paths))
b340f88 @lest use Array#uniq in AM instead of deprecated Array#uniq_by
lest authored Dec 24, 2011
735 templates.uniq { |t| t.formats }.each(&block)
99f960a Handle some TODOs and deprecations.
José Valim and Mikel Lindsaar authored Jan 24, 2010
736 end
737
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
738 def create_parts_from_responses(m, responses) #:nodoc:
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
739 if responses.size == 1 && !m.has_attachments?
9dd65c3 Make defaults accept a hash.
José Valim and Mikel Lindsaar authored Jan 26, 2010
740 responses[0].each { |k,v| m[k] = v }
74a5889 Refactor content type setting, added tests to ensure boundary exists …
José Valim and Mikel Lindsaar authored Jan 26, 2010
741 elsif responses.size > 1 && m.has_attachments?
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
742 container = Mail::Part.new
74a5889 Refactor content type setting, added tests to ensure boundary exists …
José Valim and Mikel Lindsaar authored Jan 26, 2010
743 container.content_type = "multipart/alternative"
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
744 responses.each { |r| insert_part(container, r, m.charset) }
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
745 m.add_part(container)
746 else
b5f9a9f @josevalim Move set_fields! to the old API module.
josevalim authored Apr 12, 2010
747 responses.each { |r| insert_part(m, r, m.charset) }
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
748 end
359caef @jamis A very thorough refactoring, resulting in new mail property setters a…
jamis authored May 29, 2005
749 end
750
6ba9446 Make implicit and explicit templates pass through the same part creat…
José Valim and Mikel Lindsaar authored Jan 23, 2010
751 def insert_part(container, response, charset) #:nodoc:
752 response[:charset] ||= charset
753 part = Mail::Part.new(response)
754 container.add_part(part)
359caef @jamis A very thorough refactoring, resulting in new mail property setters a…
jamis authored May 29, 2005
755 end
3fad0cd @dhh Added support for charsets for both subject and body. The default cha…
dhh authored Feb 19, 2005
756
ef5dada @nex3 Only run load hooks once a file has been fully loaded.
nex3 authored Apr 27, 2010
757 ActiveSupport.run_load_hooks(:action_mailer, self)
db045db @dhh Initial
dhh authored Nov 24, 2004
758 end
759 end
d0c4fd7 @judearasu typo changes
judearasu authored Jun 19, 2011
760
Something went wrong with that request. Please try again.