Templates.md

Mailgun - Templates

This is the Mailgun Ruby Templates utilities.

The below assumes you've already installed the Mailgun Ruby SDK in to your project. If not, go back to the master README for instructions.

Usage - Templates

Build a message with a template:

mb_obj = Mailgun::MessageBuilder.new

mb_obj.from("sender@example.com")
mb_obj.add_recipient("to", "recipient@example.com")
mb_obj.subject ("This is the subject!")
message.template('example.template.name')
message.template_version('example.tag')

mg_client.send_message "sending_domain.com", mb_obj

Rails Example. Build a message with a template:

class UserMailer < ApplicationMailer
  def welcome_email
    message = mail(
    	from: "sender@example.com",
    	to: "recipient@example.com",
    	subject: "This is the subject!",
    	template: 'example.template.name'
    ) do |format|
      format.text { render plain: "Test!" }
    end
    message.tap do |message|
      message.mailgun_template_variables ||= {
       'version' => 'example.tag'
      }
    end
  end
end

Template Handlebars

{{#if english}}
<p>This text is in the English language.</p>
{{else if spanish}}
<p>Este texto está en idioma español.</p>
{{else if french}}
<p>Ce texte est en langue française.</p>
{{/if}}

In order to send the spanish version, for example:

message.variable('spanish', 'true')

Also, Rails example:

class UserMailer < ApplicationMailer
  def welcome_email
    message = mail(
    	from: "sender@example.com",
    	to: "recipient@example.com",
    	subject: "This is the subject!",
    	template: 'example.template.name'
    ) do |format|
      format.text { render plain: "Test!" }
    end
    message.tap do |message|
      message.mailgun_variables ||= {
       'spanish' => 'true'
      }
    end
  end
end

More Documentation

See the official Mailgun Templates Docs for more information