WordPress中的`media_send_to_editor`是一个动作钩子,用于在媒体库中选择一个文件并将其发送到编辑器中时触发。下面是该钩子的用法详解:
1. 注册钩子:
// 在functions.php或插件中注册钩子
add_action('media_send_to_editor', 'my_custom_function', 10, 3);
这里将`my_custom_function`函数绑定到`media_send_to_editor`钩子上。`10`是优先级,`3`是函数参数的数量。
2. 自定义函数:
function my_custom_function($html, $attachment_id, $attachment) {
// 自定义功能代码
}
在这个自定义函数中,你可以添加你自己的代码,来实现想要的功能。该函数接收3个参数:
- `$html`:媒体文件的HTML代码。
- `$attachment_id`:媒体文件的ID。
- `$attachment`:包含媒体文件的其他信息的对象。
3. 添加自定义代码:
function my_custom_function($html, $attachment_id, $attachment) {
// 获取媒体文件的标题
$title = $attachment->post_title;
// 修改HTML代码,给图片添加标题
$html = preg_replace('//', '
', $html);
// 返回修改后的HTML代码
return $html;
}
在这个例子中,我们获取媒体文件的标题,并将其添加到图片的`title`属性中。然后,使用正则表达式将原始HTML代码中的图片标签替换为带有标题的图片标签。最后,返回修改后的HTML代码。
通过这样的方式,你可以使用`media_send_to_editor`钩子来添加、修改或删除媒体文件在编辑器中的展示方式,实现你的自定义需求。


0 个评论