README

Installation

Composer

composer require kreativabyran/kb-mailer

Plugin

Download zip-file from the latest release and install as plugin.

Usage

Register email

First you have to register an email that you later can send. This is done with kbm_register_email(), which should be hooked on init.

Example:

add_action(
   'init',
   function() {
       if ( function_exists( 'kbm_register_email' ) ) {
           kbm_register_email(
               'contact',
               'Contact request',
               array(
                   'name'    => 'Name of person requesting contact',
                   'message' => 'Message from person', 
               )
           );
       }
   }
);

Note that the function_exists() check is only needed when using as plugin, not when installing from composer.

Editing email

Go to wp-admin > KB Mailer to see a list with all registered emails, there you can edit each part of the email, and use the registered content variables in the template.

Send email

Registered emails are sent with kbm_send_email()

$to      = 'contact@example.com';
$name    = 'Oskar Modig';
$message = 'Hi! I would really like to get in touch with you.';
if ( function_exists( 'kbm_send_email' ) ) {
    kbm_send_email(
        'contact',
        $to,
        array(
            'name'    => $name,
            'message' => $message,
        )
    );
} else {
    // Failsafe if plugin is unavailable.
    wp_mail( $to, 'Contact request', "<h1>Contact request from $name</h1><p>$message</p>", array( 'Content-Type: text/html; charset=UTF-8' ) );
}

The failsafe isn't necessary when kb-mailer has been installed from composer.

Configuration

Permissions

KB Mailer defaults to showing the email builder interface in wp-admin to user with the manage_options capability. The required capability can be changed with the kb_mailer_admin_page_capability-filter.

Variable separators

The default variable separator is %. Meaning that %name% entered in the email content will be replaced with the value for that variable. The percentage sign before and/or after the variable id can be replaced with the following filters:

• kb_mailer_content_variable_before
• kb_mailer_content_variable_after