钩子文档

wp_image_editor_before_change

💡 云策文档标注

概述

wp_image_editor_before_change 是一个 WordPress 过滤器钩子,用于在应用图像更改操作之前修改 WP_Image_Editor 实例。它允许开发者在图像编辑过程中介入,自定义或调整图像处理行为。

关键要点

  • 这是一个过滤器钩子,在应用图像更改前触发。
  • 参数包括 $image(WP_Image_Editor 实例)和 $changes(更改操作数组)。
  • 可用于自定义图像编辑流程,例如修改图像数据或添加预处理步骤。
  • 首次引入于 WordPress 3.5.0 版本。

代码示例

$image = apply_filters( 'wp_image_editor_before_change', $image, $changes );

注意事项

  • 确保正确处理 $image 参数,避免破坏 WP_Image_Editor 实例的完整性。
  • 相关函数 image_edit_apply_changes() 在 wp-admin/includes/image-edit.php 中定义,用于执行图像更改操作。

📄 原文内容

Filters the WP_Image_Editor instance before applying changes to the image.

Parameters

$imageWP_Image_Editor
WP_Image_Editor instance.
$changesarray
Array of change operations.

Source

$image = apply_filters( 'wp_image_editor_before_change', $image, $changes );

Changelog

Version Description
3.5.0 Introduced.