如何在Elementor动态标签中过滤自定义字段键的输出

问题背景 #

使用Elementor Pro + WordPress，需要在Elementor > 动态标签 > 文章自定义字段中，将字段_department的slug格式值（如residential-sales、residential-lettings）转换为“Sales”“Lettings”这类易读名称，且完全不影响网站其他区域的字段调用。

疑问解答 #

1. 原过滤器是否正确？ #

不正确。elementor_pro/posts/posts_custom_fields/get_meta是Elementor Pro「Posts Widget」专属的自定义字段获取钩子，和动态标签的自定义字段输出无关，所以你的代码无法生效。

2. 正确的过滤实现方式 #

Elementor为自定义字段动态标签提供了精准的钩子，推荐两种方案：

方案一：仅针对_department字段的精准过滤

使用动态钩子elementor/dynamic_tag/custom_field/value/{$meta_key}，将{$meta_key}替换为你的字段名_department，这样只会影响该字段在Elementor动态标签中的输出，完全不会干扰其他功能：

function custom_elementor_department_display( $value, $post_id, $args ) {
    // 定义slug与友好名称的映射表
    $department_map = [
        'residential-sales' => 'Sales',
        'residential-lettings' => 'Lettings',
    ];
    // 匹配到映射值则返回，否则返回原内容
    return isset( $department_map[$value] ) ? $department_map[$value] : $value;
}
// 绑定到_department字段的动态标签钩子
add_filter( 'elementor/dynamic_tag/custom_field/value/_department', 'custom_elementor_department_display', 10, 3 );

方案二：全局自定义字段标签过滤（多字段场景可选）

如果需要同时处理多个自定义字段，可以用通用钩子，再通过字段名判断仅处理_department：

function custom_elementor_custom_field_output( $value, $post_id, $args ) {
    // 只处理_department字段，其他字段直接返回原内容
    if ( '_department' !== $args['key'] ) {
        return $value;
    }
    // 映射逻辑
    $department_map = [
        'residential-sales' => 'Sales',
        'residential-lettings' => 'Lettings',
    ];
    return isset( $department_map[$value] ) ? $department_map[$value] : $value;
}
add_filter( 'elementor/dynamic_tag/custom_field/value', 'custom_elementor_custom_field_output', 10, 3 );

使用步骤 #

1. 将代码添加到当前主题的functions.php文件，或自定义功能插件中；
2. 刷新Elementor编辑器（必要时清除网站缓存）；
3. 动态标签中调用_department字段时，将自动显示转换后的友好名称，网站其他区域的字段调用不受任何影响。

内容的提问来源于stack exchange，提问作者Ross