wp_delete_post_revision

The timeline below displays how wordpress function wp_delete_post_revision has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @param int|WP_Post $revision Revision ID or revision object.
 * @return WP_Post|false|null Null or false if error, deleted post object if success.
 */
function wp_delete_post_revision($revision)
{
    $revision = wp_get_post_revision($revision);
    if (!$revision) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if ($delete) {
        /**
         * Fires once a post revision has been deleted.
         *
         * @since 2.6.0
         *
         * @param int     $revision_id Post revision ID.
         * @param WP_Post $revision    Post revision object.
         */
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}

WordPress Version: 5.4

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @param int|WP_Post $revision_id Revision ID or revision object.
 * @return array|false|WP_Post|WP_Error|null Null or WP_Error if error, deleted post if success.
 */
function wp_delete_post_revision($revision_id)
{
    $revision = wp_get_post_revision($revision_id);
    if (!$revision) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if ($delete) {
        /**
         * Fires once a post revision has been deleted.
         *
         * @since 2.6.0
         *
         * @param int     $revision_id Post revision ID.
         * @param WP_Post $revision    Post revision object.
         */
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}

WordPress Version: 5.3

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @param int|WP_Post $revision_id Revision ID or revision object.
 * @return array|false|WP_Post|WP_Error|null Null or WP_Error if error, deleted post if success.
 */
function wp_delete_post_revision($revision_id)
{
    $revision = wp_get_post_revision($revision_id);
    if (!$revision) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if ($delete) {
        /**
         * Fires once a post revision has been deleted.
         *
         * @since 2.6.0
         *
         * @param int          $revision_id Post revision ID.
         * @param object|array $revision    Post revision object or array.
         */
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}

WordPress Version: 4.3

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @param int|WP_Post $revision_id Revision ID or revision object.
 * @return array|false|WP_Post|WP_Error|null Null or WP_Error if error, deleted post if success.
 */
function wp_delete_post_revision($revision_id)
{
    if (!$revision = wp_get_post_revision($revision_id)) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if ($delete) {
        /**
         * Fires once a post revision has been deleted.
         *
         * @since 2.6.0
         *
         * @param int          $revision_id Post revision ID.
         * @param object|array $revision    Post revision object or array.
         */
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}

WordPress Version: 4.1

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @param int|object $revision_id Revision ID or revision object.
 * @return mixed Null or WP_Error if error, deleted post if success.
 */
function wp_delete_post_revision($revision_id)
{
    if (!$revision = wp_get_post_revision($revision_id)) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if (is_wp_error($delete)) {
        return $delete;
    }
    if ($delete) {
        /**
         * Fires once a post revision has been deleted.
         *
         * @since 2.6.0
         *
         * @param int          $revision_id Post revision ID.
         * @param object|array $revision    Post revision object or array.
         */
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}

WordPress Version: 3.9

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @uses wp_get_post_revision()
 * @uses wp_delete_post()
 *
 * @param int|object $revision_id Revision ID or revision object.
 * @return mixed Null or WP_Error if error, deleted post if success.
 */
function wp_delete_post_revision($revision_id)
{
    if (!$revision = wp_get_post_revision($revision_id)) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if (is_wp_error($delete)) {
        return $delete;
    }
    if ($delete) {
        /**
         * Fires once a post revision has been deleted.
         *
         * @since 2.6.0
         *
         * @param int          $revision_id Post revision ID.
         * @param object|array $revision    Post revision object or array.
         */
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}

WordPress Version: 3.7

/**
 * Deletes a revision.
 *
 * Deletes the row from the posts table corresponding to the specified revision.
 *
 * @since 2.6.0
 *
 * @uses wp_get_post_revision()
 * @uses wp_delete_post()
 *
 * @param int|object $revision_id Revision ID or revision object.
 * @return mixed Null or WP_Error if error, deleted post if success.
 */
function wp_delete_post_revision($revision_id)
{
    if (!$revision = wp_get_post_revision($revision_id)) {
        return $revision;
    }
    $delete = wp_delete_post($revision->ID);
    if (is_wp_error($delete)) {
        return $delete;
    }
    if ($delete) {
        do_action('wp_delete_post_revision', $revision->ID, $revision);
    }
    return $delete;
}