wp_xmlrpc_server::wp_newCategory(wp_xmlrpc_server::wp_newCategory)(阵列 $个参数 ):整数|IXR_错误

创建一个新类别。

参数

$个参数阵列必修的
方法参数。注意:参数必须按照文档排序。
  • 整数
    博客ID(未使用)。
  • 1 一串
    用户名。
  • 2 一串
    密码。
  • 阵列
    类别。

返回

整数|IXR_错误类别ID。

来源

公共函数wp_newCategory($args){$this->escape($args);$username=$args[1];$password=$args[2];$category=$args[3];$user=$this->登录($username,$password);if(!$user){返回$this->错误;}/**此操作记录在wp-includes/class-wp-xmlrpc-server.php中*/do_action('xmlrpc_call','wp.newCategory',$args,$this);//确保允许用户添加类别。if(!current_user_can('manage_categories')){return new IXR_Error(401,__('对不起,您不能添加类别。'));}/**如果没有提供段塞,则将其清空*这样WordPress就会生成一个。*/if(空($category['slug']){$category['slug']='';}/**如果未提供parent_id,请将其设为空*这样它将成为顶级页面(无父级)。*/if(!isset($category['parent_id']){$category['parent_id']='';}//如果没有提供描述,请将其设为空。if(空($category['description']){$category['description']='';}$new_category=数组(“cat_name”=>$category['name'],“category_nicename”=>$category['slug'],“category_parent”=>$category['parent_id'],'category_description'=>$category['description'],);$cat_id=wp_insert_category($新类别,true);if(iswp_error($cat_id)){if('term_exists'===$cat_id->get_error_code()){return(int)$cat_id->获取错误数据();}其他{return new IXR_Error(500,__('对不起,无法创建类别');}}elseif(!$cat_id){return new IXR_Error(500,__('对不起,无法创建类别');}/***通过XML-RPC成功创建新类别后激发。**@自3.4.0起**新类别的@param int$cat_id id。*@param array$args一个新类别参数的数组。*/do_action('xmlrpc_call_success_wp_newCategory',$cat_id,$args);//phpcs:忽略WordPress。命名约定。有效挂钩名称。无小写返回$cat_id;}

挂钩

do_操作('xmlrpc_call',一串 $名称,数组|字符串 $个参数,wp_xmlrpc服务器 $服务器 )

在XML-RPC用户经过身份验证后,但在方法逻辑的其余部分开始之前激发。

do_操作('xmlrpc_call_success_wp_newCategory',整数 $类别id,阵列 $个参数 )

在通过XML-RPC成功创建新类别后激发。

变更日志

版本描述
2.2.0介绍。

用户贡献的笔记

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