钩子文档

wp_safe_redirect_fallback

💡 云策文档标注

概述

wp_safe_redirect_fallback 是一个 WordPress 过滤器钩子,用于在提供的重定向 URL 不安全(非本地)时,自定义回退 URL。它允许开发者修改默认的回退 URL,通常用于安全重定向场景。

关键要点

  • 这是一个过滤器钩子,用于处理不安全重定向时的回退 URL。
  • 接受两个参数:$fallback_url(回退 URL 字符串)和 $status(HTTP 响应状态码)。
  • 默认回退 URL 是 admin_url(),但可以通过此钩子进行自定义。
  • 与 wp_safe_redirect() 函数相关,用于执行安全(本地)重定向。
  • 在 WordPress 4.3.0 版本中引入。

代码示例

$fallback_url = apply_filters( 'wp_safe_redirect_fallback', admin_url(), $status );

📄 原文内容

Filters the redirect fallback URL for when the provided redirect is not safe (local).

Parameters

$fallback_urlstring
The fallback URL to use by default.
$statusint
The HTTP response status code to use.

Source

$fallback_url = apply_filters( 'wp_safe_redirect_fallback', admin_url(), $status );

Changelog

Version Description
4.3.0 Introduced.