wp_link_pages_link
云策文档标注
概述
wp_link_pages_link 是一个 WordPress 过滤器钩子,用于修改分页文章页面链接的 HTML 输出。它允许开发者自定义单个页码链接的显示格式。
关键要点
- 这是一个过滤器钩子,用于过滤 wp_link_pages() 函数生成的单个页码链接的 HTML 输出。
- 参数包括 $link(页码的 HTML 输出字符串)和 $i(页码的整数值)。
- 在 WordPress 3.6.0 版本中引入。
代码示例
$link = apply_filters( 'wp_link_pages_link', $link, $i );注意事项
- 此钩子与 wp_link_pages() 函数相关,后者位于 wp-includes/post-template.php 文件中,用于输出分页文章页面列表。
- 开发者可以通过添加过滤器函数来修改 $link 参数,实现自定义链接样式或内容。
原文内容
Filters the HTML output of individual page number links.
Parameters
$linkstring-
The page number HTML output.
$iint-
Page number for paginated posts’ page links.
Source
$link = apply_filters( 'wp_link_pages_link', $link, $i );
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |