WC_Order::add_order_note( string $note, int $is_customer_note, bool $added_by_user = false )
Adds a note (comment) to the order. Order must exist.
Description Description
Parameters Parameters
- $note
-
(Required) Note to add.
- $is_customer_note
-
(Required) Is this a note for the customer?.
- $added_by_user
-
(Optional) Was the note added by a user?.
Default value: false
Return Return
(int) Comment ID.
Source Source
File: includes/class-wc-order.php
public function add_order_note( $note, $is_customer_note = 0, $added_by_user = false ) {
if ( ! $this->get_id() ) {
return 0;
}
if ( is_user_logged_in() && current_user_can( 'edit_shop_order', $this->get_id() ) && $added_by_user ) {
$user = get_user_by( 'id', get_current_user_id() );
$comment_author = $user->display_name;
$comment_author_email = $user->user_email;
} else {
$comment_author = __( 'WooCommerce', 'woocommerce' );
$comment_author_email = strtolower( __( 'WooCommerce', 'woocommerce' ) ) . '@';
$comment_author_email .= isset( $_SERVER['HTTP_HOST'] ) ? str_replace( 'www.', '', sanitize_text_field( wp_unslash( $_SERVER['HTTP_HOST'] ) ) ) : 'noreply.com'; // WPCS: input var ok.
$comment_author_email = sanitize_email( $comment_author_email );
}
$commentdata = apply_filters(
'woocommerce_new_order_note_data',
array(
'comment_post_ID' => $this->get_id(),
'comment_author' => $comment_author,
'comment_author_email' => $comment_author_email,
'comment_author_url' => '',
'comment_content' => $note,
'comment_agent' => 'WooCommerce',
'comment_type' => 'order_note',
'comment_parent' => 0,
'comment_approved' => 1,
),
array(
'order_id' => $this->get_id(),
'is_customer_note' => $is_customer_note,
)
);
$comment_id = wp_insert_comment( $commentdata );
if ( $is_customer_note ) {
add_comment_meta( $comment_id, 'is_customer_note', 1 );
do_action(
'woocommerce_new_customer_note',
array(
'order_id' => $this->get_id(),
'customer_note' => $commentdata['comment_content'],
)
);
}
return $comment_id;
}