钩子文档

paginate_links

💡 云策文档标注

概述

paginate_links 是一个 WordPress 过滤器钩子,用于修改归档页面的分页链接 URL。它允许开发者在分页链接输出前进行自定义处理。

关键要点

  • 过滤器名称:paginate_links
  • 参数:$link(字符串类型,表示分页链接的 URL)
  • 用途:过滤归档页面的分页链接,常用于修改链接结构或添加查询参数
  • 相关函数:paginate_links(),用于生成分页链接
  • 引入版本:WordPress 3.0.0

代码示例

esc_url( apply_filters( 'paginate_links', $link ) )

注意事项

使用此过滤器时,应确保返回的链接是安全的,通常结合 esc_url() 函数来转义 URL,防止安全漏洞。


📄 原文内容

Filters the paginated links for the given archive pages.

Parameters

$linkstring
The paginated link URL.

Source

esc_url( apply_filters( 'paginate_links', $link ) ),

Changelog

Version Description
3.0.0 Introduced.