wpdev
471348f947
Tests / PHP Lint (pull_request) Successful in 5s
TMDO_Quotation::register() 舊版偵測 TMQUO_Main / TMQUO_Plugin 兩個類別， 在 partner 外掛中並不存在（或載入太晚），偵測實際完全靠 file_exists() 後備 撐著——程式碼讀起來像在驗證「partner 已載入」，實際只驗證了「目錄存在」。 改用 TMQUO_VERSION / TMQUO_PLUGIN_DIR，兩者在 partner 主檔的檔案解析當下即 define，早於 plugins_loaded，故本 AddOn bootstrap 的 :6 時點確實可用。 file_exists() 後備保留不動，行為不變；但偵測不再是死碼，即使將來移除後備也 不會重演 infocards-addon 那種「整個 AddOn 靜默失效」的事故。 同一版本另含先前未提交的 schema 工作：補齊 expected_columns / indexes， 並將 registry 索引 config key 由 expected_indexes 更正為 indexes （wp_parse_args() 會靜默丟棄未知 key，索引期望值先前等同從未送達）。 實測驗證（mu-plugin 於 plugins_loaded:6 量測真實請求）： 新常數 AVAILABLE；wp wpdo doctor 89 OK / 0 FAIL；表註冊欄位與索引 100% 完整。
244 lines
8.1 KiB
PHP
244 lines
8.1 KiB
PHP
<?php
|
||
/**
|
||
* TMDO_Quotation — integration with 2meet-quotation (Wave 2 / v2.1.0).
|
||
*
|
||
* 2meet-quotation 採全 flat-custom-table 架構（8 張 wp_2mq_* 表），無 postmeta
|
||
* 依賴。本整合僅將其表登記到 Custom_Table_Registry，讓 wp wpdo doctor 與
|
||
* benchmark 涵蓋。
|
||
*
|
||
* @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-quotation 整合。
|
||
*/
|
||
final class TMDO_Quotation {
|
||
|
||
/**
|
||
* 偵測以常數優先：`TMQUO_VERSION` / `TMQUO_PLUGIN_DIR` 在 2meet-quotation 主檔的
|
||
* **檔案解析當下**（第 22/25 行）即 define，早於 `plugins_loaded`；本 AddOn
|
||
* bootstrap 掛在 `plugins_loaded:6`，故此時常數已可用。
|
||
*
|
||
* 舊版偵測的 `TMQUO_Main` / `TMQUO_Plugin` 兩個類別在 2meet-quotation 中**並不存在**，
|
||
* 偵測實際完全靠 `file_exists()` 撐著。保留 file_exists 作最終後備，但常數檢查
|
||
* 現在真的有效——即使將來移除後備也不會像 infocards 那樣整個 AddOn 靜默失效。
|
||
*/
|
||
public static function register(): void {
|
||
$detected = defined( 'TMQUO_VERSION' )
|
||
|| defined( 'TMQUO_PLUGIN_DIR' )
|
||
|| file_exists( WP_PLUGIN_DIR . '/2meet-quotation/2meet-quotation.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(
|
||
// vendor_id 關聯 hp_vendor.
|
||
'2mq_quotations' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => 'hp_vendor',
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'vendor_id' => 'BIGINT',
|
||
'template_id' => 'BIGINT',
|
||
'quote_number' => 'VARCHAR',
|
||
'status' => 'VARCHAR',
|
||
'client_name' => 'VARCHAR',
|
||
'client_email' => 'VARCHAR',
|
||
'client_phone' => 'VARCHAR',
|
||
'event_type' => 'VARCHAR',
|
||
'event_date' => 'DATE',
|
||
'event_time' => 'VARCHAR',
|
||
'event_duration_hours' => 'DECIMAL',
|
||
'event_location' => 'VARCHAR',
|
||
'venue_name' => 'VARCHAR',
|
||
'guest_count' => 'INT',
|
||
'performer_count' => 'INT',
|
||
'subtotal' => 'DECIMAL',
|
||
'discount_amount' => 'DECIMAL',
|
||
'discount_reason' => 'VARCHAR',
|
||
'tax_amount' => 'DECIMAL',
|
||
'total' => 'DECIMAL',
|
||
'currency' => 'VARCHAR',
|
||
'deposit_percent' => 'INT',
|
||
'deposit_amount' => 'DECIMAL',
|
||
'balance_amount' => 'DECIMAL',
|
||
'deposit_status' => 'VARCHAR',
|
||
'deposit_order_id' => 'BIGINT',
|
||
'client_signature' => 'TEXT',
|
||
'contract_html' => 'TEXT',
|
||
'deposit_due_days' => 'INT',
|
||
'balance_due_days' => 'INT',
|
||
'cancel_policy' => 'VARCHAR',
|
||
'included_services' => 'TEXT',
|
||
'notes' => 'TEXT',
|
||
'internal_notes' => 'TEXT',
|
||
'valid_days' => 'INT',
|
||
'valid_until' => 'DATE',
|
||
'sent_at' => 'DATETIME',
|
||
'viewed_at' => 'DATETIME',
|
||
'accepted_at' => 'DATETIME',
|
||
'declined_at' => 'DATETIME',
|
||
'access_token' => 'VARCHAR',
|
||
'created_at' => 'DATETIME',
|
||
'updated_at' => 'DATETIME',
|
||
),
|
||
'indexes' => array(
|
||
'quote_number' => array( 'quote_number' ),
|
||
'vendor_id' => array( 'vendor_id' ),
|
||
'status' => array( 'status' ),
|
||
'access_token' => array( 'access_token' ),
|
||
),
|
||
),
|
||
'2mq_quotation_items' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => null,
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'quotation_id' => 'BIGINT',
|
||
'catalog_item_id' => 'BIGINT',
|
||
'module_code' => 'VARCHAR',
|
||
'label' => 'VARCHAR',
|
||
'description' => 'TEXT',
|
||
'quantity' => 'DECIMAL',
|
||
'unit' => 'VARCHAR',
|
||
'unit_price' => 'DECIMAL',
|
||
'subtotal' => 'DECIMAL',
|
||
'is_optional' => 'TINYINT',
|
||
'config' => 'TEXT',
|
||
'sort_order' => 'INT',
|
||
),
|
||
'indexes' => array(
|
||
'quotation_id' => array( 'quotation_id' ),
|
||
),
|
||
),
|
||
'2mq_quotation_history' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => null,
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'quotation_id' => 'BIGINT',
|
||
'action' => 'VARCHAR',
|
||
'actor' => 'VARCHAR',
|
||
'snapshot' => 'TEXT',
|
||
'note' => 'TEXT',
|
||
'created_at' => 'DATETIME',
|
||
),
|
||
'indexes' => array(
|
||
'quotation_id' => array( 'quotation_id' ),
|
||
),
|
||
),
|
||
'2mq_vendor_presets' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => 'hp_vendor',
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'vendor_id' => 'BIGINT',
|
||
'module_code' => 'VARCHAR',
|
||
'label' => 'VARCHAR',
|
||
'config' => 'TEXT',
|
||
'is_active' => 'TINYINT',
|
||
'sort_order' => 'INT',
|
||
'created_at' => 'DATETIME',
|
||
'updated_at' => 'DATETIME',
|
||
),
|
||
'indexes' => array(
|
||
'vendor_module' => array( 'vendor_id', 'module_code' ),
|
||
),
|
||
),
|
||
'2mq_catalog_categories' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => null,
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'code' => 'VARCHAR',
|
||
'name' => 'VARCHAR',
|
||
'icon' => 'VARCHAR',
|
||
'sort_order' => 'INT',
|
||
'is_active' => 'TINYINT',
|
||
),
|
||
'indexes' => array(
|
||
'code' => array( 'code' ),
|
||
),
|
||
),
|
||
'2mq_catalog_items' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => null,
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'category_code' => 'VARCHAR',
|
||
'module_code' => 'VARCHAR',
|
||
'name' => 'VARCHAR',
|
||
'description' => 'TEXT',
|
||
'unit' => 'VARCHAR',
|
||
'default_price' => 'DECIMAL',
|
||
'default_quantity' => 'DECIMAL',
|
||
'pricing_type' => 'VARCHAR',
|
||
'config' => 'TEXT',
|
||
'is_optional' => 'TINYINT',
|
||
'sort_order' => 'INT',
|
||
'is_active' => 'TINYINT',
|
||
'created_at' => 'DATETIME',
|
||
'updated_at' => 'DATETIME',
|
||
),
|
||
'indexes' => array(
|
||
'category_code' => array( 'category_code' ),
|
||
'module_code' => array( 'module_code' ),
|
||
),
|
||
),
|
||
'2mq_quotation_templates' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => null,
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'name' => 'VARCHAR',
|
||
'description' => 'TEXT',
|
||
'event_type' => 'VARCHAR',
|
||
'items' => 'TEXT',
|
||
'config' => 'TEXT',
|
||
'sort_order' => 'INT',
|
||
'is_active' => 'TINYINT',
|
||
'created_at' => 'DATETIME',
|
||
'updated_at' => 'DATETIME',
|
||
),
|
||
'indexes' => array(
|
||
'event_type' => array( 'event_type' ),
|
||
),
|
||
),
|
||
'2mq_vendor_catalog_prices' => array(
|
||
'primary_key' => 'id',
|
||
'post_type_link' => 'hp_vendor',
|
||
'expected_columns' => array(
|
||
'id' => 'BIGINT',
|
||
'vendor_id' => 'BIGINT',
|
||
'catalog_item_id' => 'BIGINT',
|
||
'custom_price' => 'DECIMAL',
|
||
'custom_label' => 'VARCHAR',
|
||
'is_active' => 'TINYINT',
|
||
'created_at' => 'DATETIME',
|
||
'updated_at' => 'DATETIME',
|
||
),
|
||
'indexes' => array(
|
||
'vendor_item' => array( 'vendor_id', 'catalog_item_id' ),
|
||
'vendor_id' => array( 'vendor_id' ),
|
||
),
|
||
),
|
||
);
|
||
foreach ( $tables as $table_name => $meta ) {
|
||
$registry->register(
|
||
'2meet-quotation',
|
||
array_merge( array( 'table_name' => $table_name ), $meta )
|
||
);
|
||
}
|
||
}
|
||
}
|