WP_Widget::form_callback(int |数组 $小部件_参数 = 1 ):字符串|空

生成小部件控制表单(请勿覆盖)。

参数

$小部件_参数整数|阵列可选择的
小部件实例的内部订单号或多小部件参数数组。

  • 整数
    数字增量用于同一小部件的倍数。

违约:1

返回

字符串|空

来源

公共函数form_callback($widget_args=1){if(is_numeric($widget_args)){$widget_args=数组(“数字”=>$widget_args);}$widget_args=wp_parse_args($widget_args,数组('number'=>-1));$all_instances=$this->get_settings();if(-1===$widget_args['number']){//我们回显出一个表单,稍后可以设置“数字”。$this->_set('____');$instance=数组();}其他{$this->_set($widget_args['number']);$instance=$all_instances[$widget_args['number']];}/***在显示控件窗体之前过滤小部件实例的设置。**返回控制窗体的错误有效短路显示。**@自2.8.0起**@param array$instance当前小部件实例的设置。*@param WP_Widget$小部件当前小部件实例。*/$instance=应用过滤器('widget_form_callback',$instance,$this);$return=空;if(false!==$instance){$return=$this->表单($instance);/***在小部件控件窗体的末尾激发。**使用这个钩子向小部件窗体添加额外的字段*仅当传递给“widget_form_callback”的值时才会激发*钩子不是假的。**注意:如果小部件没有表单,文本将从默认值回显*可以使用CSS隐藏表单方法。**@自2.8.0起**@param WP_Widget$Widget小部件实例(通过引用传递)。*@param null$return如果添加了新字段,则返回null。*@param array$instance小部件设置的数组。*/do_action_ref_array(“in_widget_form”,数组(&$this,&$return,$instance));}return$return;}

挂钩

do_操作_数组('在小部件表单中',WP_小工具 $小部件,无效的 $返回,阵列 $实例 )

在小部件控件窗体的末尾激发。

应用筛选器('小部件窗体回调',阵列 $实例,WP_小工具 $小部件 )

在显示控件窗体之前过滤小部件实例的设置。

变更日志

版本描述
2.8.0介绍。

用户贡献的笔记

你必须登录在能够发表注释或反馈之前。