钩子文档

wp_save_post_revision_revisions_before_deletion

💡 云策文档标注

概述

wp_save_post_revision_revisions_before_deletion 是一个 WordPress 过滤器钩子,用于在删除文章修订版本之前过滤待考虑的修订版本数组。它允许开发者自定义哪些修订版本应被纳入删除流程。

关键要点

  • 这是一个过滤器钩子,用于修改 wp_save_post_revision() 函数中待删除的修订版本列表。
  • 接收两个参数:$revisions(WP_Post 对象数组,表示修订版本)和 $post_id(文章 ID)。
  • 首次引入于 WordPress 6.2.0 版本。

代码示例

$revisions = apply_filters(
    'wp_save_post_revision_revisions_before_deletion',
    $revisions,
    $post_id
);

📄 原文内容

Filters the revisions to be considered for deletion.

Parameters

$revisionsWP_Post[]
Array of revisions, or an empty array if none.
$post_idint
The ID of the post to save as a revision.

Source

$revisions = apply_filters(
	'wp_save_post_revision_revisions_before_deletion',
	$revisions,
	$post_id
);

Changelog

Version Description
6.2.0 Introduced.