wp_notify_postauthor() │ WP 1.0.0
Відповідає за email повідомлення автора запису про те, що до його запису було залишено коментар/пінг (comment/trackback/pingback). Надсилає email повідомлення.
Робота функції залежить від: Налаштування > Обговорення > Надіслати мені листа, коли > Хто-небудь залишив коментар:
Через фільтр comment_notification_recipients можна додати або видалити email адреси кому буде надіслано повідомлення. За промовчанням там лише адреса автора запису.
Це init .
Заміна функції (перевизначення) — у плагіні можна створити функцію з такою самою назвою, тоді вона замінить поточну функцію.
Хуки з функції
wp_notify_postauthor( $comment_id, $deprecated );
-
$comment_id
(число) (обов’язковий) - ID коментаря, повідомлення про яке потрібно надіслати.
-
$deprecated
(рядок) -
Заборонено та не використовується.
Типово: null
Приклади
0
#1 Відправимо повідомлення
if( wp_notify_postauthor( 600 ) ) {
echo 'Сповіщення надіслано.';
}
список змін
| З версії 1.0.0 | Введено. |
Код wp_notify_postauthor() wp notify postauthor WP 6.0.2
function wp_notify_postauthor( $comment_id, $deprecated = null ) {
if ( null !== $deprecated ) {
_deprecated_argument( __FUNCTION__, '3.8.0');
}
$ comment = get_comment ($ comment_id);
if ( empty( $comment ) || empty( $comment->comment_post_ID ) ) {
return false;
}
$post = get_post( $comment->comment_post_ID );
$author = get_userdata( $post->post_author );
// Who to notify? By default, just the post author, але інші можуть бути added.
$emails = array();
if ($author) {
$emails[] = $author->user_email;
}
/**
* Filters надрукувати адреси електронної пошти для отримання коментарів.
*
* By default, тільки post authors є notified of comments. Цей filter allows
* others to be added.
*
* @ Since 3.7.0
*
* @param string[] $emails Залишити адресу електронної пошти для отримання коментарів.
* @param string $comment_id Коментарі ID як numeric string.
*/
$emails = apply_filters( 'comment_notification_recipients', $emails, $comment->comment_ID );
$emails = array_filter( $emails );
// If there no is address to send the comment to, bail.
if ( ! count( $emails ) ) {
return false;
}
// Facilitate unsetting below без knowing the keys.
$emails = array_flip( $emails );
/**
* Filters whether to notify comment автори своїх коментарів на своїх своїх повідомленнях.
*
* Поза сумнівом, коментарі authors are notified of their comments on their own
* Posts. Цей filter дозволить вам override that.
*
* @ Since 3.8.0
*
* @param bool $notify Whether to notify електронною поштою з їхнього свого коментаря.
* Default false.
* @param string $comment_id Коментарі ID як numeric string.
*/
$notify_author = apply_filters( 'comment_notification_notify_author', false, $comment->comment_ID );
// The comment was left by the author.
if ( $author && ! $notify_author && $comment->user_id == $post->post_author ) {
unset( $emails[ $author->user_email ] );
}
// The author moderated a comment on their own post.
if ( $author && ! $notify_author && get_current_user_id() == $post->post_author ) {
unset( $emails[ $author->user_email ] );
}
// The post author is no longer a member of the blog.
if ( $author && ! $notify_author && ! user_can( $post->post_author, 'read_post', $post->ID ) ) {
unset( $emails[ $author->user_email ] );
}
// Якщо немає електронної пошти, щоб повідомити про те, біль, інші шпильки array back around for use below.
if ( ! count( $emails ) ) {
return false;
} else {
$emails = array_flip( $emails );
}
$ switched_locale = switch_to_locale( get_locale() );
$comment_author_domain = '';
if ( WP_Http::is_ip_address( $comment->comment_author_IP ) ) {
$comment_author_domain = gethostbyaddr( $comment->comment_author_IP );
}
// Вхідний блог name is escaped with esc_html() on the way in database in sanitize_option().
// We want to reverse this for the plain text arena of emails.
$blogname = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
$comment_content = wp_specialchars_decode( $comment->comment_content );
switch ( $comment->comment_type ) {
case 'trackback':
/* translators: %s: Post title. */
$notify_message = sprintf( __( 'New trackback on your post "%s"' ), $post->post_title ) . "rn";
/* translators: 1: Trackback/pingback website name, 2: Website IP address, 3: Website hostname. */
$notify_message .= sprintf( __( 'Website: %1$s (IP address: %2$s, %3$s)' ), $comment->comment_author, $comment->comment_author_IP, $comment_author_domain ) . "rn";
/* translators: %s: Trackback/pingback/comment author URL. */
$notify_message .= sprintf( __( 'URL: %s' ), $comment->comment_author_url ) . "rn";
/* translators: %s: Comment text. */
$notify_message .= sprintf( __( 'Comment: %s' ), "rn" . $comment_content ) . "nrn";
$notify_message .= __( 'Ви можете повідомити про всі trackbacks on this post here:' ) . "rn";
/* translators: Trackback notification email subject. 1: Site title, 2: Post title. */
$subject = sprintf( __( '[%1$s] Trackback: "%2$s"' ), $blogname, $post->post_title );
break;
case 'pingback':
/* translators: %s: Post title. */
$notify_message = sprintf( __( 'New pingback on your post "%s"' ), $post->post_title ) . "rn";
/* translators: 1: Trackback/pingback website name, 2: Website IP address, 3: Website hostname. */
$notify_message .= sprintf( __( 'Website: %1$s (IP address: %2$s, %3$s)' ), $comment->comment_author, $comment->comment_author_IP, $comment_author_domain ) . "rn";
/* translators: %s: Trackback/pingback/comment author URL. */
$notify_message .= sprintf( __( 'URL: %s' ), $comment->comment_author_url ) . "rn";
/* translators: %s: Comment text. */
$notify_message .= sprintf( __( 'Comment: %s' ), "rn" . $comment_content ) . "nrn";
$notify_message .= __( 'Ви можете дати всі pingbacks на цьому сайті:' ) . "rn";
/* translators: Pingback notification email subject. 1: Site title, 2: Post title. */
$subject = sprintf( __( '[%1$s] Pingback: "%2$s"' ), $blogname, $post->post_title );
break;
default // Comments.
/* translators: %s: Post title. */
$notify_message = sprintf( __( 'New comment on your post "%s"' ), $post->post_title ) . "rn";
/* translators: 1: Comment author's name, 2: Comment author's IP address, 3: Comment author's hostname. */
$notify_message .= sprintf( __( 'Author: %1$s (IP address: %2$s, %3$s)' ), $comment->comment_author, $comment->comment_author_IP, $comment_author_domain ) . "rn";
/* translators: %s: Comment author email. */
$notify_message .= sprintf( __( 'Email: %s' ), $comment->comment_author_email ) . "rn";
/* translators: %s: Trackback/pingback/comment author URL. */
$notify_message .= sprintf( __( 'URL: %s' ), $comment->comment_author_url ) . "rn";
if ( $comment->comment_parent && user_can( $post->post_author, 'edit_comment', $comment->comment_parent ) ) {
/* translators: Comment moderation. %s: Parent comment edit URL. */
$notify_message .= sprintf( __( 'In reply to: %s' ), admin_url( "comment.php?action=editcomment&c={$comment->comment_parent}#wpbody-content" ) ) . "rn";
}
/* translators: %s: Comment text. */
$notify_message .= sprintf( __( 'Comment: %s' ), "rn" . $comment_content ) . "nrn";
$notify_message .= __( 'Ви можете додати всі коментарі на цьому сайті:' ) . "rn";
/* translators: Comment notification email subject. 1: Site title, 2: Post title. */
$subject = sprintf( __( '[%1$s] Comment: "%2$s"' ), $blogname, $post->post_title );
break;
}
$notify_message .= get_permalink( $comment->comment_post_ID ) . "#commentsrnrn";
/* translators: %s: Comment URL. */
$notify_message .= sprintf( __( 'Permalink: %s' ), get_comment_link( $comment ) ) . "rn";
if ( user_can( $post->post_author, 'edit_comment', $comment->comment_ID ) ) {
if ( EMPTY_TRASH_DAYS ) {
/* translators: Comment moderation. %s: Comment action URL. */
$notify_message .= sprintf( __( 'Trash it: %s' ), admin_url( "comment.php?action=trash&c={$comment->comment_ID}#wpbody-content" ) ) . "rn";
} else {
/* translators: Comment moderation. %s: Comment action URL. */
$notify_message .= sprintf( __( 'Delete it: %s' ), admin_url( "comment.php?action=delete&c={$comment->comment_ID}#wpbody-content" ) ) . "rn";
}
/* translators: Comment moderation. %s: Comment action URL. */
$notify_message .= sprintf( __( 'Spam it: %s' ), admin_url( "comment.php?action=spam&c={$comment->comment_ID}#wpbody-content" ) ) . "rn";
}
$wp_email = 'wordpress@' . preg_replace( '#^www.#', '', wp_parse_url( network_home_url(), PHP_URL_HOST ) );
if ( '' === $comment->comment_author ) {
$from = "From: "$blogname" <$wp_email>";
if ( '' !== $comment->comment_author_email ) {
$reply_to = "Reply-To: $comment->comment_author_email";
}
} else {
$from = "From: "$comment->comment_author" <$wp_email>";
if ( '' !== $comment->comment_author_email ) {
$reply_to = "Reply-To: "$comment->comment_author_email" <$comment->comment_author_email>";
}
}
$message_headers = "$fromn"
. 'Content-Type: text/plain; charset="' . get_option( 'blog_charset' ) . ""n";
if ( isset ( $ reply_to ) ) {
$message_headers.=$reply_to. "n";
}
/**
* Filters comment notification email text.
*
* @ Since 1.5.2
*
* @param string $notify_message Коментарі повідомлення електронної пошти.
* @param string $comment_id Comment ID як numeric string.
*/
$notify_message = apply_filters( 'comment_notification_text', $notify_message, $comment->comment_ID );
/**
* Filters comment notification email subject.
*
* @ Since 1.5.2
*
* @param string $subject Comment notification email subject.
* @param string $comment_id Comment ID як numeric string.
*/
$subject = apply_filters( 'comment_notification_subject', $subject, $comment->comment_ID );
/**
* Filters the comment notification email headers.
*
* @ Since 1.5.2
*
* @param string $message_headers Headers for comment notification email.
* @param string $comment_id Comment ID як numeric string.
*/
$message_headers = apply_filters( 'comment_notification_headers', $message_headers, $comment->comment_ID );
foreach ($emails as $email) {
wp_mail ($ email, wp_specialchars_decode ($ subject), $ notify_message, $ message_headers);
}
if ($ switched_locale) {
restore_previous_locale();
}
return true;
}Зв’язані функції
_notify (повідомлення)
Коментарі
- cancel_comment_reply_link()
- comment_author_email_link()
- comment_form()
- comment_form_title()
- comment_id_fields()
- comment_text()
- comment_type()
- comments_link()
- get_avatar_data()
- get_avatar_url()
- get_cancel_comment_reply_link()
- get_comment()
- get_comment_author_email()
- get_comment_pages_count()
- get_comment_text()
- get_comment_type()
- get_comments()
- get_comments_link()
- get_comments_number()
- get_comments_pagenum_link()
- get_edit_comment_link()
- get_next_comments_link()
- get_page_of_comment()
- get_previous_comments_link()
- get_the_comments_navigation()
- get_the_comments_pagination()
- is_comment_feed()
- is_trackback()
- next_comments_link()
- paginate_comments_links()
- previous_comments_link()
- sanitize_comment_cookies()
- the_comments_navigation()
- the_comments_pagination()
- wp_allow_comment()
- wp_count_comments()
- wp_delete_comment()
- wp_get_current_commenter()
- wp_handle_comment_submission()
- wp_insert_comment()
- wp_list_comments()
- wp_new_comment()
- wp_set_comment_cookies()
- wp_set_comment_status()
- wp_spam_comment()
- wp_transition_comment_status()
- wp_update_comment()
- wp_update_comment_count()