WordPress hook钩子get_canonical_url的用法详解

WordPress的get_canonical_url钩子是一个用来获取指定页面的规范URL的函数。这个钩子的主要用途是可以在获取规范URL之前或之后执行自定义的操作。

get_canonical_url钩子接受一个参数，即待获取规范URL的页面ID或对象。它返回一个URL字符串，表示该页面的规范URL。

使用get_canonical_url钩子可以方便地修改或添加规范URL的逻辑。下面是一个使用get_canonical_url钩子的示例：

function custom_get_canonical_url($canonical_url, $object) {
// 在规范URL之前添加自定义前缀
$prefix = 'my-custom-prefix-';
$canonical_url = $prefix . $canonical_url;

// 对特定页面添加额外的查询参数
if ($object instanceof WP_Post && $object->ID == 123) {
$query_args = array(
'extra_param' => 'value',
);
$canonical_url = add_query_arg($query_args, $canonical_url);
}

return $canonical_url;
}
add_filter('get_canonical_url', 'custom_get_canonical_url', 10, 2);

在上面的示例代码中，我们定义了一个名为custom_get_canonical_url的函数，并将其添加为get_canonical_url钩子的过滤器。

在这个函数中，我们首先将自定义的前缀添加到规范URL之前。然后，我们检查传入的对象是否是WP_Post实例，并且其ID是否等于123。如果是，则我们使用add_query_arg函数添加了一个名为extra_param的额外查询参数。

最后，我们返回修改后的规范URL。

通过使用get_canonical_url钩子，可以轻松地自定义或修改规范URL的生成逻辑，以适应特定的需求。这个钩子在主题或插件开发中非常有用，可以增强WordPress的灵活性和可扩展性。