Title: WP-EMail Author: Lester Chan Published: ஜனவரி 3, 2006 Last modified: ஆகஸ்ட் 9, 2026 --- நீட்சிகளை தேடுங்கள் ![](https://ps.w.org/wp-email/assets/banner-772x250.png?rev=3639529) ![](https://ps.w.org/wp-email/assets/icon.svg?rev=978017) # WP-EMail By [Lester Chan](https://profiles.wordpress.org/gamerz/) [பதிவிறக்கு](https://downloads.wordpress.org/plugin/wp-email.3.0.0.zip) * [Details](https://ta.wordpress.org/plugins/wp-email/#description) * [Reviews](https://ta.wordpress.org/plugins/wp-email/#reviews) * [Installation](https://ta.wordpress.org/plugins/wp-email/#installation) * [Development](https://ta.wordpress.org/plugins/wp-email/#developers) [உதவி](https://wordpress.org/support/plugin/wp-email/) ## விளக்கம் WP-EMail puts an “Email This Post” link on your posts and pages. A visitor clicking it gets a small form, fills in their name, their friend’s name and address and an optional remark, and the article goes out through `wp_mail()` — so it uses whatever WordPress itself is set up to send with. Every message is logged, so you can see what was sent, to whom, from which address and whether it arrived. The page title, the subject line, the HTML body, the plain text body and every message the visitor sees are templates you can edit, each with its own list of variables and a button to put the original back. ### Features * An “Email This Post” link built from an HTML template you edit, with the envelope glyph, the wording and the post type as variables * A standalone e-mail page or a popup window * HTML or plain text messages, with the article whole or cut to a word count * Image verification, and a minimum interval between sends, to keep the form off spammers’ lists * A sortable, paginated log of every message, with totals and a one-click purge * A widget and template tags for the most emailed posts and pages * A block on the WP-Stats page, if you have WP-Stats installed ### Donations I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations. ### Usage The plugin works as soon as it is activated. All you have to decide is where the e-mail link appears. **On selected posts and pages**, type the shortcode into the content: ``` [email_link] ``` This works in both block and classic themes, and puts the link exactly where you want it rather than on everything. **On every post and page**, call the template tag from your theme instead. In a classic theme, open `wp-content/themes//index.php` — or `single. php`, `page.php`, and so on — find: ``` ``` and add this inside the loop, where you want the link to show: ``` ``` Use one or the other, not both, or the link appears twice. If the link is there but clicking it gives a 404, re-save your permalinks under ` WP-Admin -> Settings -> Permalinks`. The plugin registers its `/email/` endpoint on activation, but a site with unusual rewrite rules can need the nudge. Everything else is configured under `WP-Admin -> E-Mail -> Settings`, which has two tabs: **Settings** for the link, the form and delivery, and **Templates** for the eight message templates. The log of what has been sent is under `WP-Admin -> E-Mail -> Manage E-Mail`. ### Filters Use `wp_email_capability` to hand a screen to a capability other than the default. The logs screen is gated on `manage_email` and the settings screen on `manage_options`: ``` add_filter( 'wp_email_capability', function ( $capability, $context ) { return 'logs' === $context ? 'edit_posts' : $capability; }, 10, 2 ); ``` Use `wp_email_form_field_values` to pre-fill the form. The plugin uses it itself to fill in a logged-in visitor’s name and address: ``` add_filter( 'wp_email_form_field_values', function ( $values ) { $values['yourremarks'] = 'Thought you would like this.'; return $values; } ); ``` The other three are `wp_email_ipaddress` (the address a send is attributed to), ` wp_email_template_redirect` (whether the plugin takes over the request for its own endpoints) and `wp_email_trust_proxy` (whether the usual forwarding headers may be trusted). ## Screenshots [⌊E-Mail -> Settings, covering the link, the form, the checks and delivery⌉⌊E-Mail- > Settings, covering the link, the form, the checks and delivery⌉[ E-Mail -> Settings, covering the link, the form, the checks and delivery [⌊The Templates tab, holding all eight templates: the page, the message itself, and what a visitor is told when a send succeeds or fails⌉⌊The Templates tab, holding all eight templates: the page, the message itself, and what a visitor is told when a send succeeds or fails⌉[ The Templates tab, holding all eight templates: the page, the message itself, and what a visitor is told when a send succeeds or fails [⌊E-Mail -> Manage E-Mail, the log of what was sent, to whom, and whether it arrived⌉⌊ E-Mail -> Manage E-Mail, the log of what was sent, to whom, and whether it arrived⌉[ E-Mail -> Manage E-Mail, the log of what was sent, to whom, and whether it arrived [⌊The e-mail link in a post, placed with the shortcode⌉⌊The e-mail link in a post, placed with the shortcode⌉[ The e-mail link in a post, placed with the shortcode [⌊The form behind the link, with its image verification⌉⌊The form behind the link, with its image verification⌉[ The form behind the link, with its image verification ## Installation 1. Install and activate the plugin. 2. Re-save your permalinks at `WP-Admin -> Settings -> Permalinks -> Save Changes`, so the e-mail endpoint is registered. 3. Decide where the link appears: type `[email_link]` into a post, or call `email_link()` in your theme. Usage below covers both. 4. Templates and options are at `WP-Admin -> E-Mail -> E-Mail Settings`, and every message sent is listed under `E-Mail Logs`. ## அடிக்கடி கேட்கப்படும் கேள்விகள் ### 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: ``` %EMAIL_ICON% Email This %POST_TYPE% ``` 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. ### I made changes to the CSS, how can I keep them from being overridden on the next upgrade? Put them in your theme’s own stylesheet. Everything the plugin styles sits under the `.wp-email` class, so `.wp-email label { ... }` in your theme is enough to override a rule, and your changes are never touched by an upgrade. Before 3.0.0 the plugin looked for a copy of `email-css.css` in your theme directory and loaded that instead of its own. That is gone: it meant a theme had to reproduce the whole file to change one rule, and every upgrade that added a rule silently skipped those themes. ### How can I make the E-Mail title different from the post title? Add a custom field with the key `wp-email-title`, and it will be used as the E-Mail title. ### How can I set a default or suggested remark for the user? Add a custom field with the key `wp-email-remark`, and it will be placed in the remarks field on the E-Mail form. ### What does the plugin store in my database? Two option rows — `wp_email_options` for the settings and `wp_email_version` for the version it last ran — and one table holding the log. Deleting the plugin from the Plugins screen removes all three, along with every pre-3.0.0 row. ## Reviews ![](https://secure.gravatar.com/avatar/99bdc5c929a4048fafb3c6e0518931a448341c9e7238610b977be00d443b1f2b? s=60&d=retro&r=g) ### 󠀁[Thank you!](https://wordpress.org/support/topic/thank-you-2732/)󠁿 [mapdi](https://profiles.wordpress.org/mapdi/) பிப்ரவரி 25, 2021 Works like a charm. Thank you for this great plugin! ![](https://secure.gravatar.com/avatar/0a49193ed32ae8fb6948a19c2422b3554dcfa54bc7e29dab388608f951819edc? s=60&d=retro&r=g) ### 󠀁[Awesome plugin!](https://wordpress.org/support/topic/awesome-plugin-3777/)󠁿 [bubencode](https://profiles.wordpress.org/bubencode/) செப்டம்பர் 3, 2018 Lester, thank you very much for creation and continuous support and updates to your plugin! Works perfect, very flexible settings and can be customized to any liking. Great job! [ Read all 11 reviews ](https://wordpress.org/support/plugin/wp-email/reviews/) ## பங்களிப்பாளர்கள் & உருவாக்குனர்கள் “WP-EMail” is open source software. The following people have contributed to this plugin. பங்களிப்பாளர்கள் * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) [Translate “WP-EMail” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-email) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wp-email/), check out the [SVN repository](https://plugins.svn.wordpress.org/wp-email/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-email/) by [RSS](https://plugins.trac.wordpress.org/log/wp-email/?limit=100&mode=stop_on_copy&format=rss). ## Changelog ### 3.0.0 * FIXED: Uninstalling left one flood record behind per address that had sent recently. They expire on their own, but until they did the site was still counting down a cooldown for a plugin that was no longer installed * FIXED: Every render of the form minted a ten-minute verification challenge, and rendering it is free and needs no account — so a request loop grew `wp_options` by two rows a time with nothing to stop it. A visitor may now hold ten live challenges at once, which is far more than anyone with several tabs open needs and far fewer than a loop wants. Collapsing to one challenge per visitor would have bounded it too, and would have brought back the bug 3.0.0 fixed, where opening a second form invalidated the first * FIXED: The reverse-DNS lookup for the log ran once per recipient rather than once per send, so the default maximum of five multiplied a blocking call — whose duration is chosen by whoever owns the address’s reverse zone — by five * FIXED: The endpoint checked only that a post was published, so any _published_ post of a non-public post type — a reusable block, a template, a plugin’s private records — could be mailed to an address of the sender’s choosing by an anonymous visitor, with its title coming back in the response. The post type has to be publicly viewable now * FIXED: The flood interval was a read of the log followed, much later, by a write, so requests arriving together all decided they were clear and all sent — it bounded a polite sender and did nothing to a parallel one. The slot is claimed before anything is sent, and an attempt counts whether or not the mailer accepted it; a refused delivery used to cost no cooldown at all * FIXED: Image verification failed _open_. With the setting on and GD missing — the state a host lands in after a PHP upgrade — the check was skipped entirely and the form’s only anti-automation control disappeared with nothing to say so. The form now refuses to submit until an administrator turns it off or installs GD. `wp_email_captcha_available` overrides the detection * FIXED: The verification image was 55×15, one call to the built-in GD font at a fixed pitch from a fixed origin, no noise and no distortion, which made it readable by thirty-odd reference bitmaps and a per-cell crop. Each character is now drawn, rotated and placed on its own, over speckle and through two lines that share its ink * FIXED: The name, address and header-token checks ran only when the matching field was switched _on_ — so turning a field off turned its validation off with it, while the value was still read and still used. A submission does not have to come from the form; the checks are unconditional now, and only “this field is required” still follows the setting * BREAKING: WordPress 6.8 and PHP 8.2 are now the minimum. A site on anything older will not be offered this update at all. * BREAKING: The `email_form-fieldvalues` filter is renamed `wp_email_form_field_values`. There is no compatibility shim. * BREAKING: The eighteen `wp_options` rows the plugin used are consolidated into` wp_email_options` and `wp_email_version`. Your settings are migrated automatically on upgrade and the old rows are deleted. * BREAKING: WP-EMail’s three checkboxes on the WP-Stats options screen become one setting on its own settings screen, and the shared `stats_display` and `stats_mostlimit` rows are no longer read. Update all seven WP-Stats plugins together. * BREAKING: `EMAIL_SHOW_REMARKS` is renamed `WP_EMAIL_SHOW_REMARKS`. * BREAKING: The settings screen moves from `?page=wp-email-options` to `?page=wp- email-settings` and is gated on `manage_options`; the logs screen keeps `manage_email`. * BREAKING: `email_wpstats_instance()`, `email_page_admin_general_stats()`, `email_page_admin_most_stats()`,` email_page_general_stats()` and `email_page_most_stats()` are removed, along with the global `email_popup()` in JavaScript. * BREAKING: The E-Mail Icon setting and the two bundled GIFs are gone, replaced by one inline SVG. A custom link template using `%EMAIL_ICON_URL%` is rewritten to `%EMAIL_ICON%` automatically, the whole `` at a time where it sat in one. * BREAKING: The E-Mail Text Link For Post, E-Mail Text Link For Page and E-Mail Text Link Style settings are removed, and `%EMAIL_TEXT%` with them. The link is one HTML template, migrated from whatever those three said. The first two parameters of `email_link()` are accepted and ignored. * BREAKING: `%EMAIL_POPUP%` is now the _value_ of a `data-wp-email-popup` attribute rather than the whole attribute, because a bare variable in attribute position did not survive the sanitizer. * NEW: A `%POST_TYPE%` link variable, which becomes the post type’s singular label—` Post`, `Page`, or a custom type’s own. * CHANGED: The settings screen is two tabs, Settings and Templates, rather than one page with the eight templates several screenfuls down. * BREAKING: The plugin no longer loads `email-css.css` from your theme directory. * NEW: Restructured into `includes/class-wp-email-*.php`. The template tags — ` email_link()`, `get_emails()`, `get_mostemailed()` and the rest — keep their names and signatures. * NEW: The settings screen is built on the WordPress Settings API, and the e-mail log is a standard admin list table with sortable columns and a per-page screen option. * NEW: Image verification no longer uses PHP sessions. Sessions are unavailable behind most page caches and on a lot of hosting, which made verification fail outright; the challenge now lives in a short-lived transient issued per form. If your server has no GD library the option is shown as unavailable instead of silently rejecting every message. * NEW: A `wp_email_capability` filter for handing either screen to a capability of your own. * NEW: The e-mail table gained indexes on the post ID, status and IP columns. * NEW: Added a PHPUnit test suite, a Vitest suite for the JavaScript, and GitHub Actions CI. * CHANGED: Proxy headers such as `X-Forwarded-For` are no longer trusted by default, because trusting them let anyone bypass the interval between e-mails. Sites behind Cloudflare or another reverse proxy must opt in via the `Header That Contains The IP` setting, the `WP_EMAIL_TRUST_PROXY` constant, or the `wp_email_trust_proxy` filter. See the FAQ. * CHANGED: The JavaScript was rewritten without jQuery, moved to `js/`, and every inline `onclick` is gone. * CHANGED: The two envelope images and the loading GIF are replaced by one inline SVG and a CSS spinner, so the plugin ships no images at all. * CHANGED: One stylesheet, `css/wp-email.css`, written with CSS logical properties, serves both text directions. `email-css-rtl.css` is deleted. * FIXED: Uninstalling on a multisite network called `wp_get_sites()`, removed in WordPress 5.1, and fatalled instead of cleaning up. It also stopped at the hundredth site, leaving options and tables behind on every site after that. * FIXED: The e-mail form on a Page posted to an `emailpage/` URL that was never registered. * FIXED: The first validation error lost part of its text and rendered a stray ` `. * FIXED: A failed submission came back with every field blank instead of keeping what you typed. * FIXED: Logged names and remarks were escaped twice, so apostrophes accumulated backslashes. * FIXED: `[email_link]` and `[donotemail]` stopped working for the rest of the page once an e-mail body had been rendered. * FIXED: The library the form used to load on every page of the site, whether or not anything on that page used it. * FIXED: The e-mail status was stored translated, so changing your site language orphaned old log rows from the totals. Existing rows are corrected on upgrade. * FIXED: The e-mail log’s `Logs per page` setting under Screen Options was thrown away when applied, so the log always paged at twenty whatever you set it to. * NOTE: Four translated strings carried whitespace a translator cannot see in a msgid list, let alone reproduce: the Mail It button’s label was padded with five spaces either side to widen it, and three messages ended in a trailing space so a value could be glued on. The padding moved to CSS and the values moved into`% s` placeholders. Those four msgids changed, so existing translations of them fall back to English until they are retranslated * NOTE: The “From” and “To” log columns carry translator context now, because a single word out of context is not enough to translate from. Those two msgids changed, so existing translations of them fall back to English until they are retranslated ## Meta * Version **3.0.0** * Last updated **5 மணி நேரங்கள் முன்பு** * Active installations **1,000+** * WordPress version ** 6.8 அல்லது மேல் ** * Tested up to **7.0.3** * PHP version ** 8.2 அல்லது மேல் ** * Language * [English (US)](https://wordpress.org/plugins/wp-email/) * Tags * [e-mail](https://ta.wordpress.org/plugins/tags/e-mail/)[email](https://ta.wordpress.org/plugins/tags/email/) [mail](https://ta.wordpress.org/plugins/tags/mail/)[recommend](https://ta.wordpress.org/plugins/tags/recommend/) [wp-email](https://ta.wordpress.org/plugins/tags/wp-email/) * [Advanced View](https://ta.wordpress.org/plugins/wp-email/advanced/) ## மதிப்பீடுகள் 4.5 out of 5 stars. * [ 8 5-star reviews ](https://wordpress.org/support/plugin/wp-email/reviews/?filter=5) * [ 2 4-star reviews ](https://wordpress.org/support/plugin/wp-email/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/wp-email/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/wp-email/reviews/?filter=2) * [ 1 1-star review ](https://wordpress.org/support/plugin/wp-email/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-email/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wp-email/reviews/) ## பங்களிப்பாளர்கள் * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) ## உதவி Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wp-email/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://lesterchan.net/site/donation/)