Code Snippets

變更記錄

4.1.0 (2026-11-05)

新增

• 在外掛頁首新增統一搜尋，可從同一個欄位搜尋程式碼片段與其中的程式碼、設定、統計資料、歡迎畫面、說明文件，以及社群雲端的程式碼片段，並支援鍵盤操作與完整的搜尋結果頁面。
• 在版本切換器中加入標籤，標示目前版本、最新版本、Beta 測試版與候選發行版，並列出各版本已測試至哪個 WordPress 版本。

變更

• 版本切換警告現在會提醒，不建議在正式網站上使用 Beta 測試版與候選發行版。
• 重設快取時，現在也會重新取得可用的外掛版本清單，並回報找到的版本數量；若無法列出版本，也會說明原因。

修正

• 修正使用頁面快取的網站因快取外掛的 REST API 回應，導致程式碼片段清單顯示過時狀態的問題。
• 修正社群雲端的搜尋方式選單缺少 [使用 AI 搜尋] 選項的問題。（PRO）
• 修正在多站網路中儲存網路程式碼片段時，未套用與子網站共用設定的問題。
• 修正 [編輯程式碼片段] 畫面出現 PHP 過時用法通知，以及瀏覽器分頁標題缺漏的問題。
• 修正單行程式碼過長且未斷行，導致程式碼片段編輯器頁面被撐寬、側邊欄超出畫面的問題。
• 修正 Code Snippets 服務或 WordPress.org 回應緩慢或無法連線時，管理畫面會一直等待遠端請求，直到網站預設逾時時間才停止的問題。這些請求的逾時上限現為 5 秒，歡迎內容的請求則為 3 秒。
• 修正版本切換訊息被管理通知篩選器隱藏，以及回應中的標記被當成 HTML 顯示的問題。
• 修正無法取得版本清單時，重新整理操作卻回報成功的問題。
• 修正網站上的外掛在 WordPress 辨識目前使用者時建立網址，導致安全模式失效及 REST API 網址異常的問題。安全模式參數現在只會附加至管理後台連結。
• 修正多站網路中的子網站管理員沒有網路程式碼片段管理權限，仍可透過匯入端點匯入網路程式碼片段的問題。感謝 Artus KG 以負責任的方式通報此問題。
• 修正程式碼片段原始碼短代碼會在無程式碼片段管理權限的使用者所撰寫的文章中顯示程式碼的問題。感謝 Het Kalariya 以負責任的方式通報此問題。

4.0.0 (2026-10-12)

新增

• 新增統計頁面，可查看程式碼片段總數與各項分類統計。
• 新增 AI Agent，可依描述建立程式碼片段：撰寫任何程式碼前，會先提出計畫供你調整或核准，
  也能修改它建立的程式碼片段。 (PRO)
• 新增程式碼片段內容修訂功能，可查看過往版本記錄、與目前程式碼並排比較差異，
  並一鍵還原。 (PRO)
• 新增顯示條件，可控制程式碼片段執行的位置與時機，無須手動撰寫判斷程式碼。 (PRO)
• 新增依角色設定程式碼片段權限的功能，可決定哪些角色能檢視、編輯、啟用或刪除程式碼片段。 (PRO)
• 新增藍圖，可透過已儲存的程式碼片段與設定集合來設定網站。 (PRO)
• 新增檔案式儲存功能，將程式碼片段儲存為檔案，與網站其他內容一併納入版本控制。 (PRO)
• 新增「已在此頁面執行」追蹤功能，顯示目前檢視的頁面實際執行了哪些程式碼片段。 (PRO)
• Community Cloud 新增自然語言搜尋功能，直接描述需求即可，無須猜測關鍵字。 (PRO)
• 新增從 Code Snippets Cloud 部署程式碼片段至已連結網站的功能，
  也能為多個程式碼片段套用同一個顯示條件後一併部署。 (PRO)
• 新增將雲端套件組合作為獨立外掛安裝至已連結網站的功能。 (PRO)
• 新增從雲端控制台更新已連結網站上的 Code Snippets Pro 的功能。 (PRO)
• 新增差異偵測功能，當網站上的程式碼片段與雲端儲存的副本不再一致時提出回報。 (PRO)
• 新增管理程式碼片段的後台介面，提供更清楚的版面配置、更快速的互動，
  並讓外掛各畫面的操作體驗更一致。 (PRO)
• 新增瀏覽程式碼片段的卡片檢視，並在程式碼片段表格與 Community Cloud 提供檢視切換功能。 (PRO)
• 新增程式碼片段預覽對話框，無須開啟編輯器，即可從程式碼片段表格查看程式碼。 (PRO)
• 在 Code Snippets 畫面上自動隱藏其他外掛的不相關後台通知。 (PRO)
• 新增管理列程式碼片段側邊面板，以 Deckerweb Snippets 工作流程為基礎，
  可從 WordPress 管理列快速存取程式碼片段與安全模式。 (PRO)
• 新增程式碼片段鎖定功能，協助防止重要程式碼片段遭到意外編輯或刪除。
  感謝 https://github.com/mgiannopoulos24 的貢獻。 (PRO)
• 改進主要程式碼片段表格的顯示選項，可控制要顯示的欄位，
  以及是否截斷過長的程式碼片段名稱或說明。 (PRO)
• 重新設計的程式碼片段表格支援批次操作與批次下載程式碼。 (PRO)
• Community Cloud 新增精選程式碼片段，並改進瀏覽體驗。 (PRO)
• 相容於 WordPress 現代化佈景主題的後台樣式。 (PRO)
• 讓無障礙標籤、標題、分頁標記、表格核取方塊、排序按鈕、複製按鈕及拖放上傳控制項
  更清楚易懂。 (PRO)
• 新增意見回報功能，可從外掛畫面傳送錯誤回報、功能需求及一般意見回饋，
  並可選擇附上網站環境摘要，方便團隊重現問題。 (PRO)

變更

• 重新設計主要程式碼片段表格，改進搜尋、篩選、排序、分頁、列操作
  及批次選取功能。 (PRO)
• 改進程式碼片段匯入與移轉體驗，讓檔案上傳處理與第三方外掛移轉流程
  更清楚。 (PRO)
• 改進程式碼片段的錯誤處理，讓啟用失敗、驗證錯誤及堆疊追蹤更容易理解。
  (PRO)
• 改進 Community Cloud 的搜尋與篩選，包括伺服器端篩選、搜尋結果載入，以及無結果時
  更清楚的顯示內容。 (PRO)
• 更新歡迎畫面、工具列、匯入畫面及雲端畫面，配合新的後台操作體驗。 (PRO)
• 將外掛內部架構更新為更清楚的 PSR-4 結構，方便長期維護。 (PRO)
• 改進程式碼片段表格、匯入畫面、移轉流程、Community Cloud、歡迎畫面、
  工具列、對話框、工具提示及程式碼編輯器的無障礙功能。 (PRO)
• 改善後台各畫面的色彩對比，並加強減少動態效果偏好的支援。 (PRO)
• 加快大型程式碼庫的載入速度，改為逐頁擷取，而非一次載入全部內容。 (PRO)

修正

• 修正一個已連結網站的 AI 對話會在另一個網站顯示的問題。 (PRO)
• 修正網站暫時無法讀取自己的程式碼片段時，導致儲存於 Code Snippets Cloud 的
  程式碼片段清單被清空的問題。 (PRO)
• 修正找不到程式碼片段時，REST API 傳回伺服器錯誤回應的問題。 (PRO)
• 修正多餘的前台邏輯，改善整體效能。 (PRO)
• 修正 Community Cloud 搜尋結果與分頁未遵循 WordPress 顯示選項的問題。 (PRO)
• 修正程式碼片段儲存與啟用時的回饋訊息，改善驗證錯誤與執行階段錯誤的顯示。 (PRO)
• 修正已下載的 Community Cloud 程式碼片段在重新載入頁面後顯示為未下載的問題。 (PRO)
• 修正多站網路查詢網路程式碼片段時使用錯誤資料表的問題。 (PRO)
• 修正未啟用程式碼片段的數量包含回收桶中程式碼片段的問題。 (PRO)
• 修正部分雲端 API 回應會導致 Community Cloud 精選程式碼片段無法載入的問題。 (PRO)
• 修正 Community Cloud 批次操作未取得選取項目，導致選取的程式碼片段始終未下載的問題。
  (PRO)
• 修正在低於 3.19 的 Elementor 版本中，Elementor 編輯器會發生嚴重錯誤的問題。
• 修正關閉 [截斷過長的程式碼片段名稱與描述] 顯示選項後，
  程式碼片段說明仍被截斷的問題。
• 修正儲存、啟用或停用程式碼片段時回報先前狀態的問題，
  此問題可能導致已停用的程式碼片段仍以檔案式執行方式運作。
• 修正程式碼片段編輯器未收到回應時，
  將儲存作業判定為失敗且未送達的問題，因為此時無法確認實際結果。
• 修正外掛仍在載入時查詢文章，
  導致翻譯過早載入並觸發 WordPress 通知的問題。

3.10.2 (2026-09-01)

新增

• 新增單次執行程式碼片段的確認流程，並強化處理程序以避免操作失敗或混淆。

變更

• 管理清單中的程式碼片段名稱現在支援 [顯示選項] 中的列截斷設定，以提供更佳的易讀性。
• 版本切換的 AJAX 請求現在會驗證正確的 Nonce，提高更新程式碼片段版本時的可靠性。

修正

• 修正因未定義的 wp_get_current_user() 呼叫所導致的安全模式嚴重錯誤。
• 修正在批次啟用程式碼片段時，錯誤觸發 PHP 驗證的問題。
• 修正使用者工作階段過期後的儲存問題。
• 修正讀取已修改的程式碼片段欄位時，因欄位別名所導致的警告。
• 透過移除無前置詞命名空間的參照，修正第三方自動載入器的問題。
• 解決管理後台使用者介面中程式碼片段名稱與版本切換行為不一致的問題。

3.10.1 (2026-08-28)

變更

• 透過邊框樣式強化工具列中目前使用中連結的可見度。

修正

• 修正影響使用 namespace 或 declare 陳述式之程式碼片段的嚴重錯誤。
• 修正在其他外掛的畫面設定篩選器傳回無效值時，程式碼片段頁面顯示空白的問題。
• 針對封鎖 REST API PUT 與 PATCH 請求的主機，改以使用方法覆寫的 POST 發送寫入請求，以修正程式碼片段儲存問題。
• 修正 [程式碼片段清單排序] 設定未套用至程式碼片段清單的問題。
• 修正在免費版中，管理工具列程式碼片段指令碼無法載入（包含網站前端）的問題。
• 修正傳送程式碼片段修改日期時未帶入正確 UTC 時區時差的問題。
• 修正 [顯示選項] 中的列截斷設定無法在不同工作階段間維持的問題。
• 修正側邊欄標籤大小不一致的問題。
• 修正固定式編輯器側邊欄顯示多餘水平捲軸的問題。

3.10.0 (2026-08-24)

新增

• 新增管理程式碼片段的後台介面，提供更清楚的版面配置、更快速的互動，並讓外掛各畫面的操作體驗更一致。
• 新增瀏覽程式碼片段的卡片檢視，並在程式碼片段表格與 Community Cloud 提供檢視切換功能。
• 新增程式碼片段預覽對話框，無須開啟編輯器，即可從程式碼片段表格查看程式碼。
• 在 Code Snippets 畫面上自動隱藏其他外掛的不相關後台通知。
• 新增管理列程式碼片段側邊面板，以 Deckerweb Snippets 工作流程為基礎，可從 WordPress 管理列快速存取程式碼片段與安全模式。
• 新增程式碼片段鎖定功能，協助防止重要程式碼片段遭到意外編輯或刪除。感謝 https://github.com/mgiannopoulos24 的貢獻。
• 改進主要程式碼片段表格的顯示選項，可控制要顯示的欄位，以及是否截斷過長的程式碼片段名稱或說明。
• 重新設計的程式碼片段表格支援批次操作與批次下載程式碼。
• Community Cloud 新增精選程式碼片段，並改進瀏覽體驗。
• 相容於 WordPress 現代化佈景主題的後台樣式。
• 讓無障礙標籤、標題、分頁標記、表格核取方塊、排序按鈕、複製按鈕及拖放上傳控制項更清楚易懂。

變更

• 重新設計主要程式碼片段表格，改進搜尋、篩選、排序、分頁、列操作及批次選取功能。
• 改進程式碼片段匯入與移轉體驗，讓檔案上傳處理與第三方外掛移轉流程更清楚。
• 改進程式碼片段的錯誤處理，讓啟用失敗、驗證錯誤及堆疊追蹤更容易理解。
• 改進 Community Cloud 的搜尋與篩選，包括伺服器端篩選、搜尋結果載入，以及無結果時更清楚的顯示內容。
• 更新歡迎畫面、工具列、匯入畫面及雲端畫面，配合新的後台操作體驗。
• 將外掛內部架構更新為更清楚的 PSR-4 結構，方便長期維護。
• 改進程式碼片段表格、匯入畫面、移轉流程、Community Cloud、歡迎畫面、工具列、對話框、工具提示及程式碼編輯器的無障礙功能。
• 改善後台各畫面的色彩對比，並加強減少動態效果偏好的支援。

修正

• 修正找不到程式碼片段時，REST API 傳回伺服器錯誤回應的問題。
• 修正多餘的前台邏輯，改善整體效能。
• 修正 Community Cloud 搜尋結果與分頁未遵循 WordPress 顯示選項的問題。
• 修正程式碼片段儲存與啟用時的回饋訊息，改善驗證錯誤與執行階段錯誤的顯示。
• 修正已下載的 Community Cloud 程式碼片段在重新載入頁面後顯示為未下載的問題。
• 修正多站網路查詢網路程式碼片段時使用錯誤資料表的問題。
• 修正未啟用程式碼片段的數量包含回收桶中程式碼片段的問題。
• 修正部分雲端 API 回應會導致 Community Cloud 精選程式碼片段無法載入的問題。

3.9.6 (2026-04-28)

修正

• 改進程式碼片段 REST API 的權限處理。
• 網站管理員無法切換共用網路程式碼片段的狀態。

3.9.5 (2026-02-05)

修正

• 提升處理雲端程式碼片段下載與更新操作時的安全性。

3.9.4 (2026-01-14)

新增

• 新增匯入功能，可透過拖放介面上傳檔案並移轉程式碼片段。
• 支援從其他熱門外掛匯入程式碼片段（Header Footer Code Manager、Insert Headers and Footers、Insert PHP Code Snippet）。
• 強化檔案式執行功能，改善多站網路模式的相容性。

修正

• 修正 Plugin 類別中的多站網路權限檢查。
• 集中處理回收桶中的程式碼片段，修正多站網路的程式碼片段執行邏輯。
• 修正多站網路的程式碼片段處理，確保個別網站的程式碼片段使用正確的資料表，並排除回收桶中的程式碼片段。

3.9.3 (2025-12-03)

新增

• 新增端對端測試，驗證程式碼片段清單頁面的切換開關視覺狀態，改善介面驗證與測試可靠性。

修正

• 還原管理選單中缺少的樣式，以及配合文字方向的版面配置。
• 確保偵測啟用開關狀態時使用正確的轉換值。

3.9.2 (2025-11-17)

變更

• 為 TinyMCE 擴充功能加入自訂剪刀圖示，並更新按鈕標題。
• 改進編輯頁面的返回導覽樣式。
• 調整雲端程式碼片段清單中欄位名稱與操作按鈕的版面配置。
• 改善雲端相關介面元件的整體樣式。
• 提升雲端搜尋效率，改進分頁與程式碼片段擷取。
• 加入基礎機制，避免 Composer 相依套件與其他外掛衝突。

修正

• 改進 Cloud API 與分頁輸出中的資料過濾及正規化處理。
• 解決 WordPress 支援論壇回報的多項 TinyMCE 問題。

3.9.1 (2025-11-14)

變更

• 改用 CSS 原生的文字方向處理（RTL/LTR），改善相容性並簡化樣式
• 將相依套件更新至最新的相容版本

修正

• 修正 TinyMCE 選單按鈕的註冊，避免初始化失敗
• 修正編輯器中 [程式碼文字方向] 控制項的位置

3.9.0 (2025-11-13)

新增

• 在程式碼片段清單表格中加入情境通知，於介面上顯示操作結果與警告
• 擴充多站網路共用設定，讓全網路程式碼片段共用的控制更清楚

變更

• 更新支援的瀏覽器目標，並改善後台介面（讓列操作徽章更清楚、改善滑鼠停留在 Pro 徽章上的效果、調整已啟用程式碼片段名稱的樣式）

修正

• 修正 REST API 分頁功能，傳回正確的結果與頁數
• 修正樣式選取器，確保已啟用程式碼片段的名稱能正確醒目提示

3.8.2 (2025-10-31)

修正

• 改進以檔案式執行方式處理含有命名空間的 PHP 程式碼片段。

3.8.1 (2025-10-28)

新增

• 新增程式碼行說明小工具，可套用或移除 AI 產生的註解。 (PRO)

變更

• 改進雲端搜尋結果的分頁處理與顯示結構。 (PRO)
• 改善雲端介面中程式碼庫資料列與未使用分頁的樣式。 (PRO)

移除

• 移除 guzzlehttp/guzzle 相依套件，減少套件衝突。 (PRO)

修正

• 改進多站網路安裝環境中的檔案式程式碼片段處理。

3.8.0 (2025-10-24)

新增

• @CarolinaOP 與 @louiswol94 以外掛貢獻者的身分加入團隊。
• 新增程式碼片段的檔案式執行模式（可在外掛設定中選用）。
• 新增版本切換選項，方便將外掛還原至較舊的版本。
• 小幅改進編輯器與側邊欄的介面。

變更

• 為 Composer 套件加上前綴，減少與其他外掛的衝突。
• 程式碼片段 REST API 現在支援透過 page 與 per_page 查詢參數進行分頁。
• 改進編輯器的預覽行為。

修正

• 修正特殊情況下程式碼片段執行與前台初始化的問題。
• 提升程式碼片段執行的可靠性。
• 修正條件功能錯誤導致 JavaScript 與 CSS 程式碼片段載入兩次的問題。 (PRO)
• 修正部分條件因在主迴圈前載入而無法運作的問題。 (PRO)

3.7.0 (2025-08-29)

新增

• 新增「條件」功能：透過功能強大的邏輯編輯器，控制程式碼片段執行的位置與時機。 (PRO)

變更

• 重新設計編輯選單，更新外觀與功能。
• 更新程式碼片段類型徽章，讓視覺差異更明顯。
• 重新設計外掛各處使用的工具提示。
• 將內容程式碼片段的短代碼選項移至獨立的互動視窗。
• 更新程式碼片段標籤編輯器，改用 WordPress 內建的標籤編輯器。
• 建立專用表單，供使用者提交 Beta 版意見回饋。
• 改進程式碼片段啟用切換開關的使用體驗。

修正

• 在多站網路中擷取已啟用的程式碼片段時，排序現在會優先依照「priority」欄位。
• 雲端搜尋現在會正確顯示，且可在 Code Snippets 免費版中下載程式碼片段。
• 改善管理選單圖示的載入效能。

3.6.9 (2025-02-17)

變更

• 更新 Cloud_API::get_bundles()，正確檢查套件組合資料，並在沒有有效套件組合時傳回空陣列。
• 重構 Cloud_List_Table::fetch_snippets()，確保一律傳回有效的 Cloud_Snippets 執行個體。
• 整理套件組合的迭代程式碼，並改進套件組合檢視中的翻譯處理。

修正

• 在迭代前先檢查套件組合陣列，修正套件組合迭代時的錯誤。

完整變更紀錄可在 GitHub 查看