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. |