WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_ajax_trash_post()

wp_ajax_trash_post( string $action )

In this article

Back to top

Handles sending a post to the Trash via AJAX.

Parameters

$actionstringrequired
Action to perform.

Source

function wp_ajax_trash_post( $action ) {	if ( empty( $action ) ) {	$action = 'trash-post';	}	$id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;	check_ajax_referer( "{$action}_$id" );	if ( ! current_user_can( 'delete_post', $id ) ) {	wp_die( -1 );	}	if ( ! get_post( $id ) ) {	wp_die( 1 );	}	if ( 'trash-post' === $action ) {	$done = wp_trash_post( $id );	} else {	$done = wp_untrash_post( $id );	}	if ( $done ) {	wp_die( 1 );	}	wp_die( 0 ); }

View all references View on Trac View on GitHub

UsesDescription
wp_trash_post()wp-includes/post.php

Moves a post or page to the Trash

wp_untrash_post()wp-includes/post.php

Restores a post from the Trash.

current_user_can()wp-includes/capabilities.php

Returns whether the current user has the specified capability.

check_ajax_referer()wp-includes/pluggable.php

Verifies the Ajax request to prevent processing requests external of the blog.

wp_die()wp-includes/functions.php

Kills WordPress execution and displays HTML page with an error message.

get_post()wp-includes/post.php

Retrieves post data given a post ID or post object.

Show 4 moreShow less
Used byDescription
wp_ajax_untrash_post()wp-admin/includes/ajax-actions.php

Handles restoring a post from the Trash via AJAX.

Changelog

VersionDescription
3.1.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.