WordPress 外掛安裝:3 種方法+常見錯誤排查

手機買回來時,功能就是內建的相機、通訊錄、瀏覽器,想要多一個記帳本、多一套翻譯工具,靠的不是換一支新手機,而是到商店抓一個 App 裝上去,就多了一種本領。WordPress 網站也是同一套邏輯,剛架好的網站只負責發文章、管理使用者這些最基本的事,想讓網站多一個聯絡表單、多一組線上金流、多一套 SEO 檢查工具,都得先學會怎麼把外掛裝上網站,也就是這篇要講的 WordPress 外掛安裝。

很多人第一次碰後台,光是想把一個外掛裝上去就卡關:後台裡的安裝按鈕怎麼都找不到、跟廠商買的外掛壓縮檔不知道要塞進哪裡、裝完卻找不到設定畫面在哪裡。這裡卡關,原因通常是方法選錯,其實 WordPress 外掛安裝一共只有三條路可以走:在後台直接搜尋安裝、上傳 ZIP 壓縮檔安裝、透過 FTP 手動安裝,三種方法各有各的適用場合,不是隨便挑一種就能一路用到底。

先從最多人會用到的後台搜尋講起,再拆解上傳 ZIP 跟 FTP 這兩種比較少人碰、卻在關鍵時刻能救急的方法,最後把裝完之後容易漏掉的收尾動作跟常見錯誤,也一次整理清楚。

為什麼你的後台可能找不到「外掛」選單?

登入後台想裝第一個外掛,卻翻遍左側選單也找不到「外掛」兩個字,這種情況通常不是操作有誤,而是手上這個 WordPress 本身就不開放安裝外掛。

這是很多新手教學會漏掉的前提,其實「WordPress」不是只有一種版本。市面上講的 WordPress 分成兩種,分別是 WordPress.org 跟 WordPress.com,兩者用的是同一套軟體,差別在誰幫你管主機。WordPress.org 是你自己找主機、自己架站,站長對整個網站有完全的控制權,外掛想裝多少就裝多少;WordPress.com 則是由 Automattic 這家公司代管主機跟後台維運,方便是方便,卻不是每個方案都開放裝外掛。根據 WordPress.com 官方支援文件的說明,安裝外掛只有在 Personal、Premium、Business、Commerce 這幾個付費方案裡才開放使用,免費方案的使用者得先升級才能用這個功能。換句話說,如果你的網站是在 WordPress.com 申請的免費帳號,翻遍後台也不會有「外掛」選單,這不是操作問題,得先決定要不要升級成付費方案。

就算你的網站是用 WordPress.org 自己架設的,也還有第二道關卡,那就是登入身份。WordPress 把後台使用者分成好幾種角色,只有系統管理員這個角色,後台側邊欄才會出現「外掛」這一項;編輯、作者這類角色本來就沒有安裝外掛的權限,不是網站設定漏掉了什麼,是角色分工本來就是這樣設計的。確認自己是用系統管理員身份登入、網站也是自架而非 WordPress.com 免費方案,這兩件事都對了,才有資格往下看接下來的三種安裝方法。

WordPress 外掛安裝三種方法對照:後台搜尋適合免費目錄裡的外掛,上傳 ZIP 適合向廠商購買的付費外掛,FTP 手動則是後台卡住時的備援方案。
三種 WordPress 外掛安裝方法各有適用場合,該用哪一種取決於外掛來源與後台當下的狀況。

方法一:後台搜尋安裝,最快速的免費外掛安裝法

多數人第一次裝外掛,走的都是這條路。只要是 WordPress 免費外掛目錄裡找得到的外掛,用後台內建的搜尋功能,幾步就能把整個安裝流程走完,不必碰任何程式碼或壓縮檔。

整個流程從後台側邊欄一路點到啟用即可完成,過程中有一個很多教學會跳過的重點,就是怎麼從搜尋結果裡的幾項資訊判斷這個外掛值不值得裝,而不是看到搜尋結果第一筆就點下去安裝。

Step 1:前往「外掛→安裝外掛」頁面

登入後台後,從左側選單點「外掛」,再點進「安裝外掛」,就會進到今天要操作的主要頁面。頁面最上方有四個分頁:精選、熱門、推薦、我的最愛,分別對應目前主打的外掛、目前最多人在用的外掛、系統依你安裝過的外掛自動推薦的相關外掛,還有你自己收藏過的外掛清單。如果已經知道要裝什麼,不必逐一點開這幾個分頁,直接在頁面右上角的「搜尋外掛」欄位輸入關鍵字最快。

WordPress 後台安裝外掛頁面,上方有精選、熱門、推薦、我的最愛四個分頁,右上角的搜尋外掛欄位可直接輸入關鍵字找外掛。
進到後台的安裝外掛頁面,最快的方式是直接在右上角搜尋欄位輸入外掛關鍵字。

Step 2:搜尋外掛,從列表資訊判斷值不值得裝

以安裝一個聯絡表單類的外掛為例,在搜尋欄輸入關鍵字後,畫面會跳出一長串搜尋結果,每一筆都是表格形式,除了外掛名稱與簡介,還會列出幾項關鍵資訊,這幾項才是真正決定要不要裝的依據。

  • 星等評分:由使用者評分,星星越多代表越多人給出正面回饋,可以順手點進去看評論內容,不要只看星星數字。
  • 最後更新日期:外掛已經一兩年沒更新,代表開發者可能已經停止維護,跟目前的 WordPress 核心版本搭配容易出問題,這種外掛風險比較高。
  • 啟用安裝數:數字越大代表越多網站正在使用這個外掛,出問題時也比較容易在網路上找到別人遇過同樣狀況的討論。
  • 相容性標示:頁面會直接寫出「與你的 WordPress 版本相容」或「未經測試」,選標示相容的優先。

這幾項資訊都是安裝前就能看到的,比只看名稱或簡介可靠得多。

WordPress 外掛搜尋結果的每一筆卡片都列出星等評分、最後更新日期、啟用安裝數與版本相容性,這四項是安裝前判斷外掛值不值得裝的依據。
搜尋結果卡片上的星等、最後更新、安裝數與相容性,才是安裝前真正該看的判斷依據。

Step 3:點擊安裝,記得點啟用

挑定外掛後,點下「立即安裝」,畫面會跑一段安裝進度,完成後按鈕會變成「啟用」,這一步千萬不能跳過。很多新手以為看到安裝完成就代表結束,其實外掛沒有啟用,等於沒裝,網站前台不會有任何變化。點下「啟用」後,畫面通常會跳出啟用成功的提示,這時候才算真正把外掛裝進網站裡。

外掛安裝完成後,WordPress 後台原本的立即安裝按鈕會變成藍色的啟用按鈕,沒點啟用外掛就不會真正生效。
安裝完成後按鈕會變成「啟用」,這一步不點下去,外掛等於沒裝、前台不會有任何變化。

方法二:上傳 ZIP 檔安裝,把付費外掛裝上網站

不是每個外掛都收錄在 WordPress 內建的免費外掛目錄裡,跟第三方廠商購買的付費外掛,或是直接從開發商網站下載的版本,通常拿到的都是一個 ZIP 壓縮檔,這種情況下方法一的搜尋安裝派不上用場,得改用上傳安裝。這個方法從拿到壓縮檔開始講起,一路走到上傳、安裝、啟用。

Step 1:先搞懂 ZIP 檔從哪裡來、要不要解壓縮

付費外掛通常是向開發商網站或購買平台下載得到一個 .zip 壓縮檔,這裡有一個常見的誤解要先澄清,那就是不要先把這個壓縮檔解壓縮,上傳的時候要直接用壓縮檔本身,解壓縮後的資料夾反而沒辦法用這個方法安裝。另外挑外掛來源時也順手留意一下,開發商是否有清楚的更新紀錄與技術支援管道,來路不明、很久沒更新的外掛,裝了之後風險也比較高。

Step 2:用「上傳外掛」按鈕上傳並安裝

從「外掛→安裝外掛」頁面進去,這次不搜尋,改點頁面上方的「上傳外掛」按鈕,接著點「選擇檔案」,從電腦裡選剛剛下載好的 ZIP 檔,再按「立即安裝」。畫面顯示安裝完成後,會出現「啟用外掛」按鈕,跟方法一一樣,這一步同樣不能漏掉。

WordPress 後台上傳外掛畫面,先按選擇檔案挑出外掛的 ZIP 壓縮檔,再按立即安裝,就能把付費外掛裝上網站。
付費外掛拿到的是 ZIP 檔,改用上傳外掛、選好檔案後按立即安裝即可。

Step 3:上傳後安裝失敗,最常見是這兩個原因

有時候按下「立即安裝」,畫面沒有跑出成功訊息,反而跳出錯誤提示,最常見的原因有兩個,一個是上傳的檔案格式不對,或根本不是一個有效的外掛壓縮檔;另一個是上傳的檔案大小超過主機設定的上傳限制。這兩種狀況先不用急著切換去用 FTP,詳細的排查方法留在後面「安裝外掛失敗」那節統一講。

方法三:FTP 手動安裝,後台安裝行不通時的救援方案

多數人架設網站的過程裡,可能一次都不會用到 FTP,但真正卡關的時候,這往往是唯一還能動手救回網站的方法。當後台安裝或上傳卡住,像是主機限制了上傳檔案大小、目錄權限出問題,或是要一次搬回好幾個外掛做網站復原,FTP 就是這時候該派上用場的工具。這個方法比前兩種都繁瑣,也比較適合當備援,不當首選。

FTP 手動安裝外掛的四個步驟:先在電腦把 ZIP 解壓縮,用 FTP 連上主機,把外掛資料夾上傳到 wp-content/plugins 資料夾,最後回後台手動啟用。
FTP 手動安裝要走完解壓縮、連線、上傳到 plugins 資料夾、回後台啟用四步,最後一步不會自動完成。

Step 1:什麼情況該用 FTP,而不是後台安裝?

真正會用到 FTP 的情境不多,但都很實際:主機商限制了上傳檔案的大小、後台安裝時一直顯示「無法建立目錄」這類權限錯誤、網站搬家需要一次還原大量外掛,或是某個外掛出了問題,需要直接把它的資料夾改名來強制停用、搶救網站。遇到其中任何一種,都代表該切換到 FTP 這條路。

Step 2:準備 FTP 軟體與主機帳密,連到外掛資料夾

開始之前,需要準備一套 FTP 或 SFTP 客戶端軟體,還有主機商提供的 FTP 帳號密碼,這組帳密通常能在主機商的後台管理介面裡找到。連線成功後,要在網站的檔案目錄裡找到 /wp-content/plugins/ 這個資料夾,所有外掛實際上都存放在這裡,之後不管是安裝新外掛還是排查問題,都會一直用到這個路徑。

Step 3:上傳解壓縮後的外掛資料夾,回後台啟用

這一步跟前兩個方法不一樣,ZIP 檔要先在自己電腦上解壓縮,取得完整的外掛資料夾,再把整個資料夾本身(不是壓縮檔)上傳到剛剛連線到的 plugins 資料夾裡。上傳完成後,FTP 本身並不會自動啟用外掛,得回到 WordPress 後台的「已安裝外掛」頁面,找到剛上傳的外掛,手動點擊啟用,才算真正裝完。

免費外掛用方法一就好,付費外掛通常得靠方法二

三種 WordPress 外掛安裝的方法都講完,其實可以收斂成一個好記的判斷原則,那就是外掛在 WordPress 免費目錄裡找得到,就優先用方法一,最快也最省事;跟外部廠商購買、或不在目錄裡的外掛,才輪到方法二上傳 ZIP;只有後台安裝或上傳卡住,或是要一次處理大量外掛時,才需要動用方法三 FTP。沒有一種方法是萬用的,該用哪一種,取決於外掛的來源跟後台當下的狀況。

方法適用情境需要準備什麼
方法一:後台搜尋外掛在 WordPress 免費目錄裡找得到系統管理員帳號,後台登入即可
方法二:上傳 ZIP向廠商購買,或從開發商網站下載的外掛外掛的 ZIP 壓縮檔(不要先解壓縮)
方法三:FTP 手動安裝後台安裝或上傳卡住、要一次搬回多個外掛FTP/SFTP 客戶端軟體、主機的 FTP 帳密

外掛安裝完成後,還有三件事要做

不少教學寫到「啟用」兩個字就結束,但外掛真正裝好,還有三件收尾的事容易被漏掉,缺一件都可能讓你以為裝完了,其實根本沒生效。

第一,回到「已安裝外掛」頁面,看每個外掛是啟用中還是還沒啟用。啟用中的外掛名稱通常會用粗體標示,整行的底色也會跟其他外掛不一樣,一眼就能分辨,不用一個一個點進去確認。

第二,每個外掛的設定入口位置都不固定,可能會直接在後台側邊欄新增一個獨立選單,也可能藏在「已安裝外掛」列表裡,外掛名稱下方多出一行「設定」連結,兩種情況都要留意,才找得到剛裝好的外掛設定畫面在哪裡。

第三,也是最容易被跳過的一步,裝完、設定完之後,一定要到網站前台,實際去點一次那個功能,確認畫面上真的看得到、也真的能正常運作,而不是後台顯示啟用中就當作大功告成。

安裝外掛失敗,跳出錯誤訊息,怎麼一步步排查?

多數同類教學遇到安裝出錯,往往只寫一句可能是權限問題就帶過,讀者還是不知道下一步該做什麼。這裡把三種最常遇到的狀況,從症狀到排查方法一次講完。

錯誤一:安裝時顯示「無法建立目錄」

這個錯誤通常來自兩個原因。一個是外掛資料夾的寫入權限不足,WordPress 開發者文件建議伺服器上的資料夾權限設定在 755、檔案權限設定在 644,權限低於這個標準,安裝程式就沒辦法在伺服器上建立新資料夾;另一個原因單純是主機空間已經滿了,沒有多餘的容量能寫入新檔案。遇到這個錯誤,不需要自己去改權限碼這種進階操作,直接聯絡主機商,請對方確認資料夾權限與剩餘空間即可。

錯誤二:上傳外掛後,網站變成一片空白

這種俗稱白畫面的狀況,通常是外掛跟目前的 WordPress 版本,或主機的 PHP 版本不相容,也可能是外掛本身的程式碼有問題。解法是透過 FTP 連進伺服器,把出問題的那個外掛資料夾改名,等於強制讓它停用,網站通常就能立刻恢復正常,之後再回頭找相容的替代外掛。

排查到最後,要先停用外掛逐一測試

不管遇到哪一種錯誤,只要懷疑問題出在外掛衝突,最可靠的方法都是回到「已安裝外掛」頁面,把外掛一個一個停用、再逐一重新啟用,抓出真正造成問題的那一個,而不是整批砍掉重裝。找到問題外掛之後,可以先試著停用再重新啟用一次看看是否只是暫時性問題,如果同樣的錯誤又出現,就代表這個外掛跟網站真的不相容,該找其他功能類似的外掛替代。

外掛裝好、設定完、前台也實際測試過之後,網站並不會就此一勞永逸。手機裡的 App 用久了要更新版本,家裡的家電也要定期保養,WordPress 外掛安裝完更是一樣的道理,養成定期回後台檢查更新、清掉早就沒在用的外掛的習慣,網站才能一直維持乾淨、好維護的狀態。

資料來源
  1. Install a Plugin — WordPress.com
  2. Changing File Permissions — WordPress.org