WordPress短代码故障：日程页演出信息短代码实现问题

首先，咱们得先把短代码的基础逻辑捋顺——直接在页面PHP里硬编码HTML确实不够灵活，而短代码故障大概率是因为没走对「注册短代码」的标准流程，这也是新手常踩的坑！

第一步：正确注册短代码函数 #

先把生成演出信息的逻辑封装成函数，然后在主题的functions.php里完成注册，这样WordPress才能识别你的短代码。这里给你写一个带参数的版本，用户调用时直接传数据就行：

// 把这段代码添加到主题的functions.php文件中
function concert_info_shortcode($atts) {
    // 提取短代码参数，同时设置默认值兜底
    $params = shortcode_atts(array(
        'date' => '01.02.2018',
        'band' => 'RHCP',
        'time' => '20:00',
        'location' => 'NY',
        'link' => '#'
    ), $atts);

    // 拼接安全的HTML结构（用esc系列函数防止XSS风险）
    $html_output = '<h4>This year hardcoded</h4>';
    $html_output .= '<a href="' . esc_url($params['link']) . '" class="p-link">';
    $html_output .= '<h2>' . esc_html($params['date']) . ' / ' . esc_html($params['band']) . '</h2>';
    $html_output .= '<p>' . esc_html($params['time']) . ' / ' . esc_html($params['location']) . '</p>';
    $html_output .= '</a>';

    return $html_output;
}
// 注册短代码，命名为concert_info
add_shortcode('concert_info', 'concert_info_shortcode');

第二步：在页面中调用短代码 #

现在你可以直接在WordPress页面编辑器里用这个短代码，按需传入参数就行，比如：

[concert_info date="01.02.2018" band="RHCP" time="20:00" location="NY" link="#"]

如果需要在页面PHP文件里直接调用，也可以用do_shortcode()函数：

echo do_shortcode('[concert_info date="01.02.2018" band="RHCP" time="20:00" location="NY" link="#"]');

排查之前短代码故障的常见原因 #

你之前的第一个短代码出问题，大概率是这几个情况：

• 没在functions.php里注册短代码，直接在页面PHP里写函数WordPress识别不了
• HTML拼接时出现语法错误（比如引号没闭合、标签未配对）
• 没有使用esc_url()/esc_html()这类安全函数，导致输出被WordPress的安全机制过滤
• 短代码命名和现有插件/主题的短代码重名了

用标准流程注册短代码后，既灵活又好维护，后续修改演出信息不用碰代码，直接在编辑器里改短代码参数就行~

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