钩子文档

customize_render_control_{$this->id}

💡 云策文档标注

概述

此文档描述了 WordPress 自定义器中的一个动态 Hook,它在特定控制渲染前触发。Hook 名称包含控制 ID 的动态部分,用于精确控制渲染过程。

关键要点

  • Hook 名称:customize_render_control_{$this->id},其中 {$this->id} 是控制 ID 的动态占位符。
  • 触发时机:在特定 Customizer 控制渲染之前立即触发。
  • 参数:$control,类型为 WP_Customize_Control,表示控制实例。
  • 相关函数:WP_Customize_Control::maybe_render() 用于检查权限并渲染控制。
  • 版本历史:自 WordPress 3.4.0 版本引入。

📄 原文内容

Fires just before a specific Customizer control is rendered.

Description

The dynamic portion of the hook name, $this->id, refers to the control ID.

Parameters

$controlWP_Customize_Control

Source

do_action( "customize_render_control_{$this->id}", $this );

Changelog

Version Description
3.4.0 Introduced.