|
@@ -1169,11 +1147,11 @@ class TMDO_Admin {
- HPCT Modules
+ AddOn Modules
| |
|---|
- $state ) : ?>
+ $state ) : ?>
|
|
@@ -2717,79 +2695,6 @@ wpdo.getListings({ per_page: 3 }).then(r => console.log(r));'
'
- . esc_html__( 'HPCT 匯入需要啟用 2meet-data-optimizer-hivepress-addon。', '2meet-data-optimizer' )
- . ' ';
- return;
- }
-
- // Handle import action.
- if ( isset( $_POST['wpdo_run_import'] ) && check_admin_referer( 'wpdo_hpct_import' ) ) {
- $result = TMDO_HPCT_Import::run();
- if ( is_wp_error( $result ) ) {
- echo '' . esc_html( $result->get_error_message() ) . ' ' . esc_html__( 'HPCT 匯入成功！建議停用 HP Custom Tables 外掛。', '2meet-data-optimizer' ) . '
-
-
- |
- |
- |
-
-
-
-
-
- |
- |
- |
-
-
-
-
-
-
-
-
-
-
- console.log(r));'
?>
-
+
@@ -3004,13 +2909,16 @@ wpdo.getListings({ per_page: 3 }).then(r => console.log(r));'
}
$tests = array(
- 'wpdo_schema_drift' => array( 'check_schema_drift', __( 'Schema 完整性', '2meet-data-optimizer' ) ),
- 'wpdo_error_budget' => array( 'check_error_budget', __( '錯誤預算（過去 7 天）', '2meet-data-optimizer' ) ),
- 'wpdo_hook_conflicts' => array( 'check_hook_conflicts', __( 'Hook 衝突', '2meet-data-optimizer' ) ),
- 'wpdo_autoload_bloat' => array( 'check_autoload_bloat', __( 'Autoload 大小', '2meet-data-optimizer' ) ),
- 'wpdo_postmeta_explosion' => array( 'check_postmeta_explosion', __( 'wp_postmeta 爆量', '2meet-data-optimizer' ) ),
- 'wpdo_orphan_zone_rows' => array( 'check_orphan_zone_rows', __( 'Orphan zone rows', '2meet-data-optimizer' ) ),
- 'wpdo_missing_snapshot' => array( 'check_missing_snapshot', __( '缺少最近快照', '2meet-data-optimizer' ) ),
+ 'wpdo_schema_drift' => array( 'check_schema_drift', __( 'Schema 完整性', '2meet-data-optimizer' ) ),
+ 'wpdo_error_budget' => array( 'check_error_budget', __( '錯誤預算（過去 7 天）', '2meet-data-optimizer' ) ),
+ 'wpdo_hook_conflicts' => array( 'check_hook_conflicts', __( 'Hook 衝突', '2meet-data-optimizer' ) ),
+ 'wpdo_autoload_bloat' => array( 'check_autoload_bloat', __( 'Autoload 大小', '2meet-data-optimizer' ) ),
+ 'wpdo_postmeta_explosion' => array( 'check_postmeta_explosion', __( 'wp_postmeta 爆量', '2meet-data-optimizer' ) ),
+ 'wpdo_orphan_zone_rows' => array( 'check_orphan_zone_rows', __( 'Orphan zone rows', '2meet-data-optimizer' ) ),
+ 'wpdo_missing_snapshot' => array( 'check_missing_snapshot', __( '缺少最近快照', '2meet-data-optimizer' ) ),
+ 'wpdo_entity_group_collisions' => array( 'check_entity_group_collisions', __( '實體群組名稱衝突', '2meet-data-optimizer' ) ),
+ 'wpdo_orphaned_entity_groups' => array( 'check_orphaned_entity_groups', __( '孤兒實體群組', '2meet-data-optimizer' ) ),
+ 'wpdo_missing_integration_addons' => array( 'check_missing_integration_addons', __( '缺少對應 AddOn', '2meet-data-optimizer' ) ),
);
?>
@@ -3490,7 +3398,7 @@ wpdo.getListings({ per_page: 3 }).then(r => console.log(r));'
console.log(r));'
console.log(r));'
';
foreach ( $all as $m ) {
printf(
diff --git a/admin/class-tmdo-deprecated-addons-notice.php b/admin/class-tmdo-deprecated-addons-notice.php
new file mode 100644
index 0000000..89c0151
--- /dev/null
+++ b/admin/class-tmdo-deprecated-addons-notice.php
@@ -0,0 +1,91 @@
+ in_array( "2meet-data-optimizer-{$slug}-addon/2meet-data-optimizer-{$slug}-addon.php", $active, true )
+ )
+ );
+ }
+
+ /**
+ * Print the notice for administrators when any deprecated AddOn is active.
+ *
+ * @return void
+ */
+ public static function render(): void {
+ if ( ! current_user_can( 'manage_options' ) ) {
+ return;
+ }
+ $active = self::active();
+ if ( empty( $active ) ) {
+ return;
+ }
+
+ $names = implode( ', ', array_map( static fn( string $slug ): string => "2meet-data-optimizer-{$slug}-addon", $active ) );
+ printf(
+ '',
+ esc_html__( '2meet Data Optimizer：', '2meet-data-optimizer' ),
+ esc_html(
+ sprintf(
+ /* translators: %s: comma-separated AddOn plugin slugs */
+ __( '以下 AddOn 已淘汰：%s。對應的 2meet 外掛改為自行向核心註冊資料表與欄位，AddOn 之後會移除。', '2meet-data-optimizer' ),
+ $names
+ )
+ ),
+ esc_html__( '改寫方式見 2meet-data-optimizer 外掛內的 docs/PARTNER-REGISTRATION.md；partner 外掛完成自行註冊後即可停用對應 AddOn。', '2meet-data-optimizer' )
+ );
+ if ( array_intersect( $active, array( 'hub', 'spoke', 'sso' ) ) ) {
+ printf(
+ '',
+ esc_html__( 'Hub / Spoke / SSO AddOn 不需替代：2meet-hub-core 與 2meet-spoke-sso 會自行註冊資料表，SSO 值存回 usermeta 即可。停用前先執行 wp tmdo bridge-restore-native user --group=sso --retire。', '2meet-data-optimizer' )
+ );
+ }
+ }
+}
diff --git a/admin/class-tmdo-help-tabs.php b/admin/class-tmdo-help-tabs.php
index c1c36ba..57cb85b 100644
--- a/admin/class-tmdo-help-tabs.php
+++ b/admin/class-tmdo-help-tabs.php
@@ -107,7 +107,7 @@ class TMDO_Help_Tabs {
private static function content_dashboard(): string {
return '' . esc_html__( '儀表板顯示：', '2meet-data-optimizer' ) . ' '
. ''
- . '- ' . esc_html__( 'System Overview — DB 引擎、HivePress、HPCT、Object Cache 是否啟用', '2meet-data-optimizer' ) . '
'
+ . '- ' . esc_html__( 'System Overview — DB 引擎、HivePress、Object Cache 是否啟用', '2meet-data-optimizer' ) . '
'
. '- ' . esc_html__( 'Zone 行數統計 — Hot/Warm/Cold/Archive 各自累積多少資料', '2meet-data-optimizer' ) . '
'
. '- ' . esc_html__( 'Module 狀態 — 每個 module 在 7-state FSM 哪一格', '2meet-data-optimizer' ) . '
'
. '- ' . esc_html__( 'Warm zone live view — 哪些 view counts / TTL 進來、24h 快過期數', '2meet-data-optimizer' ) . '
'
@@ -173,7 +173,6 @@ class TMDO_Help_Tabs {
. '' . esc_html__( '常見原因：', '2meet-data-optimizer' ) . ' '
. ''
. '- ' . esc_html__( 'Hook Bus 啟用（wpdo_hook_bus_enabled = 1）+ legacy interceptors 還沒卸載', '2meet-data-optimizer' ) . '
'
- . '- ' . esc_html__( 'HPCT (HP Custom Tables) plugin 還沒移除 — 與 WPDO 同時攔截', '2meet-data-optimizer' ) . '
'
. ' '
. '' . esc_html__( '解法：先看 conflict-scan 詳情，必要時用 wp wpdo bridge-set off 暫停 Hook Bus 直到清理完。', '2meet-data-optimizer' ) . ' ';
}
@@ -184,7 +183,7 @@ class TMDO_Help_Tabs {
* @return string
*/
private static function content_doctor(): string {
- return '' . esc_html__( '7 項自動健康檢查：', '2meet-data-optimizer' ) . ' '
+ return '' . esc_html__( '10 項自動健康檢查：', '2meet-data-optimizer' ) . ' '
. ''
. '- schema_drift — ' . esc_html__( '所有 v2 表是否存在', '2meet-data-optimizer' ) . '
'
. '- error_budget — ' . esc_html__( '7 天內 wp_wpdo_errors 行數', '2meet-data-optimizer' ) . '
'
@@ -193,6 +192,9 @@ class TMDO_Help_Tabs {
. '- postmeta_explosion — ' . esc_html__( 'wp_postmeta > 5M 行', '2meet-data-optimizer' ) . '
'
. '- orphan_zone_rows — ' . esc_html__( '已 idle 的 module 但 zone 表還有資料', '2meet-data-optimizer' ) . '
'
. '- missing_snapshot — ' . esc_html__( '在 cutover/cleanup/complete 但 7 天沒 snapshot', '2meet-data-optimizer' ) . '
'
+ . '- entity_group_collisions — ' . esc_html__( '同名實體群組被不同外掛以不同欄位註冊（後者被忽略）', '2meet-data-optimizer' ) . '
'
+ . '- orphaned_entity_groups — ' . esc_html__( '扁平表還在但已無外掛註冊的群組（已依保存的定義還原以維持可讀）', '2meet-data-optimizer' ) . '
'
+ . '- missing_integration_addons — ' . esc_html__( 'HivePress / WooCommerce 已啟用但對應 AddOn 未啟用', '2meet-data-optimizer' ) . '
'
. ' '
. '' . esc_html__( '結果有 5 分鐘 transient cache，剛操作完想立刻看新值請等下個週期。', '2meet-data-optimizer' ) . ' ';
}
diff --git a/admin/class-tmdo-missing-addons-notice.php b/admin/class-tmdo-missing-addons-notice.php
new file mode 100644
index 0000000..0803c63
--- /dev/null
+++ b/admin/class-tmdo-missing-addons-notice.php
@@ -0,0 +1,62 @@
+ $addon ) {
+ $lines[] = sprintf( '%s → %s', $plugin, $addon );
+ }
+ printf(
+ '',
+ esc_html__( '2meet Data Optimizer：', '2meet-data-optimizer' ),
+ esc_html(
+ sprintf(
+ /* translators: %s: "Plugin → AddOn" pairs */
+ __( '以下外掛已啟用，但對應的 AddOn 沒有啟用，它們的欄位不會被優化：%s。請啟用對應的 AddOn。', '2meet-data-optimizer' ),
+ implode( '；', $lines )
+ )
+ )
+ );
+ }
+}
diff --git a/cli/class-tmdo-cli-post.php b/cli/class-tmdo-cli-post.php
index 717b525..ac9382f 100644
--- a/cli/class-tmdo-cli-post.php
+++ b/cli/class-tmdo-cli-post.php
@@ -259,6 +259,94 @@ class TMDO_CLI_Post {
);
}
+ // ── post-reconcile-groups ─────────────────────────────────────────────────
+
+ /**
+ * Move post values written under legacy routing into their post type's
+ * group table, then switch on post_type-scoped routing.
+ *
+ * Needed once on sites that already hold post flat rows (the installer
+ * leaves tmdo_post_scoped_routing off there). Resumable: an interrupted
+ * run continues from its cursor.
+ *
+ * ## OPTIONS
+ *
+ * [--dry-run]
+ * : Count the values that would be copied / overwritten; write nothing.
+ *
+ * [--batch=]
+ * : Rows per batch. Default 500.
+ *
+ * ## EXAMPLES
+ *
+ * wp tmdo post-reconcile-groups --dry-run
+ * wp tmdo post-reconcile-groups
+ *
+ * @param array $args Positional arguments (unused).
+ * @param array $assoc_args Named arguments.
+ */
+ public function post_reconcile_groups( $args, $assoc_args ): void {
+ $dry_run = isset( $assoc_args['dry-run'] );
+ $report = TMDO_Post_Group_Reconciler::run( $dry_run, (int) ( $assoc_args['batch'] ?? 500 ) );
+
+ if ( empty( $report['moves'] ) ) {
+ WP_CLI::log( 'No shared post keys to move.' );
+ }
+ foreach ( $report['moves'] as $m ) {
+ WP_CLI::log( sprintf( '%s → %s %s: %d value(s)%s', $m['source'], $m['target'], $m['key'], $m['copied'], $dry_run ? sprintf( ', %d would overwrite a different value', $m['overwritten'] ) : '' ) );
+ }
+
+ if ( $dry_run ) {
+ WP_CLI::success( '[dry-run] Nothing written. Re-run without --dry-run to copy and switch on scoped routing.' );
+ return;
+ }
+ WP_CLI::success( 'Post groups reconciled; tmdo_post_scoped_routing is on.' );
+ }
+
+ // ── post-status-sync ──────────────────────────────────────────────────────
+
+ /**
+ * Add post_status / post_date copies (and their index) to every post
+ * group table and fill them from wp_posts.
+ *
+ * Existing tables only get the columns here, never in a web request:
+ * ALTER on a large table can take seconds. Afterwards status changes keep
+ * the copies current. Re-run after bulk writes that bypass WordPress
+ * (e.g. post-reconcile-groups, post migrations).
+ *
+ * ## OPTIONS
+ *
+ * [--dry-run]
+ * : Count rows whose copies are missing or stale; change nothing.
+ *
+ * [--batch=]
+ * : Rows per UPDATE. Default 1000.
+ *
+ * ## EXAMPLES
+ *
+ * wp tmdo post-status-sync --dry-run
+ * wp tmdo post-status-sync
+ *
+ * @param array $args Positional arguments (unused).
+ * @param array $assoc_args Named arguments.
+ */
+ public function post_status_sync( $args, $assoc_args ): void {
+ $dry_run = isset( $assoc_args['dry-run'] );
+ $report = TMDO_Post_Status_Sync::run( $dry_run, (int) ( $assoc_args['batch'] ?? 1000 ) );
+
+ if ( empty( $report ) ) {
+ WP_CLI::log( 'No post group tables.' );
+ }
+ foreach ( $report as $group => $r ) {
+ WP_CLI::log( sprintf( '%s: %d row(s), %d missing or stale%s', $group, $r['rows'], $r['mismatched'], $dry_run ? '' : sprintf( ' → %s', TMDO_Post_Status_Sync::state( $group ) ) ) );
+ }
+ if ( $dry_run ) {
+ WP_CLI::success( '[dry-run] Nothing changed.' );
+ return;
+ }
+ WP_CLI::success( 'post_status / post_date copies are in sync.' );
+ }
+
// ── post-cleanup (v2.9.3) ─────────────────────────────────────────────────
/**
@@ -816,23 +904,7 @@ class TMDO_CLI_Post {
* @return string|null
*/
private static function group_post_type_for_cli( string $group ): ?string {
- switch ( $group ) {
- case 'attachment':
- return 'attachment';
- case 'wc_product':
- return 'product';
- case 'hp_listing_core':
- return 'hp_listing';
- case 'hp_request_core':
- return 'hp_request';
- case 'hp_vendor_core':
- return 'hp_vendor';
- case 'nav_menu_item':
- return 'nav_menu_item';
- case 'wp_core':
- default:
- return null;
- }
+ return TMDO_Post_Fields::post_type_for_group( $group );
}
}
@@ -853,3 +925,6 @@ WP_CLI::add_command( 'wpdo post-benchmark', array( 'TMDO_CLI_Post', 'post_benchm
WP_CLI::add_command( 'tmdo post-benchmark', array( 'TMDO_CLI_Post', 'post_benchmark' ) );
WP_CLI::add_command( 'wpdo post-shadow-report', array( 'TMDO_CLI_Post', 'post_shadow_report' ) );
WP_CLI::add_command( 'tmdo post-shadow-report', array( 'TMDO_CLI_Post', 'post_shadow_report' ) );
+WP_CLI::add_command( 'wpdo post-reconcile-groups', array( new TMDO_CLI_Post(), 'post_reconcile_groups' ) );
+WP_CLI::add_command( 'tmdo post-reconcile-groups', array( new TMDO_CLI_Post(), 'post_reconcile_groups' ) );
+WP_CLI::add_command( 'tmdo post-status-sync', array( new TMDO_CLI_Post(), 'post_status_sync' ) );
diff --git a/cli/class-tmdo-cli-term-comment.php b/cli/class-tmdo-cli-term-comment.php
index 5d31dd9..96dea8a 100644
--- a/cli/class-tmdo-cli-term-comment.php
+++ b/cli/class-tmdo-cli-term-comment.php
@@ -429,7 +429,7 @@ class TMDO_CLI_Term_Comment {
WP_CLI::log( sprintf( 'Mode: %s', $term_mode ) );
WP_CLI::log( sprintf( 'wp_terms: %s', number_format_i18n( $terms_count ) ) );
WP_CLI::log( sprintf( 'wp_termmeta: %s (1:%s)', number_format_i18n( $termmeta_count ), $terms_count > 0 ? round( $termmeta_count / $terms_count, 2 ) : 'n/a' ) );
- self::print_flat_row( $wpdb->prefix . 'wpdo_term_hp_taxonomy', 'wpdo_term_hp_taxonomy' );
+ self::print_group_rows( 'term' );
self::print_flat_row( $wpdb->prefix . 'wpdo_term_misc', 'wpdo_term_misc' );
WP_CLI::log( '' );
@@ -437,7 +437,7 @@ class TMDO_CLI_Term_Comment {
WP_CLI::log( sprintf( 'Mode: %s', $comment_mode ) );
WP_CLI::log( sprintf( 'wp_comments: %s', number_format_i18n( $comments_count ) ) );
WP_CLI::log( sprintf( 'wp_commentmeta: %s (1:%s)', number_format_i18n( $commentmeta_count ), $comments_count > 0 ? round( $commentmeta_count / $comments_count, 2 ) : 'n/a' ) );
- self::print_flat_row( $wpdb->prefix . 'wpdo_comment_hp_review', 'wpdo_comment_hp_review' );
+ self::print_group_rows( 'comment' );
self::print_flat_row( $wpdb->prefix . 'wpdo_comment_misc', 'wpdo_comment_misc' );
WP_CLI::log( '' );
@@ -470,6 +470,21 @@ class TMDO_CLI_Term_Comment {
return 'Both entities at disabled. Promote to dual_write first to enable Hook Bus interception.';
}
+ /**
+ * Print the row count of every registered group table of an entity.
+ *
+ * @param string $entity_type 'term' or 'comment'.
+ * @return void
+ */
+ private static function print_group_rows( string $entity_type ): void {
+ foreach ( TMDO_Term_Comment_Backfill::registered_groups() as $group => $type ) {
+ if ( $type === $entity_type ) {
+ $table = TMDO_Schema_Manager::get_table_name( $entity_type, $group );
+ self::print_flat_row( $table, TMDO_TABLE_PREFIX . $entity_type . '_' . $group );
+ }
+ }
+ }
+
/**
* Print a flat table's row count (or "(missing)" when not present).
*
@@ -647,7 +662,8 @@ class TMDO_CLI_Term_Comment {
);
}
- $valid_groups = array( 'all', 'hp_taxonomy', 'hp_review' );
+ $registered = TMDO_Term_Comment_Backfill::registered_groups();
+ $valid_groups = array_merge( array( 'all' ), array_keys( $registered ) );
if ( ! in_array( $group, $valid_groups, true ) ) {
WP_CLI::error( 'Invalid --group. Choose: ' . implode( ', ', $valid_groups ) );
}
@@ -656,8 +672,7 @@ class TMDO_CLI_Term_Comment {
if ( 'all' === $group ) {
$results = TMDO_Term_Comment_Backfill::backfill_all( $dry_run );
} else {
- $entity_type = 'hp_review' === $group ? 'comment' : 'term';
- $results = array( $group => TMDO_Term_Comment_Backfill::backfill_group( $entity_type, $group, $dry_run ) );
+ $results = array( $group => TMDO_Term_Comment_Backfill::backfill_group( $registered[ $group ], $group, $dry_run ) );
}
// Render table.
diff --git a/cli/class-tmdo-cli-v2.php b/cli/class-tmdo-cli-v2.php
index 986e420..b3d76f2 100644
--- a/cli/class-tmdo-cli-v2.php
+++ b/cli/class-tmdo-cli-v2.php
@@ -152,6 +152,71 @@ class TMDO_CLI_V2 {
WP_CLI::success( "Hook Bus: {$state}" );
}
+ /**
+ * Write an entity's flat-table values back to native meta — the way out of
+ * aeav_only. Resumable; re-run after an interruption.
+ *
+ * ## OPTIONS
+ *
+ *
+ * : post | user | term | comment
+ *
+ * [--dry-run]
+ * : Count the flat rows per group; write nothing.
+ *
+ * [--batch=]
+ * : Rows per batch. Default 500.
+ *
+ * [--demote]
+ * : After a complete run, switch the entity to dual_write (both copies kept in step).
+ *
+ * [--group=]
+ * : Only this group.
+ *
+ * [--retire]
+ * : With --group, after the write-back: forget the group (registry_meta row)
+ * and rename its flat table to _retired_. Refused while a plugin
+ * still registers the group or native meta differs from the flat table.
+ *
+ * ## EXAMPLES
+ *
+ * wp tmdo bridge-restore-native user --dry-run
+ * wp tmdo bridge-restore-native user --demote
+ * wp tmdo bridge-restore-native user --group=sso --retire
+ *
+ * @param array $args Positional arguments.
+ * @param array $assoc_args Named arguments.
+ */
+ public function bridge_restore_native( $args, $assoc_args ): void {
+ $entity = (string) ( $args[0] ?? '' );
+ if ( ! in_array( $entity, TMDO_Entity_Registry::VALID_ENTITY_TYPES, true ) ) {
+ WP_CLI::error( 'Usage: wp tmdo bridge-restore-native [--dry-run] [--batch=] [--demote] [--group= [--retire]]' );
+ }
+ $dry_run = isset( $assoc_args['dry-run'] );
+ $group = sanitize_key( (string) ( $assoc_args['group'] ?? '' ) );
+ if ( isset( $assoc_args['retire'] ) && '' === $group ) {
+ WP_CLI::error( '--retire needs --group=.' );
+ }
+ $report = TMDO_Native_Restorer::run( $entity, $dry_run, (int) ( $assoc_args['batch'] ?? 500 ), isset( $assoc_args['demote'] ), $group );
+
+ foreach ( $report['groups'] as $group => $g ) {
+ WP_CLI::log( sprintf( '%s/%s: %d row(s)%s', $entity, $group, $g['rows'], $dry_run ? '' : sprintf( ', %d native value(s) written', $g['written'] ) ) );
+ }
+ if ( $dry_run ) {
+ WP_CLI::success( '[dry-run] Nothing written.' );
+ return;
+ }
+ if ( isset( $assoc_args['retire'] ) ) {
+ $retired = TMDO_Native_Restorer::retire( $entity, $group );
+ if ( 'retired' !== $retired['status'] ) {
+ WP_CLI::error( sprintf( 'Not retired (%s%s). Written values stay in native meta.', $retired['status'], $retired['mismatches'] ? ", {$retired['mismatches']} value(s) differ" : '' ) );
+ }
+ WP_CLI::success( "{$entity}/{$group} retired; flat table kept as {$retired['archived_table']}." );
+ return;
+ }
+ WP_CLI::success( $report['demoted'] ? "Restored; {$entity} is now dual_write." : 'Restored. Demote the entity to dual_write (admin Entity Bridge tab) before its next write, or re-run with --demote.' );
+ }
+
/**
* Audit per-module state + shadow_read flags.
*
@@ -784,6 +849,8 @@ WP_CLI::add_command( 'wpdo bridge-status', array( 'TMDO_CLI_V2', 'bridge_status'
WP_CLI::add_command( 'tmdo bridge-status', array( 'TMDO_CLI_V2', 'bridge_status' ) );
WP_CLI::add_command( 'wpdo bridge-set', array( 'TMDO_CLI_V2', 'bridge_set' ) );
WP_CLI::add_command( 'tmdo bridge-set', array( 'TMDO_CLI_V2', 'bridge_set' ) );
+WP_CLI::add_command( 'wpdo bridge-restore-native', array( new TMDO_CLI_V2(), 'bridge_restore_native' ) );
+WP_CLI::add_command( 'tmdo bridge-restore-native', array( new TMDO_CLI_V2(), 'bridge_restore_native' ) );
WP_CLI::add_command( 'wpdo mode-audit', array( 'TMDO_CLI_V2', 'mode_audit' ) );
WP_CLI::add_command( 'tmdo mode-audit', array( 'TMDO_CLI_V2', 'mode_audit' ) );
WP_CLI::add_command( 'wpdo mode-set', array( 'TMDO_CLI_V2', 'mode_set' ) );
diff --git a/cli/class-tmdo-cli.php b/cli/class-tmdo-cli.php
index e227736..6d193ef 100644
--- a/cli/class-tmdo-cli.php
+++ b/cli/class-tmdo-cli.php
@@ -42,7 +42,6 @@ class TMDO_CLI {
$compat = TMDO_Compatibility::check();
WP_CLI::log( 'HivePress: ' . ( $compat['hivepress'] ? 'Active' : 'Not found' ) );
- WP_CLI::log( 'HP Custom Tables: ' . self::format_hpct_status( $compat ) );
WP_CLI::log( 'Object Cache: ' . ( wp_using_ext_object_cache() ? 'External' : 'Built-in' ) );
WP_CLI::log( '' );
@@ -57,10 +56,10 @@ class TMDO_CLI {
WP_CLI::log( 'Module States:' );
- $hpct_flags = TMDO_Feature_Flags::hpct_modules();
- if ( ! empty( $hpct_flags ) ) {
- WP_CLI::log( ' [HPCT Modules]' );
- foreach ( $hpct_flags as $module => $state ) {
+ $addon_flags = TMDO_Feature_Flags::addon_modules();
+ if ( ! empty( $addon_flags ) ) {
+ WP_CLI::log( ' [AddOn Modules]' );
+ foreach ( $addon_flags as $module => $state ) {
WP_CLI::log( " {$module}: {$state}" );
}
}
@@ -330,6 +329,40 @@ class TMDO_CLI {
WP_CLI::log( ' [OK] Crypto key derivable (AUTH_KEY / SECURE_AUTH_SALT present)' );
}
+ // ── Entity group name collisions ─────────────────────────────────────────
+ $collisions = TMDO_Entity_Registry::get_collisions();
+ if ( empty( $collisions ) ) {
+ WP_CLI::log( ' [OK] No entity group name collisions' );
+ }
+ foreach ( $collisions as $c ) {
+ WP_CLI::warning(
+ sprintf(
+ ' [COLLISION] %s/%s registered twice with different fields (second ignored) — added: %s; removed: %s; changed: %s',
+ $c['entity_type'],
+ $c['group'],
+ implode( ', ', $c['added'] ) ?: '-',
+ implode( ', ', $c['removed'] ) ?: '-',
+ implode( ', ', $c['changed'] ) ?: '-'
+ )
+ );
+ $all_ok = false;
+ }
+
+ // ── Orphaned entity groups (restored from wpdo_registry_meta) ───────────
+ foreach ( TMDO_Entity_Registry::get_restored_groups() as $r ) {
+ WP_CLI::warning(
+ sprintf(
+ ' [ORPHAN] %s/%s — no active plugin registers it; restored %d field(s) from wpdo_registry_meta%s%s. Reactivate the owner or write the data back before removing it.',
+ $r['entity_type'],
+ $r['group'],
+ $r['fields'],
+ $r['skipped'] ? ' (skipped, owned by another group: ' . implode( ', ', $r['skipped'] ) . ')' : '',
+ $r['native'] ? ' (left on native meta, which has newer data: ' . implode( ', ', $r['native'] ) . ')' : ''
+ )
+ );
+ $all_ok = false;
+ }
+
// Check recent errors.
$errors = TMDO_Logger::get_recent( '', 5 );
if ( ! empty( $errors ) ) {
@@ -634,51 +667,6 @@ class TMDO_CLI {
WP_CLI::success( "Module {$module} disabled (idle)." );
}
- /**
- * Import settings from HP Custom Tables.
- *
- * ## EXAMPLES
- *
- * wp wpdo import-hpct
- *
- * @param array $args Positional arguments.
- * @param array $assoc_args Associative arguments.
- * @return void
- *
- * @subcommand import-hpct
- */
- public function import_hpct( $args, $assoc_args ): void { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed
- // HPCT is a HivePress-family plugin; the importer ships in that AddOn.
- if ( ! class_exists( 'TMDO_HPCT_Import' ) ) {
- WP_CLI::error( 'import-hpct needs 2meet-data-optimizer-hivepress-addon to be active.' );
- }
-
- if ( TMDO_HPCT_Import::is_imported() ) {
- WP_CLI::warning( 'HPCT settings have already been imported.' );
- return;
- }
-
- if ( ! TMDO_HPCT_Import::can_import() ) {
- WP_CLI::error( 'HP Custom Tables plugin not detected or already imported.' );
- }
-
- // Show preview.
- $preview_data = TMDO_HPCT_Import::preview();
- if ( ! empty( $preview_data['modules'] ) ) {
- WP_CLI::log( 'Import preview:' );
- WP_CLI\Utils\format_items( 'table', $preview_data['modules'], array( 'module', 'hpct_status', 'wpdo_state' ) );
- }
-
- WP_CLI::confirm( 'Proceed with import?' );
-
- $result = TMDO_HPCT_Import::run();
- if ( is_wp_error( $result ) ) {
- WP_CLI::error( $result->get_error_message() );
- }
-
- WP_CLI::success( 'HPCT settings imported successfully. You can now deactivate HP Custom Tables.' );
- }
-
/**
* Run performance benchmark.
*
@@ -1396,22 +1384,6 @@ class TMDO_CLI {
}
}
- /**
- * Format the HPCT status string for display.
- *
- * @param array $compat Compatibility check result array.
- * @return string Human-readable HPCT status.
- */
- private static function format_hpct_status( array $compat ): string {
- if ( $compat['hpct_active'] && $compat['hpct_imported'] ) {
- return 'Active (Imported)';
- }
- if ( $compat['hpct_active'] ) {
- return 'Active (Not imported — run `wp wpdo import-hpct`)';
- }
- return 'Not found';
- }
-
/**
* Create the appropriate migration instance for a module name.
*
diff --git a/docs/BENCHMARK-SCALE.md b/docs/BENCHMARK-SCALE.md
new file mode 100644
index 0000000..3eb6066
--- /dev/null
+++ b/docs/BENCHMARK-SCALE.md
@@ -0,0 +1,74 @@
+# 規模效能基準：原生 postmeta vs Hot 表 vs Entity 表
+
+**量測日期**：2026-09-25 **分支**：`hardening/2.0` **目標規模**：vendor 100,000、listing 1,000,000
+
+## 如何重現
+
+```bash
+# DB 帳密沿用整合測試的 TMDO_TEST_DB_* 環境變數；資料庫名稱必須以 _bench 結尾
+TMDO_TEST_DB_NAME=wp_wpdo_bench php tests/bench/seed.php --vendors=100000 --listings=1000000 # 約 7.5 分鐘
+TMDO_TEST_DB_NAME=wp_wpdo_bench php tests/bench/run.php --iterations=20 # 約 20 分鐘
+```
+
+## 環境與資料
+
+| 項目 | 值 |
+|---|---|
+| 資料庫 | MariaDB 10.11.14（本機，InnoDB 預設設定） |
+| 主機 | 8 核、31 GB RAM、NVMe |
+| 資料 | 100,000 vendor（users + hp_vendor posts）、1,000,000 listing（90% publish） |
+| 原生 meta | postmeta 9,549,796 筆（951 MB）、usermeta 600,000 筆 |
+| Entity 表 | `wpdo_post_hp_listing_core` 1,000,000 筆（379 MB） |
+| Hot 表 | `wpdo_hot_hp_listing` 1,000,000 筆（229 MB） |
+
+SQL 的形狀與實際程式一致：原生是 WP_Query 的 meta_query（每個條件一個 INNER JOIN、數值用 CAST、`SQL_CALC_FOUND_ROWS`），Hot 是 `TMDO_Query_Router`，Entity 是 `TMDO_Post_Query_Router`。每個情境 20 次，另有 3 次暖機不計入，參數隨機但可重現（`--seed=7`）。寫入在交易內執行後 rollback。
+
+> 20 次取樣下 p95 等於最大值，僅供參考。
+
+## 結果
+
+| 情境 | 形式 | p50 ms | p95 ms | 結果筆數 | 使用索引 |
+|---|---|---:|---:|---:|---|
+| 1. 價格區間搜尋（命中約 20%） | 原生 | **14,695** | 14,890 | 180,292 | postmeta:post_id |
+| | Hot | 558 | 3,605 | 180,329 | h:ALL |
+| | Entity | 652 | 3,817 | 180,300 | e:ALL |
+| 2. 價格區間 + verified=1 | 原生 | **17,094** | 17,250 | 54,197 | postmeta:post_id ×2 |
+| | Hot | 277 | 299 | 54,109 | `idx_hp_verified_hp_price`（複合） |
+| | Entity | 337 | 340 | 54,180 | e:ALL |
+| 3. 某 vendor 名下的 listing | `post_parent`（HivePress 實際做法） | 0.19 | 0.25 | 7 | posts:post_parent |
+| | 原生 meta `hp_vendor` | **14,432** | 14,599 | 8 | postmeta:post_id |
+| | Hot | **3,405** | 3,651 | 10 | 無可用索引 |
+| | Entity | 0.28 | 0.33 | 8 | `idx_hp_vendor` |
+| 4. 單筆 listing 讀全部 meta | 原生 | 0.12 | 0.15 | 9 列 | postmeta:post_id |
+| | Hot / Entity | 0.09 | 0.11–0.14 | 1 列 | 主鍵 |
+| 5. 列表頁預載 20 筆 meta | 原生 | 0.59 | 0.61 | 181 列 | postmeta:post_id |
+| | Hot / Entity | 0.21–0.22 | 0.23–0.26 | 20 列 | 主鍵 |
+| 6. 單一 vendor 讀使用者 meta | 原生 | 0.11 | 0.14 | 6 列 | usermeta:user_id |
+| | Entity | 0.08 | 0.11 | 1 列 | 主鍵 |
+| 7. 寫入：更新一筆價格 | 原生 | 0.12 | 0.16 | — | — |
+| | Entity | 0.10 | 0.13 | — | — |
+| | dual_write（兩邊都寫） | 0.22 | 0.26 | — | — |
+
+## 結論
+
+1. **原生 meta_query 在百萬規模下無法使用。** 任何以 meta 為條件的搜尋都要 14–17 秒，扁平化是必要的，不是錦上添花。
+2. **扁平表的價值集中在「搜尋與篩選」。** 單筆或批次讀 meta（情境 4–6）三種形式都在 1 ms 內，差距可以忽略，而且實務上還有 object cache。
+3. **寬範圍搜尋仍有瓶頸（情境 1，p50 約 0.6 秒、p95 約 3.7 秒）。** 命中 18 萬筆時，優化器選擇全表掃描；再加上 `SQL_CALC_FOUND_ROWS` 要算總數、`ORDER BY post_date` 要排序，還要 JOIN 回 `posts` 過濾狀態。p50 和 p95 差很多，是因為不同的價格區間讓優化器選了不同的執行計畫。
+ - **PR-028**：post 群組表可存 `post_status`、`post_date` 副本與 `(post_status, post_date)` 索引（`wp tmdo post-status-sync`）。1M 列實測：加欄位 0.05 秒（instant）、建索引 5.3 秒、分批（1,000 列）回填 32 秒，之後與 `posts` 0 筆不一致。欄位 collation 必須跟 `posts.post_status` 相同，否則比對會出現 illegal mix of collations。查詢改寫在 PR-029。
+ - **PR-029**：副本 ready 且無 NULL 時，單一 post type、明確狀態、依日期排序的搜尋改為 INNER JOIN、`post_status IN (…)`、`ORDER BY` 副本 `post_date`、不 GROUP BY（bench 變體 `entity+copy`，`--iterations=5`）。仍帶 `SQL_CALC_FOUND_ROWS` 時：情境 1 p50 670→770 ms、**p95 3,739→773 ms**；情境 2 p50 356→448 ms（變慢，因為算總數仍要掃完所有符合列）。拿掉 `SQL_CALC_FOUND_ROWS` 後同形狀情境 1 只要 **8 ms**（走 `idx_post_status_date`、LIMIT 提早結束）→ 完整效益要搭配 PR-030。
+ - **PR-030**：路由後的搜尋不再帶 `SQL_CALC_FOUND_ROWS`；總數改由同一查詢的 `COUNT(*)` 回答，存在物件快取，key 綁 `last_changed(posts)`（核心存文、Hook Bus 扁平寫入都會推進）。1M 實測：快取命中時整頁 **8 ms**（原 694 / 363 ms）；快取失效後第一次為頁面 8 ms + COUNT 608 / 344 ms，與原本相當。任何 post 寫入都讓全部計數失效（WP last_changed 語意），寫入頻繁的站命中率較低。
+4. **Hot 表的索引規則有漏洞。** `add_covering_indexes()` 只替 decimal、tinyint，以及名稱以 `_time` 結尾的 bigint 建索引，所以 `hp_vendor` 沒有索引，情境 3 要 3.4 秒，比 Entity 慢約 12,000 倍。
+5. **Entity 表只有單欄索引。** 情境 2 輸給有複合索引的 Hot 表（337 ms 對 277 ms）。
+ - **PR-027 之後**：群組可用 `register_group( ..., array( 'indexes' => ... ) )` 宣告複合索引。在 1M 列的 Entity 表加上 `cidx_verified_price (hp_verified, hp_price)` 花 8.1 秒；重跑情境 2（`--iterations=10`），Entity p50 從 337 ms 降到 **278 ms**（p95 285 ms），Hot 是 269 ms（p95 280 ms），差距在量測誤差內。執行計畫改走 `e:cidx_verified_price`。
+6. **dual_write 的寫入成本約為兩倍（0.22 ms 對 0.12 ms）**，絕對值很小，不是瓶頸。
+7. **Hot 表和 Entity 表儲存了同一份 listing 資料**（合計約 608 MB），兩者功能重疊。
+
+## 優化候選（待使用者確認後排入 backlog）
+
+| # | 候選 | 針對 | 預期效果 |
+|---|---|---|---|
+| O-1 | Entity 表把 `post_status`、`post_date` 一併存進來，並建 `(hp_status, post_date)` 等複合索引，讓搜尋不必 JOIN 回 `posts` 排序 | 情境 1、2 | 寬範圍搜尋改為走索引排序，避免 filesort |
+| O-2 | Entity 表支援群組層級的複合索引宣告，例如 `(hp_verified, hp_price)`、`(hp_featured, hp_price)` | 情境 2 | 追上或超過 Hot 表 |
+| O-3 | Hot 表的索引規則補上外鍵型 bigint 欄位（例如 `hp_vendor`） | 情境 3 | 3.4 秒降到 1 ms 以下 |
+| O-4 | 提供總數快取，或讓路由後的查詢可以不跑 `SQL_CALC_FOUND_ROWS`（MySQL 8 已棄用） | 情境 1、2 | 省去每次搜尋都要算出全部符合列的成本 |
+| O-5 | 評估 Hot 表與 Entity 表的整併，避免同一份資料存兩份 | 容量、寫入 | 省下約 229 MB 並減少一次寫入 |
diff --git a/docs/INTEGRATION_PATTERN_DECISION.md b/docs/INTEGRATION_PATTERN_DECISION.md
index c6fa033..ba2c8fd 100644
--- a/docs/INTEGRATION_PATTERN_DECISION.md
+++ b/docs/INTEGRATION_PATTERN_DECISION.md
@@ -1,5 +1,7 @@
# Integration Pattern Decision — 2026-04-25
+> **2026-09 更新：** 2meet 自家外掛回到「partner 自行註冊」，做法見 `PARTNER-REGISTRATION.md`；對應的 8 個 AddOn 已淘汰。
+
> **v1.0.0 後記（2026-07-31）：本文結論已被架構拆分取代。**
> 當時的兩個選項是「集中在核心」vs「各外掛自帶 bridge」。v1.0.0 走的是第三條路：
> 每個夥伴外掛對應**一個獨立 AddOn 外掛**（`2meet-data-optimizer--addon`，共 11 個），
diff --git a/docs/PARTNER-REGISTRATION.md b/docs/PARTNER-REGISTRATION.md
new file mode 100644
index 0000000..0e9ad64
--- /dev/null
+++ b/docs/PARTNER-REGISTRATION.md
@@ -0,0 +1,115 @@
+# Partner 外掛自行註冊指南
+
+> 適用：2meet 自家外掛（bookings、collab、hub、infocards、mobile-bridge、playlist、quotation、spoke）。
+> 這 8 個外掛原本各有一個 `2meet-data-optimizer--addon`，替它們向核心註冊資料表和欄位。
+> 這些 AddOn 已淘汰：資料結構的定義應該和資料的擁有者放在一起，所以改由 partner 外掛自己註冊。
+> 啟用中的 AddOn 會在後台顯示淘汰通知（`TMDO_Deprecated_Addons_Notice`）。
+>
+> HivePress、WooCommerce、LatePoint 是第三方外掛，仍然保留各自的 AddOn。
+
+## 1. 掛上 trait
+
+核心提供 `TMDO_Anti_EAV_Aware` trait（`includes/trait-tmdo-anti-eav-aware.php`）。trait 由核心載入，所以只有在核心存在時才宣告 bridge 類別，把它放在獨立檔案：
+
+```php
+// 2meet-bookings.php（partner 主檔）
+add_action(
+ 'plugins_loaded',
+ static function () {
+ if ( ! trait_exists( 'TMDO_Anti_EAV_Aware' ) ) {
+ return; // 核心未啟用：什麼都不做。
+ }
+ require_once __DIR__ . '/includes/class-tmb-tmdo-bridge.php';
+ ( new TMB_TMDO_Bridge() )->boot();
+ },
+ 3
+);
+```
+
+```php
+// includes/class-tmb-tmdo-bridge.php
+final class TMB_TMDO_Bridge {
+ use TMDO_Anti_EAV_Aware;
+
+ protected function plugin_slug(): string {
+ return '2meet-bookings';
+ }
+
+ public function boot(): void {
+ $this->bind_anti_eav_hooks();
+ }
+
+ // 覆寫需要的 on_register_*()，見下面兩節。
+}
+```
+
+**時機**：核心在 `plugins_loaded:4` 觸發 `wpdo_register_*`，並在 `init:1` 再觸發一次。
+建議掛在 `plugins_loaded:3`，這樣第一次觸發就能收到你的註冊，`init` 之前的讀寫也會被正確路由。
+掛在 `:5` 之後也能運作（會在 `init:1` 補上），只是 `init` 之前的請求看不到你的欄位。
+
+**名稱**：請用 `TMDO_Anti_EAV_Aware`。`WPDO_Anti_EAV_Aware` 是舊的 wp-data-optimizer 3.x 的 trait，由 mu-plugin `wpdo-policy-enforcer.php` 從已退役的路徑載入，沒有後面提到的 `post_types` 參數。
+
+## 2. 註冊自有資料表
+
+讓 `wp wpdo doctor` / benchmark 認得你的資料表，並做 schema 漂移檢查。以 bookings 為例：
+
+```php
+public function on_register_custom_tables( TMDO_Custom_Table_Registry $r ): void {
+ $this->register_custom_table(
+ $r,
+ array(
+ 'table_name' => '2mb_services', // 不含 $wpdb->prefix
+ 'primary_key' => 'id',
+ 'post_type_link' => null, // 若每列對應一個 post，填 post_type（playlist 用 'hp_vendor'）
+ 'expected_columns' => array(
+ 'id' => 'BIGINT',
+ 'vendor_id' => 'BIGINT',
+ 'title' => 'VARCHAR',
+ // …照 CREATE TABLE 逐欄列出
+ ),
+ 'indexes' => array(
+ 'vendor_id' => array( 'vendor_id' ),
+ ),
+ )
+ );
+}
+```
+
+collab、playlist、quotation、mobile-bridge 的 AddOn 只做這件事：把各自 `includes/class-tmdo-.php` 裡 `register_custom_tables()` 的 `$tables` 陣列**原樣**搬進 partner 的 bridge 即可。
+
+## 3. 註冊 entity 欄位群組（選用）
+
+只有要把 meta 從 `wp_postmeta` / `wp_usermeta` 等 EAV 表移到扁平表時才需要：
+
+```php
+public function on_register_entity_fields(): void {
+ $this->register_entity_fields(
+ 'post',
+ 'tmb_service_core',
+ array(
+ array( 'key' => 'tmb_price', 'type' => 'decimal', 'searchable' => true ),
+ array( 'key' => 'tmb_status', 'type' => 'enum', 'options' => array( 'open', 'closed' ) ),
+ ),
+ array( 'post_types' => array( 'tmb_service' ) )
+ );
+}
+```
+
+- **`post_types`（post 群組建議必填）**：群組只套用在這些 post type。多個群組共用同一個 meta key 時，會依 post 本身的類型決定寫到哪張表；不屬於這些 post type 的 post，這個 key 不受管理（照舊寫原生 meta）。沒有宣告時，共用 key 會被「最後註冊的群組」整個接走。
+- **定義一旦上線就不要改**：欄位定義的 hash 存在 `wpdo_registry_meta`，改了會對已有資料的扁平表執行 ALTER。要新增欄位時，開新群組。
+- **群組名稱不可和別人重複**：同名但定義不同時，後註冊的會被忽略，並在 Site Health、後台 Doctor 分頁和 `wp wpdo doctor` 顯示 `[COLLISION]`。
+
+## 4. 從 AddOn 遷移
+
+1. 在 partner 的 bridge 裡註冊和 AddOn **完全相同**的資料表與群組（直接複製 AddOn 的定義）。
+2. 部署 partner 新版，AddOn 先保持啟用。`wp wpdo doctor` 不應出現 `[COLLISION]`；兩邊定義相同時，重複註冊會被靜默忽略。
+3. 停用 AddOn。
+4. 再跑一次 `wp wpdo doctor`：資料表仍在清單中，而且不應出現 `[ORPHAN]`。如果出現，表示有群組沒有被 partner 接手；該實體是 aeav_only 時，核心會依 `wpdo_registry_meta` 暫時還原它，讓資料可以讀取，但仍應補上註冊。
+5. 確認沒有問題後，刪除 AddOn 外掛。
+
+hub、infocards、spoke 的 partner 外掛本身已經會自己註冊，AddOn 只是重複註冊；停用前照第 2 步確認沒有 `[COLLISION]` 即可。
+
+## 相關文件
+
+- `ENTITY_ADAPTER_COOKBOOK.md`：整合深度 Tier 1–3（`TMDO_API` facade、Schema Registry、自訂 adapter）。
+- `INTEGRATION_PATTERN_DECISION.md`：2026-04 的「partner 自帶 bridge」決策紀錄；本指南回到這個做法。
diff --git a/docs/WAF-COMPATIBILITY.md b/docs/WAF-COMPATIBILITY.md
new file mode 100644
index 0000000..f4cba3c
--- /dev/null
+++ b/docs/WAF-COMPATIBILITY.md
@@ -0,0 +1,279 @@
+# WAF 相容性 — NinjaFirewall
+
+適用：2meet-data-optimizer v1.0.2+ / NinjaFirewall (WP Edition) 4.9
+
+**結論：兩者可共存，且不需要開發 AddOn。** 本文記錄實測結果、symlink 多租戶部署的必要設定、WP SaaS 的開站流程與驗證清單，以及開發時必須遵守的三條約束。
+
+> 只想開新站台的話，直接看 §3；踩到 `Cannot retrieve user options from database (#3)` 看 §2。
+
+---
+
+## 1. 兩種模式的差異
+
+NinjaFirewall 只有兩種模式（「WP+」是付費版本，不是模式）：
+
+| | WordPress WAF | Full WAF |
+|---|---|---|
+| 載入方式 | mu-plugin `0-ninjafirewall.php` | `auto_prepend_file`（`.user.ini` / php.ini） |
+| 執行時機 | WordPress 載入中 | **WordPress 載入之前** |
+| 讀設定 | `get_option('nfw_options')` | 自行解析 wp-config.php，**原生 mysqli 直查 `{prefix}options`** |
+| symlink 安全 | ✅ 站台身分由 WordPress 決定 | ❌ 自行以 `__DIR__` 推導（見 §2） |
+
+這個差異是後續所有注意事項的根源：**Full WAF 完全繞過 WordPress**，因此 TMDO 的任何 PHP 攔截器對它都不存在，但反過來，TMDO 對 `wp_options` 的**持久性**改動會影響它。
+
+---
+
+## 2. Symlink / 多租戶部署（必讀）
+
+WP SaaS 常以 symlink 共享 codebase：
+
+```
+tenant-a/wp-content/plugins -> /shared/plugins
+tenant-b/wp-content/plugins -> /shared/plugins
+```
+
+Full WAF 在 `lib/firewall.php:78` 這樣推導站台位置：
+
+```php
+$nfw_['wp_content'] = dirname(dirname(dirname( __DIR__ )));
+```
+
+**PHP 的 `__DIR__` 會解析 symlink 到真實路徑**，於是每個租戶都被判定為「共享目錄所屬的那個站」。接著 `firewall.php:120-121` 讀到錯誤的 wp-config.php、連到錯誤的資料庫，撈不到該站的 `nfw_options`，最後在 `firewall.php:613` 回傳錯誤碼 6：
+
+```
+NinjaFirewall fatal error: Cannot retrieve user options from database (#3).
+Review your installation, your site is not protected.
+```
+
+最後那句是字面意義的 —— 此時 WAF 已 `nfw_quit()`，**完全不做任何過濾**。
+
+### 解法：以 DOCUMENT_ROOT 為錨點
+
+`.htninja` 的搜尋位置是 `$_SERVER['DOCUMENT_ROOT']`（`firewall.php:47-48`），那是 web server 的 per-site 值，不受 symlink 影響。第二順位是 `dirname(DOCUMENT_ROOT)`，因此**一份檔案即可服務所有租戶**：
+
+```php
+`）不會外洩內容，但不該依賴它。
+
+### 3.2 每個新租戶站台（順序不可顛倒）
+
+**順序很重要**：先確保錨點與設定就緒，再安裝 Full WAF。順序顛倒會直接撞上 §2 的 `#3` 錯誤。
+
+**Step 1 — 啟用外掛，建立該站自己的設定**
+
+```bash
+wp --path=/var/www/sites/ plugin activate ninjafirewall
+wp --path=/var/www/sites/ option list --search='nfw*' --fields=option_name,autoload
+# 必須看到 nfw_options 與 nfw_rules，否則後續一定 #3
+```
+
+`nfw_options` / `nfw_rules` 存在**該租戶自己的資料庫**，不會因為 codebase 共享而自動存在。這是 `#3` 最常見的成因 —— 路徑修對了，但那個站從沒跑過 installer。
+
+**Step 2 — 確認目錄權限**
+
+php-fpm worker（通常 www-data）必須能在 `nfwlog/` 建立與寫入檔案：
+
+| 路徑 | 建議 | 理由 |
+|---|---|---|
+| `wp-content/nfwlog/` 及子目錄 | `2775` `wpdev:www-data` | setgid 確保新檔繼承 group；group 需 `w` 否則 WAF 寫不了 log |
+| `nfwlog/` 內檔案 | `664` | 同上 |
+| `nfwlog/session/` | 不用管 | 由 WAF 自建，它會用自己的嚴格權限（`0700`） |
+| `.user.ini`（裝 Full WAF 後才有） | `664` `wpdev:www-data` | www-data 需可讀，否則 auto_prepend 靜默失效 |
+
+```bash
+NFWLOG=/var/www/sites//wp-content/nfwlog
+sudo find "$NFWLOG" -type d -exec chmod 2775 {} +
+sudo find "$NFWLOG" -type f -exec chmod 664 {} +
+```
+
+若 `nfwlog/` 的 owner 本來就是 www-data（例如全程由後台建立），預設 `0755` 也可運作 —— owner 有寫入權。會出事的是「owner 是別人、group 只有 `r-x`」這種組合。
+
+**Step 3 — 安裝 Full WAF（從後台）**
+
+務必從 WordPress 後台操作，不要手工建檔：後台以 www-data 執行，權限天然正確；且官方安裝流程有 sandbox 驗證，會先確認 `auto_prepend_file` 真的生效才寫入設定，避免寫出讓整站 500 的 `.user.ini`。
+
+裝完立刻檢查 `.user.ini` 權限（見上表）。`root:root 0640` 是常見的踩雷組合 —— PHP 讀不到，Full WAF 等同沒裝，而表面上一切正常。
+
+**Step 4 — 套用 nginx 規則並 reload**
+
+```bash
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+### 3.3 開站後驗證（每站必跑）
+
+四項缺一不可。只做前兩項會漏掉最隱蔽的失效模式。
+
+```bash
+SITE=https://.example.com
+NFWLOG=/var/www/sites//wp-content/nfwlog
+
+# (1) 模式判別 —— 回 Forbidden 代表 Full WAF 生效（auto_prepend 已套用到所有 PHP 請求）
+curl -sk "$SITE/wp-content/plugins/ninjafirewall/lib/i18n.php" | head -c 9; echo
+
+# (2) 攔截能力 —— 應為 403
+curl -sk -o /dev/null -w '%{http_code}\n' "$SITE/?t=../../etc/passwd"
+
+# (3) 記錄能力 —— 最容易被漏掉的一項，log 必須增長
+before=$(stat -c%s "$NFWLOG/firewall_$(date +%Y-%m).php")
+curl -sk -o /dev/null "$SITE/?t=../../etc/passwd"
+after=$(stat -c%s "$NFWLOG/firewall_$(date +%Y-%m).php")
+[ "$after" -gt "$before" ] && echo "log OK" || echo "log FAIL — 檢查 nfwlog 權限"
+
+# (4) web 封鎖與功能未損
+for p in /wp-content/nfwlog/ /wp-content/nfwlog/readme.txt /.user.ini /.htaccess; do
+ printf "%-40s %s\n" "$p" "$(curl -sk -o /dev/null -w '%{http_code}' "$SITE$p")" # 全部應為 403
+done
+for p in / /wp-json/ /wp-admin/; do
+ printf "%-40s %s\n" "$p" "$(curl -sk -o /dev/null -w '%{http_code}' "$SITE$p")" # 200 / 200 / 302
+done
+```
+
+**第 (3) 項為什麼不能省**：攔截與記錄是兩件事。權限不足時 WAF 照樣回 403，但一筆記錄都寫不進去 —— 你得到一個沒有稽核軌跡的防火牆，事故調查時等於沒有。更嚴重的是同一個權限問題會讓 `session/` 建不出來，而 `wl_admin` 管理員白名單靠 `NFWSESSID` session 承載 `nfw_goodguy` 旗標，於是管理員實際上是被全規則掃描的 —— 這正是「後台操作偶爾莫名 403」的來源。
+
+### 3.4 排查時的常見誤判
+
+這幾項在實測中都出現過，全部會誤導判斷：
+
+| 現象 | 直覺結論 | 實際 |
+|---|---|---|
+| 首頁 200、後台沒有錯誤訊息 | WAF 正常 | 完全不能推論。WAF 失效時是 `nfw_quit()` 靜默放行，不擋也不記 |
+| 攻擊 payload 回 403 | Full WAF 生效 | 可能來自共享 mu-plugin 的 WP WAF。用 §3.3 第 (1) 項區分 |
+| `nfwlog/` 下的檔案回 403 | nginx 規則生效 | 也可能是 nginx 以 www-data 開不了 root-only 檔案。修好權限後會突然變 200 |
+| `/.well-known/` 回 403 | dotfile 規則誤擋了 ACME | 多半是目錄存在但 autoindex off。用實檔測：`/.well-known/acme-challenge/` 若回 404（WordPress 頁面）而非 403，代表規則有正確放行 |
+| `wp-login.php` 回 404 | nginx 改壞了 | 檢查是否啟用 `wps-hide-login` 之類的登入頁隱藏外掛 |
+| `wp tmdo doctor` 全綠 | WAF 與外掛相容 | WP-CLI 完全豁免 WAF（`firewall.php:18-23`），CLI 結果不能當相容性證據，必須另外走 HTTP 驗證 |
+
+### 3.5 每租戶獨立的維運負擔
+
+symlink 共享的是 codebase，**不是設定與狀態**。以下每一項都是 per-tenant：
+
+- **`nfw_options` / `nfw_rules`** 存在各自的 `wp_options`。`nfw_rules` 約 77 KB 且 `autoload=auto`，N 個租戶就是 N 份。
+- **規則更新**要逐站執行，沒有集中派送機制。
+- **log / cache / session** 各自獨立（前提是 §2 的 `NFW_LOG_DIR` 已正確設定，否則全部寫進共享目錄互相覆蓋）。
+- **停用租戶站台時**，`nfwlog/readme.txt` 明示：解除安裝後要等 5 分鐘再刪除該目錄，否則站台可能崩潰。
+
+規劃階段就要把這些算進成本 —— 特別是「規則更新要逐站跑」這點，租戶數量上去之後需要自動化。
+
+---
+
+## 4. 開發約束（三條）
+
+### 4.1 不得重導向 WAF 的設定選項
+
+`TMDO_Options_Manager::register_settings_group()` 以 `pre_update_option_{key}` 回傳 `$old_value`，讓選項不再落地 `wp_options`。而 Full WAF 是用原生 mysqli 直查該表 —— 一旦 `nfw_options` / `nfw_rules` 被重導向，WAF 會讀不到設定而**靜默停止防護：不報錯、不寫 log**。
+
+v1.0.2 起由 `PROTECTED_OPTIONS` 常數擋下，測試見 `tests/unit/OptionsManagerProtectedTest.php`。新增任何「WordPress 載入前就會以原生 SQL 讀取 `wp_options`」的第三方元件時，必須把它的設定鍵加進該清單。
+
+**autoload 最佳化不受此限** —— `optimize_autoload()` 只改 `autoload` 欄位、不刪列，而 Full WAF 那句 `SELECT *` 不看 autoload。
+
+### 4.2 不得把 option 名稱字串放進 GET/POST
+
+規則 **322**（`lev=3`，CRITICAL）：
+
+```
+(^|\S['"])nfw_(?:options|rules)\b
+```
+
+任何 GET/POST 值含 `nfw_options` 或 `nfw_rules` 字串即 **403**（why: "Attempt to modify NinjaFirewall settings"）。
+
+這對「列出 autoload 清單讓使用者勾選清理」這類 UI 是直接的地雷 —— 而 `nfw_rules` 正好是最大的 autoload 項目之一，必然出現在清單裡。若要做這種介面，用索引或 hash 當作 POST 值，或直接走 CLI。
+
+### 4.3 不得以 base64 傳送含 SQL 語意的 payload
+
+`nfw_check_b64()`（`firewall.php:1412-1448`，`post_b64` 選項，預設開）會把每個 POST 值 base64 解碼後再比對。明文的 SQL 規則多半需要「以數字/引號開頭」或「以註解結尾」才命中，**base64 版只要「含有」就 CRITICAL 403** —— 涵蓋 `SELECT...FROM...WHERE`、`INSERT INTO`、`UNION SELECT`、`UPDATE...SET`、以及序列化物件 `O:n:"..."`。
+
+換言之，**編碼會讓事情變糟，不是變好**。硬編碼白名單只有 `fpd_print_order` 與 `g-recaptcha-response` 兩個欄位名。
+
+---
+
+## 5. 風險矩陣（實測結果）
+
+於 dev30（**Full WAF**、`wl_admin=1`、`no_restapi=0`、`admin_ajax` 未設）實測。**同一組項目在 WP WAF 模式下結果完全相同** —— 兩種模式都跑過：
+
+| 項目 | 結果 |
+|---|---|
+| `wp tmdo status` / `wp tmdo doctor` | ✅ 不受影響（CLI 豁免） |
+| `GET /wp-json/wpdo/v1/listings`（**無 cookie**） | ✅ 200，且回的是 JSON 而非 WAF 的 HTML 403 頁 |
+| `?hp_price_min=100&hp_featured=1` 動態欄位 filter | ✅ 200 |
+| 首頁 / REST 根 | ✅ 200 |
+| 後台 `/wp-admin/` | ✅ 302（導向登入） |
+| firewall log 中的 TMDO 相關攔截 | ✅ **0 筆**（log 內全部攔截皆為刻意送出的測試 payload） |
+
+最後一項是判斷相容性的核心證據：不是「沒看到錯誤」，而是逐筆檢查 firewall log 的攔截記錄，確認沒有任何一筆來自本外掛的正常操作。
+
+仍需留意的情境：
+
+| 風險 | 觸發條件 | 緩解 |
+|---|---|---|
+| Full WAF 靜默失效 | WAF 設定選項被重導向 | §4.1（已由 `PROTECTED_OPTIONS` 擋下） |
+| 規則 322 誤擋 | option 名稱字串進 GET/POST | §4.2 |
+| migration 中斷 | `run_sync_loop()` 的 110 秒同步 POST（`class-tmdo-migration-orchestrator.php:443` `set_time_limit(120)`）被代理切斷；鎖 `LOCK_TTL_SEC=1800` 才釋放 | 大站用 `force_async=true` 或走 CLI |
+| REST 回 HTML 而非 JSON | 非 administrator 角色，或以 Application Password / JWT 呼叫（無 `NFWSESSID` cookie）→ 不在 `wl_admin` 白名單。403 頁面是 HTML（`firewall.php:1585-1590`），client 端看到的是「JSON parse error」這種難查的錯 | 程式化呼叫走 CLI；或確認帶 cookie |
+| admin-ajax 被當 bot | `admin_ajax` 選項開啟時，缺 `HTTP_ACCEPT` / `Accept-Language` / UA 不含 `Mozilla` 的請求回 **404**（`firewall.php:1760-1802`） | curl / server-to-server 呼叫需帶完整 header；預設此選項未開 |
+
+**WP-CLI 完全豁免**：`firewall.php:18-23` 對 `defined('WP_CLI') && WP_CLI && PHP_SAPI === 'cli'` 直接 `return`。TMDO 全部 63 個 CLI 子命令零風險 —— 這也是 migration、snapshot restore、backfill 等重操作建議走 CLI 的另一個理由。
+
+**管理員幾乎豁免**：`wl_admin=1` 時，帶 `NFWSESSID` cookie 的 administrator 只跑 3 條規則就 `nfw_quit(20)`（`firewall.php:233-252`）。
+
+---
+
+## 6. 為什麼不需要 AddOn
+
+| 理由 | 證據 |
+|---|---|
+| 無對外 hook API | 全 codebase 零個 `apply_filters('nfw_*')` / `do_action('nfw_*')` |
+| 官方相容手段都在部署層 | `.htninja`、`exclude_waf_list` UI、wp-config 常數 —— 沒有一項是 plugin 程式碼掛得上的 |
+| 常見衝突模式在 TMDO 全不存在 | 無 loopback self-POST、無 `db.php`/`object-cache.php` drop-in、無 wp-config 改動、無 `auto_prepend` 操作、無 `$_FILES` 上傳 |
+
+NinjaFirewall 處理「合法外掛送 SQL 被擋」的官方做法是**在引擎裡硬編碼白名單**（例：`firewall.php:1434-1439` 的 JetPack 例外），需向 NinTechNet 回報才會納入，第三方無法自行擴充。
+
+因此本外掛的相容性工作全部落在**核心的三條約束**（§4）與**部署設定**（§2），沒有 AddOn 的著力點。
diff --git a/docs/adr-003-hot-vs-entity.md b/docs/adr-003-hot-vs-entity.md
new file mode 100644
index 0000000..5486434
--- /dev/null
+++ b/docs/adr-003-hot-vs-entity.md
@@ -0,0 +1,78 @@
+# ADR-003：Hot zone 與 Entity 表收斂
+
+- **狀態**：已接受（2026-09-26，選項 A）
+- **日期**：2026-09-26
+- **相關**：`BENCHMARK-SCALE.md`（O-3、O-5）、backlog PR-025〜PR-030
+
+## 背景
+
+post 的高頻欄位有兩套扁平化機制，資料可能存兩份：
+
+| | Hot zone | Entity bridge |
+|---|---|---|
+| 表 | `wp_wpdo_hot_{post_type}`（每個 post type 一張） | `wp_wpdo_post_{group}`（每個群組一張） |
+| 註冊 | `TMDO_Schema_Registry`（zone = hot） | `TMDO_Entity_Registry::register_group()` |
+| 寫入 | `TMDO_Sync_Bridge`（zone 模組進入 dual_write 後） | `TMDO_Hook_Bus`（實體 mode ≥ dual_write） |
+| 查詢改寫 | `TMDO_Query_Router`（`hot_*` 模組 cutover 後） | `TMDO_Post_Query_Router`（post mode ≥ shadow_read） |
+| 生命週期 | 每個 zone 模組 7 狀態 FSM | 每個實體 4 模式（disabled → aeav_only） |
+| 涵蓋實體 | 只有 post | post、user、term、comment |
+| 可完全取代原生 meta | 否（cutover 後原生仍保留） | 是（aeav_only） |
+| 其他 | 單欄 `indexed`、自訂 `data_type` | post_type 範圍（PR-033）、schema hash、衝突偵測、孤兒還原、回寫原生（PR-017/018/031） |
+
+Warm（瀏覽數 TTL）、Cold（JSON blob）、Archive（已刪除文章的 meta）是 Entity 沒有的能力，**不在本決策範圍**，保持原狀。
+
+## 事實
+
+**效能**（100k vendor / 1M listing，`BENCHMARK-SCALE.md`）：
+
+| 情境 | Hot | Entity |
+|---|---:|---:|
+| 價格區間搜尋 p50 | 558 ms | 652 ms |
+| 價格區間 + verified p50 | **277 ms**（有複合索引） | 337 ms |
+| vendor 名下 listing p50 | 3,405 ms（無索引） | **0.28 ms** |
+| 單筆 / 列表預載 | 相同 | 相同 |
+| 容量 | 229 MB | 379 MB |
+
+唯一 Hot 領先的是有複合索引的情境；Entity 支援複合索引後（PR-027）即可追平。
+
+**各站使用現況**（2026-09-26 唯讀查詢）：
+
+| 站 | Hot / Cold 表 | zone 模組 | post entity |
+|---|---|---|---|
+| dev20 / dev21 / dev22 | 無 | 全 idle | aeav_only（dev21 約 400 萬列） |
+| dev23 / 24 / 30 / 31 / 40 | 無 | 全 idle | disabled |
+| dev34（舊 WPDO 1.3.37） | hot_hp_listing 486、hot_hp_vendor 233 | cutover | disabled |
+| dev10 DB（舊版） | hot_hp_listing 491、hot_hp_vendor 231 | cutover | aeav_only（約 3,900 列） |
+
+- **沒有任何 2meet-DO 站在用 Hot zone**；有扁平資料的站全部走 Entity。
+- 只有兩個舊系統的站有 Hot 資料，而它們在 cutover 仍雙寫 postmeta，Hot 表只是副本（PR-022 已確認以 postmeta 為準）。
+
+**只由 Hot zone 註冊、Entity 群組沒有涵蓋的 HP 欄位**：listing / request 的 `hp_drafted`；bookings 的 `hp_start_time`、`hp_end_time`、`hp_quantity`；memberships 的 `hp_expire_period`、`hp_primary`、`hp_expired_time`。
+
+## 選項
+
+**A. 收斂到 Entity（建議）**
+post 高頻欄位只用 Entity。Hot zone 凍結：不再新增註冊，程式碼暫留只為讀取舊資料，確認沒有站使用後再移除。
+
+- 優點：一套路由、一份資料；Entity 能力是 Hot 的超集；現況已經全部在用 Entity，不需要搬資料。
+- 代價：Hot 獨有的欄位（上面那幾個）要改成新的 Entity 群組；情境 2 要靠 PR-027 的複合索引追平。
+
+**B. 兩套並存**
+維持現狀。代價是兩套寫入和查詢路徑都要維護，同一個 key 可能存兩份，O-3 之類的最佳化要做兩次。
+
+**C. 收斂到 Hot**
+不可行：Hot 只支援 post，也沒有 aeav_only、範圍宣告、回寫工具。
+
+## 建議（選項 A）的後續步驟
+
+1. **PR-026（Hot 表 bigint 索引）標為 `[!]` 不做**：沒有站在用 Hot zone。
+2. **PR-027（Entity 複合索引）照常做**：這是情境 2 追平 Hot 的方式。
+3. **新增 PR（HP AddOn）**：把 Hot 獨有的欄位改註冊成新的 Entity 群組（例如 `hp_booking_core`、`hp_membership_core`，以及 listing / request 的補充群組）；既有群組的定義不能改。
+4. **新增 PR（HP AddOn）**：HP adapter 停止註冊 hot 欄位；核心對 zone = hot 的新註冊記錄 deprecated 警告。
+5. **之後**：dev34（PR-022）和 dev10 DB（PR-023）遷出後，再評估移除 `TMDO_Zone_Hot`、`TMDO_Sync_Bridge` 的 hot 路徑與 `TMDO_Query_Router`。
+
+## 決定
+
+**選項 A：收斂到 Entity。**（使用者 2026-09-26 決定）
+
+Hot zone 凍結，依上面的後續步驟執行；backlog 已同步調整（PR-026 標為 `[!]`，新增 HP AddOn 的兩個 PR）。
diff --git a/includes/advisor/class-tmdo-module-detector.php b/includes/advisor/class-tmdo-module-detector.php
index b8727c4..b3c00ba 100644
--- a/includes/advisor/class-tmdo-module-detector.php
+++ b/includes/advisor/class-tmdo-module-detector.php
@@ -284,7 +284,6 @@ class TMDO_Module_Detector {
$active = match ( $plugin ) {
'hivepress' => TMDO_Compatibility::is_hivepress_active(),
'woocommerce' => TMDO_Compatibility::is_woocommerce_active(),
- 'hpct' => TMDO_Compatibility::is_hpct_active(),
'latepoint' => TMDO_Compatibility::is_latepoint_active(),
default => false,
};
diff --git a/includes/advisor/class-tmdo-module-rules.php b/includes/advisor/class-tmdo-module-rules.php
index fd9011e..c998a21 100644
--- a/includes/advisor/class-tmdo-module-rules.php
+++ b/includes/advisor/class-tmdo-module-rules.php
@@ -29,52 +29,10 @@ if ( ! defined( 'ABSPATH' ) ) {
class TMDO_Module_Rules {
/**
- * Default rules for the 15 known modules. Use `get()` to apply filter.
+ * Default rules for the 8 known modules. Use `get()` to apply filter.
*/
private const DEFAULT_RULES = array(
- // ─── HPCT modules（HivePress + HPCT）────────────────────────────
- 'reviews' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_review',
- 'min_post_count' => 100,
- 'description' => '若使用 HivePress reviews 且累積評論 ≥ 100 條，啟用後可顯著降低 listing 查詢的 JOIN 成本。',
- ),
- 'messages' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_message_thread',
- 'min_post_count' => 50,
- 'description' => 'HivePress messages 累積對話數 ≥ 50 時，啟用 module 可加速 inbox / unread count 查詢。',
- ),
- 'favorites' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_favorite',
- 'min_post_count' => 200,
- 'description' => '使用者 favorite 累積 ≥ 200 條時，啟用 module 把 favorite meta 從 wp_postmeta 搬出。',
- ),
- 'memberships' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_membership',
- 'min_post_count' => 50,
- 'description' => 'HivePress memberships 啟用且 ≥ 50 條訂閱時，membership 過期檢查會更快。',
- ),
- 'statistics' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_listing',
- 'min_post_count' => 500,
- 'description' => 'Listing ≥ 500 條時，view_count / favorite_count 等高頻統計搬到 stats module 可大幅減少 wp_postmeta 寫入。',
- ),
- 'requests' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_request',
- 'min_post_count' => 50,
- 'description' => 'HivePress requests / quotes 累積 ≥ 50 條時建議啟用。',
- ),
- 'listing_meta' => array(
- 'compat_required' => array( 'hivepress' ),
- 'post_type_required' => 'hp_listing',
- 'min_post_count' => 100,
- 'description' => '所有 listing meta 集中管理；listing ≥ 100 時可省下大量 postmeta JOIN。',
- ),
+ // ─── AddOn modules ──────────────────────────────────────────────
'wc_orders' => array(
'compat_required' => array( 'woocommerce' ),
'post_type_required' => 'shop_order',
diff --git a/includes/class-tmdo-compatibility.php b/includes/class-tmdo-compatibility.php
index a9e0d1c..c8891eb 100644
--- a/includes/class-tmdo-compatibility.php
+++ b/includes/class-tmdo-compatibility.php
@@ -37,57 +37,23 @@ class TMDO_Compatibility {
}
self::$detected = array(
- 'hpct_active' => self::is_hpct_active(),
- 'hpct_imported' => self::is_hpct_imported(),
- 'hivepress' => self::is_hivepress_active(),
- 'woocommerce' => self::is_woocommerce_active(),
+ 'hivepress' => self::is_hivepress_active(),
+ 'woocommerce' => self::is_woocommerce_active(),
);
return self::$detected;
}
- /**
- * Can WPDO register its HPCT-inherited module interceptors?
- *
- * True when:
- * - hp-custom-tables is NOT active, OR
- * - hp-custom-tables IS active but already imported into WPDO.
- */
- public static function can_register_hpct_hooks(): bool {
- $compat = self::check();
-
- // HPCT not active → WPDO can freely register.
- if ( ! $compat['hpct_active'] ) {
- return true;
- }
-
- // HPCT is active but already imported → WPDO takes over.
- if ( $compat['hpct_imported'] ) {
- return true;
- }
-
- // HPCT is active and NOT imported → defer to HPCT.
- return false;
- }
-
/**
* Can WPDO register zone-specific interceptors (hot/warm/cold/archive)?
*
* Zone interceptors are always safe to register — they operate on
- * WPDO's own tables and do not conflict with HPCT.
+ * WPDO's own tables.
*/
public static function can_register_zone_hooks(): bool {
return true;
}
- /**
- * Should WPDO show an admin notice about HPCT import?
- */
- public static function should_show_hpct_notice(): bool {
- $compat = self::check();
- return $compat['hpct_active'] && ! $compat['hpct_imported'];
- }
-
/**
* Is HivePress core active?
*/
@@ -102,6 +68,26 @@ class TMDO_Compatibility {
return class_exists( 'WooCommerce' );
}
+ /**
+ * Integrations that are active while their AddOn is not.
+ *
+ * Core does not know these plugins; their fields are only optimised by the
+ * matching AddOn. The AddOn is detected by its bootstrap class, which its
+ * main file declares as soon as the plugin loads.
+ *
+ * @return array Plugin name → AddOn plugin slug.
+ */
+ public static function missing_integration_addons(): array {
+ $missing = array();
+ if ( self::is_hivepress_active() && ! class_exists( 'TMDO_HP_Bootstrap' ) ) {
+ $missing['HivePress'] = '2meet-data-optimizer-hivepress-addon';
+ }
+ if ( self::is_woocommerce_active() && ! class_exists( 'TMDO_Woocommerce_Bootstrap' ) ) {
+ $missing['WooCommerce'] = '2meet-data-optimizer-woocommerce-addon';
+ }
+ return $missing;
+ }
+
/**
* Is LatePoint plugin active? (v2.5.0 M16 polish — for module detector.)
*
@@ -113,23 +99,4 @@ class TMDO_Compatibility {
|| defined( 'LATEPOINT_VERSION' )
|| function_exists( 'latepoint_get_settings' );
}
-
- // ── Detection Methods ────────────────────────────────────────────────
-
- /**
- * Is HP Custom Tables plugin active (loaded)?
- *
- * Checks for the HPCT_Loader class, which is always loaded
- * when hp-custom-tables is active.
- */
- public static function is_hpct_active(): bool {
- return class_exists( 'HPCT_Loader' ) || defined( 'HPCT_VERSION' );
- }
-
- /**
- * Has HPCT been imported into WPDO?
- */
- private static function is_hpct_imported(): bool {
- return (bool) get_option( 'wpdo_hpct_imported', false );
- }
}
diff --git a/includes/class-tmdo-core.php b/includes/class-tmdo-core.php
index 781c745..e661487 100644
--- a/includes/class-tmdo-core.php
+++ b/includes/class-tmdo-core.php
@@ -31,31 +31,10 @@ class TMDO_Core {
// Fire the schema registry hook so integrations can register their fields.
$registry = TMDO_Schema_Registry::instance();
- // v2.0.x: Pre-register the 7 partner plugin integrations BEFORE firing the
- // `wpdo_register_fields` and `wpdo_register_custom_tables` hooks. Each
- // `register()` is a thin `add_action()` wrapper guarded by a partner-plugin
- // `class_exists()` probe (TMDO_Infocards / Bookings / Quotation / Events /
- // Mobile_Bridge / Collab / Playlist). Without this, partner add_actions
- // arrive too late and the do_action below misses them — observed via
- // 2meet-infocards 9 hp_vendor meta keys never landing in Schema Registry.
- // register() is side-effect-free aside from add_action(), so pre-registering
- // is provably safe (no hidden dependency on later-state global init).
- // v2.1.3 R1 (B step): TMDO_Events removed — 2meet-events now self-registers
- // via its own bridge class. Other partners still pre-registered here pending
- // their own decentralized migrations (R1 continuation in v2.2.x).
- $partner_integrations = array(
- 'TMDO_Infocards',
- 'TMDO_Bookings',
- 'TMDO_Quotation',
- 'TMDO_Mobile_Bridge',
- 'TMDO_Collab',
- 'TMDO_Playlist',
- 'TMDO_WooCommerce',
- 'TMDO_Member_Fields',
- 'TMDO_Post_Fields',
- 'TMDO_Hivepress_Term_Comment_Fields',
- );
- foreach ( $partner_integrations as $cls ) {
+ // Core-owned field providers register before `wpdo_register_fields` fires.
+ // AddOns wire their own integrations from their bootstraps
+ // (plugins_loaded:3 or :6), so core does not probe for them here.
+ foreach ( array( 'TMDO_Member_Fields', 'TMDO_Post_Fields' ) as $cls ) {
if ( class_exists( $cls ) ) {
call_user_func( array( $cls, 'register' ) );
}
@@ -74,7 +53,6 @@ class TMDO_Core {
// AFTER plugins_loaded:4 (e.g., partners loaded by HP modules at plugins_loaded:5+,
// or lazy-loaded modules booted on init:0). Schema_Registry::register() has
// internal dedup, so re-firing is idempotent — same partner calls won't double-register.
- // This deprecates the need for the TMDO_Core hardcoded partner pre-registration list above.
//
// v2.1.6: also re-fire `wpdo_register_entity_fields` so partner plugins booting on
// plugins_loaded:20 (e.g. 2meet-spoke-sso) can register entity-based user/term/comment
@@ -93,6 +71,12 @@ class TMDO_Core {
if ( class_exists( 'TMDO_Custom_Table_Registry' ) ) {
TMDO_Custom_Table_Registry::instance()->fire_registration();
}
+ // Every provider has registered by now: re-register groups whose flat
+ // table still holds data but whose plugin is gone, so aeav_only
+ // values keep reading back (routing only — never DDL).
+ if ( class_exists( 'TMDO_Schema_Manager' ) && class_exists( 'TMDO_Entity_Registry' ) ) {
+ TMDO_Schema_Manager::restore_orphaned_groups();
+ }
if ( class_exists( 'TMDO_Schema_Manager' ) && class_exists( 'TMDO_Entity_Registry' ) ) {
$pending = TMDO_Entity_Registry::get_pending_schemas();
if ( ! empty( $pending ) ) {
@@ -111,17 +95,6 @@ class TMDO_Core {
// Cache Layer hooks (Zone C prefetch + save_post warming).
TMDO_Cache_Layer::register_hooks();
- // Register HPCT-inherited module interceptors if allowed.
- if ( TMDO_Compatibility::can_register_hpct_hooks() ) {
- $this->register_hpct_interceptors();
- }
-
- // v2.1.2 fix: WC commission interceptor is independent of HPCT — writes
- // to its own wp_wpdo_wc_commissions table. Register whenever WC is active.
- if ( class_exists( 'TMDO_WooCommerce' ) && TMDO_WooCommerce::is_active() && class_exists( 'TMDO_WC_Orders_Interceptor' ) ) {
- ( new TMDO_WC_Orders_Interceptor() )->register_hooks();
- }
-
// Zone interceptors are always safe to register.
if ( TMDO_Compatibility::can_register_zone_hooks() ) {
$this->register_zone_hooks();
@@ -136,6 +109,9 @@ class TMDO_Core {
// v2.0.0: boot the unified Hook Bus when explicitly enabled.
TMDO_Hook_Bus_Bridge::maybe_init_hook_bus();
+ // Keep post_status / post_date copies on post entity tables current.
+ TMDO_Post_Status_Sync::register();
+
// Register audit log listeners for wpdo_after_write / wpdo_after_delete.
if ( class_exists( 'TMDO_Audit_Logger' ) ) {
TMDO_Audit_Logger::init();
@@ -149,18 +125,9 @@ class TMDO_Core {
TMDO_Conflict_Monitor::register_hooks();
}
- // v2.0.x: partner plugin integrations have been pre-registered earlier
- // (see top of run() before the wpdo_register_fields do_action). Removing
- // the duplicate late-binding block — see commit log for time-ordering bug.
-
// Schedule cron events.
$this->schedule_cron();
- // Admin notice for HPCT import.
- if ( is_admin() && TMDO_Compatibility::should_show_hpct_notice() ) {
- add_action( 'admin_notices', array( $this, 'render_hpct_notice' ) );
- }
-
// v2.6.6: async entity backfill cron handler.
add_action( 'wpdo_entity_backfill_batch', array( $this, 'run_entity_backfill_batch' ), 10, 2 );
@@ -182,14 +149,6 @@ class TMDO_Core {
add_action( TMDO_Comment_Stress_Tester::CRON_HOOK, array( __CLASS__, 'run_comment_stress_test_batch' ) );
}
- // v2.11.5: HivePress per-post transient cache → wp_options reroute.
- // Filters registered on `init` so HivePress's own bootstrap (plugins_loaded:5)
- // runs first and our filter chain catches the actual cache writes happening
- // during save_post and term-cache rebuilds.
- if ( class_exists( 'TMDO_Hivepress_Transient_Filter' ) ) {
- add_action( 'init', array( 'TMDO_Hivepress_Transient_Filter', 'init' ), 5 );
- }
-
// v2.12.1: Term + Comment garbage write-time filter
// (silent-drop _wxr_import_* / _2meet_demo_* / orphan post-meta keys).
if ( class_exists( 'TMDO_Term_Comment_Garbage_Filter' ) ) {
@@ -282,218 +241,6 @@ class TMDO_Core {
do_action( 'wpdo_register_entity_fields', TMDO_Entity_Registry::class );
}
- /**
- * Register default HivePress field mappings.
- *
- * These are the known HivePress meta_keys and their zone classifications.
- *
- * @param TMDO_Schema_Registry $registry The schema registry instance.
- * @return void
- */
- private function register_hivepress_defaults( TMDO_Schema_Registry $registry ): void {
- // Zone A (Hot) — Listing search/filter fields.
- $registry->register_many(
- 'hivepress',
- array(
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_price',
- 'zone' => 'hot',
- 'data_type' => 'decimal(10,2) NOT NULL DEFAULT 0',
- 'column' => 'hp_price',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_featured',
- 'zone' => 'hot',
- 'data_type' => 'tinyint(1) NOT NULL DEFAULT 0',
- 'column' => 'hp_featured',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_verified',
- 'zone' => 'hot',
- 'data_type' => 'tinyint(1) NOT NULL DEFAULT 0',
- 'column' => 'hp_verified',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_expired_time',
- 'zone' => 'hot',
- 'data_type' => 'bigint(20) NOT NULL DEFAULT 0',
- 'column' => 'hp_expired_time',
- ),
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_featured_time',
- 'zone' => 'hot',
- 'data_type' => 'bigint(20) NOT NULL DEFAULT 0',
- 'column' => 'hp_featured_time',
- ),
- // Vendor hot fields.
- array(
- 'post_type' => 'hp_vendor',
- 'meta_key' => 'hp_verified',
- 'zone' => 'hot',
- 'data_type' => 'tinyint(1) NOT NULL DEFAULT 0',
- 'column' => 'hp_verified',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_vendor',
- 'meta_key' => 'hp_hourly_rate',
- 'zone' => 'hot',
- 'data_type' => 'decimal(10,2) NOT NULL DEFAULT 0',
- 'column' => 'hp_hourly_rate',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_vendor',
- 'meta_key' => 'hp_rating_count',
- 'zone' => 'hot',
- 'data_type' => 'int(11) NOT NULL DEFAULT 0',
- 'column' => 'hp_rating_count',
- 'indexed' => false,
- ),
- )
- );
-
- // Zone C (Cold) — Profile/display fields.
- $registry->register_many(
- 'hivepress',
- array(
- array(
- 'post_type' => 'hp_vendor',
- 'meta_key' => 'hp_description',
- 'zone' => 'cold',
- 'cache_group' => 'wpdo_cold_hp_vendor',
- 'cache_ttl' => HOUR_IN_SECONDS,
- ),
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_description',
- 'zone' => 'cold',
- 'cache_group' => 'wpdo_cold_hp_listing',
- 'cache_ttl' => HOUR_IN_SECONDS,
- ),
- )
- );
-
- // ── HivePress extension fields (filled the 47% → 94% coverage gap) ──
- // Reviews extension (hp_review post type).
- $registry->register_many(
- 'hivepress-reviews',
- array(
- array(
- 'post_type' => 'hp_review',
- 'meta_key' => 'hp_rating',
- 'zone' => 'hot',
- 'data_type' => 'tinyint(1) NOT NULL DEFAULT 0',
- 'column' => 'hp_rating',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_vendor',
- 'meta_key' => 'hp_rating',
- 'zone' => 'hot',
- 'data_type' => 'decimal(3,2) NOT NULL DEFAULT 0',
- 'column' => 'hp_rating',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_review',
- 'meta_key' => 'hp_text',
- 'zone' => 'cold',
- 'cache_group' => 'wpdo_cold_hp_review',
- 'cache_ttl' => HOUR_IN_SECONDS,
- ),
- )
- );
-
- // Bookings extension (hp_booking post type).
- $registry->register_many(
- 'hivepress-bookings',
- array(
- array(
- 'post_type' => 'hp_booking',
- 'meta_key' => 'hp_start_time',
- 'zone' => 'hot',
- 'data_type' => 'bigint(20) NOT NULL DEFAULT 0',
- 'column' => 'hp_start_time',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_booking',
- 'meta_key' => 'hp_end_time',
- 'zone' => 'hot',
- 'data_type' => 'bigint(20) NOT NULL DEFAULT 0',
- 'column' => 'hp_end_time',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_booking',
- 'meta_key' => 'hp_status',
- 'zone' => 'hot',
- 'data_type' => "varchar(20) NOT NULL DEFAULT ''",
- 'column' => 'hp_status',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_listing',
- 'meta_key' => 'hp_booking_enabled',
- 'zone' => 'hot',
- 'data_type' => 'tinyint(1) NOT NULL DEFAULT 0',
- 'column' => 'hp_booking_enabled',
- 'indexed' => true,
- ),
- )
- );
-
- // Marketplace / Requests extension.
- $registry->register_many(
- 'hivepress-marketplace',
- array(
- array(
- 'post_type' => 'hp_request',
- 'meta_key' => 'hp_request_category',
- 'zone' => 'hot',
- 'data_type' => 'bigint(20) NOT NULL DEFAULT 0',
- 'column' => 'hp_request_category',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_offer',
- 'meta_key' => 'hp_amount',
- 'zone' => 'hot',
- 'data_type' => 'decimal(10,2) NOT NULL DEFAULT 0',
- 'column' => 'hp_amount',
- 'indexed' => true,
- ),
- array(
- 'post_type' => 'hp_offer',
- 'meta_key' => 'hp_request',
- 'zone' => 'hot',
- 'data_type' => 'bigint(20) NOT NULL DEFAULT 0',
- 'column' => 'hp_request',
- 'indexed' => true,
- ),
- )
- );
- }
-
- /**
- * Register HPCT-inherited module interceptors and query interceptors.
- */
- private function register_hpct_interceptors(): void {
- // 7 HPCT-era meta interceptors 已搬到 2meet-data-optimizer-hivepress-addon。
- // 1 LatePoint interceptor 已搬到 2meet-data-optimizer-latepoint-addon。
- // 5 query interceptors 已搬到 2meet-data-optimizer-hivepress-addon。
- // 此方法保留為空殼以保持 ABI 相容；AddOn 各自於自身 bootstrap 內 register_hooks。
- }
-
/**
* Register zone-specific hooks.
*/
@@ -791,27 +538,6 @@ class TMDO_Core {
TMDO_Zone_Archive::sweep();
}
- /**
- * Render admin notice when hp-custom-tables is detected but not imported.
- */
- public function render_hpct_notice(): void {
- $import_url = admin_url( 'tools.php?page=wp-data-optimizer&tab=hpct-import' );
- ?>
-
-
- WP Data Optimizer:
- ' . esc_html__( 'HPCT 匯入頁面', '2meet-data-optimizer' ) . ''
- );
- ?>
-
- ' . esc_html( '2meet Data Optimizer 已停止解除安裝：以下資料只存在 wpdo_* 表，刪除外掛會一併刪除這些表。' ) . ' '
+ . '- ' . implode( '
- ', array_map( 'esc_html', $wpdo_blocked ) ) . '
'
+ . '' . esc_html( '目前沒有把這些資料寫回 WordPress 原生表的自動工具。若只想移除外掛程式，可手動刪除外掛目錄，資料表會保留。' ) . ' '
+ );
+}
+
// ── v2.2.0 M1.5: pre-uninstall snapshot (main-site context only) ─────────
// Snapshot is taken once on the main site — it captures the catalog of all
// wpdo_snapshots rows (which is per-site so per-site snapshots survive the
// site-level table DROP that happens later). Best-effort.
-if ( $bootstrap_ok && class_exists( 'TMDO_Snapshot_Manager' ) ) {
+if ( class_exists( 'TMDO_Snapshot_Manager' ) ) {
$result = TMDO_Snapshot_Manager::create(
'pre_uninstall',
array(),
@@ -75,172 +129,9 @@ if ( $bootstrap_ok && class_exists( 'TMDO_Snapshot_Manager' ) ) {
}
}
-// ── v2.14.0: shared cleanup helper ───────────────────────────────────────
-// Falls back to inline DROP loop if the helper class isn't loadable
-// (e.g. partially-broken install where includes/class-tmdo-installer.php
-// is missing). The inline path is the original v2.13.x logic verbatim.
-$has_helper = class_exists( 'TMDO_Installer' )
- && method_exists( 'TMDO_Installer', 'drop_all_tables_for_current_blog' );
-
-/**
- * Run the cleanup for the current blog (helper-aware).
- */
-$run_cleanup = static function () use ( $has_helper ): void {
- global $wpdb;
-
- if ( $has_helper ) {
+// ── Drop wpdo_* tables and options on every site ─────────────────────────
+$wpdo_for_each_site(
+ static function (): void {
TMDO_Installer::drop_all_tables_for_current_blog();
- return;
}
-
- // ── Fallback inline path (helper unavailable) ─────────────────────────
- $tables = array(
- $wpdb->prefix . 'wpdo_migrations',
- $wpdb->prefix . 'wpdo_errors',
- $wpdb->prefix . 'wpdo_benchmarks',
- $wpdb->prefix . 'wpdo_warm',
- $wpdb->prefix . 'wpdo_archive',
- $wpdb->prefix . 'wpdo_audit',
- $wpdb->prefix . 'wpdo_shadow_diffs',
- $wpdb->prefix . 'wpdo_site_metrics',
- $wpdb->prefix . 'wpdo_registry_meta',
- $wpdb->prefix . 'wpdo_uni_options',
- $wpdb->prefix . 'wpdo_wc_commissions',
- $wpdb->prefix . 'wpdo_snapshots',
- $wpdb->prefix . 'wpdo_migration_status',
- $wpdb->prefix . 'wpdo_user_points_ledger',
- $wpdb->prefix . 'wpdo_user_membership',
- $wpdb->prefix . 'wpdo_user_activity',
- $wpdb->prefix . 'wpdo_user_profile',
- $wpdb->prefix . 'wpdo_user_sso',
- $wpdb->prefix . 'wpdo_user_core_profile',
- $wpdb->prefix . 'wpdo_user_social',
- $wpdb->prefix . 'wpdo_user_commerce',
- $wpdb->prefix . 'wpdo_user_hp_user',
- $wpdb->prefix . 'wpdo_user_admin_prefs',
- $wpdb->prefix . 'wpdo_post_wp_core',
- $wpdb->prefix . 'wpdo_post_attachment',
- $wpdb->prefix . 'wpdo_post_wc_product',
- $wpdb->prefix . 'wpdo_post_hp_listing_core',
- $wpdb->prefix . 'wpdo_post_hp_request_core',
- $wpdb->prefix . 'wpdo_post_hp_vendor_core',
- $wpdb->prefix . 'wpdo_post_nav_menu_item',
- $wpdb->prefix . 'wpdo_hot_hp_listing',
- $wpdb->prefix . 'wpdo_term_hp_taxonomy',
- $wpdb->prefix . 'wpdo_comment_hp_review',
- $wpdb->prefix . 'wpdo_term_misc',
- $wpdb->prefix . 'wpdo_comment_misc',
- // v3.0.0: HivePress family integration tables.
- $wpdb->prefix . 'wpdo_hot_hp_request',
- $wpdb->prefix . 'wpdo_hot_hp_membership',
- $wpdb->prefix . 'wpdo_hot_hp_membership_plan',
- $wpdb->prefix . 'wpdo_hot_hp_booking',
- $wpdb->prefix . 'wpdo_comment_hp_message',
- $wpdb->prefix . 'wpdo_comment_hp_favorite',
- $wpdb->prefix . 'wpdo_comment_hp_offer',
- $wpdb->prefix . 'wpdo_term_hp_listing_tag',
- );
-
- $hot_like = $wpdb->esc_like( $wpdb->prefix . 'wpdo_hot_' ) . '%';
- $cold_like = $wpdb->esc_like( $wpdb->prefix . 'wpdo_cold_' ) . '%';
- $entity_like = $wpdb->esc_like( $wpdb->prefix . 'wpdo_user_' ) . '%';
- $post_ent_like = $wpdb->esc_like( $wpdb->prefix . 'wpdo_post_' ) . '%';
- $term_ent_like = $wpdb->esc_like( $wpdb->prefix . 'wpdo_term_' ) . '%';
- $comment_ent_like = $wpdb->esc_like( $wpdb->prefix . 'wpdo_comment_' ) . '%';
-
- if ( class_exists( 'WP_SQLite_Driver' ) ) {
- $dynamic = $wpdb->get_col(
- $wpdb->prepare(
- "SELECT name FROM sqlite_master WHERE type='table' AND (name LIKE %s OR name LIKE %s OR name LIKE %s OR name LIKE %s OR name LIKE %s OR name LIKE %s)",
- $hot_like,
- $cold_like,
- $entity_like,
- $post_ent_like,
- $term_ent_like,
- $comment_ent_like
- )
- );
- } else {
- $dynamic = $wpdb->get_col(
- $wpdb->prepare(
- 'SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE() AND (TABLE_NAME LIKE %s OR TABLE_NAME LIKE %s OR TABLE_NAME LIKE %s OR TABLE_NAME LIKE %s OR TABLE_NAME LIKE %s OR TABLE_NAME LIKE %s)',
- $hot_like,
- $cold_like,
- $entity_like,
- $post_ent_like,
- $term_ent_like,
- $comment_ent_like
- )
- );
- }
-
- $tables = array_unique( array_merge( $tables, $dynamic ?: array() ) );
- $prefix = $wpdb->prefix . 'wpdo_';
- foreach ( $tables as $table ) {
- if ( ! preg_match( '/^[a-zA-Z0-9_]+$/', $table ) || strpos( $table, $prefix ) !== 0 ) {
- continue;
- }
- // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
- $wpdb->query( "DROP TABLE IF EXISTS `{$table}`" );
- }
-
- delete_option( 'wpdo_db_version' );
- delete_option( 'wpdo_features' );
- delete_option( 'wpdo_features_shadow' );
- delete_option( 'wpdo_hpct_imported' );
- delete_option( 'wpdo_hook_bus_enabled' );
- delete_option( 'wpdo_v2_features_backup' );
- delete_option( 'wpdo_v2_upgrade_status' );
- delete_option( 'wpdo_v2_upgrade_error' );
- delete_option( 'wpdo_v2_upgraded_at' );
- delete_option( 'wpdo_health_alert' );
- delete_option( 'wpdo_rl_stats' );
- delete_option( 'wpdo_setup_wizard_completed' );
- delete_option( 'wpdo_first_run_at' );
-
- wp_clear_scheduled_hook( 'wpdo_warm_cleanup' );
- wp_clear_scheduled_hook( 'wpdo_archive_sweep' );
- wp_clear_scheduled_hook( 'wpdo_errors_gc' );
- wp_clear_scheduled_hook( 'wpdo_health_snapshot_monthly' );
- wp_clear_scheduled_hook( 'wpdo_daily_health_check' );
- wp_clear_scheduled_hook( 'wpdo_snapshot_prune_daily' );
-};
-
-// ── Run cleanup ──────────────────────────────────────────────────────────
-// v2.14.0: when network-uninstalling on multisite, iterate every site so each
-// wp_N_wpdo_* table set is dropped. Pre-v2.14.0 only the main site got cleaned.
-if ( is_multisite() ) {
- $is_network_active = function_exists( 'is_plugin_active_for_network' )
- && is_plugin_active_for_network( plugin_basename( __FILE__ ) );
-
- if ( $is_network_active ) {
- // Iterate all sites in batches.
- $offset = 0;
- $batch = 100;
- do {
- $site_ids = get_sites(
- array(
- 'number' => $batch,
- 'offset' => $offset,
- 'fields' => 'ids',
- )
- );
- foreach ( $site_ids as $wpdo_blog_id ) {
- switch_to_blog( (int) $wpdo_blog_id );
- try {
- $run_cleanup();
- } finally {
- restore_current_blog();
- }
- }
- $offset += $batch;
- $batch_size = count( $site_ids );
- } while ( $batch_size === $batch );
- } else {
- // Per-site activation: clean only the current site.
- $run_cleanup();
- }
-} else {
- // Single-site install: run once.
- $run_cleanup();
-}
+);
|