WordPress添加自定义shortcode前端不显示无报错问题咨询

核心常见错误（优先排查） #

你贴出的代码中<、>符号被转义为了<、>，如果你直接将带转义字符的代码复制到了主题配置文件中，输出到前端的只会是纯文本的脚本代码，不会被浏览器解析为可运行的标签。
正确的短代码注册代码如下，请直接复制这段代码替换你现有的配置：

function homeShortCode(){
    $string = '<script async data-uid="36f126fae8" src="//hypnotherapywithmiriam.ck.page/36f126fae8/index.js"></script>';
    return $string;
}
add_shortcode('myshortcode', 'homeShortCode');

其他问题排查步骤 #

• 确认代码放置路径正确
  要将PHP代码放到当前启用的主题的functions.php文件末尾，如果你使用的是Hello Elementor主主题，建议先安装子主题，把代码放到子主题的functions.php中，避免主题升级后代码被覆盖。不要将代码放到CSS文件、自定义JS文件或其他非PHP配置文件中。
• 验证短代码本身是否正常
  暂时修改短代码的返回内容为纯文本测试，比如改成return '<p>短代码测试成功</p>';，在Elementor编辑器中添加短代码组件，输入正确的调用规则[myshortcode]，保存后刷新前端页面，如果能看到测试文本，说明短代码的注册和调用逻辑都正常。
• 排查脚本加载问题
  如果测试文本能正常显示，说明问题出在你插入的脚本本身：
  1. 打开浏览器开发者工具的「控制台」标签，刷新页面查看是否有JS报错
  2. 切换到「网络」标签，确认对应的JS文件是否成功加载，有没有被广告拦截插件、浏览器安全策略拦截
  3. 检查是否安装了WordPress安全插件、脚本优化插件，这类插件可能会拦截、延迟加载或者移除自定义插入的脚本
• 排查缓存与调用规则问题
  1. 如果你安装了页面缓存插件、CDN，先清空所有缓存后再刷新页面测试
  2. 确认你在Elementor中使用的是官方的「短代码」组件，不要将短代码输入到普通文本模块中（部分情况下文本模块会自动转义特殊字符）
  3. 确认该短代码所在模块没有设置隐藏规则，比如仅对管理员可见、仅在特定设备端显示

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