開發部落格
寫回 WordPress 之前,如何確認要修改的位置
先說結論
網站經營者選擇套用建議時,我們會取得 WordPress 目前的內容,確認修改應該落在哪裡。目標明確時才寫入;需要手動修改時,則提供文字讓經營者複製使用。
限制連線與目標
WordPress 應用程式密碼會加密保存,只在透過 HTTPS 呼叫已登錄主機的 REST API 時使用。套用時,我們會確認訂閱狀態,以及建議的頁面是否屬於該網站。
文章和頁面會與 WordPress 回傳的網址比對。首頁則讀取 WordPress 的首頁設定。
從目前的內容規劃修改
標題和說明的原文必須與目前的值相符。修改內文時,我們會解析 HTML,在畫面上看得到的文字節點中尋找唯一符合條件的位置,並比較修改前後非文字節點的數量。
寫入內文還需要能保留 HTML 的權限。公開的 HTML 中有可辨識的頁面建構工具標記,或原文出現在兩個符合條件的位置時,我們會提供文字,讓經營者複製到編輯器中修改。
確認儲存結果與復原的極限
寫入前會先記錄預定的修改,並把回傳的儲存值與預期的值比較。兩者不同時,我們會嘗試恢復原本的值並回報失敗;這個恢復本身也可能失敗,而且無法完全避免覆蓋期間插入的其他編輯。
復原時會比對目標欄位整體的 hash,寫入後已被改過就不覆蓋。不過,在讀取和寫入之間發生的編輯仍可能互相衝突。從複製內容手動套用的修改,不在這個復原範圍內。
用虛構的內文走一遍
假設一家虛構維修店頁面儲存的內文是「<p>我們修理單車。</p>」,建議的原文是「我們修理單車。」,替換文字是「歡迎把單車交給我們保養。」。網址相符、原文只出現在一個符合條件的可見文字節點中,其他條件也通過時,系統就會規劃這次替換。規劃不代表一定寫入成功。
如果原文出現兩次,系統無法判斷要改哪一處,就會改為提供文字讓人手動複製。目前的值已改變、讀不到支援的 SEO 說明,或沒有保留 HTML 的權限,也都無法自動套用。請對照建議和 WordPress 編輯器,選出要修改的位置。
確認頁面,謹慎復原
套用前,請確認網址和修改前後的文字。套用後,打開公開頁面,看修改的句子和周圍的版面。快取可能讓訪客晚一點才看到,所以儲存的值和公開畫面要分開確認。
復原時顯示值已改變或失敗的話,不要直接覆蓋之後的編輯。請比較 WordPress 目前的欄位和可用的修訂版本,和網站維護者一起決定要恢復什麼。自動恢復本身也可能失敗,手動貼上的修改不在這項服務的復原範圍內。