WP Bakery自定义模板变量失效，自定义短代码输出为空求助

我来帮你逐一排查并修复这两个WP Bakery相关的问题：

一、自定义Grid短代码输出为空的修复 #

你的代码存在三个关键问题，直接导致短代码无法正常输出内容：

1. 过滤器函数未返回处理后的数组 #

WP的过滤器钩子要求函数必须返回修改后的参数，你的my_module_add_grid_shortcodes函数没有返回$shortcodes，相当于没有把自定义短代码添加到Grid Builder的可用列表中。

2. 语法错误：字符串未闭合 #

description字段的字符串末尾缺少闭合引号和分号，会触发PHP语法错误，直接中断代码执行。

3. 缺少短代码渲染函数 #

你只注册了短代码的基础元信息，但没有定义它的输出逻辑——即使注册成功，也不会有任何内容输出。

修复后的完整代码

// 注册Grid Builder可用的短代码
add_filter( 'vc_grid_item_shortcodes', 'my_module_add_grid_shortcodes' );
function my_module_add_grid_shortcodes( $shortcodes ) {
    $shortcodes['vc_custom_post_press_link'] = array(
        'name' => __( 'Press link', 'domain' ),
        'base' => 'vc_custom_post_press_link',
        'category' => __( 'Content', 'my-text-domain' ),
        'description' => __( 'Show custom post meta', 'my-text-domain' ) // 修复字符串闭合问题
    );
    return $shortcodes; // 必须返回修改后的数组，否则过滤器无效
}

// 定义短代码的渲染逻辑
add_shortcode( 'vc_custom_post_press_link', 'vc_custom_post_press_link_render' );
function vc_custom_post_press_link_render( $atts ) {
    // 获取当前Grid项对应的文章ID
    $post_id = get_the_ID();
    if ( !$post_id ) return '';

    // 替换成你实际使用的自定义字段键名
    $press_link = get_post_meta( $post_id, 'your_custom_meta_key', true );

    // 有值则输出格式化的链接，无值则返回空
    if ( !empty( $press_link ) ) {
        return '<a href="' . esc_url( $press_link ) . '" target="_blank">' . __( 'View Press', 'my-text-domain' ) . '</a>';
    }
    return '';
}

二、WP Bakery自定义模板变量无法工作的解决方案 #

如果你的自定义模板变量失效，可按以下步骤逐一排查：

1. 确保变量已正确注册 #

要让自定义变量在WP Bakery模板中可用，需要通过vc_grid_item_template_attribute_{shortcode_base}钩子注册变量。比如给上面的短代码添加模板变量支持：

add_filter( 'vc_grid_item_template_attribute_vc_custom_post_press_link', 'vc_custom_post_press_link_template_var', 10, 2 );
function vc_custom_post_press_link_template_var( $value, $post ) {
    // 返回你想作为模板变量的值，这里直接返回自定义字段内容
    return get_post_meta( $post->ID, 'your_custom_meta_key', true );
}

注册完成后，你就可以在Grid模板编辑器中用{{ vc_custom_post_press_link }}调用这个变量。

2. 检查模板变量调用格式 #

确保在WP Bakery模板中使用正确的调用格式：{{ 变量名 }}，注意变量名要和注册的完全一致，区分大小写。

3. 清空缓存 #

WP Bakery会缓存模板和短代码配置，尝试以下操作：

• 进入WP Bakery设置页面，点击「Clear Cache」按钮清空插件缓存
• 清空网站的页面缓存（如果使用了缓存插件）

4. 确认上下文正确性 #

模板变量只能在对应的上下文（比如Grid Builder的模板编辑界面、单个短代码的模板设置中）使用，确保你是在正确的场景下调用变量。

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