WordPress自定义插件的shortcode短代码文件正确存放位置是哪里？

你的操作方式存在本质逻辑错误，是导致站点报错、文章无法保存的直接原因。

核心错误点 #

• 加载逻辑混淆：自定义插件的文件不需要通过主题的functions.php引入，插件是独立于主题的功能模块，依赖主题加载插件文件会触发加载时序异常，导致短代码注册时机不对、插件启停逻辑找不到对应文件。
• 路径硬编码风险：你手动拼接的ABSPATH . '/wp-content/plugins/my-plugin/shortcodes.php'属于硬编码路径，一旦修改插件文件夹名、调整WordPress目录结构就会直接失效，且不符合WordPress开发规范。
• 语法冲突风险：如果主题的functions.php本身已存在PHP开标签，你额外写入的完整<?php ?>代码块会直接触发PHP语法错误，直接导致站点崩溃。

正确实现步骤 #

• 第一步：立刻删除你在主题functions.php中添加的所有引入插件文件的代码，恢复主题文件原始状态。
• 第二步：在你的自定义插件的入口文件（即插件根目录下带有插件头注释的主文件，如果你当前插件的核心逻辑写在插件目录下的functions.php中，就操作该文件）中，使用WordPress官方提供的路径函数引入shortcodes.php，不要硬编码路径：

// 插件内部加载短代码文件，自动适配当前插件所在路径
include_once plugin_dir_path( __FILE__ ) . 'shortcodes.php';

• 第三步：将shortcodes.php中的短代码注册逻辑挂载到init钩子上执行，保证WordPress核心加载完成后再注册短代码，避免时序错误：

add_action( 'init', 'my_custom_plugin_register_shortcodes' );
function my_custom_plugin_register_shortcodes() {
    // 所有add_shortcode调用都放在这个函数里
    // 示例：add_shortcode( 'test_shortcode', 'test_shortcode_render_func' );
}

补充说明：do_shortcode是手动解析短代码内容的调用函数，不需要和短代码注册逻辑放在一起，仅当你需要在非文章内容区域（比如自定义模板、插件固定输出位）手动渲染短代码时才需要调用。

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