wp_create_file_in_uploads

查看官方原文 ↗

💡 云策文档标注

概述

wp_create_file_in_uploads 是一个 WordPress 过滤器，用于在设置自定义页眉或背景图像后，过滤附件文件路径。主要用于文件复制场景。

过滤器名称：wp_create_file_in_uploads
用途：在自定义页眉或背景图像设置后，修改附件文件路径，支持文件复制操作
参数：$file（文件路径字符串）、$attachment_id（附件 ID 整数）
调用示例：$file = apply_filters( 'wp_create_file_in_uploads', $file, $attachment_id );
相关函数：包括 wp_ajax_crop_image()、Custom_Image_Header 和 Custom_Background 类中的多个方法
引入版本：WordPress 2.1.0

📄 原文内容

Filters the attachment file path after the custom header or background image is set.

Used for file replication.

$file = apply_filters( 'wp_create_file_in_uploads', $file, $attachment_id ); // For replication.

Used by	Description
wp_ajax_crop_image()`wp-admin/includes/ajax-actions.php`	Handles cropping an image via AJAX.
Custom_Image_Header::ajax_header_crop()`wp-admin/includes/class-custom-image-header.php`	Gets attachment uploaded by Media Manager, crops it, then saves it as a new object. Returns JSON-encoded object details.
Custom_Image_Header::step_2()`wp-admin/includes/class-custom-image-header.php`	Displays second step of custom header image page.
Custom_Image_Header::step_3()`wp-admin/includes/class-custom-image-header.php`	Displays third step of custom header image page.
Custom_Background::handle_upload()`wp-admin/includes/class-custom-background.php`	Handles an Image upload for the background image.

Version	Description
2.1.0	Introduced.