WP-EMail

Contributors: GamerZ, aaroncampbell
Donate link: http://lesterchan.net/site/donation/
Tags: email, e-mail, wp-email, mail, send, recommend, ajax, friend
Requires at least: 2.8
Tested up to: 3.5
Stable tag: trunk

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 | Translations | Support Forums

Credits

Icons courtesy of FamFamFam.
__ngetext() by Anna Ozeritskaya.
Right-to-left language support by Kambiz R. Khojasteh
Maintenance by AaronCampbell

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 [email protected].

Installation

You can either install it automatically from the WordPress admin, or do it manually:

Upload the whole wp-email directory into your plugins folder(/wp-content/plugins/)
Activate the plugin through the 'Plugins' menu in WordPress

Once installed take the following steps to set it up:

Under E-Mail Settings, modify the setting Method Used To Send E-Mail accordingly. If the method is wrong, no email will get sent.
You Need To Re-Generate The Permalink (WP-Admin -> Settings -> Permalinks -> Save Changes)
Refer To Usage For Further Instructions

Usage

Open wp-content/themes/<YOUR THEME NAME>/index.php You may place it in single.php, post.php, page.php, etc also.
Find: <?php while (have_posts()) : the_post(); ?>
Add Anywhere Below It: <?php if(function_exists('wp_email')) { 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.

Screenshots

Admin E-Mail logs
Options/settings page
Sample E-Mail Post link
Sample E-Mail Post screen

Frequently Asked Questions

How do I add this to my theme?

Open wp-content/themes/<YOUR THEME NAME>/index.php You may place it in single.php, post.php, page.php, etc also.
Find: <?php while (have_posts()) : the_post(); ?>
Add Anywhere Below It: <?php if(function_exists('wp_email')) { email_link(); } ?>

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:

You can use the included widget by going to Wp-Admin -> Appearance -> Widgets" and using the widget named "Email"
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?

Open wp-email.php
Find define('EMAIL_SHOW_REMARKS', true);
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.

Changelog

2.61

FIXED: Unable to load WP-Email on Password Protected posts

2.60

Move AJAX Request to wp-admin/admin-ajax.php
Added nonce To Email Form

2.52

Added support for the wp-email-title and wp-email-remark custom fields

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 Tag For Form Fields
FIXED: Remarks Column Removed From E-Mail Logs Due To Privacy Issue
FIXED: Duplicate Subject/Name When Sent Using PHP
FIXED: Quotes Not Displaying When Sending In Plain Text

2.04a

FIXED: PHP Mail Not Working Properly (Thanks To Pablo)

2.04

NEW: Ability To Sent To Multiple EMails (Config Via Admin Panel)l
NEW: Added wp-email-popup.php For Using WP-EMail In A Pop Up Windowl
NEW: Combined functions-wp-email.php With email.phpl
NEW: Moved wp-email.php/wp-email-popup.php To Plugin Folderl

2.03

NEW: Improved On 'manage_email' Capabilities
NEW: Neater Structure
NEW: No More Install/Upgrade File, It Will Install/Upgrade When You Activate The Plugin
NEW: Added E-Mail Stats Function
NEW: Per Page Option In email-manager.php
NEW: Added Excerpt As A Template Variable
NEW: Added EMail Image With email_link_image()
FIXED: Now Paginate Have Sort Options
FIXED: Default Mailer Type Is Now PHP
FIXED: Charset Is Now UTF-8
FIXED: Quotes Not Displaying

2.02

NEW: Added 'manage_email' Capabilities To Administrator Roles
FIXED: Able To View Password Protected Blog

2.01

NEW: Compatible With WordPress 2.0 Only
NEW: EMail A Snippet Of The Post Rather Than The Whole Post. Able To Specify The No. Of Words Before Cutting Off
NEW: Spam Prevention - Better Checking Of Names, EMail Addresses And Remarks
NEW: Spam Prevention - Able To Specify The No. Of Mins Before User Is Allowed To Send A 2nd Article
NEW: GPL License Added
NEW: Page Title Added To wp-email.php
NEW: Automated Permalink
FIXED: Date Not Showing Correctly In EMail Logs
FIXED: Friend's Name Is Displayed Instead Of Friend's EMail On The Results Page
UPDATE: Moved All The WP-EMail Functions To wp-includes/functions-wp-email.php

2.00b

FIXED: Error In Sending E-Mail With Pages

2.00a

FIXED: exit(); Missing in wp-email.php

2.00

FIXED: Did Not Strip Slashes In Remarks Field
FIXED: All Of WordPress Permlink Styles Should Work Now
FIXED: Better Localization Support (80% Done, Will Leave It In The Mean Time)
NEW: EMail Administration Panel
NEW: EMail Templates Editable Online Via The Administration Panel
NEW: Change EMail Options Online Via The Administration Panel
NEW: Every EMail Sent Will Be Logged
NEW: Uses WordPress Default Query Instead Of Own
NEW: Uses Most Of The WordPress Functions To Get Data Instead Of Own
NEW: Able To EMail Page Also
NEW: If No Remarks Is Made, It Is Known As N/A

bekanntmacher / wp-email Goto Github PK

wp-email's Introduction