本文详解如何在自定义 elementor 小部件中，将插件目录内的图片（如 assets/img/placeholder.png）设为 media 控件的默认值，替代 elementor 默认占位图。
本文详解如何在自定义 elementor 小部件中，将插件目录内的图片（如 assets/img/placeholder.png）设为 media 控件的默认值，替代 elementor 默认占位图。
在开发 Elementor 自定义小部件插件时，MEDIA 控件（Controls_Manager::MEDIA）常用于让用户上传或选择图片。默认情况下，若未显式指定 default 值，Elementor 会回退至其内置占位图（通过 \Elementor\Utils::get_placeholder_image_src() 返回）。但若希望统一使用插件自身提供的品牌化默认图（例如 assets/img/placeholder.png），需手动构造该图片的可访问 URL。
关键在于：default 数组中的 'url' 必须是可通过浏览器直接加载的绝对 HTTP 地址（而非文件系统路径）。因此不能使用 plugin_dir_path()，而应使用 plugin_dir_url() 动态生成 Web 可达的 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',
],
]
);
? 注意事项：
- __DIR__ 指向当前 PHP 文件所在目录；确保 assets/img/placeholder.png 确实存在于插件目录对应路径下；
- 图片需为 Web 可公开访问资源（即放在插件根目录或子目录中，且服务器已配置允许直接 GET 请求）；
- 若图片未生效，请检查浏览器开发者工具的 Network 面板，确认生成的 URL 是否能正常返回 200 状态码；
- 不建议使用相对路径（如 './assets/img/...'）或 ABSPATH，它们无法被前端识别；
- 如需支持默认图片同时携带 id（例如关联媒体库附件），可额外添加 'id' => 0（但非必需；仅当后续逻辑依赖附件 ID 时才需预设有效 ID）。
通过这种方式，你不仅提升了小部件的视觉一致性，也增强了插件的可维护性与品牌识别度——所有实例在未配置前均展示专属默认图，告别千篇一律的灰色占位符。
