Professional email for
PageMotor

What does EP Email do?

By default, PageMotor sends email using your server’s built-in mail() function. This works, but emails are frequently blocked, delayed, or marked as spam — because your server isn’t recognised as a trusted email sender.

EP Email fixes this by routing your emails through a proper SMTP server — the same way Gmail, Outlook, and every other email provider delivers mail.

Installing EP Email

EP Email installs like any PageMotor plugin. The process takes under a minute.

Setting up SMTP delivery

SMTP is the industry standard for sending email reliably. EP Email connects to your SMTP provider to deliver messages that actually reach inboxes.

SMTP Settings Reference

Building contact forms

EP Email includes a powerful contact form system. Define forms in JSON and render them with a shortcode — with conditional logic, custom field types, and built-in validation.

Adding a Form

The [ep-email] shortcode renders forms defined in JSON:

JSON Structure

Each form is a named object containing a recipient, subject, success message, button text, and an array of fields:

{
    "contact": {
        "recipient": "info@example.com",
        "subject": "Contact from {name}",
        "success": "Thanks! We'll reply within 24 hours.",
        "button": "Send Message",
        "fields": [
            {"type": "text", "name": "name", "label": "Name", "required": true},
            {"type": "email", "name": "email", "label": "Email", "required": true},
            {"type": "textarea", "name": "message", "label": "Message",
             "rows": 5, "required": true}
        ]
    }
}

Form Properties

Field Types

Field Properties

Conditional Logic

Show or hide fields based on another field’s value:

{
    "type": "select",
    "name": "department",
    "label": "Department",
    "options": ["Sales", "Support", "Billing"]
},
{
    "type": "text",
    "name": "order_number",
    "label": "Order Number",
    "conditional": {"field": "department", "value": "Billing"}
}

The order_number field only appears when “Billing” is selected. Multiple values are supported: "value": ["Support", "Billing"]

Custom Messages

Override default UI messages per form:

{
    "contact": {
        "recipient": "info@example.com",
        "messages": {
            "sending": "Submitting your enquiry...",
            "error": "Something went wrong. Please try again.",
            "network_error": "Connection failed. Check your internet.",
            "required": "{label} is required.",
            "invalid_email": "Please enter a valid email for {label}.",
            "success": "Thanks! We'll be in touch soon."
        },
        "fields": [ ... ]
    }
}

Messages Reference

Extending EP Email

EP Email’s extension system lets developers build add-ons that integrate deeply with the contact form engine. Extensions can register custom field types, hook into submissions, add settings, and modify frontend behaviour.

Building an Extension

An EP Email extension is a standard PageMotor plugin that registers an EP_Email_Extension subclass:

Quick Start Example

// In your plugin's construct() method:
public function construct() {
    if (!class_exists('EP_Email_Extension'))
        return;

    require_once $this->path . '/includes/class-my-extension.php';
    $ext = new My_Extension();
    EP_Email_Extension::register($ext);
}

File Uploads add-on

The EP Email File Uploads extension adds drag-and-drop file upload fields to your contact forms. Files are attached directly to the notification email as MIME attachments — they are not stored on your server.

Usage

Add a file field to any form by using "type": "file" in your JSON definition:

{
    "application": {
        "recipient": "hr@example.com",
        "subject": "Application from {name}",
        "fields": [
            {"type": "text", "name": "name", "label": "Full Name", "required": true},
            {"type": "email", "name": "email", "label": "Email", "required": true},
            {"type": "file", "name": "resume", "label": "Resume / CV", "required": true}
        ]
    }
}

Configuration

File upload settings are configured in EP Email Settings under the File Uploads section:

Tracking delivery

EP Email maintains a complete log of every email your site sends. The log records the recipient, subject, delivery status, and timestamp for each message.

Common questions & fixes