钩子文档

admin_referrer_policy

💡 云策文档标注

概述

admin_referrer_policy 是一个 WordPress 过滤器钩子,用于修改管理后台的 Referrer-Policy 头部值,控制外部请求中 referrer 信息的发送策略。

关键要点

  • 过滤器钩子名称为 admin_referrer_policy,用于过滤管理后台的 referrer 策略头部值。
  • 参数 $policy 是字符串类型,表示 referrer 策略值,默认值为 'strict-origin-when-cross-origin'。
  • 该钩子在 wp_admin_headers() 函数中被调用,确保管理屏幕的 referrer 信息不发送到外部。
  • WordPress 4.9.0 版本引入此钩子,4.9.5 版本将默认值更改为 'strict-origin-when-cross-origin'。

代码示例

$policy = apply_filters( 'admin_referrer_policy', $policy );

📄 原文内容

Filters the admin referrer policy header value.

Parameters

$policystring
The admin referrer policy header value. Default 'strict-origin-when-cross-origin'.

Source

$policy = apply_filters( 'admin_referrer_policy', $policy );

Changelog

Version Description
4.9.5 The default value was changed to 'strict-origin-when-cross-origin'.
4.9.0 Introduced.