Title: WP-EMail Author: Lester Chan Published: January 3, 2006 Last modified: December 18, 2024 --- Search plugins ![](https://ps.w.org/wp-email/assets/banner-772x250.jpg?rev=1206755) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/wp-email/assets/icon.svg?rev=978017) # WP-EMail By [Lester Chan](https://profiles.wordpress.org/gamerz/) [Download](https://downloads.wordpress.org/plugin/wp-email.2.69.3.zip) * [Details](https://mlt.wordpress.org/plugins/wp-email/#description) * [Reviews](https://mlt.wordpress.org/plugins/wp-email/#reviews) * [Development](https://mlt.wordpress.org/plugins/wp-email/#developers) [Support](https://wordpress.org/support/plugin/wp-email/) ## Description ### General Usage 1. Under E-Mail Settings, modify the setting Method Used To Send E-Mail accordingly. If the method is wrong, no email will get sent. 2. You Need To Re-Generate The Permalink (WP-Admin -> Settings -> Permalinks -> Save Changes) 3. Open `wp-content/themes//index.php` (You may place it in single. php, post.php, page.php, etc also) 4. * Find: `` * Simply add this code inside the loop where you want the email link to display:` if(function_exists('email_link')) { email_link(); }` If you DO NOT want the email link to appear in every post/page, DO NOT use the code above. Just use the shortcode by typing [email_link] into the selected post/page content and it will embed the email link into that post/page only. ### Build Status ### Development * [https://github.com/lesterchan/wp-email](https://github.com/lesterchan/wp-email) ### Translations * [http://dev.wp-plugins.org/browser/wp-email/i18n/](http://dev.wp-plugins.org/browser/wp-email/i18n/) ### Credits * Plugin icon by [Yannick](http://yanlu.de) from [Flaticon](http://www.flaticon.com) * Icons courtesy of [FamFamFam](http://www.famfamfam.com/). ### 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 as my school allowance, I will really appreciate it. If not feel free to use it without any obligations. ## Screenshots * [[ * Admin – E-Mail Logs * [[ * Admin – Options Page * [[ * Admin – Templates Page * [[ * Sample E-Mail Post link * [[ * Sample E-Mail Post screen ## FAQ ### Does it support SMTP authentication with servers utilizing SSL encryption? 1. Yes. Go to `WP-Admin -> E-Mail -> Email Options`, under `SMTP Server`, use `ssl:// smtp.gmail.com:465` if you are using Gmail SMTP. ### How do I add this to my theme? 1. Open `wp-content/themes//index.php` (You may place it in single. php, post.php, page.php, etc also) 2. Find: `` 3. Simply add this code **inside the loop** where you want the email link to display:` if(function_exists('email_link')) { email_link(); }` ### How can I customize my E-Mail link? Many customizations can be made from the options page (WP Admin->E-Mail->E-Mail Options). Additionally, you can override the “E-Mail Text Link for Post” and “E-Mail Text Link for Page” options with the first two parameters of the email_link function like this: ``` if(function_exists('email_link')) email_link( 'E-Mail Text Link for Post', 'E-Mail Text Link for Page'); ``` You can also force `email_link()` to return the link rather than echo it by setting the third parameter to false: ``` if(function_exists('email_link')) { $email_link email_link( 'E-Mail Text Link for Post', 'E-Mail Text Link for Page', false); } else { $email_link ''; } echo $email_link; ``` ### How can I show my E-Mail stats? There are two options for this: 1. You can use the included widget by going to Wp-Admin -> Appearance -> Widgets” and using the widget named “Email” 1. You can use a number of included theme functions for displaying various stats. Please continue to read these FAQs for more information. ### How can I display the Most E-Mailed Posts? Simply insert this code into your theme: ``` if (function_exists('get_mostemailed')) get_mostemailed('both', 10); ``` The first parameter is what you want to get, ‘post’, ‘page’, or ‘both’ and defaults to ‘both’. The second parameter is the maximum number of posts/pages you want to get. ### How can I display the Total E-Mails Sent? Simply insert this code into your theme: ``` if (function_exists('get_emails')) get_emails(); ``` ### How can I display the Total E-Mails Sent Successfully? Simply insert this code into your theme: ``` if (function_exists('get_emails_success')) get_emails_success(); ``` ### How can I display the Total E-Mails Sent Unsuccessfully? Simply insert this code into your theme: ``` if (function_exists('get_emails_failed')) get_emails_failed(); ``` ### How do I hide remarks when viewing E-Mail logs in WP-Admin? 1. Open `wp-email.php` 2. Find `define('EMAIL_SHOW_REMARKS', true);` 3. Replace with `define('EMAIL_SHOW_REMARKS', false);` ### How can I keep some post text from being sent in the E-Mail? If you do not want to email a portion of your post’s content, do the following: ``` [donotemail]Text within this tag will not be displayed when emailed[/donotemail] ``` The text within [donotemail][/donotemail] will not be displayed when you are emailing a post or page. However, it will still be displayed as normal on a normal post or page view. Do note that if you are using WP-Print, any text within [donotemail][/ donotemail] will not be printed as well. ### I made changes to the CSS, how can I keep them from being overridden on the next upgrade? WP-Email will load `email-css.css` from your theme’s directory if it exists. If it doesn’t exist then it will load the default `email-css.css` that comes with WP- Email. Just move your custom CSS to the appropriate file in your theme directory and it will be “upgrade-proof” ### How can I make the E-Mail title different from the post title? If you add a custom field with the key “wp-email-title” it will be used as the E- Mail title. ### How can I set a default or suggested remark for the user? If you add a custom field with the key “wp-email-remark” it will be placed in the remarks field in the E-Mail form. ## 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/) February 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/) September 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/) ## Contributors & Developers “WP-EMail” is open source software. The following people have contributed to this plugin. Contributors * [ 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 ### 2.69.3 * FIXED: Remove email_textdomain() ### 2.69.2 * FIXED: PHP Warning * FIXED: Remove load_plugin_textdomain since it is no longer needed since WP 4.6 ### 2.69.1 * FIXED: XSS for text links ### 2.69.0 * NEW: Supports specifying which header to read the user’s IP from. Props Marc Montpas. * FIXED: Added more nonce check to email-manager.php ### 2.68.2 * FIXED: PHP8 deprecated notices ### 2.68.1 * FIXED: Fatal Error on activation as it suppose to be delete_option() and not remove_option ### 2.68.0 * NEW: Uses `wp_mail()` instead of PHPMailer * NEW: Removed SMTP & Mailer Settings ### 2.67.6 FIXED: Notices ### 2.67.5 * FIXED: Email form not appearing if user is not using nice permalink ### 2.67.4 * FIXED: Use `wp_email` instead of `email` as query var. * FIXED: Use `wp_email_popup` instead of `emailpopup` as query var. ### 2.67.3 * FIXED: esc_attr() on form fields to prevent XSS. Props Edward Woodfall. ### 2.67.2 * FIXED: Fixed SQL Injection in inserting email logs. Props [Jxs.nl](http://jxs.nl). ### 2.67.1 * FIXED: Fixed vulnerability in `get_email_ipaddress()` ### 2.67 * FIXED: Notices in Widget Constructor for WordPress 4.3 * FIXED: Remove clean_pre() because it is deprecated. ### 2.66 * NEW: Add viewport meta tag. Props @Luanramos * FIXED: Proper loading of templates. Props @ocean90 * FIXED: Apply custom filters only to the main query. Props @ocean90 ### 2.65 * FIXED: Integration with WP-Stats * FIXED: Added in wp_nonce_field to email-options page ### 2.64 * NEW: Added in `wp_email_template_redirect` filter to allow other plugins disable template redirect when query var contains ’email’ ### 2.63 * NEW: Finally there is custom post type support. Props [nimmolo](http://andrewnimmo.org/). * NEW: Allow Multisite Network Activate * NEW: Uses WordPress uninstall.php file to uninstall the plugin * NEW: Added noindex, nofollow to meta tag to email-standalone.php * FIXED: Use get_the_author() instead of the_author(”, false) ## Meta * Version **2.69.2** * Last updated **1 year ago** * Active installations **2,000+** * WordPress version ** 4.6 or higher ** * Tested up to **6.7.5** * Language * [English (US)](https://wordpress.org/plugins/wp-email/) * Tags * [e-mail](https://mlt.wordpress.org/plugins/tags/e-mail/)[email](https://mlt.wordpress.org/plugins/tags/email/) [mail](https://mlt.wordpress.org/plugins/tags/mail/)[recommend](https://mlt.wordpress.org/plugins/tags/recommend/) [wp-email](https://mlt.wordpress.org/plugins/tags/wp-email/) * [Advanced View](https://mlt.wordpress.org/plugins/wp-email/advanced/) ## Ratings 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/) ## Contributors * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) ## Support 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/)