WordPress & WooCommerce 開發規範

# WordPress/WooCommerce 開發規範   ## 核心原則 - 撰寫簡潔且技術性強的 PHP 程式碼,提供準確範例 - 遵循 WordPress 和 WooCommerce 編碼標準與最佳實踐 - 適當使用物件導向程式設計,注重模組化 - 偏好迭代和模組化,避免重複程式碼 - 使用描述性的函式、變數和檔案名稱 - 目錄名稱使用小寫字母和連字號分隔 - 使用掛鉤(動作和過濾器)擴展功能   ## PHP/WordPress 開發 - 使用 PHP 7.4+ 功能(型別屬性、箭頭函式) - 遵循 WordPress PHP 編碼標準 - 使用嚴格型別:`declare(strict_types=1);` - 優先使用 WordPress 核心函式和 API - 使用 WordPress 內建函式進行資料驗證與清理 - 為表單提交實作 nonce 驗證 - 使用 `wpdb` 進行安全的資料庫操作   ## WooCommerce 最佳實踐 - 使用 WooCommerce 提供的動作與過濾器掛鉤擴展功能 - 遵循 WooCommerce 編碼標準和命名慣例 - 使用 WooCommerce 內建函式,避免重新發明輪子 - 使用 WooCommerce 設定 API 建立外掛設定頁面 - 在外掛中覆寫 WooCommerce 模板實現自訂佈局 - 使用 WooCommerce 的 CRUD 類別管理自訂資料 - 檢查 WooCommerce 啟用狀態與版本相容性   ## 安全與性能 - 實作適當的安全措施(nonces、資料轉義、輸入清理) - 使用 `wp_enqueue_script()` 和 `wp_enqueue_style()` 進行資源管理 - 使用 WordPress Transients API 進行快取 - 使用 `wp_cron()` 實作背景處理 - 使用 `prepare()` 語句確保資料庫查詢安全   ## 國際化與本地化 - 使用 WordPress i18n 函式實作國際化 - 使用 WooCommerce 翻譯函式處理文字字串 - 在外掛 CSS 中支援 RTL 語言 - 實作適當的分頁功能