在 wordpress 插件开发中，若通过类静态方法动态注册短代码，必须使用 `init` 钩子（而非 `admin_init`）确保前后台均生效；同时需修正变量作用域、引用方式及短代码回调设计，才能使 `[foo]` 等自定义短代码正常渲染内容。
wordPress 的短代码（Shortcode）机制要求：所有 add_shortcode() 调用必须在 init 钩子或更早的前台/后台通用钩子中执行，因为短代码解析器在 the_content 过滤阶段（即模板输出前）才启用，而 admin_init 仅在 wordpress 后台管理界面加载时触发——这意味着你在 admin_init 中注册的短代码，前台页面完全不可见，也不会被解析，导致 [foo] 原样显示，毫无替换效果。
此外，原始代码中还存在多个关键问题，需一并修复：
✅ 正确的钩子与执行时机
将 add_action( ‘admin_init’, […] ) 替换为：
add_action( 'init', [ 'my_class', 'register_shortcodes' ] );init 是 WordPress 初始化完成、核心功能就绪后的首个通用钩子，适用于前后台，是注册短代码、重写规则、加载语言包等操作的标准时机。
✅ 修复变量作用域与静态属性引用
原代码中 add_shortcode( $codes[‘code1’], … ) 使用了未声明的局部变量 $codes，应改为访问静态属性 self::$codes：
class my_class { private static $codes = []; public static function register_shortcodes() { // 从数据库读取配置（建议加空值校验） $options = get_option( 'my_options_in_database', [] ); if ( ! is_array( $options ) ) { return; } self::$codes = $options; // 动态注册多个短代码 if ( isset( self::$codes['code1'] ) && ! empty( self::$codes['code1'] ) ) { add_shortcode( self::$codes['code1'], [ __CLASS__, 'render_shortcode' ] ); } if ( isset( self::$codes['code2'] ) && ! empty( self::$codes['code2'] ) ) { add_shortcode( self::$codes['code2'], [ __CLASS__, 'render_shortcode' ] ); } } /** * 通用短代码渲染函数，支持多 shortcode 共享逻辑 * @param array $atts 未使用，但必须保留签名（WordPress 要求） * @param string|null $content 内容型短代码的嵌套内容（本例未使用） * @param string $tag 当前触发的 shortcode 标签名（如 'foo'） * @return string 渲染结果 */ public static function render_shortcode( $atts, $content = null, $tag ) { // 根据 shortcode 标签名反查对应显示文本（需约定键名映射规则） // 示例：若数据库存 'code1'=>'foo', 'show1'=>'bar'，则 $tag==='foo' → 返回 'bar' foreach ( self::$codes as $key => $value ) { if ( strpos( $key, 'code' ) === 0 && $value === $tag ) { $show_key = str_replace( 'code', 'show', $key ); return isset( self::$codes[ $show_key ] ) ? esc_html( self::$codes[ $show_key ] ) : ''; } } return ''; // 未匹配时返回空 } }✅ 推荐增强：支持参数化与健壮性
- 安全输出：始终使用 esc_html() 或 wp_kses_post() 过滤动态内容，防止 xss。
- 键名规范建议：数据库中可改用关联数组提升可维护性，例如：
$options = [ ['shortcode' => 'foo', 'output' => 'bar'], ['shortcode' => 'baz', 'output' => 'qux'] ]; update_option( 'my_shortcodes_config', $options );对应注册逻辑可改为循环遍历，更清晰易扩展。
⚠️ 注意事项总结
- ❌ 不要在 admin_init、wp_loaded（过晚）、plugins_loaded（过早，get_option 可能不可用）等非标准钩子注册短代码；
- ✅ 必须确保 add_shortcode() 在 init 钩子中调用，且类方法为 public Static；
- ✅ 回调函数签名必须严格符合 function( $atts, $content, $tag )，即使不使用参数；
- ✅ 数据库选项需提前创建（如通过插件激活钩子），避免 get_option 返回 false 导致致命错误；
- ✅ 开发阶段启用 WP_DEBUG，配合浏览器开发者工具检查 HTML 源码，确认短代码是否被解析（而非残留原始标签）。
按此方案重构后，[foo] 将正确替换为 bar，且代码具备可扩展性与生产环境健壮性。