Wordpress Manager

🚀 WordPress 插件開發指南

本指南將詳細介紹 WordPress 插件的安裝、配置、功能使用、自定義請求等內容，助您輕鬆上手 WordPress 插件開發。

🚀 快速開始

安裝步驟

1. 登錄您的 WordPress 管理界面。
2. 導航至 插件 > 添加插件。
3. 在搜索欄中輸入插件名稱，點擊“安裝現在”按鈕。
4. 安裝完成後，點擊“激活”以啟用插件。

配置指南

• 打開 WordPress 管理界面中的插件設置頁面。
• 填寫必要的配置選項（如 API 鍵、秘密密鑰等）。
• 保存設置即可完成配置。

✨ 主要特性

文章管理

獲取文章列表

• 功能描述：返回指定條件下的文章列表。
• 參數說明：
  • perPage：每頁顯示的文章數量（默認為10）。
  • page：當前請求的頁碼（默認為1）。
  • searchTerm：搜索關鍵詞。

創建新文章

• 功能描述：新增一篇 WordPress 文章。
• 必要參數：
  • title：文章標題。
  • content：文章內容。
  • customFields：自定義字段數據。

媒體管理

獲取媒體文件列表

• 功能描述：返回指定條件下的媒體文件列表。
• 可選參數：
  • mediaType：媒體類型（如圖片、視頻等）。
  • searchTerm：搜索關鍵詞。

新增媒體文件

• 功能描述：上傳並存儲新的媒體文件到 WordPress。
• 必要參數：
  • file：待上傳的文件路徑或二進制數據。
  • fileName：文件名稱（可自定義）。
  • description：文件描述信息。

分類管理

獲取分類列表

• 功能描述：返回所有 WordPress 分類信息。
• 參數說明：
  • perPage：每頁顯示的分類數量（默認為10）。
  • page：當前請求的頁碼（默認為1）。

創建新分類

• 功能描述：新增一個新的 WordPress 分類。
• 必要參數：
  • categoryName：分類名稱。
  • customData：可選附加數據（如分類描述、父分類ID等）。

自定義請求

發送自定義請求

• 功能描述：支持發送任意的 WordPress REST API 請求。
• 必要參數：
  • siteUrl：站點 URL 地址。
  • username：WordPress 用戶名。
  • password：用戶密碼。
• 可選參數：
  • customEndpoint：自定義請求路徑（如 /wp/v2/posts）。
  • customMethod：請求方法（默認為 GET，支持 POST、PUT、DELETE）。
  • customData：POST 或 PUT 請求的主體數據。
  • customParams：URL 查詢參數。

示例

{
  "tool": "custom_request",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "your_password_here",
  "customEndpoint": "/wp/v2/posts/123",
  "customMethod": "DELETE"
}

📚 詳細文檔

響應格式

數據結構

• 成功響應：

{
  "status": "success",
  "data": {...},
  "message": "操作成功"
}

• 失敗響應：

{
  "status": "error",
  "code": "404",
  "message": "資源未找到"
}

分頁與排序

• 支持自定義分頁和排序功能。
• 可通過 orderBy 和 orderDirection 參數控制返回結果的順序。

安全考慮

基本安全措施

1. 確保 WordPress 核心程序和插件始終處於最新版本狀態。
2. 避免使用過於簡單的密碼，建議採用強密碼策略。
3. 定期備份網站數據，以防萬一。

應用密碼管理

• 使用 WordPress 的應用密碼功能來增強安全性。
• 應用密碼允許您為特定應用程序創建受限的訪問權限，而無需共享主用戶密碼。

開發與貢獻

提交代碼規範

1. 遵循 Git 版本控制流程，確保代碼提交清晰可追溯。
2. 在 Pull Request 中詳細說明修改內容和目的。
3. 確保單元測試覆蓋率達標，並通過所有自動化檢測。

貢獻指南

• 歡迎社區開發者參與項目貢獻。
• 請在提出更改前先閱讀項目文檔和代碼規範。

📄 許可證

• MIT License：允許自由使用、修改和分發，但需保留版權聲明。
• GPL v3.0：遵循開源協議進行二次開發和發佈。

通過以上指南，您可以輕鬆上手 WordPress 插件的安裝、配置與開發。如需進一步支持，請參考官方文檔或聯繫社區開發者。