WordPress

WP All Import 怎麼用?5 步驟把 CSV、Excel 匯進 WordPress

紙箱上寫著「雜物」,打開卻是鍋子、充電線和幾本書。搬家最耗時間的從來不是搬運,而是拆箱之後,每一樣東西都得重新找到自己該去的房間。把資料搬進 WordPress 也是同一件事,WP All Import 這支外掛做的就是拆箱和貼標籤。

舊系統匯出的 CSV 把商品名稱放在第 3 欄,分類擠成一整串文字;供應商寄來的 Excel 每個月欄位順序都不一樣;另一個網站吐出的 XML 層層巢狀。資料都在,只是沒有任何一份對得上 WordPress 的欄位。這支外掛把 CSV、XML、Excel 裡的每個欄位,用拖拉的方式對到文章、頁面或自訂文章類型的欄位,再一次建成幾十、幾千筆內容。

WordPress 後台雖然也有匯入功能,但能接的來源很窄,WP All Import 補上的就是這一塊。

WP All Import 是什麼?

WP All Import 是 Soflyy 開發的 WordPress 外掛。它讀取 CSV、XML、Excel 這類檔案,讓使用者把檔案裡的欄位拖到 WordPress 的對應欄位上,再批次建成文章、頁面或自訂文章類型。外掛頁特別說明,檔案裡的元素不需要照特定方式排列,欄位怎麼命名、順序怎麼排都可以。

後台「工具 → 匯入」裡的 WordPress 匯入工具(WordPress Importer)則是另一種思路。它的外掛頁寫明,它匯入的是 WordPress 自己匯出的檔案,內容包括文章、頁面、留言、自訂欄位、分類標籤與作者。WP All Import 外掛頁的常見問題形容內建工具採取的是「全有或全無」的做法,而 WP All Import 可以篩選、對應、修改進來的資料。

WordPress 內建匯入工具WP All Import
接得上的來源WordPress 自己匯出的檔案CSV、XML、Excel 等各種來源
處理方式整份檔案全部進來可以篩選、對應、修改進來的資料
適合的情況同為 WordPress 站之間搬內容舊 CMS、供應商資料表、其他系統匯出的檔案

外掛頁列出的使用情境很廣,從舊 CMS 搬到 WordPress,到用聯盟行銷資料源建一個商店,甚至做房地產入口網站都有。落到一般網站的日常,最常見的是三種場景:把舊網站或舊系統的內容搬進來、定期收到一份資料表就要更新網站、一次建立上百個結構相同的頁面或文章。

外掛頁上的數字也能看出它的規模。使用中安裝數超過 100,000,共有 1,964 則評分、平均 4.7 分(滿分 5 分),其中 1,793 則是五星、120 則是一星;2012 年 7 月首次上架,目前版本是 4.1.4,標示測試到 WordPress 7.1.3。以下的操作畫面與選項以 wordpress.org 上架的 4.1.2 版為準;4.1.4 把外掛整體的 Settings 頁重新整理成六個分頁,部分項目的名稱與位置和下文略有不同,例如 Log Storage 改叫 Logs kept。Pro 版另外提供的功能集中放在文末一節。

WP All Import 的 wordpress.org 外掛頁,顯示 100,000+ 使用中安裝與 4.7 星評分
WP All Import 在 wordpress.org 免費上架,使用中安裝數超過 100,000,平均 4.7 星(資料來源:WordPress.org)。

安裝方式、後台選單與執行環境

安裝路徑和一般外掛相同,到後台「外掛 → 安裝外掛」搜尋 WP All Import,免費安裝並啟用即可。

啟用後,左側選單會多出「All Import」,底下有五個項目:

  • New Import:建立一筆新的匯入,所有流程從這裡開始。
  • Manage Imports:已建立的匯入都列在這裡,可以重跑、修改設定、查看歷史紀錄。
  • Settings:外掛整體的設定,包括匯入範本的管理、日誌保留份數與暫存檔清理。
  • Support:說明文件與支援入口。
  • Partner Discounts:合作夥伴折扣的資訊頁。
WP All Import 啟用後,WordPress 後台左側多出 All Import 選單與 New Import 等五個子項目
外掛啟用後,所有匯入都從左側的 All Import 選單開始,介面以英文為主。

外掛的語言檔只有德文、西班牙文、日文等幾種,沒有繁體中文,即使 WordPress 後台設定成繁體中文,WP All Import 的畫面仍然以英文為主,只有沿用 WordPress 本身用語的地方(像「文章」「分類」)會跟著變成中文。

執行環境有兩個層面。版本上,需要 WordPress 5.0 以上、PHP 7.4 以上。PHP 元件上,還需要 DOMDocument、XMLReader、XMLWriter 三個模組,缺任何一個,外掛就會顯示 Required PHP components are missing 的錯誤訊息,無法讀取檔案。這三個都是 PHP 的標準元件,遇到這個訊息時,請主機商協助啟用即可。

可讀取的檔案格式與匯入前的資料整理

手上的檔案能不能直接匯入,通常不是問題,多數格式外掛都讀得進來。真正費工的是資料本身,寫法不一致的資料不會讓匯入失敗,卻會讓匯進網站的內容歪掉,事後得一筆筆改。

CSV、Excel、XML 等支援的檔案類型

外掛接受的副檔名包括 xml、csv、tsv、txt、dat、psv、json、xls、xlsx、sql,另外也能上傳 zip 與 gz 壓縮檔,壓縮檔裡放 xml、csv、xls、xlsx 這類常見格式即可。實務上最常用到的是 CSV、Excel 與 XML 三種。

CSV 最單純。欄位標題隨便取,外掛會自己讀出來,順序也沒有限制。外掛內部會把 CSV 即時轉成 XML 再處理,所以後面步驟二的篩選功能,CSV 與 XML 的用法完全一致。如果檔案的分隔符不是逗號,例如用豎線 | 或 # 分隔,可以在步驟二指定;匯入後出現特殊字元亂碼時,先把檔案另存成 UTF-8 編碼再上傳,多數狀況就能排除。

Excel 的 xls 與 xlsx 可以直接上傳,外掛會自動偵測欄位,不必先另存成 CSV。如果匯入大型 Excel 檔時遇到記憶體問題或錯誤,匯入設定的 Configure Advanced Settings(進階設定)裡有一個「Use alternative Excel processing method」選項,勾選後會改用另一套處理方式。

XML 的結構最自由,缺點是每個檔案長相不同,所以要在步驟二指定哪一個標籤代表「一筆記錄」。

外掛頁雖然寫明能處理 Google Sheets,但直接貼試算表網址屬於 Pro 功能;免費外掛的做法是先把試算表下載成 CSV 或 xlsx,再當作一般檔案上傳。

資料混亂時,先用 AI 工具標準化

WP All Import 本身沒有內建 AI 功能,後台畫面與變更紀錄都找不到相關選項。AI 派得上用場的地方在匯入之前,先用外部工具把資料整理乾淨,再交給外掛做對應。

常見的混亂有幾類:日期同時出現 2026/3/5、03-05-2026、3 月 5 日三種寫法;全形與半形數字混用;同一個分類在不同列被寫成「馬克杯」「杯子」「Mug」;欄位前後夾著多餘空白或亂碼。以分類為例,直接匯入後網站上會出現三個指同一類商品、名稱卻不同的分類。

先從檔案挑出 10 筆左右、涵蓋各種寫法的樣本,貼給 AI 助手,請它歸納出規則並統一格式;規則確認沒問題,再請它套用到整份檔案,或直接產生可以在試算表裡使用的公式。ChatGPT、Claude、Gemini 這類通用的 AI 助手都做得到。

整理完的檔案要抽樣核對筆數有沒有少、欄位數有沒有變、特殊字元有沒有被改掉內容。資料如果含有姓名、電話等個人資料,就要先去識別化,再貼給任何外部工具。

步驟一,上傳檔案並選定匯入目標

整個流程從「All Import → New Import」開始。外掛頁寫的是四個步驟,WP All Import 的說明文件(Quickstart)與後台畫面則分成 Step 1 到 Step 5,依序是上傳、確認檔案、對應欄位、匯入設定、確認並執行。兩種說法並不衝突,步驟二可以略過,直接按 Set Up Import 的話,實際經過的畫面就是四個。

畫面最上方有三個來源按鈕:Upload a file(上傳檔案)、Download a file(下載檔案)、Use existing file(使用既有檔案)。免費外掛能用的是上傳,另外兩個按下去會出現升級提示,屬於 Pro 功能。上傳時要先點 Upload a file 這個分頁,再把檔案拖進虛線框或點選挑檔,完成後畫面會顯示 Upload Complete 與檔名、檔案大小。

檔案上傳完成,下方會出現「Create or modify」下拉選單,這一步決定資料要變成 WordPress 裡的什麼東西。選項包括文章、頁面,以及站上註冊的各種自訂文章類型,主題與外掛新增的類型(例如 WooCommerce 的 Products)也會一併列出。Users 與 WooCommerce 相關的目標需要對應的加值模組(Add-On),Taxonomies(分類詞彙本身)與 Comments(留言)選了會顯示需要 Pro 的提示。

選好目標之後,畫面下方有兩顆按鈕,代表兩條路。

  • Create Filters(建立篩選):先篩掉不想匯入的資料列,再進入步驟二。
  • Set Up Import(開始設定匯入):標示為 Import Everything,全部匯入,直接跳到步驟三的欄位對應。

檔案裡沒有需要排除的資料,就走第二條,省掉一個畫面。

WP All Import 步驟一上傳 CSV 完成,匯入目標選文章,下方可選 Create Filters 或 Set Up Import
上傳完成後會顯示檔名與大小,選好匯入目標,再決定要先篩選還是全部匯入。

步驟二,確認解析結果並篩選資料列

按了 Create Filters 才會進到這一步,它處理的是檔案裡不想匯入的資料列,像是停售的品項、測試用的資料、重複的列。外掛提供的是視覺化的篩選器,不必手寫 XPath。

分隔符和記錄節點要先確認正確

進入畫面後,外掛已經讀完檔案,第一件事是確認它讀對了沒有。CSV 要看分隔符是否正確,欄位有沒有被切開;分隔符選錯時,整列資料會擠成一個欄位,後面的對應全部失效。XML 則要確認記錄節點選對,也就是外掛把哪一個標籤當成「一筆記錄」。

畫面上可以逐筆翻看來源資料,會顯示目前是第幾筆、共有幾筆。多翻幾筆,特別是資料排在中間與最後的幾列,能提早發現某些列的欄位少了、日期格式不同。確認無誤,再按 Continue to Step 3(繼續到步驟三)進入下一步。

WP All Import 步驟二預覽 CSV 解析結果,可逐筆翻看 8 筆資料並確認分隔符為逗號
進入步驟二先翻幾筆資料,確認分隔符正確、每個欄位都切開了。

篩選規則由欄位、規則與值組成

一條篩選規則由三個零件組成:Element(要看哪個欄位)、Rule(用什麼方式比較)、Value(比對的值)。操作順序是先展開 Add Filtering Options(新增篩選選項)區塊,選 Element、選 Rule、填 Value,按 Add Rule(加入規則)把它放進清單,最後按 Apply Filters To XPath(套用篩選)才會真正生效。

Rule 的種類有 10 種:equals(等於)、not equals(不等於)、greater than(大於)、equals or greater than(大於或等於)、less than(小於)、equals or less than(小於或等於)、contains(包含)、not contains(不包含)、is empty(是空的)、is not empty(不是空的)。其中 is empty 與 is not empty 不需要填值。

以龐果設計的虛構商品清單為例,假設只想匯入價格不低於 300、而且描述欄不是空的商品。第一條規則選 price、equals or greater than、填 300;第二條選 description、is not empty。兩條規則都成立的列才會進來,標價偏低或描述還沒寫的列就不會被匯入。

WP All Import 篩選器加入 price 大於或等於 300 與 description 不是空的兩條規則,套用後剩 4 筆
兩條規則都成立的列才會匯入,按下 Apply Filters To XPath 後,8 筆資料篩到剩 4 筆。

匯入建好之後想改篩選條件,路徑是 All Import → Manage Imports,找到那一筆匯入,點 Edit Template。篩選區塊會出現在欄位對應畫面的最上方,名稱換成 Manage Filtering Options(管理篩選選項),操作方式和新匯入時相同,改好規則再按一次 Apply Filters To XPath,最後儲存範本。篩選器處理不了的少數情況,也可以直接手寫 XPath,不過多數資料用視覺化篩選器就夠了。

AND、OR 條件與縮排群組的用法

單一條件不夠用時,多條規則可以用 AND 與 OR 串起來。AND(&&)表示兩個條件同時成立,OR(||)表示任一個成立即可,條件數量沒有限制。

條件更複雜時,把規則縮排就能分組,效果等同括號,可以表達「A 且 B」或「C 且 D」這類邏輯。說明文件的說法是,組合 AND、OR 與縮排,能做出任何想要的篩選邏輯。

延續龐果設計的商品清單,假設想匯入兩類商品,周邊類而且價格不低於 300 的,加上所有文具類的。寫成條件就是(分類等於「周邊」且價格大於或等於 300)或(分類等於「文具」)。前兩條規則縮排成同一組,第三條獨立,周邊類只有價格夠高的才進來,文具類則不論價格全數匯入。

WP All Import 篩選規則縮排成同一組,效果等同把 AND 條件包進括號,再用 OR 接上另一條規則
前兩條規則縮排成一組,等於(周邊且價格不低於 300)或(文具)。

步驟三,把來源欄位拖進 WordPress 欄位

這是整支外掛最核心的畫面。右邊是從檔案讀出來的所有欄位,連同第一筆記錄的實際內容;左邊是 WordPress 的欄位,包括標題、內容、摘要等。用滑鼠把右邊的欄位拖到左邊,對應就完成了。畫面上也看得到 Images、Custom Fields、Function Editor 三個區塊,這幾個屬於 Pro 功能。

拖拉語法可以組合多個欄位與固定文字

左側上方是標題欄與內容編輯器,下方還有 Excerpt(摘要)欄;右側的欄位清單可以切換看第 1 筆、第 2 筆的內容。把欄位拖進標題欄,會變成 {product_name[1]} 這種寫法,大括號裡是檔案的欄位名稱,後面的 [1] 是外掛套在每筆記錄上的位置標記,照著拖過去就好,不需要自己寫。

同一個欄位裡可以放多個元素,也可以夾固定文字。例如標題欄寫成 {product_name[1]} 龐果設計限定款,每一筆商品的標題都會加上同一段後綴;內容欄可以放 {description[1]},再自己補一段固定的說明。不需要的欄位留空即可;標題或內容留空時,外掛會顯示警告,但仍然可以繼續。

WP All Import 步驟三的拖拉畫面,標題欄填入 product_name 欄位加上固定文字,右側列出 CSV 欄位與第一筆內容
右邊是檔案讀出的欄位與第一筆內容,拖到左邊就完成對應,也能夾固定文字。

內容編輯器有「預覽」與「程式碼」兩個頁籤,要貼 HTML 時用程式碼頁籤。編輯器下方的 Advanced Options(進階選項)有兩個勾選項:Keep line breaks from file(保留檔案裡的換行),來源資料的段落是用換行分隔時很有用;Decode HTML entities with html_entity_decode(解碼 HTML 實體),檔案裡的 & 這類寫法會被還原成一般字元。

分類與標籤的階層式匯入

文章匯入最容易出狀況的是分類。來源資料常把一整串階層寫在同一格,例如「周邊 > 杯類 > 馬克杯」,外掛要能把它拆成三層,並建出正確的父子關係。勾選 Taxonomies, Categories, Tags 區塊裡的「分類」後,有三種設定:

  • 每篇文章只有一個分類:可以另外勾選 Try to match terms to existing child(嘗試比對站上已有的子分類)。
  • 每篇文章有多個分類:同一格填多個分類,用 Separated by 指定的分隔符分開。
  • 階層式(父子層):資料裡有父子關係時選這個。

階層式又分兩種資料形狀。一種是一個欄位裡含整串階層,在欄位填入 {category[1]},並指定分隔符,預設是 >;如果同一格有多組階層,勾選 Separate hierarchy groups via symbol(用符號分隔多組階層),還能用 Add Another Hierarchy Group(新增另一組階層)加第二組。另一種是勾選 Manually design the hierarchy with drag & drop(用拖拉手動設計階層),在畫面上用拖拉決定哪個欄位是父層、哪個是子層。

WP All Import 分類設定選階層式,填入 category 欄位並以 > 分隔,把整串分類拆成父子層
資料把整串階層寫在同一格時,選階層式、填入欄位並指定分隔符 >。

站上沒有的分類,外掛會自動建立;不想新增分類,只想用既有的,可以勾選 Do not create new terms(不建立新詞彙)。名稱對不上站上既有分類時,勾選 Enable Mapping for 分類(啟用分類對映),可以把檔案裡的名稱對映到站上已有的分類,例如把檔案裡的「杯子」對到站上的「馬克杯」。標籤和分類在同一個區塊,另外勾選即可,做法比分類簡單。自訂文章類型有自己的分類法時,也會列在這個區塊。

WP All Import 匯入後,文章分類頁自動建立周邊、杯類、馬克杯等三層父子分類
站上原本沒有的分類,匯入時依檔案裡的階層自動建好父子關係。

文章狀態、日期、作者和網址別名的設定

標題、內容與分類之外,每篇文章還有一批屬性,外掛集中放在 Other Post Options(在繁體中文後台會顯示成「Other 文章 Options」)區塊。匯入時就能一併決定,不必匯完再逐篇修改。

  • Post Status(文章狀態):選 Published 直接發佈、Draft 存成草稿,或用 Set with XPath 依檔案裡的某個欄位決定。想先檢查再上線,選草稿最安全。
  • Post Dates(日期):As specified 依檔案指定,日期格式只要是 PHP 的 strtotime 讀得懂的都行;Random dates 在指定範圍內隨機分配。
  • Comments 與 Trackbacks and Pingbacks:決定匯入的內容是否開放留言與引用通知,可統一設成開放或關閉,也能依檔案欄位決定。
  • Post Slug(網址別名)與 Post Author(作者):網址別名可以直接拖入檔案欄位;作者可以填使用者 ID、使用者名稱或電子郵件,把文章指派給站上已有的帳號。
  • Post Format、Page Template、Menu Order:分別決定文章格式、頁面範本與排序值,匯入頁面或要控制排列順序時用得到。
WP All Import 的 Other 文章 Options 區塊,文章狀態選草稿,下方依序是日期、留言、引用通知、網址別名與作者
文章狀態、日期、留言開關、網址別名與作者,都能在匯入時一併設定。

Download & Import Attachments 區塊另有一個勾選項 Search for existing attachments to prevent duplicates in media library(搜尋既有附件以避免媒體庫重複),勾選後會先找媒體庫裡已有的附件,同一個檔案不會重複匯入。

預覽匯入結果,再把設定存成範本

正式執行前,步驟三有兩個動作很值得做。第一個是預覽,Excerpt(摘要)欄下方有一顆 Preview(預覽)按鈕,按下去會把資料套進標題與內容,寫入網站之前就能逐筆翻看結果;結果不對就回頭改對應,改到滿意再繼續。畫面最下方還有另一顆可切換後台、前台檢視的 Preview 按鈕,按下去會出現升級提示,屬於 Pro 功能。

WP All Import 預覽視窗把第一筆資料套進標題與內容,顯示經典馬克杯龐果設計限定款
寫入網站之前先預覽,確認標題與內容套出來的樣子,結果不對再回頭改對應。

另一個動作是勾選 Save settings as a template(把設定存成範本),輸入名稱。下一次做類似的匯入,在步驟三用 Load Template(載入範本)下拉選單選回來,就不用重新拖拉。已存的範本可以在「All Import → Settings → Import/Export Templates」管理,能匯出,也能刪除。

確認對應都正確,按 Continue to Import Settings 進入步驟四。

步驟四,決定新增紀錄或比對既有內容

步驟四決定這批資料進來是全部建成新的,還是去和網站上已有的內容對上、更新它。很多資料不是搬一次就結束,改過價格、補過說明之後,同一批資料還會再來一次;外掛怎麼判斷「這筆是新的還是舊的」、更新時怎麼避免洗掉不該動的欄位,都在這個畫面設定。

畫面頂端有兩個單選,Create new(為檔案裡的每筆記錄建立新項目)與 Attempt to match to existing(先嘗試比對既有項目,再建立新的),說明文件稱為 Create new 與 Match existing 兩種匯入類型。

唯一識別欄位讓重跑不產生重複

Create new 這條路靠 Unique Identifier(唯一識別欄位)來記住「哪一筆資料是這個匯入建出來的哪一篇」。第一次跑會建立新文章;之後拿更新過的檔案再跑一次,外掛會用識別欄位把檔案裡的記錄連回上次建的文章,更新原本那幾篇,而不是又建一批。

識別欄位可以按旁邊的 Auto-detect(自動偵測)讓外掛挑一個,也可以自己拖拉一個或多個元素組合。挑選的原則是每一筆都不重複,而且檔案更新後仍然不變。商品編號、SKU、原系統的 ID 都適合;標題只有在確定不會改名時才適合,描述與價格則不行,因為它們會變。如果檔案裡有多筆記錄的識別值相同,只有第一筆會被建立,其餘會被視為重複。

Create new 只會更新「這個匯入自己建立的」文章,不會動到站上其他文章。再跑時有兩個預設都勾選的選項:Create new posts from records newly present in your file(檔案新增的列就新建)與 Update existing posts with changed data in your file(有變動就更新)。

WP All Import 步驟四選 Create new,唯一識別欄位填 sku,重跑時新增與更新兩個選項預設勾選
用每一筆都不重複、也不會變動的 SKU 當唯一識別欄位,重跑時就能連回同一篇文章。

識別欄位選得不好(空白、固定不變或有重複),後果之一是重跑時整批記錄被跳過。想改識別欄位,路徑是 Manage Imports → Settings,不過說明文件建議先刪掉這個匯入建立的所有紀錄再改,否則重跑會產生重複。

比對網站既有內容的四種依據

Attempt to match to existing 不靠外掛自己的紀錄,直接去網站上找對得上的內容來更新,因此手動建立的文章、別的匯入建的文章也都能被更新。比如手上有一份新的價格表,想更新站上已有的商品或頁面,就適合這條路。

選了這個選項後,有四種比對依據:

  • Title:用標題比對,標題一樣就視為同一篇。
  • Content:用內容比對。
  • Custom field:填入自訂欄位的名稱,以及對應的來源值來比對。
  • Post ID:填入文章 ID 的來源欄位,前提是檔案裡有站上文章的 ID。
WP All Import 選 Attempt to match to existing 後,可用 Title、Content、Custom field 或 Post ID 比對站上既有文章
比對既有內容有四種依據,用標題或文章 ID 比對最直接。

說明文件的範例思路,是拿檔案裡一個站上也存在的編號當比對值;設定欄位對應時,只填要更新的欄位,其他留空。比對值重複時,只會更新找到的第一筆;比對不到時,這個匯入類型也能建立新的一篇。另外要注意,它不能拿另一個匯入的 Unique Identifier 來比對。

四種依據裡,Custom field 要站上已經有自訂欄位才有東西可比,用 Title 或 Post ID 比對是最直接的做法。在測試站的實際操作中,先用 Create new 從 8 筆資料篩出 4 筆商品匯入,再用 Attempt to match to existing 以 Title 比對,匯入一份含 2 筆修改資料的新檔,確認頁寫著會把資料合併進既有文章,結果頁顯示更新了 2 筆。

選擇性更新的欄位範圍與分類處理方式

更新既有文章時,最怕只想改價格,結果標題、內容被空值蓋掉。勾選 Update existing posts 之後,有兩個選項:Update all data(全部更新)與 Choose which data to update(勾選要更新的欄位)。這個選項在 Create new 路線也有,用來更新自己建過的紀錄。

選擇 Choose which data to update,可以勾選的欄位有 Post status、Title、Author、Slug、Content、Excerpt/Short Description、Dates、Menu order、Parent post、Post type、Post format、Comment status、Trackbacks and pingbacks、Attachments、Images、Custom Fields,以及 Taxonomies(含分類與標籤)。清單預設全部勾選,只想改價格或內容,就要把用不到的項目取消勾選。說明文件也提醒,選了更新全部卻沒有對應好欄位,可能會把既有資料洗掉,所以只讓有對應的欄位進更新清單才安全。

WP All Import 選 Choose which data to update 後列出可更新的欄位,分類預設為移除既有分類再加入新分類
可更新的欄位預設全部勾選,分類的預設處理方式是先移除既有分類。

分類與標籤特別需要留意,因為預設的處理方式是 Remove existing taxonomies, add new taxonomies,也就是把既有分類換成檔案裡的。測試站上實際跑過一次,第二次匯入用 Match existing 比對,範本沒有對應分類欄位、分類處理方式卻維持預設,結果被更新的兩筆龐果設計商品,第一次匯入時建立的分類被清掉,文章列表顯示變回「未分類」;沒被更新的另外兩篇,原本的分類都還在。

以 Match existing 更新兩筆商品後,因範本沒對應分類,這兩篇文章的分類變回未分類
第二次匯入只更新了兩筆,範本沒對應分類又維持預設,這兩篇原本的分類被清掉,另外兩篇不受影響。

分類與標籤共有四種處理方式:

  • Leave these taxonomies alone, update all others:指定的分類法不動,其餘都更新。
  • Update only these taxonomies, leave the rest alone:只更新指定的分類法,其餘不動。
  • Remove existing taxonomies, add new taxonomies:移除既有分類,換成檔案裡的新分類。
  • Only add new:只補新的,不砍舊的。

只想更新內容或價格時,把 Taxonomies 取消勾選,或選 Leave these taxonomies alone;想要只補不砍,選 Only add new。

步驟五,確認摘要並執行匯入

最後一步會先給一頁匯入摘要讓使用者核對,確認後才真正執行。

匯入摘要頁與跑完後的結果訊息

按下 Continue 之後,先看到「Your file is all set up!」與 Import Summary(匯入摘要)。摘要頁會列出幾項資訊:目前伺服器的 max_execution_time(單次執行時間上限)、匯入的檔案與大小、檔案裡要處理幾列、唯一識別欄位。還有兩行和主機的執行時間上限有關,一行是 Piece By Piece Processing(分批處理)每批處理幾筆,另一行是檔案每幾筆切成一塊,大檔案出狀況時,要調整的就是這兩個數字。

WP All Import 步驟五的匯入摘要,列出執行時間上限、檔案、篩選條件、唯一識別欄位與分批設定
執行前先核對摘要,分批處理的筆數與分塊大小也列在這裡。

核對沒問題,按綠色的 Confirm & Run Import(確認並執行匯入)。處理完成後會顯示 Import Complete!,並附上一句結果,例如「All 4 records from pongo_products.csv were successfully processed」,接著是外掛建立或更新了幾筆記錄。畫面下方的 Log 區會逐筆列出處理日誌,旁邊有 View Logs 與 Manage Imports 兩個連結。

WP All Import 匯入完成頁顯示 4 筆記錄全部處理成功並建立 4 筆新文章,下方附逐行日誌
匯入完成後會說明處理了幾筆、建立或更新了幾筆,下方日誌逐行列出處理過程。

跑完之後,立刻到後台的文章列表抽驗幾筆,看標題、分類、內容有沒有照預期進來。結果不對時,先別急著重跑,回到 Manage Imports 修改範本或設定,比較容易找出原因。

Manage Imports 的重跑與歷史紀錄

建好的匯入不會消失,會留在 All Import → Manage Imports 的列表裡。每一筆匯入旁邊有幾個操作:Run Import(重新執行)、Edit Template(回到步驟三,修改欄位對應與篩選)、Settings(回到步驟四,修改比對與更新設定)、Delete(刪除)、History Logs(歷史日誌)。

WP All Import 的 Manage Imports 列表,每筆匯入可重新執行、修改範本與設定、刪除或查看歷史日誌
建好的匯入都留在 Manage Imports,可以重跑,也能回頭修改範本與設定。

每執行一次,歷史日誌就會留下一筆紀錄,標示是手動執行(manual run)還是排程觸發(triggered by cron),也能下載日誌,匯入結果不如預期時,第一個該看的就是這裡。保留幾份日誌,可以在 All Import → Settings 的 Log Storage 調整,填 0 代表不保留。從列表上的狀態提示,像是 settings edited since last run(上次執行後設定被修改過)、Import failed, please check logs、Import canceled,也能一眼看出每筆匯入現在的狀況。

WP All Import 歷史日誌列出每次執行的時間、耗時、手動執行類型與結果,並可下載日誌
每執行一次就留下一筆紀錄,匯入結果不如預期時先從這裡查。

用新檔案重跑時,新檔案的欄位名稱與結構要和原本設定匯入時的檔案一致,CSV 的分隔符也不能換,否則外掛會警告這個檔案的結構和上次不同,無法沿用目前的設定匯入。列表上的 Scheduling Options(排程選項)是灰色的,排程匯入屬於 Pro 功能。

搭配 WP All Export 做批次編輯與搬遷

WP All Import 有個同公司的姊妹外掛 WP All Export,在 wordpress.org 上獨立上架,需要另外安裝。兩支搭配起來,可以把站上資料匯出成試算表、改完再匯回去做批次編輯,也可以把資料帶到另一個網站,WP All Import 的外掛簡介就點名了這個搭配。WP All Export 的外掛頁同樣標示 100,000+ 的使用中安裝數。

想一次修改一批既有文章、又不想一篇篇進後台時,批次編輯的順序如下。

  1. 到 All Export → New Export,選要修改的文章類型,按 Customize Export File。
  2. 在拖拉畫面把要修改的欄位拖進匯出清單,按 Continue。
  3. 在匯出設定頁按 Confirm & Run Export,完成後下載 CSV。
  4. 用試算表軟體修改檔案內容。
  5. 回到 WP All Export 按 Import with WP All Import 按鈕,外掛會自動帶好欄位對應,上傳改好的檔案後一路往下,最後在摘要頁按 Confirm & Run Import 即可更新。

有兩個地方容易踩雷。第一,匯出時一定要包含辨識用的欄位,例如文章 ID,外掛才能知道每一列對應站上的哪一篇,缺少時會顯示提示。第二,匯出檔案的欄位名稱與檔案結構不能動,改完要存回同樣的格式,CSV 的分隔符也要保持一致,否則匯入時會出現「There’s a problem with your import file」。想更新全部文章,匯出時就不要加篩選條件。

用 WP All Export 匯出 CSV、以試算表修改後再用 WP All Import 匯回,更新站上既有文章的流程
匯出時帶上文章 ID、改完維持原本的欄位結構,匯回後更新的就是站上原本那幾篇。

搬到另一個網站時,可以用 WP All Export 的 Bundle。匯出完成後下載 Bundle,這個 zip 檔裡除了資料還有一份匯入範本,不必解壓縮,直接到目標站的 New Import 上傳,欄位對應與設定就會自動帶好。說明文件的搬遷示範還涵蓋圖片與使用者:附在文章上的圖片與自訂欄位會跟著一起搬,使用者則要另外匯出一份 Bundle 再匯入;其中圖片與自訂欄位的匯入,在 WP All Import 屬於 Pro 功能。正式搬遷前,先拿少量資料試跑,確認分類階層與欄位都對得上。想複製既有匯入的設定,也可以到 Manage Imports 的 Settings,在 Configure Advanced Settings 區的 Downloads 下載 Import Template 或 Import Bundle,再到新的匯入中使用。

大量匯入的分批處理和備份準備

匯入一次就寫進上百上千筆資料,出錯的代價比單篇編輯大。大檔案在主機上跑不完、匯入出錯想還原,這兩種狀況都得在正式執行前先做好準備。

每批處理筆數與檔案分塊設定

外掛不會一口氣把整份檔案寫進網站,而是拆成小批次處理,目的是避開主機的執行時間上限。每一批預設處理 20 筆,說明文件稱為 iteration,每一批都必須在伺服器的 max_execution_time 內處理完,否則匯入會失敗。匯入進行到一半出錯時,第一個要調的就是 Import Speed Optimization 裡的「In each iteration, process N records」,把每批筆數調低。這個數字沒有放諸四海皆準的建議值,要看主機的效能。

另一個設定是檔案分塊,預設把檔案切成 1,000 筆一塊。它的用意是避免大檔案後段愈跑愈慢。如果不分塊,處理最後 1,000 筆時,每一批都得從檔案開頭往後讀;分塊之後,只需要從最後一塊的開頭讀起。

Configure Advanced Settings 還有幾個進階選項。Import only specified records 只匯入指定的列,例如填 1,5,7-10 會匯入第 1、5、7 到 10 筆,拿來先試跑幾筆很方便。Delete source XML file after importing 會在匯入完成後刪除來源檔,但這一項只在來源是 FTP 或 Use existing file 時才會出現,這兩種來源在免費外掛都屬於 Pro 功能,用上傳檔案建立的匯入看不到它。Use StreamReader instead of XMLReader to parse import file 改用另一種讀檔方式,XMLReader 速度較快,但遇到特定資料時偶爾會讓某些記錄匯不進來。Increase speed by disabling do_action calls in wp_insert_post during import 是給有開發經驗的人用的,停用匯入時的 do_action 呼叫可以提升速度,但可能影響主題或外掛的掛鉤。

WP All Import 的 Configure Advanced Settings,每批預設處理 20 筆、檔案切成 1000 筆一塊,下方是只匯入指定列等選項
匯入到一半出錯時,先把每批處理筆數調低。

外掛整體的設定(All Import → Settings)也有兩個相關項目,Chunk Size 調整分塊的筆數,Clean Up Temp Files 清理匯入中斷後留下的暫存檔。

WP All Import 的 Settings 頁,包含範本管理、預設開啟的安全模式、日誌保留份數、暫存檔清理與分塊筆數
外掛整體設定集中在 All Import 的 Settings,安全模式預設開啟,保持即可。

備份、測試站與外掛更新

匯入會直接寫入資料庫,更新模式還可能覆蓋既有內容,所以跑之前先備份網站與資料庫,是最基本的習慣。接著在測試站跑一遍,或用 Import only specified records 先匯入前幾筆,確認欄位對應與分類階層都對,再跑全量。

外掛本身也要保持更新。wordpress.org 的變更紀錄多次列出安全性修補,包括 4.1.4 讓上傳的 ZIP 檔一律解壓到該次匯入自己的資料夾、並略過無法安全清理的 SVG 圖片,4.1.2 更新了讀取 Excel 用的 PhpSpreadsheet 元件,4.1.1 加強了對內嵌 PHP 執行的限制,4.0.1 與 4.0.0 各修復了一個有 CVE 編號的漏洞,所以不要停在舊版本。

外掛還有一個安全設定值得確認,就是 All Import → Settings 裡的 Secure Mode(安全模式),預設是勾選的。開啟後,匯入的檔案、分塊檔、日誌與暫存檔,會放在 wp-content/uploads/wpallimport 底下以隨機名稱命名的資料夾裡,降低檔案被猜中網址的風險,保持開啟即可。

WP All Import Pro 的功能、方案與價格

WP All Import 的 wordpress.org 外掛頁列出了 Pro 版另外提供的功能與加值模組,前面幾個步驟裡按下去會出現升級提示的選項,也都屬於這一塊。

Pro 另外提供的功能有:

  • 圖片匯入:從網址下載圖片放進媒體庫,使用媒體庫既有的圖片或伺服器上傳目錄裡的圖片,並可設定第一張為特色圖片。
  • 自訂欄位匯入:把資料對應到站上的自訂欄位。ACF、Meta Box、JetEngine 等欄位外掛,由對應的加值模組處理。
  • 從網址或 FTP/SFTP 下載檔案:可以搭配 HTTP 認證下載,也包含 Use existing file 這個來源,Google Sheets 的公開網址也屬於這一類。
  • 排程匯入:可以用手動 cron 設定,或使用 WP All Import 提供的付費 Automatic Scheduling Service(自動排程服務)。
  • 自訂 PHP 函式與 Function Editor:在匯入過程中用 PHP 函式處理資料。
  • 更多重跑選項:包括 Skip posts if their data in your file has not changed(資料沒有變動就跳過),以及 Remove or modify posts that are not present in this import file(處理檔案裡已不存在的文章)。
  • 匯入分類詞彙本身與留言:Taxonomies 與 Comments 這兩個匯入目標。替匯入的文章指定分類與標籤不在此限,外掛本身就能做。
  • email 技術支援:Pro 提供保證回應的 email 技術支援;外掛頁也說明,免費外掛的支援不做保證。

加值模組有 WooCommerce、ACF、Meta Box、JetEngine、Gravity Forms、User 等。wordpress.org 上也有同公司推出的免費加值模組,例如 WP All Import – Import Add-On for ACF(版本 1.0.9,50,000+ 啟用,只支援基本欄位)、WP All Import – Product Import for WooCommerce(版本 1.5.6,20,000+ 啟用)與 Import SEO Settings for Yoast SEO(版本 2.0,20,000+ 啟用)。WooCommerce 的變化商品、外部或組合商品、網址匯入與排程等進階項目,則屬於 Pro。

價格會變動,以定價頁當下標示為準,目前頁面所見的方案包括:Import 單品方案 US$99/年;Import Pro Package(Import Pro 加六個加值模組)US$199/年;WooCommerce Import 方案 US$169/年;終身授權 US$1,299 一次付費。所有方案都是無限安裝,也可以用在客戶的網站,並附 90 天退款保證。頁面上的方案雖然以年計價,定價頁同時註明,目前購買的外掛仍附終身授權,WP All Import 正在測試、準備改為年費制,購買前以結帳畫面的授權說明為準。

紙箱終究會拆完,而 WP All Import 把這件事變成一套可以檢查、可以重跑的流程。第一次上手,先拿一份只有 10 筆資料的小檔案,在測試站走完五個畫面,確認分類階層與更新結果都符合預期,再把正式資料交給它。

常見問答

本區問答由 AI 依文章內容自動整理,僅供快速參考,正式內容仍以全文為準。

WP All Import 跟內建匯入工具有什麼不同?

WordPress 內建匯入工具只接 WordPress 自己匯出的檔案,整份全部進來;WP All Import 能讀取 CSV、XML、Excel 等各種來源,還能篩選、對應、修改進來的資料,適合處理舊 CMS 或供應商資料表。

WP All Import 的匯入流程分成哪幾個步驟?

WP All Import 的後台分成 5 個步驟,依序是上傳檔案並選定目標、確認解析結果並篩選資料列、拖拉對應欄位、決定新增或比對既有內容,最後確認摘要並執行。沒有要排除的資料時,按 Set Up Import 就能略過篩選。

WP All Import 怎麼匯入有父子層的分類?

WP All Import 在分類設定選「階層式」,欄位若含整串階層,例如「周邊 > 杯類 > 馬克杯」,填入該欄位並指定分隔符即可,預設是 >。也能用拖拉手動設計父層與子層,站上沒有的分類會自動建立。

WP All Import 更新時怎麼保住原本的分類?

WP All Import 預設會移除既有分類、換成檔案裡的,範本沒對應分類欄位時,文章會變回未分類。只想更新內容或價格,就把 Taxonomies 取消勾選;想只補不砍,改選 Only add new。

WP All Import 大檔案匯入失敗怎麼辦?

WP All Import 會把檔案拆成小批次處理,每批預設 20 筆,每一批都要在主機的執行時間上限內完成,否則匯入會失敗。中途出錯時,先到 Import Speed Optimization 調低每批處理筆數,合適的數字看主機效能而定。

WP All Import 支援哪些檔案格式?

WP All Import 能讀取 CSV、Excel、XML,以及 tsv、json、sql 等格式,也接受 zip 與 gz 壓縮檔。Google Sheets 要先下載成 CSV 或 xlsx 再上傳,直接貼網址屬於 Pro 功能。

WP All Import 怎麼篩掉不想匯入的資料?

WP All Import 在步驟一按 Create Filters 進入篩選畫面,每條規則由欄位、比較方式與比對值組成,比較方式有等於、大於、包含、是空的等 10 種。多條規則可以用 AND 與 OR 串起來,再用縮排分組。

WP All Import 重跑時怎麼避免重複建文章?

WP All Import 靠 Unique Identifier 記住每筆資料建出的是哪一篇,拿新檔案重跑時,會更新原本那幾篇,而不是又建一批。識別欄位要選每筆都不重複、檔案更新後也不變的值,例如商品編號、SKU 或原系統的 ID。

WP All Import 能用來批次編輯文章嗎?

WP All Import 搭配 WP All Export 就能批次編輯,把要改的欄位匯出成 CSV、用試算表改好,再按 Import with WP All Import 匯回。匯出時要包含文章 ID 這類辨識欄位,檔案結構也不能動。

WP All Import Pro 多了哪些功能?

WP All Import Pro 另外提供圖片匯入、自訂欄位匯入、從網址或 FTP 下載檔案、排程匯入、自訂 PHP 函式,以及資料沒變就跳過等更多重跑選項,也能匯入分類詞彙本身與留言,並附保證回應的 email 技術支援。

資料來源
  1. WP All Import – Drag & Drop Import for CSV, XML, Excel & Google Sheets — WordPress.org
  2. WordPress Importer — WordPress.org
  3. WP All Export – Drag & Drop Export to Any Custom CSV, XML & Excel — WordPress.org
  4. WP All Import – Import Add-On for ACF — WordPress.org
  5. WP All Import – Product Import for WooCommerce — WordPress.org
  6. WP All Import – Import SEO Settings for Yoast SEO — WordPress.org
  7. How to Import Any CSV, XML, Excel or Google Sheets File to WordPress — WP All Import
  8. Filtering Import Data with XPath — WP All Import
  9. Import Types Available in WP All Import — WP All Import
  10. Define Unique Identifier Correctly — WP All Import
  11. Use WP All Import to Update Existing Posts On Your Site — WP All Import
  12. How to Bulk Edit WordPress Posts — WP All Import
  13. How to Migrate WooCommerce and WordPress Data — WP All Import
  14. Schedule XML & CSV Imports Using Cron Jobs — WP All Import
  15. WP All Import Pricing — WP All Import