Author
» Lester 'GaMerZ' Chan

EMail:
»

Website:
» http://www.lesterchan.net/

Demo:
» http://www.lesterchan.net/blogs/wp-email.php?p=647

Documentation:
» http://dev.wp-plugins.org/wiki/wp-email

Development:
» http://dev.wp-plugins.org/browser/wp-email/

Support Forums:
» http://forums.lesterchan.net/viewforum.php?f=13

Updated:
» 1st July 2006

• Version 2.06 (01-07-2006)
  • FIXED: Modified Get Most Emailed Post Function
• Version 2.05 (06-06-2006)
  • NEW: Spam Prevention - Image Verification
  • NEW: EMail Administration Panel And The Code That WP-EMail Generated Is XHTML 1.0 Transitional
  • NEW: Added <label> 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
• Version 2.04a (01-05-2006)
  • FIXED: PHP Mail Not Working Properly (Thanks To Pablo)
• Version 2.04 (01-04-2006)
  • 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
• Version 2.03 (01-03-2006)
  • 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
• Version 2.02 (01-02-2006)
  • NEW: Added 'manage_email' Capabilities To Administrator Roles
  • FIXED: Able To View Password Protected Blog
• Version 2.01 (01-01-2006)
  • 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
• Version 2.00b (29-11-2005)
  • FIXED: Error In Sending E-Mail With Pages
• Version 2.00a (27-11-2005)
  • FIXED: exit(); Missing in wp-email.php
• Version 2.00 (20-11-2005)
  • 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

1. Open wp-content/plugins Folder
2. Put:

   Folder: email

3. Activate WP-EMail Plugin
4. Login To WP-Admin, Click E-Mail Tab
5. Modify your settings accordingly. If the mail server/type settings are not correct, WP-Email will NOT work.
6. You MAY Need To Re-Generate The Permalink (Options -> Permalinks Options -> Update Permalink Structure)
7. Refer To Usage For Further Instructions

1. Deactivate WP-EMail Plugin
2. Open wp-content/plugins Folder
3. Overwrite:

   Folder: email

4. Activate WP-EMail Plugin
5. Go to 'WP-Admin -> EMail -> EMail Options' and restore all the template variables to Default

1. Deactivate WP-EMail Plugin
2. Delete these file if exists:

   wp-content/plugins/email.php
   wp-admin/email-options.php
   wp-admin/email-manager.php
   wp-includes/class-phpmailer.php
   wp-includes/class-smtp.php
   wp-includes/functions-wp-email.php
   

3. Open wp-content/plugins Folder
4. Put:

   Folder: email

5. Activate WP-EMail Plugin
6. You MAY Need To Re-Generate The Permalink (Options -> Permalinks Options -> Update Permalink Structure)
7. Refer To Usage For Further Instructions

1. Open wp-content/themes/<YOUR THEME NAME>/index.php

   You may place it in single.php, post.php or page.php also.

2. Find:

   <?php while (have_posts()) : the_post(); ?>

3. Add Anywhere Below It:

   <?php if(function_exists('wp_email')) { email_link(); } ?>

   The first value you pass in is the text for emailing post. The second value is the text for emailing page.

   Default: email_link('EMail This Post', 'EMail This Page')

   If you want to use an image/icon instead, replace email_link(); with email_link_image();

   If you want to use a popup window, replace email_link(); with email_popup(); for normal link or email_popup_image(); for image/icon.

4. Tutorial On How To Integrate wp-email.php With Your Theme:

   http://www.lesterchan.net/wordpress/tutorials/integrating/

• To Display Most E-Mailed Posts
• Use:

  <?php if (function_exists('get_mostemailed')): ?>
     <?php get_mostemailed(); ?>
  <?php endif; ?>

  The default limit is 10, you can change the limit by doing this <?php get_mostemailed(<LIMIT>); ?>

• To Display Total E-Mails Sent
• Use:

  <?php if (function_exists('get_emails')): ?>
     <?php get_emails(); ?>
  <?php endif; ?>

• To Display Total E-Mails Sent Successfully
• Use:

  <?php if (function_exists('get_emails_success')): ?>
     <?php get_emails_success(); ?>
  <?php endif; ?>

• To Display Total E-Mails Sent Unsuccessfully
• Use:

  <?php if (function_exists('get_emails_failed')): ?>
     <?php get_emails_failed(); ?>
  <?php endif; ?>