From e0e1f3c1571bc5160ca259823c0da8e95c641dc2 Mon Sep 17 00:00:00 2001
From: wpdev <webdemo2080@gmail.com>
Date: Fri, 31 Jul 2026 06:03:47 +0800
Subject: [PATCH] =?UTF-8?q?feat(back-compat):=20=E5=8A=A0=E5=85=A5=20WPDO?=
 =?UTF-8?q?=5F*=20class=20alias=EF=BC=88E3=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

核心的 class-tmdo-back-compat.php 在 plugins_loaded:4 執行，AddOn 於 :6
才載入，所以核心的 alias 表涵蓋不到 AddOn 類別 —— 姊妹外掛或第三方若
以 WPDO_* 名稱引用本 AddOn 的類別會直接 fatal。

新增 includes/back-compat-aliases.php，於 plugins_loaded:7 為本 AddOn
自有類別建立 WPDO_ alias；主檔加入 require。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY
---
 2meet-data-optimizer-hub-addon.php |  1 +
 includes/back-compat-aliases.php   | 32 ++++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 includes/back-compat-aliases.php

diff --git a/2meet-data-optimizer-hub-addon.php b/2meet-data-optimizer-hub-addon.php
index d995c2e..9d117e7 100644
--- a/2meet-data-optimizer-hub-addon.php
+++ b/2meet-data-optimizer-hub-addon.php
@@ -29,6 +29,7 @@ define( 'TMDO_HUB_FILE', __FILE__ );
 
 require_once TMDO_HUB_PATH . 'includes/class-tmdo-hub-bootstrap.php';
 
+require_once TMDO_HUB_PATH . 'includes/back-compat-aliases.php';
 /**
  * Phase 2 任務：完成本 AddOn 的 includes/ 實作。
  *
diff --git a/includes/back-compat-aliases.php b/includes/back-compat-aliases.php
new file mode 100644
index 0000000..a1cbf6c
--- /dev/null
+++ b/includes/back-compat-aliases.php
@@ -0,0 +1,32 @@
+<?php
+/**
+ * Backward-compat class aliases for the hub AddOn.
+ *
+ * Sister plugins and third-party code may still reference the WPDO_* class
+ * names from wp-data-optimizer. The core plugin aliases its own classes in
+ * class-tmdo-back-compat.php, but it runs before AddOns load (plugins_loaded:4
+ * vs :6), so each AddOn must alias its own classes here.
+ *
+ * @package TMDO
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+add_action(
+	'plugins_loaded',
+	static function () {
+		$aliases = array(
+			'TMDO_Hub_Bootstrap' => 'WPDO_Hub_Bootstrap',
+			'TMDO_Hub_Custom_Tables' => 'WPDO_Hub_Custom_Tables',
+			'TMDO_Hub_Vendor_Field' => 'WPDO_Hub_Vendor_Field',
+		);
+		foreach ( $aliases as $tmdo_class => $wpdo_alias ) {
+			if ( class_exists( $tmdo_class, false ) && ! class_exists( $wpdo_alias, false ) ) {
+				class_alias( $tmdo_class, $wpdo_alias );
+			}
+		}
+	},
+	7
+);