钩子文档

pre_delete_attachment

💡 云策文档标注

概述

pre_delete_attachment 是一个 WordPress 过滤器,用于控制附件删除操作是否执行。它允许开发者在删除附件前进行自定义检查或干预。

关键要点

  • 过滤器名称:pre_delete_attachment
  • 主要用途:过滤附件删除操作,决定是否继续执行删除
  • 参数:$delete(WP_Post|false|null,是否执行删除)、$post(WP_Post 对象,附件对象)、$force_delete(bool,是否强制删除绕过回收站)
  • 返回值:通过返回 false 或 null 可以阻止删除,返回其他值则继续执行
  • 相关函数:wp_delete_attachment() 用于删除附件
  • 引入版本:WordPress 5.5.0

代码示例

$check = apply_filters( 'pre_delete_attachment', null, $post, $force_delete );

📄 原文内容

Filters whether an attachment deletion should take place.

Parameters

$deleteWP_Post|false|null
Whether to go forward with deletion.
$postWP_Post
Post object.
$force_deletebool
Whether to bypass the Trash.

Source

$check = apply_filters( 'pre_delete_attachment', null, $post, $force_delete );

Changelog

Version Description
5.5.0 Introduced.