=== WP-EMail === Contributors: GamerZ, aaroncampbell Donate link: http://lesterchan.net/wordpress Tags: email, e-mail, wp-email, mail, send, recommend, ajax, friend Requires at least: 2.8 Tested up to: 2.9.1 Stable tag: 2.51 Allows people to recommend/send your WordPress blog's post/page to a friend. == Description == Allows people to recommend/send your WordPress blog's post/page to a friend. [Demo](http://lesterchan.net/wordpress/2006/07/05/donations/email/ "Demo") | [Translations](http://dev.wp-plugins.org/browser/wp-email/i18n/ "Translations") | [Support Forums](http://forums.lesterchan.net/index.php?board=13.0 "WP-EMail Support Forums") = Credits = * Icons courtesy of [FamFamFam](http://www.famfamfam.com/). * __ngetext() by [Anna Ozeritskaya](http://hweia.ru/). * Right-to-left language support by [Kambiz R. Khojasteh](http://persian-programming.com/) * Maintenance by [AaronCampbell](http://xavisys.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 appericiate it. If not feel free to use it without any obligations. Thank You. My Paypal account is lesterchan@gmail.com. == Installation == You can either install it automatically from the WordPress admin, or do it manually: 1. Upload the whole `wp-email` directory into your plugins folder(`/wp-content/plugins/`) 1. Activate the plugin through the 'Plugins' menu in WordPress Once installed take the following steps to set it up: 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. 1. You Need To Re-Generate The Permalink (WP-Admin -> Settings -> Permalinks -> Save Changes) 1. Refer To Usage For Further Instructions = Usage = 1. Open `wp-content/themes//index.php` You may place it in single.php, post.php, page.php, etc also. 1. Find: `` 1. Add Anywhere Below It: `` 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. == Screenshots == 1. Admin E-Mail logs 2. Options/settings page 3. Sample E-Mail Post link 4. Sample E-Mail Post screen == Frequently Asked Questions == = 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. 1. Find: `` 1. Add Anywhere Below It: `` 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` 1. Find `define('EMAIL_SHOW_REMARKS', true);` 1. Replace with `define('EMAIL_SHOW_REMARKS', false);` = How can I keep some post text form 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" == Changelog == = 2.51 = * FIXED: Warnings of non-existant array indices = 2.50 = * NEW: Works For WordPress 2.8 Only * NEW: Javascript Now Placed At The Footer * NEW: Uses jQuery Instead Of tw-sack * NEW: Minified Javascript Instead Of Packed Javascript * NEW: Renamed email-js-packed.js To email-js.js * NEW: Renamed email-js.js To email-js.dev.js * NEW: Translate Javascript Variables Using wp_localize_script() * NEW: Fill In "Your Name" And "Your Email" Fields If User Is Logged In (By Aaron Campbell) * NEW: Added [donotemail][/donotemail] Short Code (Refer To Usage Tab) * NEW: Added In Most Emailed Pages To WP-Stats * NEW: Use _n() Instead Of __ngettext() And _n_noop() Instead Of __ngettext_noop() * NEW: Uses New Widget Class From WordPress * NEW: Merge Widget Code To wp-email.php And Remove wp-email-widget.php * FIXED: Uses $_SERVER['PHP_SELF'] With plugin_basename(__FILE__) Instead Of Just $_SERVER['REQUEST_URI'] * FIXED: Nested ShortCode Issues * FIXED: Double Slashes In SMTP Username = 2.40 = * NEW: Works For WordPress 2.7 Only * NEW: Load Admin JS And CSS Only In WP-Email Admin Pages * NEW: Added email-admin-css.css For WP-Email Admin CSS Styles * NEW: Uses wp_register_style(), wp_print_styles(), plugins_url() And site_url() * NEW: Better Translation Using __ngetext() by Anna Ozeritskaya * NEW: Right To Left Language Support by Kambiz R. Khojasteh * NEW: Called email_textdomain() In create_email_table() by Kambiz R. Khojasteh * NEW: Added "email-css-rtl.css" by Kambiz R. Khojasteh * NEW: E-mail Form Is More CSS Friendly by Kambiz R. Khojasteh * NEW: Use language_attributes() To Get Attributes Of HTML Tag For Popup Window by Kambiz R. Khojasteh * NEW: Popup Window Is Now Auto Sized And Centralized by Kambiz R. Khojasteh * NEW: Page Title Is Now "Post Title -> Email" Instead Of "Email -> Post Title" by Kambiz R. Khojasteh * FIXED: remove_filter('the_content', 'email_form', ''); By TripleM * FIXED: Missing Display Of Friend's Invalid Email Address In Javascript Alert Box = 2.31 = * NEW: Works For WordPress 2.6 * FIXED: MYSQL Charset Issue Should Be Solved = 2.30 = * NEW: Works For WordPress 2.5 Only * NEW: WP-Email Will Load 'email.php' Inside Your Theme Directory If It Exists. This Will Allow Some Flexibility Instead Of Using 'page.php' As The Default Template. * NEW: WP-Email Will Load 'email-css.css' Inside Your Theme Directory If It Exists. If Not, It Will Just Load The Default 'email-css.css' By WP-Email * NEW: Changed CSS Style For Input Field From 'Forms' To 'TextField' And For Buttons From 'Buttons' To 'Button' * NEW: Renamed email-js.php To email-js.js and Move The Dynamic Javascript Variables To The PHP Pages * NEW: Uses email-js-packed.js * NEW: Uses /wp-email/ Folder Instead Of /email/ * NEW: Uses wp-email.php Instead Of email.php * NEW: Uses wp-email-widget.php Instead Of email-widget.php * NEW: Changed wp-email.php To email-standalone.php * NEW: Changed wp-email-popup.php To email-popup.php * NEW: Use number_format_i18n() Instead * NEW: Show 'Remarks' In 'WP-Admin -> E-Mail -> E-Mail Logs' Page By Default. See Usage Tab On How To Hide It. = 2.20 = * NEW: Works For WordPress 2.3 Only * NEW: Removed PHPMailer Files From The Zip As It Is Included In WordPress * NEW: Ability To Embed [email_link] Into Excerpt * NEW: AJAX Used To Email The Post/Page * NEW: Most Emailed Widget Added * NEW: Ability To Uninstall WP-EMail * NEW: Uses WP-Stats Filter To Add Stats Into WP-Stats Page * FIXED: Displaying Friend's E-Mail Field Is Compulsory To Prevent Error * FIXED: Method Of Storing SMTP Information Updated * FIXED: If There Is No Trailing Slash In Your Permalink, WP-Email Will Add It For You * FIXED: Use @session_start() Instead To Compress Session Already Started Error = 2.11 = * NEW: Added Template For Page Title And Page Subtitle In 'WP-Admin -> E-Mail -> E-Mail Options' * NEW: Putting [email_link] In Your Post/Page Content Will Display A Link To The E-Mail Post/Page * FIXED: Suppress gethostbyaddr() Error * FIXED: Duplicate Page Title When Listing Pages With wp_list_pages() * FIXED: If page.php Is Not Found, single.php or index.php Will Be Used * FIXED: Wrong URL For Page Under Most E-Mailed Posts Listing * FIXED: Wrong URL If Front Page Is A Static Page * FIXED: Fixed A Minor Grammer Mistake For Remark (Singular) * FIXED: Some Text Not Translated = 2.10 = * NEW: Works For WordPress 2.1 Only * NEW: Added Fam Fam Fam's E-Mail Icon * NEW: Localize WP-EMail * NEW: Ability To Configure The Text For E-Mail Links Via 'WP-Admin -> E-Mail -> E-Mail Options' * NEW: Ability To Set E-Mail Link Type (Standalone Page Or Popup Page) Via 'WP-Admin -> E-Mail -> E-Mail Options' * NEW: The Text For E-Mail Links Can No Longer Be Pass To The Function email_link(), email_link_image(), email_popup() or email_popup_image(). * NEW: Ability To Select Which Field You Want To Display In The E-Mail Form * FIXED: Name Fields No Longer Check For Validity Due To Localization * FIXED: Special HTML Characters No Longer Get Converted Into Its Symbolic Form When Displaying In E-Mail -> E-Mail Options * FIXED: Extra ; When Displaying Error Message * FIXED: Removed 1 0 I O From The Image Verify To Avoid Confusion = 2.07 = * NEW: WP-EMail-Popup Now Have Nice Permalinks /emailpopup/ Or /emailpopuppage/ * NEW: Added rel="nofollow" To All Links Generated By WP-EMail * NEW: Added noindex, nofollow To Robots Meta Tag In wp-email-popup.php * NEW: Error Messages Will Now Be Displayed Together With The E-Mail Form * FIXED: PHP5 Compatibility Issue * FIXED: Image Verify Is Now Not Case Sensitive * FIXED: Error In Logging Due To Post ID Being Blank * FIXED: Form Input Data Will No Longer Be Lost After Encountering An Error * FIXED: WP-EMail-Popup Not Working With Other Nice Permalinks = 2.06 = * FIXED: Modified Get Most Emailed Post Function = 2.05 = * NEW: Spam Prevention - Image Verification * NEW: EMail Administration Panel And The Code That WP-EMail Generated Is XHTML 1.0 Transitional * NEW: Added