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. |