云策 WordPress 开发者社区

函数文档

write_post()

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

概述

write_post() 函数调用 wp_write_post() 并处理错误，用于基于 $_POST 信息创建新文章。

关键要点

  • 调用 wp_write_post() 函数来创建文章
  • 使用 is_wp_error() 检查错误，并在出错时通过 wp_die() 显示错误信息
  • 成功时返回文章 ID，失败时返回 void
  • 自 WordPress 2.0.0 版本引入

代码示例

function write_post() {
    $result = wp_write_post();
    if ( is_wp_error( $result ) ) {
        wp_die( $result->get_error_message() );
    } else {
        return $result;
    }
}

注意事项

  • 此函数依赖于 wp_write_post() 处理 $_POST 数据，确保数据格式正确
  • 错误处理使用 wp_die()，会终止执行并显示错误页面，适用于后台管理场景
📄 原文内容

Calls wp_write_post() and handles the errors.

Return

int|void Post ID on success, void on failure.

Source

function write_post() {
	$result = wp_write_post();
	if ( is_wp_error( $result ) ) {
		wp_die( $result->get_error_message() );
	} else {
		return $result;
	}
}

View all references View on Trac View on GitHub

Uses Description
wp_write_post()wp-admin/includes/post.php

Creates a new post from the “Write Post” form using $_POST information.
wp_die()wp-includes/functions.php

Kills WordPress execution and displays HTML page with an error message.
is_wp_error()wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Show 1 moreShow less

Changelog

Version Description
2.0.0 Introduced.