add_ping( int|WP_Post $post, string|array $uri )
Adds a URL to those already pinged.
Parameters
- $post
-
(Required) Post ID or post object.
- $uri
-
(Required) Ping URI or array of URIs.
Return
(int|false) How many rows were updated.
Source
File: wp-includes/post.php
function add_ping( $post_id, $uri ) {
global $wpdb;
$post = get_post( $post_id );
if ( ! $post ) {
return false;
}
$pung = trim( $post->pinged );
$pung = preg_split( '/\s/', $pung );
if ( is_array( $uri ) ) {
$pung = array_merge( $pung, $uri );
}
else {
$pung[] = $uri;
}
$new = implode("\n", $pung);
/**
* Filters the new ping URL to add for the given post.
*
* @since WP-2.0.0
*
* @param string $new New ping URL to add.
*/
$new = apply_filters( 'add_ping', $new );
$return = $wpdb->update( $wpdb->posts, array( 'pinged' => $new ), array( 'ID' => $post->ID ) );
clean_post_cache( $post->ID );
return $return;
}
Changelog
Version | Description |
---|---|
4.7.0 | $uri can be an array of URIs. |
1.5.0 | Introduced. |