云策 WordPress 开发者社区

函数文档

xmlrpc_getpostcategory()

查看官方原文 ↗
💡 云策文档标注

概述

xmlrpc_getpostcategory() 函数用于从 XML-RPC XML 请求内容中提取文章的分类信息。如果未找到分类元素，则使用全局变量 $post_default_category 的默认值，返回类型为字符串；否则返回分类名称数组。

关键要点

  • 函数从 XML-RPC XML 内容中解析文章分类，支持单个或多个分类。
  • 参数 $content 为必需字符串，表示 XML-RPC XML 请求内容。
  • 返回值类型为字符串数组或字符串，取决于是否找到分类元素。
  • 内部使用正则表达式匹配和全局变量 $post_default_category 处理默认情况。

代码示例

function xmlrpc_getpostcategory( $content ) {
	global $post_default_category;
	if ( preg_match( '/(.+?)/is', $content, $matchcat ) ) {
		$post_category = trim( $matchcat[1], ',' );
		$post_category = explode( ',', $post_category );
	} else {
		$post_category = $post_default_category;
	}
	return $post_category;
}

注意事项

  • 函数依赖于全局变量 $post_default_category，需确保其已正确设置。
  • 正则表达式匹配可能受 XML 格式影响，需确保输入内容符合预期结构。
  • 返回类型可变，调用时需根据情况处理字符串或数组。
📄 原文内容

Retrieves the post category or categories from XML-RPC XML.

Description

If the category element is not found in the XML, the default post category from the $post_default_category global will be used instead.
The return type will then be a string.

If the category element is found, the return type will be an array.

Parameters

$contentstringrequired
XML-RPC XML Request content.

Return

string[]|string An array of category names or default category name.

Source

function xmlrpc_getpostcategory( $content ) {
	global $post_default_category;
	if ( preg_match( '/<category>(.+?)</category>/is', $content, $matchcat ) ) {
		$post_category = trim( $matchcat[1], ',' );
		$post_category = explode( ',', $post_category );
	} else {
		$post_category = $post_default_category;
	}
	return $post_category;
}

View all references View on Trac View on GitHub

Used by Description
wp_xmlrpc_server::blogger_newPost()wp-includes/class-wp-xmlrpc-server.php

Creates a new post.
wp_xmlrpc_server::blogger_editPost()wp-includes/class-wp-xmlrpc-server.php

Edits a post.

Changelog

Version Description
0.71 Introduced.