Inline documentation for hooks in wp-mail.php.

props kpdesign, radices.
fixes #25551.
Built from https://develop.svn.wordpress.org/trunk@26129


git-svn-id: http://core.svn.wordpress.org/trunk@26041 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2013-11-13 11:58:12 +00:00
parent 1b3e9d33ce
commit 256e24c0ed
1 changed files with 33 additions and 7 deletions

View File

@ -14,8 +14,12 @@ require(dirname(__FILE__) . '/wp-load.php');
if ( ! apply_filters( 'enable_post_by_email_configuration', true ) ) if ( ! apply_filters( 'enable_post_by_email_configuration', true ) )
wp_die( __( 'This action has been disabled by the administrator.' ) ); wp_die( __( 'This action has been disabled by the administrator.' ) );
/** Allow a plugin to do a complete takeover of Post by Email **/ /**
do_action('wp-mail.php'); * Fires to allow a plugin to do a complete takeover of Post by Email.
*
* @since 2.9.0
*/
do_action( 'wp-mail.php' );
/** Get the POP3 class with which to access the mailbox. */ /** Get the POP3 class with which to access the mailbox. */
require_once( ABSPATH . WPINC . '/class-pop3.php' ); require_once( ABSPATH . WPINC . '/class-pop3.php' );
@ -176,9 +180,17 @@ for ( $i = 1; $i <= $count; $i++ ) {
} }
$content = trim($content); $content = trim($content);
//Give Post-By-Email extending plugins full access to the content /**
//Either the raw content or the content of the last quoted-printable section * Filter the original content of the email.
$content = apply_filters('wp_mail_original_content', $content); *
* Give Post-By-Email extending plugins full access to the content, either
* the raw content, or the content of the last quoted-printable section.
*
* @since 2.8.0
*
* @param string $content The original email content.
*/
$content = apply_filters( 'wp_mail_original_content', $content );
if ( false !== stripos($content_transfer_encoding, "quoted-printable") ) { if ( false !== stripos($content_transfer_encoding, "quoted-printable") ) {
$content = quoted_printable_decode($content); $content = quoted_printable_decode($content);
@ -194,7 +206,14 @@ for ( $i = 1; $i <= $count; $i++ ) {
$content = trim($content); $content = trim($content);
$post_content = apply_filters('phone_content', $content); /**
* Filter the content of the post submitted by email before saving.
*
* @since 1.2.0
*
* @param string $content The email content.
*/
$post_content = apply_filters( 'phone_content', $content );
$post_title = xmlrpc_getposttitle($content); $post_title = xmlrpc_getposttitle($content);
@ -213,7 +232,14 @@ for ( $i = 1; $i <= $count; $i++ ) {
if ( empty( $post_ID ) ) if ( empty( $post_ID ) )
continue; continue;
do_action('publish_phone', $post_ID); /**
* Fires after a post submitted by email is published.
*
* @since 1.2.0
*
* @param int $post_ID The post ID.
*/
do_action( 'publish_phone', $post_ID );
echo "\n<p>" . sprintf(__('<strong>Author:</strong> %s'), esc_html($post_author)) . '</p>'; echo "\n<p>" . sprintf(__('<strong>Author:</strong> %s'), esc_html($post_author)) . '</p>';
echo "\n<p>" . sprintf(__('<strong>Posted title:</strong> %s'), esc_html($post_title)) . '</p>'; echo "\n<p>" . sprintf(__('<strong>Posted title:</strong> %s'), esc_html($post_title)) . '</p>';