fix: partner 偵測符號對齊實際存在的常數 + schema 期望值補齊 #1

Open
wpdev wants to merge 1 commits from fix/partner-detection-symbols into main
3 changed files with 144 additions and 11 deletions
Showing only changes of commit 4801682192 - Show all commits
+2 -2
View File
@@ -3,7 +3,7 @@
* Plugin Name: 2meet Data Optimizer — Playlist AddOn
* Plugin URI: https://2meet.io/2meet-data-optimizer/playlist
* Description: 2meet-playlist 5 張自訂表 (2mpl_singer_settings/songs/queue/rate_limits/sessions) 註冊
* Version: 0.1.0
* Version: 0.1.1
* Requires at least: 6.0
* Tested up to: 6.9.4
* Requires PHP: 8.1
@@ -24,7 +24,7 @@ if ( ! defined( 'ABSPATH' ) ) {
exit;
}
define( 'TMDO_PLAYLIST_VERSION', '0.1.0' );
define( 'TMDO_PLAYLIST_VERSION', '0.1.1' );
define( 'TMDO_PLAYLIST_PATH', plugin_dir_path( __FILE__ ) );
define( 'TMDO_PLAYLIST_URL', plugin_dir_url( __FILE__ ) );
define( 'TMDO_PLAYLIST_FILE', __FILE__ );
+27
View File
@@ -13,6 +13,33 @@ Versioning follows [Semantic Versioning](https://semver.org/).
---
## [0.1.1] — 2026-08-08 — 5 張 `2mpl_*` 表補齊 schema 期望值
### Added
- 為全部 5 張 `2mpl_*` 表補上 `expected_columns``indexes`
`2mpl_singer_settings``2mpl_songs``2mpl_queue``2mpl_rate_limits`
`2mpl_sessions`。欄位與索引逐項轉錄自 2meet-playlist activator 的
`CREATE TABLE`。先前只註冊表名,`wp wpdo doctor` 只知道表存在,無從判斷欄位或
索引是否漂移——`2mpl_queue` / `2mpl_rate_limits` 這類高頻讀寫表尤其吃索引,
漏建索引卻沒有警訊是實際風險。
### Fixed
- `TMDO_Custom_Table_Registry::register()` 的索引期望值 config key 由
`expected_indexes` 更正為 `indexes`。該 API 以 `wp_parse_args()` 併入預設值,
未知 key 會被**靜默丟棄**——先前索引期望值等同從未送達 registry,
`wp wpdo doctor` 的 schema drift 只驗欄位、不驗索引。此問題橫跨全部 8 個 AddOn,
已一併更正。
- `TMDO_Playlist::register()` 的 partner 偵測符號對齊實際存在的常數。舊版偵測的
`TMPL_Main` 類別在 2meet-playlist 中**根本不存在**。補上 `TMPL_VERSION` /
`TMPL_PLUGIN_DIR`(兩者在主檔檔案解析當下即 define,早於 `plugins_loaded`),
並保留確實存在的 `TMPL_Plugin`
實測(mu-plugin 於 `plugins_loaded:6` 量測):`TMPL_VERSION` = AVAILABLE。
`file_exists()` 後備保留不動,行為不變;但偵測不再含死符號。
---
## [0.1.0] — TBD
### Added (initial release, scaffold)
+115 -9
View File
@@ -20,8 +20,19 @@ if ( ! defined( 'ABSPATH' ) ) {
*/
final class TMDO_Playlist {
/**
* 偵測以常數優先:`TMPL_VERSION` / `TMPL_PLUGIN_DIR` 在 2meet-playlist 主檔的
* **檔案解析當下**(第 34/36 行)即 define,早於 `plugins_loaded`;本 AddOn
* bootstrap 掛在 `plugins_loaded:6`,故此時常數已可用。
*
* 舊版偵測的 `TMPL_Main` 類別在 2meet-playlist 中**並不存在**`TMPL_Plugin` 雖存在,
* 但要到 `plugins_loaded:30``tmpl_run_plugin`)才 require,在 :6 當下必定 MISSING。
* 偵測實際完全靠 `file_exists()` 撐著。保留 file_exists 作最終後備,但常數檢查
* 現在真的有效——即使將來移除後備也不會像 infocards 那樣整個 AddOn 靜默失效。
*/
public static function register(): void {
$detected = class_exists( 'TMPL_Main' )
$detected = defined( 'TMPL_VERSION' )
|| defined( 'TMPL_PLUGIN_DIR' )
|| class_exists( 'TMPL_Plugin' )
|| file_exists( WP_PLUGIN_DIR . '/2meet-playlist/2meet-playlist.php' );
if ( ! $detected ) {
@@ -32,19 +43,114 @@ final class TMDO_Playlist {
public static function register_custom_tables( TMDO_Custom_Table_Registry $registry ): void {
$tables = array(
'2mpl_singer_settings' => array( 'id', 'hp_vendor' ),
'2mpl_songs' => array( 'id', null ),
'2mpl_queue' => array( 'id', null ),
'2mpl_rate_limits' => array( 'id', null ),
'2mpl_sessions' => array( 'id', null ),
'2mpl_singer_settings' => array(
'primary_key' => 'id',
'post_type_link' => 'hp_vendor',
'expected_columns' => array(
'id' => 'BIGINT',
'vendor_id' => 'BIGINT',
'is_accepting_requests' => 'TINYINT',
'show_queue_public' => 'TINYINT',
'request_limit_per_ip' => 'SMALLINT',
'request_limit_minutes' => 'SMALLINT',
'banner_text' => 'VARCHAR',
'enable_sound_notification' => 'TINYINT',
'push_subscription' => 'TEXT',
'created_at' => 'DATETIME',
'updated_at' => 'DATETIME',
),
'indexes' => array(
'vendor_id' => array( 'vendor_id' ),
),
),
'2mpl_songs' => array(
'primary_key' => 'id',
'post_type_link' => null,
'expected_columns' => array(
'id' => 'BIGINT',
'vendor_id' => 'BIGINT',
'title' => 'VARCHAR',
'artist' => 'VARCHAR',
'notes' => 'TEXT',
'is_visible' => 'TINYINT',
'is_deleted' => 'TINYINT',
'request_count' => 'INT',
'created_at' => 'DATETIME',
'updated_at' => 'DATETIME',
),
'indexes' => array(
'vendor_visible' => array( 'vendor_id', 'is_visible', 'is_deleted' ),
'vendor_requests' => array( 'vendor_id', 'request_count' ),
'ft_search' => array( 'title', 'artist' ),
),
),
'2mpl_queue' => array(
'primary_key' => 'id',
'post_type_link' => null,
'expected_columns' => array(
'id' => 'BIGINT',
'session_id' => 'BIGINT',
'vendor_id' => 'BIGINT',
'song_id' => 'BIGINT',
'display_title' => 'VARCHAR',
'display_artist' => 'VARCHAR',
'requester_name' => 'VARCHAR',
'requester_ip_hash' => 'CHAR',
'status' => 'VARCHAR',
'sort_order' => 'INT',
'vote_count' => 'INT',
'requested_at' => 'DATETIME',
'completed_at' => 'DATETIME',
),
'indexes' => array(
'vendor_status_order' => array( 'vendor_id', 'status', 'sort_order' ),
'vendor_status_time' => array( 'vendor_id', 'status', 'requested_at' ),
'song_id' => array( 'song_id' ),
'session_id' => array( 'session_id' ),
),
),
'2mpl_rate_limits' => array(
'primary_key' => 'id',
'post_type_link' => null,
'expected_columns' => array(
'id' => 'BIGINT',
'vendor_id' => 'BIGINT',
'ip_hash' => 'CHAR',
'request_count' => 'SMALLINT',
'window_start' => 'DATETIME',
),
'indexes' => array(
'vendor_ip_window' => array( 'vendor_id', 'ip_hash', 'window_start' ),
),
),
'2mpl_sessions' => array(
'primary_key' => 'id',
'post_type_link' => null,
'expected_columns' => array(
'id' => 'BIGINT',
'vendor_id' => 'BIGINT',
'event_id' => 'BIGINT',
'title' => 'VARCHAR',
'status' => 'VARCHAR',
'started_at' => 'DATETIME',
'ended_at' => 'DATETIME',
),
'indexes' => array(
'vendor_status' => array( 'vendor_id', 'status' ),
'vendor_started' => array( 'vendor_id', 'started_at' ),
'event_id' => array( 'event_id' ),
),
),
);
foreach ( $tables as $table_name => $meta ) {
$registry->register(
'2meet-playlist',
array(
'table_name' => $table_name,
'primary_key' => $meta[0],
'post_type_link' => $meta[1],
'table_name' => $table_name,
'primary_key' => $meta['primary_key'],
'post_type_link' => $meta['post_type_link'],
'expected_columns' => $meta['expected_columns'],
'indexes' => $meta['indexes'],
)
);
}