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 語言
- 實作適當的分頁功能