RSS订阅

WordPress函数_wp_translate_postdata()用法

  • liuying 发布于 2024-09-10
  • 分类：未分类
  • 阅读(309)

源代码

File: wp-admin/includes/post.php

function _wp_translate_postdata( $update = false, $post_data = null ) {

	if ( empty($post_data) )
		$post_data = &$_POST;

	if ( $update )
		$post_data['ID'] = (int) $post_data['post_ID'];

	$ptype = get_post_type_object( $post_data['post_type'] );

	if ( $update && ! current_user_can( 'edit_post', $post_data['ID'] ) ) {
		if ( 'page' == $post_data['post_type'] )
			return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to edit pages as this user.' ) );
		else
			return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to edit posts as this user.' ) );
	} elseif ( ! $update && ! current_user_can( $ptype->cap->create_posts ) ) {
		if ( 'page' == $post_data['post_type'] )
			return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to create pages as this user.' ) );
		else
			return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to create posts as this user.' ) );
	}

	if ( isset( $post_data['content'] ) )
		$post_data['post_content'] = $post_data['content'];

	if ( isset( $post_data['excerpt'] ) )
		$post_data['post_excerpt'] = $post_data['excerpt'];

	if ( isset( $post_data['parent_id'] ) )
		$post_data['post_parent'] = (int) $post_data['parent_id'];

	if ( isset($post_data['trackback_url']) )
		$post_data['to_ping'] = $post_data['trackback_url'];

	$post_data['user_ID'] = get_current_user_id();

	if (!empty ( $post_data['post_author_override'] ) ) {
		$post_data['post_author'] = (int) $post_data['post_author_override'];
	} else {
		if (!empty ( $post_data['post_author'] ) ) {
			$post_data['post_author'] = (int) $post_data['post_author'];
		} else {
			$post_data['post_author'] = (int) $post_data['user_ID'];
		}
	}

	if ( isset( $post_data['user_ID'] ) && ( $post_data['post_author'] != $post_data['user_ID'] )
		 && ! current_user_can( $ptype->cap->edit_others_posts ) ) {
		if ( $update ) {
			if ( 'page' == $post_data['post_type'] )
				return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to edit pages as this user.' ) );
			else
				return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to edit posts as this user.' ) );
		} else {
			if ( 'page' == $post_data['post_type'] )
				return new WP_Error( 'edit_others_pages', __( 'Sorry, you are not allowed to create pages as this user.' ) );
			else
				return new WP_Error( 'edit_others_posts', __( 'Sorry, you are not allowed to create posts as this user.' ) );
		}
	}

	if ( ! empty( $post_data['post_status'] ) ) {
		$post_data['post_status'] = sanitize_key( $post_data['post_status'] );

		// No longer an auto-draft
		if ( 'auto-draft' === $post_data['post_status'] ) {
			$post_data['post_status'] = 'draft';
		}

		if ( ! get_post_status_object( $post_data['post_status'] ) ) {
			unset( $post_data['post_status'] );
		}
	}

	// What to do based on which button they pressed
	if ( isset($post_data['saveasdraft']) && '' != $post_data['saveasdraft'] )
		$post_data['post_status'] = 'draft';
	if ( isset($post_data['saveasprivate']) && '' != $post_data['saveasprivate'] )
		$post_data['post_status'] = 'private';
	if ( isset($post_data['publish']) && ( '' != $post_data['publish'] ) && ( !isset($post_data['post_status']) || $post_data['post_status'] != 'private' ) )
		$post_data['post_status'] = 'publish';
	if ( isset($post_data['advanced']) && '' != $post_data['advanced'] )
		$post_data['post_status'] = 'draft';
	if ( isset($post_data['pending']) && '' != $post_data['pending'] )
		$post_data['post_status'] = 'pending';

	if ( isset( $post_data['ID'] ) )
		$post_id = $post_data['ID'];
	else
		$post_id = false;
	$previous_status = $post_id ? get_post_field( 'post_status', $post_id ) : false;

	if ( isset( $post_data['post_status'] ) && 'private' == $post_data['post_status'] && ! current_user_can( $ptype->cap->publish_posts ) ) {
		$post_data['post_status'] = $previous_status ? $previous_status : 'pending';
	}

	$published_statuses = array( 'publish', 'future' );

	// Posts 'submitted for approval' present are submitted to $_POST the same as if they were being published.
	// Change status from 'publish' to 'pending' if user lacks permissions to publish or to resave published posts.
	if ( isset($post_data['post_status']) && (in_array( $post_data['post_status'], $published_statuses ) && !current_user_can( $ptype->cap->publish_posts )) )
		if ( ! in_array( $previous_status, $published_statuses ) || !current_user_can( 'edit_post', $post_id ) )
			$post_data['post_status'] = 'pending';

	if ( ! isset( $post_data['post_status'] ) ) {
		$post_data['post_status'] = 'auto-draft' === $previous_status ? 'draft' : $previous_status;
	}

	if ( isset( $post_data['post_password'] ) && ! current_user_can( $ptype->cap->publish_posts ) ) {
		unset( $post_data['post_password'] );
	}

	if (!isset( $post_data['comment_status'] ))
		$post_data['comment_status'] = 'closed';

	if (!isset( $post_data['ping_status'] ))
		$post_data['ping_status'] = 'closed';

	foreach ( array('aa', 'mm', 'jj', 'hh', 'mn') as $timeunit ) {
		if ( !empty( $post_data['hidden_' . $timeunit] ) && $post_data['hidden_' . $timeunit] != $post_data[$timeunit] ) {
			$post_data['edit_date'] = '1';
			break;
		}
	}

	if ( !empty( $post_data['edit_date'] ) ) {
		$aa = $post_data['aa'];
		$mm = $post_data['mm'];
		$jj = $post_data['jj'];
		$hh = $post_data['hh'];
		$mn = $post_data['mn'];
		$ss = $post_data['ss'];
		$aa = ($aa <= 0 ) ? date('Y') : $aa;
		$mm = ($mm <= 0 ) ? date('n') : $mm;
		$jj = ($jj > 31 ) ? 31 : $jj;
		$jj = ($jj <= 0 ) ? date('j') : $jj;
		$hh = ($hh > 23 ) ? $hh -24 : $hh;
		$mn = ($mn > 59 ) ? $mn -60 : $mn;
		$ss = ($ss > 59 ) ? $ss -60 : $ss;
		$post_data['post_date'] = sprintf( "%04d-%02d-%02d %02d:%02d:%02d", $aa, $mm, $jj, $hh, $mn, $ss );
		$valid_date = wp_checkdate( $mm, $jj, $aa, $post_data['post_date'] );
		if ( !$valid_date ) {
			return new WP_Error( 'invalid_date', __( 'Invalid date.' ) );
		}
		$post_data['post_date_gmt'] = get_gmt_from_date( $post_data['post_date'] );
	}

	if ( isset( $post_data['post_category'] ) ) {
		$category_object = get_taxonomy( 'category' );
		if ( ! current_user_can( $category_object->cap->assign_terms ) ) {
			unset( $post_data['post_category'] );
		}
	}

	return $post_data;
}

更新日志

Version描述
2.6.0Introduced.

在WordPress中，_wp_translate_postdata() 是一个内部函数，用于将表单提交的数据转换为WordPress帖子（posts）和页面（pages）的正确格式。这个函数主要在WordPress的 wp_insert_post() 函数中使用，以准备和过滤通过 $_POST 变量提交的数据。
这个函数不是公开文档化的，通常不应该在主题或插件代码中直接使用，因为它可能会在WordPress的未来版本中发生变化。然而，如果你需要了解其用法，以下是该函数的基本结构：

_wp_translate_postdata( $post_type = 'post' );

参数解释如下：

  • $post_type：可选参数，表示帖子类型。默认为 ‘post’，但也可以是 ‘page’ 或其他自定义帖子类型。
    函数执行以下操作：
  • 确保提交的数据是有效的。
  • 将提交的数据转换为WordPress帖子或页面的格式。
  • 执行必要的数据过滤和消毒。
    由于 _wp_translate_postdata() 是一个内部函数，它的使用通常是在WordPress核心处理帖子提交时隐式发生的。以下是一个示例，展示了在处理帖子提交时可能会调用此函数的上下文：
if ( isset( $_POST['post_type'] ) ) {
    $post_type = $_POST['post_type'];
} else {
    $post_type = 'post';
}
// 在处理帖子提交之前，确保已经做了安全检查
if ( isset( $_POST['post_ID'] ) ) {
    $post_id = absint( $_POST['post_ID'] );
}
// 确保当前用户有权限编辑或创建帖子
if ( current_user_can( 'edit_post', $post_id ) ) {
    // 调用内部函数来转换和过滤提交的数据
    _wp_translate_postdata( $post_type );

    // 这里可以添加更多的代码来处理转换后的数据，例如保存帖子
}

请记住，直接使用 _wp_translate_postdata() 函数是不推荐的，因为它可能会在没有通知的情况下在未来的WordPress版本中发生变化。如果你正在编写插件或主题，并需要处理帖子提交，应该使用WordPress提供的高级函数，如 wp_insert_post() 和 wp_update_post()。
如果你确实需要处理提交的数据，以下是一个更安全的做法：

// 准备要插入或更新的帖子数组
$postarr = array(
    'ID'           => $post_id, // 如果是更新已有帖子，提供帖子ID
    'post_title'   => $_POST['post_title'],
    'post_content' => $_POST['post_content'],
    // ...其他帖子字段
);
// 使用 wp_insert_post() 或 wp_update_post() 来处理帖子
if ( $post_id ) {
    // 更新帖子
    $post_id = wp_update_post( $postarr );
} else {
    // 插入新帖子
    $post_id = wp_insert_post( $postarr );
}

在上述代码中，不需要直接调用 _wp_translate_postdata()，因为 wp_insert_post() 和 wp_update_post() 已经处理了数据转换和过滤。

未经允许不得转载：445IT之家 » WordPress函数_wp_translate_postdata()用法

赞 (0) 打赏

作者：liuying

相关推荐

    暂无内容！

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏