钩子文档

year_link

💡 云策文档标注

概述

year_link 是一个 WordPress 过滤器,用于修改年份归档页面的永久链接。它允许开发者自定义年份归档的 URL 结构。

关键要点

  • year_link 是一个过滤器钩子,用于过滤年份归档的永久链接。
  • 它接受两个参数:$yearlink(年份归档的原始永久链接字符串)和 $year(归档的年份整数)。
  • 通过 apply_filters 调用,开发者可以添加自定义函数来修改链接。
  • 相关函数 get_year_link() 用于获取年份归档的永久链接。

代码示例

add_filter( 'year_link', 'custom_year_link', 10, 2 );
function custom_year_link( $yearlink, $year ) {
    // 自定义逻辑,例如添加查询参数
    return add_query_arg( 'custom_param', 'value', $yearlink );
}

📄 原文内容

Filters the year archive permalink.

Parameters

$yearlinkstring
Permalink for the year archive.
$yearint
Year for the archive.

Source

return apply_filters( 'year_link', $yearlink, $year );

Changelog

Version Description
1.5.0 Introduced.