NAME

Mojolicious::Plugin::Mailgun - Easy Email sending with mailgun

SYNOPSIS

  # Mojolicious::Lite
  plugin 'mailgun' => { mom => {
    api_key => '123',
    domain => 'mom.no',
  }};

  # Mojolicious
  $self->plugin(mailgun => { mom => {
    site => {
      api_key => '123',
      domain => 'mom.no',
  }});

  # in controller named params
  $self->mailgun->send( mom => {
    recipient => 'pop@pop.com',
    subject   => 'use Perl or die;'
    html      => $html,
    inline    => { file => 'public/file.png' },
    sub { my $self,$res = shift },  # receives a Mojo::Transaction from mailgun.
  );

DESCRIPTION

Provides a quick and easy way to send email using the Mailgun API with support for multiple user agents.

OPTIONS

Mojolicious::Plugin::Mailgun can be provided a hash of mailgun sites with api key and domain, or it can read them directly from $c->config->{mailgun} if not provided at load time.

HELPERS

Mojolicious::Plugin::Mailgun implements one helper.

mailgun->send <$site>, <\%post_options>, <$cb>

Send a mail with the mailgun API. This is just a thin wrapper around Mojo::UserAgent to handle authentication settings. See the mailgun sending documentation for more information about the supported arguments to the post_options hash. This API can only be used non-blocking, so the callback is required.

https://documentation.mailgun.com/api-sending.html#sending

METHODS

Mojolicious::Plugin::Mailgun inherits all methods from Mojolicious::Plugin and implements the following new ones.

register

$plugin->register;

Register plugin hooks and helpers in Mojolicious application.

SEE ALSO

Mojolicious

AUTHOR

Marcus Ramberg <mramberg@cpan.org>

COPYRIGHT & LICENSE

Copyright (C) 2017 by Marcus Ramberg.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.