функция
since 2.9.0
get_delete_post_link()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_delete_post_link( int|WP_Post $post, string $deprecated = '', bool $force_delete = false ): string|null
Описание
Можно использовать как внутри цикла WordPress, так и вне его, с любым типом записи.
Оригинал (английский)
Can be used within the WordPress loop or outside of it, with any post type.
Параметры
$post
int|WP_Post
необязательный
ID записи или объект записи. По умолчанию — глобальная переменная $post.
$deprecated
string
необязательный
= ''
Не используется.
$force_delete
bool
необязательный
= false
Обходить ли корзину и принудительно удалять.
Возвращаемое значение
string|null
Исходный код
wp-includes/link-template.php:1556
function get_delete_post_link( $post = 0, $deprecated = '', $force_delete = false ) {
if ( ! empty( $deprecated ) ) {
_deprecated_argument( __FUNCTION__, '3.0.0' );
}
$post = get_post( $post );
if ( ! $post ) {
return null;
}
$post_type_object = get_post_type_object( $post->post_type );
if ( ! $post_type_object ) {
return null;
}
if ( ! current_user_can( 'delete_post', $post->ID ) ) {
return null;
}
$action = ( $force_delete || ! EMPTY_TRASH_DAYS ) ? 'delete' : 'trash';
$delete_link = add_query_arg( 'action', $action, admin_url( sprintf( $post_type_object->_edit_link, $post->ID ) ) );
/**
* Filters the post delete link.
*
* @since 2.9.0
*
* @param string $link The delete link.
* @param int $post_id Post ID.
* @param bool $force_delete Whether to bypass the Trash and force deletion. Default false.
*/
return apply_filters( 'get_delete_post_link', wp_nonce_url( $delete_link, "$action-post_{$post->ID}" ), $post->ID, $force_delete );
}
История изменений
| Версия | Описание |
|---|---|
| 2.9.0 | Introduced. |

