{"id":1259,"date":"2006-01-03T07:46:28","date_gmt":"2006-01-03T07:46:28","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wp-email\/"},"modified":"2024-12-18T14:25:20","modified_gmt":"2024-12-18T14:25:20","slug":"wp-email","status":"publish","type":"plugin","link":"https:\/\/szl.wordpress.org\/plugins\/wp-email\/","author":259,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.69.2","stable_tag":"2.69.3","tested":"6.7.5","requires":"4.6","requires_php":"","requires_plugins":null,"header_name":"WP-EMail","header_author":"Lester 'GaMerZ' Chan","header_description":"","assets_banners_color":"e9eaec","last_updated":"2024-12-18 14:25:20","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/lesterchan.net\/site\/donation\/","header_plugin_uri":"https:\/\/lesterchan.net\/portfolio\/programming\/php\/","header_author_uri":"https:\/\/lesterchan.net","rating":4.5,"author_block_rating":0,"active_installs":2000,"downloads":514920,"num_ratings":11,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.00":{"tag":"1.00","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.00b":{"tag":"2.00b","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.01":{"tag":"2.01","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.02":{"tag":"2.02","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.03":{"tag":"2.03","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.04":{"tag":"2.04","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.04a":{"tag":"2.04a","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.05":{"tag":"2.05","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.06":{"tag":"2.06","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.07":{"tag":"2.07","author":"GamerZ","date":"2007-03-17 07:03:19"},"2.10":{"tag":"2.10","author":"GamerZ","date":"2007-03-21 07:42:29"},"2.11":{"tag":"2.11","author":"GamerZ","date":"2007-06-23 03:40:15"},"2.20":{"tag":"2.20","author":"GamerZ","date":"2007-09-30 08:16:37"},"2.30":{"tag":"2.30","author":"GamerZ","date":"2008-06-10 07:24:26"},"2.31":{"tag":"2.31","author":"GamerZ","date":"2008-07-15 14:43:33"},"2.40":{"tag":"2.40","author":"GamerZ","date":"2009-02-07 13:56:27"},"2.50":{"tag":"2.50","author":"aaroncampbell","date":"2010-02-07 19:35:53"},"2.51":{"tag":"2.51","author":"aaroncampbell","date":"2010-02-09 01:48:14"},"2.52":{"tag":"2.52","author":"aaroncampbell","date":"2010-04-27 23:14:10"},"2.61":{"tag":"2.61","author":"GamerZ","date":"2014-04-17 01:52:08"},"2.62":{"tag":"2.62","author":"GamerZ","date":"2014-04-17 02:35:01"},"2.63":{"tag":"2.63","author":"GamerZ","date":"2014-09-05 02:42:54"},"2.64":{"tag":"2.64","author":"GamerZ","date":"2014-12-18 03:32:22"},"2.65":{"tag":"2.65","author":"GamerZ","date":"2015-01-09 03:07:08"},"2.66":{"tag":"2.66","author":"GamerZ","date":"2015-04-21 13:54:41"},"2.67":{"tag":"2.67","author":"GamerZ","date":"2015-11-23 03:04:56"},"2.67.1":{"tag":"2.67.1","author":"GamerZ","date":"2016-04-14 03:52:19"},"2.67.2":{"tag":"2.67.2","author":"GamerZ","date":"2016-05-17 02:22:23"},"2.67.3":{"tag":"2.67.3","author":"GamerZ","date":"2016-12-08 03:41:21"},"2.67.4":{"tag":"2.67.4","author":"GamerZ","date":"2017-03-31 02:32:40"},"2.67.5":{"tag":"2.67.5","author":"GamerZ","date":"2017-03-31 10:47:05"},"2.67.6":{"tag":"2.67.6","author":"GamerZ","date":"2020-05-20 01:42:37"},"2.68.0":{"tag":"2.68.0","author":"GamerZ","date":"2020-08-12 11:43:17"},"2.68.1":{"tag":"2.68.1","author":"GamerZ","date":"2020-08-20 02:21:38"},"2.68.2":{"tag":"2.68.2","author":"GamerZ","date":"2022-02-05 06:21:42"},"2.69.0":{"tag":"2.69.0","author":"GamerZ","date":"2022-05-25 02:40:04"},"2.69.1":{"tag":"2.69.1","author":"GamerZ","date":"2023-08-09 03:05:02"},"2.69.2":{"tag":"2.69.2","author":"GamerZ","date":"2024-12-18 01:03:35"},"2.69.3":{"tag":"2.69.3","author":"GamerZ","date":"2024-12-18 14:25:20"}},"upgrade_notice":[],"ratings":{"1":"1","2":0,"3":0,"4":"2","5":"8"},"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":978017,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":1206755,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":1206755,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.00","2.00b","2.01","2.02","2.03","2.04","2.04a","2.05","2.06","2.07","2.10","2.11","2.20","2.30","2.31","2.40","2.50","2.51","2.52","2.61","2.62","2.63","2.64","2.65","2.66","2.67","2.67.1","2.67.2","2.67.3","2.67.4","2.67.5","2.67.6","2.68.0","2.68.1","2.68.2","2.69.0","2.69.1","2.69.2","2.69.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":1206755,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":1206755,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":1206755,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":1206755,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":1206755,"resolution":"5","location":"assets","locale":""}},"screenshots":{"1":"Admin - E-Mail Logs","2":"Admin - Options Page","3":"Admin - Templates Page","4":"Sample E-Mail Post link","5":"Sample E-Mail Post screen"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[3152,267,450,3465,26735],"plugin_category":[41,59],"plugin_contributors":[77620],"plugin_business_model":[],"class_list":["post-1259","plugin","type-plugin","status-publish","hentry","plugin_tags-e-mail","plugin_tags-email","plugin_tags-mail","plugin_tags-recommend","plugin_tags-wp-email","plugin_category-communication","plugin_category-utilities-and-tools","plugin_contributors-gamerz","plugin_committers-gamerz"],"banners":{"banner":"https:\/\/ps.w.org\/wp-email\/assets\/banner-772x250.jpg?rev=1206755","banner_2x":"https:\/\/ps.w.org\/wp-email\/assets\/banner-1544x500.jpg?rev=1206755","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/wp-email\/assets\/icon.svg?rev=978017","icon":"https:\/\/ps.w.org\/wp-email\/assets\/icon.svg?rev=978017","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-email\/assets\/screenshot-1.png?rev=1206755","caption":"Admin - E-Mail Logs"},{"src":"https:\/\/ps.w.org\/wp-email\/assets\/screenshot-2.png?rev=1206755","caption":"Admin - Options Page"},{"src":"https:\/\/ps.w.org\/wp-email\/assets\/screenshot-3.png?rev=1206755","caption":"Admin - Templates Page"},{"src":"https:\/\/ps.w.org\/wp-email\/assets\/screenshot-4.png?rev=1206755","caption":"Sample E-Mail Post link"},{"src":"https:\/\/ps.w.org\/wp-email\/assets\/screenshot-5.png?rev=1206755","caption":"Sample E-Mail Post screen"}],"raw_content":"<!--section=description-->\n<h3>General Usage<\/h3>\n\n<ol>\n<li>Under E-Mail Settings, modify the setting Method Used To Send E-Mail accordingly. If the method is wrong, no email will get sent.<\/li>\n<li>You Need To Re-Generate The Permalink (WP-Admin -&gt; Settings -&gt; Permalinks -&gt; Save Changes)<\/li>\n<li>Open <code>wp-content\/themes\/&lt;YOUR THEME NAME&gt;\/index.php<\/code> (You may place it in single.php, post.php, page.php, etc also)\n\n<ul>\n<li>Find: <code>&lt;?php while (have_posts()) : the_post(); ?&gt;<\/code><\/li>\n<li>Simply add this code inside the loop where you want the email link to display: <code>if(function_exists('email_link')) { email_link(); }<\/code><\/li>\n<\/ul><\/li>\n<\/ol>\n\n<p>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.<\/p>\n\n<h3>Build Status<\/h3>\n\n<p><a href=\"https:\/\/travis-ci.org\/lesterchan\/wp-email\"><\/a><\/p>\n\n<h3>Development<\/h3>\n\n<ul>\n<li><a href=\"https:\/\/github.com\/lesterchan\/wp-email\" title=\"https:\/\/github.com\/lesterchan\/wp-email\">https:\/\/github.com\/lesterchan\/wp-email<\/a><\/li>\n<\/ul>\n\n<h3>Translations<\/h3>\n\n<ul>\n<li><a href=\"http:\/\/dev.wp-plugins.org\/browser\/wp-email\/i18n\/\" title=\"http:\/\/dev.wp-plugins.org\/browser\/wp-email\/i18n\/\">http:\/\/dev.wp-plugins.org\/browser\/wp-email\/i18n\/<\/a><\/li>\n<\/ul>\n\n<h3>Credits<\/h3>\n\n<ul>\n<li>Plugin icon by <a href=\"http:\/\/yanlu.de\">Yannick<\/a> from <a href=\"http:\/\/www.flaticon.com\">Flaticon<\/a><\/li>\n<li>Icons courtesy of <a href=\"http:\/\/www.famfamfam.com\/\">FamFamFam<\/a>.<\/li>\n<\/ul>\n\n<h3>Donations<\/h3>\n\n<p>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.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='does%20it%20support%20smtp%20authentication%20with%20servers%20utilizing%20ssl%20encryption%3F'><h3>Does it support SMTP authentication with servers utilizing SSL encryption?<\/h3><\/dt>\n<dd><ol>\n<li>Yes. Go to <code>WP-Admin -&gt; E-Mail -&gt; Email Options<\/code>, under <code>SMTP Server<\/code>, use <code>ssl:\/\/smtp.gmail.com:465<\/code> if you are using Gmail SMTP.<\/li>\n<\/ol><\/dd>\n<dt id='how%20do%20i%20add%20this%20to%20my%20theme%3F'><h3>How do I add this to my theme?<\/h3><\/dt>\n<dd><ol>\n<li>Open <code>wp-content\/themes\/&lt;YOUR THEME NAME&gt;\/index.php<\/code> (You may place it in single.php, post.php, page.php, etc also)<\/li>\n<li>Find: <code>&lt;?php while (have_posts()) : the_post(); ?&gt;<\/code><\/li>\n<li>Simply add this code <strong>inside the loop<\/strong> where you want the email link to display: <code>if(function_exists('email_link')) { email_link(); }<\/code><\/li>\n<\/ol><\/dd>\n<dt id='how%20can%20i%20customize%20my%20e-mail%20link%3F'><h3>How can I customize my E-Mail link?<\/h3><\/dt>\n<dd><p>Many customizations can be made from the options page (WP Admin-&gt;E-Mail-&gt;E-Mail Options).<\/p>\n\n<p>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:<\/p>\n\n<pre><code>if(function_exists('email_link'))\n    email_link( 'E-Mail Text Link for Post', 'E-Mail Text Link for Page');\n<\/code><\/pre>\n\n<p>You can also force <code>email_link()<\/code> to return the link rather than echo it by setting the third parameter to false:<\/p>\n\n<pre><code>if(function_exists('email_link')) {\n    $email_link email_link( 'E-Mail Text Link for Post', 'E-Mail Text Link for Page', false);\n} else {\n    $email_link '';\n}\n\necho $email_link;\n<\/code><\/pre><\/dd>\n<dt id='how%20can%20i%20show%20my%20e-mail%20stats%3F'><h3>How can I show my E-Mail stats?<\/h3><\/dt>\n<dd><p>There are two options for this:\n1. You can use the included widget by going to Wp-Admin -&gt; Appearance -&gt; Widgets\" and using the widget named \"Email\"\n1. You can use a number of included theme functions for displaying various stats.  Please continue to read these FAQs for more information.<\/p><\/dd>\n<dt id='how%20can%20i%20display%20the%20most%20e-mailed%20posts%3F'><h3>How can I display the Most E-Mailed Posts?<\/h3><\/dt>\n<dd><p>Simply insert this code into your theme:<\/p>\n\n<pre><code>if (function_exists('get_mostemailed'))\n    get_mostemailed('both', 10);\n<\/code><\/pre>\n\n<p>The first parameter is what you want to get, 'post', 'page', or 'both' and defaults to 'both'.\nThe second parameter is the maximum number of posts\/pages you want to get.<\/p><\/dd>\n<dt id='how%20can%20i%20display%20the%20total%20e-mails%20sent%3F'><h3>How can I display the Total E-Mails Sent?<\/h3><\/dt>\n<dd><p>Simply insert this code into your theme:<\/p>\n\n<pre><code>if (function_exists('get_emails'))\n    get_emails();\n<\/code><\/pre><\/dd>\n<dt id='how%20can%20i%20display%20the%20total%20e-mails%20sent%20successfully%3F'><h3>How can I display the Total E-Mails Sent Successfully?<\/h3><\/dt>\n<dd><p>Simply insert this code into your theme:<\/p>\n\n<pre><code>if (function_exists('get_emails_success'))\n    get_emails_success();\n<\/code><\/pre><\/dd>\n<dt id='how%20can%20i%20display%20the%20total%20e-mails%20sent%20unsuccessfully%3F'><h3>How can I display the Total E-Mails Sent Unsuccessfully?<\/h3><\/dt>\n<dd><p>Simply insert this code into your theme:<\/p>\n\n<pre><code>if (function_exists('get_emails_failed'))\n    get_emails_failed();\n<\/code><\/pre><\/dd>\n<dt id='how%20do%20i%20hide%20remarks%20when%20viewing%20e-mail%20logs%20in%20wp-admin%3F'><h3>How do I hide remarks when viewing E-Mail logs in WP-Admin?<\/h3><\/dt>\n<dd><ol>\n<li>Open <code>wp-email.php<\/code><\/li>\n<li>Find <code>define('EMAIL_SHOW_REMARKS', true);<\/code><\/li>\n<li>Replace with <code>define('EMAIL_SHOW_REMARKS', false);<\/code><\/li>\n<\/ol><\/dd>\n<dt id='how%20can%20i%20keep%20some%20post%20text%20from%20being%20sent%20in%20the%20e-mail%3F'><h3>How can I keep some post text from being sent in the E-Mail?<\/h3><\/dt>\n<dd><p>If you do not want to email a portion of your post's content, do the following:<\/p>\n\n<pre><code>[donotemail]Text within this tag will not be displayed when emailed[\/donotemail]\n<\/code><\/pre>\n\n<p>The text within [donotemail][\/donotemail] will not be displayed when you are emailing a post or page.\nHowever, it will still be displayed as normal on a normal post or page view.\nDo note that if you are using WP-Print, any text within [donotemail][\/donotemail] will not be printed as well.<\/p><\/dd>\n<dt id='i%20made%20changes%20to%20the%20css%2C%20how%20can%20i%20keep%20them%20from%20being%20overridden%20on%20the%20next%20upgrade%3F'><h3>I made changes to the CSS, how can I keep them from being overridden on the next upgrade?<\/h3><\/dt>\n<dd><p>WP-Email will load <code>email-css.css<\/code> from your theme's directory if it exists.  If it doesn't exist then it will load the default <code>email-css.css<\/code> that comes with WP-Email.  Just move your custom CSS to the appropriate file in your theme directory and it will be \"upgrade-proof\"<\/p><\/dd>\n<dt id='how%20can%20i%20make%20the%20e-mail%20title%20different%20from%20the%20post%20title%3F'><h3>How can I make the E-Mail title different from the post title?<\/h3><\/dt>\n<dd><p>If you add a custom field with the key \"wp-email-title\" it will be used as the E-Mail title.<\/p><\/dd>\n<dt id='how%20can%20i%20set%20a%20default%20or%20suggested%20remark%20for%20the%20user%3F'><h3>How can I set a default or suggested remark for the user?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h3>2.69.3<\/h3>\n\n<ul>\n<li>FIXED: Remove email_textdomain()<\/li>\n<\/ul>\n\n<h3>2.69.2<\/h3>\n\n<ul>\n<li>FIXED: PHP Warning<\/li>\n<li>FIXED: Remove load_plugin_textdomain since it is no longer needed since WP 4.6<\/li>\n<\/ul>\n\n<h3>2.69.1<\/h3>\n\n<ul>\n<li>FIXED: XSS for text links<\/li>\n<\/ul>\n\n<h3>2.69.0<\/h3>\n\n<ul>\n<li>NEW: Supports specifying which header to read the user's IP from. Props Marc Montpas.<\/li>\n<li>FIXED: Added more nonce check to email-manager.php<\/li>\n<\/ul>\n\n<h3>2.68.2<\/h3>\n\n<ul>\n<li>FIXED: PHP8 deprecated notices<\/li>\n<\/ul>\n\n<h3>2.68.1<\/h3>\n\n<ul>\n<li>FIXED: Fatal Error on activation as it suppose to be delete_option() and not remove_option<\/li>\n<\/ul>\n\n<h3>2.68.0<\/h3>\n\n<ul>\n<li>NEW: Uses <code>wp_mail()<\/code> instead of PHPMailer<\/li>\n<li>NEW: Removed SMTP &amp; Mailer Settings<\/li>\n<\/ul>\n\n<h3>2.67.6<\/h3>\n\n<p>FIXED: Notices<\/p>\n\n<h3>2.67.5<\/h3>\n\n<ul>\n<li>FIXED: Email form not appearing if user is not using nice permalink<\/li>\n<\/ul>\n\n<h3>2.67.4<\/h3>\n\n<ul>\n<li>FIXED: Use <code>wp_email<\/code> instead of <code>email<\/code> as query var.<\/li>\n<li>FIXED: Use <code>wp_email_popup<\/code> instead of <code>emailpopup<\/code> as query var.<\/li>\n<\/ul>\n\n<h3>2.67.3<\/h3>\n\n<ul>\n<li>FIXED: esc_attr() on form fields to prevent XSS. Props Edward Woodfall.<\/li>\n<\/ul>\n\n<h3>2.67.2<\/h3>\n\n<ul>\n<li>FIXED: Fixed SQL Injection in inserting email logs. Props <a href=\"http:\/\/jxs.nl\">Jxs.nl<\/a>.<\/li>\n<\/ul>\n\n<h3>2.67.1<\/h3>\n\n<ul>\n<li>FIXED: Fixed vulnerability in <code>get_email_ipaddress()<\/code><\/li>\n<\/ul>\n\n<h3>2.67<\/h3>\n\n<ul>\n<li>FIXED: Notices in Widget Constructor for WordPress 4.3<\/li>\n<li>FIXED: Remove clean_pre() because it is deprecated.<\/li>\n<\/ul>\n\n<h3>2.66<\/h3>\n\n<ul>\n<li>NEW: Add viewport meta tag. Props @Luanramos<\/li>\n<li>FIXED: Proper loading of templates. Props @ocean90<\/li>\n<li>FIXED: Apply custom filters only to the main query. Props @ocean90<\/li>\n<\/ul>\n\n<h3>2.65<\/h3>\n\n<ul>\n<li>FIXED: Integration with WP-Stats<\/li>\n<li>FIXED: Added in wp_nonce_field to email-options page<\/li>\n<\/ul>\n\n<h3>2.64<\/h3>\n\n<ul>\n<li>NEW: Added in <code>wp_email_template_redirect<\/code> filter to allow other plugins disable template redirect when query var contains 'email'<\/li>\n<\/ul>\n\n<h3>2.63<\/h3>\n\n<ul>\n<li>NEW: Finally there is custom post type support. Props <a href=\"http:\/\/andrewnimmo.org\/\" title=\"nimmolo\">nimmolo<\/a>.<\/li>\n<li>NEW: Allow Multisite Network Activate<\/li>\n<li>NEW: Uses WordPress uninstall.php file to uninstall the plugin<\/li>\n<li>NEW: Added noindex, nofollow to meta tag to email-standalone.php<\/li>\n<li>FIXED: Use get_the_author() instead of the_author('', false)<\/li>\n<\/ul>","raw_excerpt":"Allows people to recommend\/send your WordPress blog&#039;s post\/page to a friend.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/1259","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=1259"}],"author":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/gamerz"}],"wp:attachment":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=1259"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=1259"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=1259"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=1259"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=1259"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=1259"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}