2meet-data-optimizer-playlist-addon/includes/class-tmdo-playlist.php

<?php
/**
 * TMDO_Playlist — integration with 2meet-playlist (Wave 3 / v2.2.0).
 *
 * 5 張表的歌單系統。註冊全部 + 含 fulltext index 的 2mpl_songs 適合
 * benchmark / doctor 觀察。
 *
 * @package WP_Data_Optimizer
 * @since   2.0.0
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

// phpcs:disable Squiz.Commenting.FunctionComment.Missing,Squiz.Commenting.InlineComment.InvalidEndChar,Generic.Commenting.DocComment.MissingShort,WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.PHP.YodaConditions,Generic.CodeAnalysis.EmptyStatement -- v2.0.0 partner integrations: pure registration helpers + intentional silent catches.

/**
 * 2meet-playlist 整合。
 */
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 = defined( 'TMPL_VERSION' )
			|| defined( 'TMPL_PLUGIN_DIR' )
			|| class_exists( 'TMPL_Plugin' )
			|| file_exists( WP_PLUGIN_DIR . '/2meet-playlist/2meet-playlist.php' );
		if ( ! $detected ) {
			return;
		}
		add_action( 'wpdo_register_custom_tables', array( __CLASS__, 'register_custom_tables' ) );
	}

	public static function register_custom_tables( TMDO_Custom_Table_Registry $registry ): void {
		$tables = array(
			'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['primary_key'],
					'post_type_link'   => $meta['post_type_link'],
					'expected_columns' => $meta['expected_columns'],
					'indexes' => $meta['indexes'],
				)
			);
		}
	}
}