本文介绍如何在开发 Elementor 自定义小部件时，将插件目录内的图片（如 assets/img/placeholder.png）设为 MEDIA 控件的默认图像，替代 Elementor 默认占位图。
本文介绍如何在开发 elementor 自定义小部件时，将插件目录内的图片（如 `assets/img/placeholder.png`）设为 media 控件的默认图像，替代 elementor 默认占位图。
在 Elementor 插件开发中，Controls_Manager::MEDIA 控件常用于让用户上传或选择图片。默认情况下，若未显式指定 default 值，该控件会显示 Elementor 内置的灰色占位图（由 \Elementor\Utils::get_placeholder_image_src() 提供）。但实际项目中，你往往希望使用品牌一致的默认图——例如插件自有资源目录下的 assets/img/placeholder.png。
实现方法非常简洁：只需将 plugin_dir_url(__DIR__) . 'assets/img/placeholder.png' 作为 'url' 键的值传入 default 数组即可。plugin_dir_url(__DIR__) 安全返回当前插件根目录的可访问 URL（自动处理斜杠与协议），确保路径在前端可正确加载。
✅ 正确示例代码如下：
$repeater->add_control(
'ferdaussk_team_profile_image',
[
'label' => esc_html__( 'Choose Image', 'ferdaussk' ),
'type' => Controls_Manager::MEDIA,
'default' => [
'url' => plugin_dir_url(__DIR__) . 'assets/img/placeholder.png',
],
]
);⚠️ 注意事项：
- 确保 assets/img/placeholder.png 文件真实存在于插件目录中，且 Web 服务器有读取权限；
- 不要使用 plugin_dir_path()（返回文件系统路径），它无法在浏览器中直接访问；
- 若图片需支持多语言或高分辨率（如 Retina），建议同时提供 id（通过 wp_insert_attachment 预注册图片）以启用 Elementor 的完整媒体管理能力；但仅作静态默认图时，url 已完全满足需求；
- 如该控件位于重复器（Repeater）内，此默认值将应用于每个新添加的重复项，行为符合预期。
通过这一行路径配置，即可无缝替换默认占位图，提升小部件的专业性与视觉一致性。
