WP-EMail

About this plugin

[email_link]

<?php while ( have_posts() ) : the_post(); ?>

<?php if ( function_exists( 'email_link' ) ) { email_link(); } ?>

add_filter( 'wp_email_capability', function ( $capability, $context ) {
    return 'logs' === $context ? 'edit_posts' : $capability;
}, 10, 2 );

add_filter( 'wp_email_form_field_values', function ( $values ) {
    $values['yourremarks'] = 'Thought you would like this.';

    return $values;
} );

Questions

How does the plugin send mail?

Through wp_mail(), so it uses whatever WordPress itself is configured to use. The plugin dropped its own SMTP settings in 2.68.0; if you need SMTP, install an SMTP plugin and WP-EMail will follow it.

How can I customize my E-Mail link?

Edit the E-Mail Link Template under WP-Admin -> E-Mail -> Settings. It is the whole of the link’s markup, and it ships as:

<a href="%EMAIL_URL%" data-wp-email-popup="%EMAIL_POPUP%" title="Email This %POST_TYPE%" rel="nofollow">%EMAIL_ICON% Email This %POST_TYPE%</a>

Four variables are available:

• %EMAIL_URL% — the e-mail page or popup for this post
• %EMAIL_POPUP% — 1 when the E-Mail Link Type is the popup, 0 otherwise; it belongs inside the data-wp-email-popup attribute
• %EMAIL_ICON% — the envelope glyph, drawn inline
• %POST_TYPE% — the singular name of what is being viewed: Post, Page, or a custom post type’s own label

Leave one out to drop it. A template without %EMAIL_ICON% is a text link; one holding nothing but %EMAIL_ICON% is an icon, and the anchor’s title is then what a screen reader announces. Restore Default Template puts the shipped markup back.

An unrecognised variable is left in the markup as written rather than blanked, so a typo shows up on the page instead of silently emptying the link.

Setting the third parameter of email_link() to false returns the link instead of echoing it:

$email_link = function_exists( 'email_link' ) ? email_link( '', '', false ) : '';

echo $email_link;

The first two parameters are still accepted so that a theme written before 3.0.0 does not fatal, but they no longer do anything.

How can I show my E-Mail stats?

Two ways. Add the widget named “Email” under WP-Admin -> Appearance -> Widgets, or call one of the template tags from your theme.

How can I display the Most E-Mailed Posts?

Insert this into your theme:

if ( function_exists( 'get_mostemailed' ) ) {
    get_mostemailed( 'both', 10 );
}

The first parameter is what to list — post, page or both — and the second is how many.

How can I display the totals?

get_emails() for everything sent, get_emails_success() for what went out successfully, get_emails_failed() for what did not, and get_email_count() for one post:

if ( function_exists( 'get_emails' ) ) {
    get_emails();
}

Visitors are told to wait before sending, or every log row shows the same IP

Your site is behind a reverse proxy or CDN — Cloudflare, a load balancer, nginx in front of Apache — so the address PHP sees is the proxy’s, not the visitor’s. Because the interval between e-mails is keyed on that address, every visitor shares one interval and each of them is told to wait for somebody else’s send.

The real address is in a forwarded header, but WP-EMail ignores those by default: any client can send one with any value, so trusting them blindly lets a visitor forge an address and bypass the interval entirely. Opt in only if a proxy you control actually sets the header.

If you know which header it is, name it under WP-Admin -> E-Mail -> Settings in the Header That Contains The IP field — for example HTTP_CF_CONNECTING_IP for Cloudflare. That is the narrowest option, and the one to prefer.

To trust the usual set instead (X-Forwarded-For, CF-Connecting-IP and friends), add this to wp-config.php above the /* That's all, stop editing! */ line:

define( 'WP_EMAIL_TRUST_PROXY', true );

If you need to decide per request — say, only trust the header when the request arrives from your load balancer — use the filter instead:

add_filter( 'wp_email_trust_proxy', function () {
    return isset( $_SERVER['REMOTE_ADDR'] ) && '10.0.0.1' === $_SERVER['REMOTE_ADDR'];
} );

With none of the three set, the plugin uses REMOTE_ADDR — correct on a plain host, and the proxy’s address behind one.

How do I hide remarks when viewing E-Mail logs in WP-Admin?

Add this to your wp-config.php:

define( 'WP_EMAIL_SHOW_REMARKS', false );

The constant was called EMAIL_SHOW_REMARKS before 3.0.0. The plugin only defines it if you have not, so your setting survives upgrades.

How can I keep some post text from being sent in the E-Mail?

Wrap it:

[donotemail]Text within this tag will not be displayed when emailed[/donotemail]

The text inside will not appear in the message, but it will still show on the post or page as normal. Note that if you also run WP-Print, text inside [donotemail] will not be printed either.