钩子文档

wp_default_autoload_value

💡 云策文档标注

概述

wp_default_autoload_value 是一个 WordPress 过滤器钩子,用于在未显式传递 autoload 值时,确定选项的默认 autoload 值。它允许开发者自定义 autoload 行为,影响选项在数据库中的存储方式。

关键要点

  • 这是一个过滤器钩子,用于设置选项的默认 autoload 值。
  • 参数包括 $autoload(默认值,可为 bool 或 null)、$option(选项名)和 $value(选项值)。
  • 返回值 true 对应数据库中的 'auto-on',false 对应 'auto-off',null 对应 'auto'。
  • 在 WordPress 6.6.0 版本中引入。

代码示例

$autoload = apply_filters( 'wp_default_autoload_value', null, $option, $value, $serialized_value );

注意事项

此钩子与 wp_determine_option_autoload_value() 函数相关,用于基于输入确定 autoload 值。


📄 原文内容

Allows to determine the default autoload value for an option where no explicit value is passed.

Parameters

$autoloadbool|null
The default autoload value to set. Returning true will be set as 'auto-on' in the database, false will be set as 'auto-off', and null will be set as 'auto'.
$optionstring
The passed option name.
$valuemixed
The passed option value to be saved.

Source

$autoload = apply_filters( 'wp_default_autoload_value', null, $option, $value, $serialized_value );

Changelog

Version Description
6.6.0 Introduced.