WordPress hook钩子page_link如何使用

WordPress中的“page_link”是一个钩子（hook），用于修改或添加指向页面的链接。

该钩子的用法如下：

1. 使用`add_filter()`函数将回调函数（callback function）添加到钩子上：

add_filter( 'page_link', 'my_custom_page_link', 10, 3 );

上述代码将`my_custom_page_link`函数添加到`page_link`钩子上。

2. 创建回调函数`my_custom_page_link`：

function my_custom_page_link( $link, $post_id, $sample ) {
// 在这里可以修改或添加指向页面的链接逻辑
return $link;
}

回调函数中的参数包括：
- `$link`：原始页面链接
- `$post_id`：当前页面的ID
- `$sample`：示例参数，通常不使用

3. 在回调函数中，可以根据需要修改或添加指向页面的链接逻辑。例如，可以添加额外的查询参数、修改链接的外观等等。

以下是一个示例，向指向页面的链接添加额外的查询参数：

function my_custom_page_link( $link, $post_id, $sample ) {
// 获取当前页面的元数据
$meta_value = get_post_meta( $post_id, 'my_custom_meta', true );

// 添加额外的查询参数
$new_link = add_query_arg( array( 'custom_param' => $meta_value ), $link );

return $new_link;
}

在上述示例中，使用`get_post_meta()`函数获取当前页面的自定义元数据（以"my_custom_meta"为例）。然后，使用`add_query_arg()`函数将该元数据作为额外的查询参数添加到页面链接中。

通过使用`page_link`钩子，可以在不直接修改主题文件的情况下对页面链接进行修改。这样可以避免在主题更新时丢失修改。