钩子文档

pre_ping

💡 云策文档标注

概述

pre_ping 是一个 WordPress 动作钩子,在文章中的链接被 pingback 之前触发。它允许开发者修改待检查的链接列表,常用于自定义 pingback 行为。

关键要点

  • pre_ping 钩子在 pingback 过程中触发,用于处理文章中的链接。
  • 参数包括 $post_links(待检查链接数组,引用传递)、$pung(已 ping 链接数组,引用传递)和 $post_id(文章 ID)。
  • 通过此钩子可以过滤或修改链接,例如禁用来自自身站点的 pingbacks。

代码示例

/**
 * Disables pingbacks from your own site.
 */
add_action( 'pre_ping', function ( &$post_links, &$pung, int $post_ID ) {
	foreach ( $post_links as $key => $link ) {
		if ( 0 === strpos( $link, home_url() ) ) {
			unset( $post_links[ $key ] ); 
		}
	}
}, 10, 3 );

📄 原文内容

Fires just before pinging back links found in a post.

Parameters

$post_linksstring[]
Array of link URLs to be checked (passed by reference).
$pungstring[]
Array of link URLs already pinged (passed by reference).
$post_idint
The post ID.

Source

do_action_ref_array( 'pre_ping', array( &$post_links, &$pung, $post->ID ) );

Changelog

Version Description
2.0.0 Introduced.

User Contributed Notes