钩子文档

_get_page_link

💡 云策文档标注

概述

_get_page_link 是一个 WordPress 过滤器,用于修改非首页页面的固定链接。它允许开发者在页面链接生成时进行自定义处理。

关键要点

  • 这是一个过滤器钩子,用于过滤非首页页面的固定链接。
  • 接受两个参数:$link(页面的固定链接字符串)和 $post_id(页面的 ID)。
  • 在 WordPress 2.1.0 版本中引入。

代码示例

add_filter( '_get_page_link', 'custom_page_link', 10, 2 );
function custom_page_link( $link, $post_id ) {
    // 自定义逻辑,例如修改链接
    return $link;
}

注意事项

  • 仅适用于非首页页面(即非 page_on_front 页面)。
  • 与 _get_page_link() 函数相关,用于检索页面固定链接。
  • 源代码位于 wp-includes/link-template.php 文件中。

📄 原文内容

Filters the permalink for a non-page_on_front page.

Parameters

$linkstring
The page’s permalink.
$post_idint
The ID of the page.

Source

return apply_filters( '_get_page_link', $link, $post->ID );

Changelog

Version Description
2.1.0 Introduced.