wp_xmlrpc_server::pingback_extensions_getPingbacks( string $url ): array|IXR_Error

Retrieves an array of URLs that pingbacked the given URL.

Description

Specs on http://www.aquarionics.com/misc/archives/blogite/0198.html

Parameters

$urlstringrequired

Return

array|IXR_Error

Source

public function pingback_extensions_getPingbacks( $url ) {
	global $wpdb;

	/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
	do_action( 'xmlrpc_call', 'pingback.extensions.getPingbacks', $url, $this );

	$url = $this->escape( $url );

	$post_id = url_to_postid( $url );
	if ( ! $post_id ) {
		// We aren't sure that the resource is available and/or pingback enabled.
		return $this->pingback_error( 33, __( 'The specified target URL cannot be used as a target. It either does not exist, or it is not a pingback-enabled resource.' ) );
	}

	$actual_post = get_post( $post_id, ARRAY_A );

	if ( ! $actual_post ) {
		// No such post = resource not found.
		return $this->pingback_error( 32, __( 'The specified target URL does not exist.' ) );
	}

	$comments = $wpdb->get_results( $wpdb->prepare( "SELECT comment_author_url, comment_content, comment_author_IP, comment_type FROM $wpdb->comments WHERE comment_post_ID = %d", $post_id ) );

	if ( ! $comments ) {
		return array();
	}

	$pingbacks = array();
	foreach ( $comments as $comment ) {
		if ( 'pingback' === $comment->comment_type ) {
			$pingbacks[] = $comment->comment_author_url;
		}
	}

	return $pingbacks;
}

Hooks

do_action( ‘xmlrpc_call’, string $name, array|string $args, wp_xmlrpc_server $server )

Fires after the XML-RPC user has been authenticated but before the rest of the method logic begins.

Changelog

VersionDescription
1.5.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.