docs / wp-plugin

WordPress 外掛文件

SEO AI WordPress 外掛 — 架構設計、Hook 系統、REST API 與安全機制

下載 WordPress 外掛

即時生成 ZIP

外掛架構

seo-ai-plugin/
├── seo-ai-plugin.php          # 主入口文件
├── includes/
│   ├── class-seo-ai-core.php  # 核心類別
│   ├── class-api-client.php   # API 客戶端
│   ├── class-schema-injector.php # Schema 注入器
│   └── class-content-sync.php # 內容同步
├── admin/
│   ├── class-admin-menu.php   # 後台選單
│   └── views/                 # 後台視圖
└── public/
    └── class-public-hooks.php # 前台 Hook

Hook 系統

Action Hooks:
  seo_ai_content_published  — 內容發布時觸發
  seo_ai_schema_inject      — Schema 注入時觸發
  seo_ai_sync_complete      — 同步完成時觸發

Filter Hooks:
  seo_ai_meta_title         — 過濾 Meta Title
  seo_ai_meta_description   — 過濾 Meta Description
  seo_ai_schema_data        — 過濾 Schema 資料

REST API 端點

基礎路徑: /wp-json/seo-ai/v1/

POST   /sync              觸發內容同步
GET    /schema/{post_id}  取得文章 Schema
PUT    /schema/{post_id}  更新文章 Schema
GET    /keywords          取得關鍵字清單
GET    /status            取得外掛狀態

安全機制

1. API 金鑰驗證 — 所有 REST API 請求需要有效的 API 金鑰
2. Nonce 驗證 — 後台操作使用 WordPress Nonce 防止 CSRF
3. 能力檢查 — 使用 current_user_can() 驗證用戶權限
4. 資料清理 — 所有輸入使用 sanitize_text_field() 清理
5. 輸出轉義 — 所有輸出使用 esc_html() / esc_attr() 轉義