Setting up custom transactional email in Magento

Today we are going to cover the way of setting up custom transactional email in Magento which you can customized using Admin Transactional email section in Magento.

Here is the step by step guide with bear minimal configuration -:

Step 1 – Create a new module under your local folder, in our case under /app/local/Scommerce/CustomEmail.

Step 2 – Register the module in etc/modules directory either in Scommerce_All.xml or Scommerce_CustomEmail.xml by using the following code -:

<br>
&lt;Scommerce_CustomEmail&gt;<br> &lt;active&gt;true&lt;/active&gt;<br> &lt;codePool&gt;local&lt;/codePool&gt;<br>
&lt;/Scommerce_CustomEmail&gt;<br>

Step 3 – Create config.xml under etc directory of your module /app/local/Scommerce/CustomEmail/etc by using the following code

<br>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;<br>
&lt;config&gt;<br> &lt;modules&gt;<br> &lt;Scommerce_CustomEmail&gt;<br> &lt;version&gt;0.0.1&lt;/version&gt;<br> &lt;/Scommerce_CustomEmail&gt;<br> &lt;/modules&gt;<br> &lt;global&gt;<br> &lt;template&gt;<br> &lt;email&gt;<br> &lt;scommerce_customemail_custom_email_template translate='label' module='customemail'&gt;<br> &lt;label&gt;Custom Email&lt;/label&gt;<br> &lt;file&gt;custom_email.html&lt;/file&gt;<br> &lt;type&gt;html&lt;/type&gt;<br> &lt;/scommerce_customemail_custom_email&gt;<br> &lt;/email&gt;<br> &lt;/template&gt;<br> &lt;/global&gt;<br>
&lt;/config&gt;<br>

The above declaration will tell Magento that you have system configuration in the following xpath scommmerce_customemail -> custom ->email_template. You will see this in the next step in system.xml. Make sure it matches with system.xml otherwise it is not going to work. One of the important configuration to make this work.

Step 4 – Create system.xml under etc directory of your module /app/local/Scommerce/CustomEmail/etc by using the following code -:

<br>
&lt;?xml version="1.0"?&gt;<br>
&lt;config&gt;<br> &lt;tabs&gt;<br> &lt;scommerce translate="label" module="customemail"&gt;<br> &lt;label&gt;Scommerce Configuration&lt;/label&gt;<br> &lt;sort_order&gt;100&lt;/sort_order&gt;<br> &lt;/scommerce&gt;<br> &lt;/tabs&gt;<br> &lt;sections&gt;<br> &lt;scommerce_customemail translate="label"&gt;<br> &lt;label&gt;Custom Email&lt;/label&gt;<br> &lt;tab&gt;scommerce&lt;/tab&gt;<br> &lt;frontend_type&gt;text&lt;/frontend_type&gt;<br> &lt;sort_order&gt;100&lt;/sort_order&gt;<br> &lt;show_in_default&gt;1&lt;/show_in_default&gt;<br> &lt;show_in_website&gt;1&lt;/show_in_website&gt;<br> &lt;show_in_store&gt;1&lt;/show_in_store&gt;<br> &lt;groups&gt;<br> &lt;custom translate="label"&gt;<br> &lt;label&gt;Custom&lt;/label&gt;<br> &lt;frontend_type&gt;text&lt;/frontend_type&gt;<br> &lt;sort_order&gt;100&lt;/sort_order&gt;<br> &lt;show_in_default&gt;1&lt;/show_in_default&gt;<br> &lt;show_in_website&gt;1&lt;/show_in_website&gt;<br> &lt;show_in_store&gt;1&lt;/show_in_store&gt;<br> &lt;fields&gt;<br> &lt;sender_email_identity translate="label"&gt;<br> &lt;label&gt;Email Sender&lt;/label&gt;<br> &lt;frontend_type&gt;select&lt;/frontend_type&gt;<br> &lt;source_model&gt;adminhtml/system_config_source_email_identity&lt;/source_model&gt;<br> &lt;sort_order&gt;10&lt;/sort_order&gt;<br> &lt;show_in_default&gt;1&lt;/show_in_default&gt;<br> &lt;show_in_website&gt;1&lt;/show_in_website&gt;<br> &lt;show_in_store&gt;1&lt;/show_in_store&gt;<br> &lt;/sender_email_identity&gt;<br> &lt;email_template translate="label"&gt;<br> &lt;label&gt;Email Template&lt;/label&gt;<br> &lt;frontend_type&gt;select&lt;/frontend_type&gt;<br> &lt;source_model&gt;adminhtml/system_config_source_email_template&lt;/source_model&gt;<br> &lt;sort_order&gt;20&lt;/sort_order&gt;<br> &lt;show_in_default&gt;1&lt;/show_in_default&gt;<br> &lt;show_in_website&gt;1&lt;/show_in_website&gt;<br> &lt;show_in_store&gt;1&lt;/show_in_store&gt;<br> &lt;/email_template&gt;<br> &lt;/fields&gt;<br> &lt;/custom&gt;<br> &lt;/groups&gt;<br> &lt;/scommerce_customemail&gt;<br> &lt;/sections&gt;<br>
&lt;/config&gt;<br>

Step 5 – Sending transactional email either using your Model or Controller class

</p>
<p> /**<br> * Sending email to customer<br> *<br> * @param type $name<br> * @param type $email<br> * @return boolean<br> */<br> private function sendEmail()<br> {<br> $storeId = Mage::app()-&gt;getStore()-&gt;getStoreId();<br> $emailId = $this-&gt;helper-&gt;getConfigData('sender_email_identity');<br> $emailFrom = $this-&gt;helper-&gt;getConfigData('email_template');<br> $email_address = 'toemailadddress@gmail.com'</p>
<p> /* Sender Name */<br> $fromName =Mage::getStoreConfig('trans_email/ident_'.$emailFrom.'/name'); </p>
<p> /* Sender Email */<br> $fromEmail = Mage::getStoreConfig('trans_email/ident_'.$emailFrom.'/email');</p>
<p> try{<br> $translate = Mage::getSingleton('core/translate');</p>
<p> /* @var $translate Mage_Core_Model_Translate */<br> $translate-&gt;setTranslateInline(false);</p>
<p> $emailTemplate = Mage::getModel('core/email_template');</p>
<p> /* @var $emailTemplate Mage_Core_Model_Email_Template */<br> $emailTemplate-&gt;setDesignConfig(array('area' =&gt; 'frontend', 'store' =&gt; $storeId));</p>
<p> $emailTemplate-&gt;sendTransactional( $emailId,<br> array('email' =&gt; $fromEmail, 'name' =&gt; $fromName),<br> $email_address,<br> null,<br> array('custom_var1' =&gt; 'Custom Variable Value 1', 'custom_var2' =&gt; 'Custom Variable Value 2')<br> );</p>
<p> $translate-&gt;setTranslateInline(true);<br> }<br> catch (Exception $e){<br> return false;<br> }<br> return true;<br> }</p>
<p>

Step 6 – Create custom_email.html as declared in config.xml under app/locale/en_US/template/email

</p>
<p>&lt;style type="text/css"&gt;<br> body,td { color:#2f2f2f; font:11px/1.35em Verdana, Arial, Helvetica, sans-serif; }<br> .orange { color:#DB7200; }<br>
&lt;/style&gt;</p>
<p>&lt;div style="font:11px/1.35em Verdana, Arial, Helvetica, sans-serif;"&gt;</p>
<p> &lt;table cellspacing="0" cellpadding="0" border="0" width="650"&gt;<br> &lt;tr&gt;<br> &lt;td valign="top"&gt;<br> &lt;p&gt;<br> &lt;strong&gt;Hello &lt;span class="orange"&gt;{{var custom_var1}}&lt;/span&gt;&lt;/strong&gt;,&lt;br/&gt;&lt;br/&gt;<br> {{var custom_var2}}<br> &lt;/b&gt;<br> &lt;/p&gt;<br> &lt;p&gt;<br> Thank you again for purchasing from My Website.<br> &lt;/p&gt;<br> Kind Regards&lt;/br&gt;&lt;/br&gt;</p>
<p> &lt;/td&gt;<br> &lt;/tr&gt;<br> &lt;/table&gt;<br>
&lt;/div&gt;<br>

That’s it, it is as simple as that. Hope this article helped you in some way. Please leave us your comment and let us know what do you think? Thanks.

Discover more from WHO WILL CARE eCommerce

Subscribe now to keep reading and get access to the full archive.

Continue reading