set-screen-option

过滤钩子
apply_filters( 'set-screen-option', $screen_option, $option, $value )
参数
  • (mixed) $screen_option The value to save instead of the option value. Default false (to skip saving the current option).
    Required:
  • (string) $option The option name.
    Required:
  • (int) $value The option value.
    Required:
定义位置
相关勾子
set_screen_option_optiondelete_optionpre_optiondeleted_optiondelete_site_option
相关方法
set_screen_optionsscreen_optionsadd_screen_optionget_screen_iconscreen_iconget_site_option
引入
5.4.2
弃用
-

set-screen-option – 当一个屏幕选项的值被更新时,这个动作钩子被调用。屏幕选项是WordPress管理界面中一个特定屏幕的用户偏好的设置。

在设置屏幕选项值之前对其进行过滤。

过滤器还可用于修改非标准的[items]_per_page设置。有关标准选项的完整列表,请参见父函数。

从过滤器返回false将跳过保存当前选项。

$screen_option = apply_filters( 'set-screen-option', $screen_option, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

常见问题

FAQs
查看更多 >