钩子文档

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.