add_ping() WordPress Function
The add_ping() function enables you to add a pingback URL to your post. A pingback is a special type of comment that is created when someone links to your post from their own site. When a pingback is created, the other site's server will notify your site, and your site will then display the pingback in the comments section of the post.
add_ping( int|WP_Post $post_id, string|array $uri ) #
Add a URL to those already pinged.
Parameters
- $post_id
(int|WP_Post)(Required)Post object or ID.
- $uri
(string|array)(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 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;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.7.0 | $uri can be an array of URIs. |
| 1.5.0 | Introduced. |