使用 Drupal Feeds 匯入 JSON 格式內容

2025-05-09

標籤：模組

如何在 Drupal（適用於 Drupal 10 或其他現代版本）中使用 Feeds 模組匯入 JSON 格式的內容。本指南假設您對 Drupal 基本操作（如模組安裝和內容類型管理）有一定了解。

步驟 1：安裝必要的模組

要匯入 JSON 格式內容，您需要以下模組：

使用 Composer 安裝模組： bash composer require 'drupal/feeds:^3.0' composer require 'drupal/feeds_tamper:^2.0' composer require 'drupal/feeds_ex:^1.0'
啟用模組：
前往 Drupal 後台：管理 > 擴展。
啟用 Feeds、Feeds Tamper（若使用）及 Feeds Extensible Parsers。

準備 JSON 資料：
確保 JSON 檔案格式正確，例如： json [ { "title": "文章標題 1", "body": "文章內容 1", "date": "2025-05-09" }, { "title": "文章標題 2", "body": "文章內容 2", "date": "2025-05-10" } ]
將 JSON 檔案儲存至伺服器可存取的位置（如 sites/default/files/import/data.json），或準備一個公開的 URL（如 API 端點）。
創建目標內容類型：
前往 結構 > 內容類型 > 添加內容類型，創建一個內容類型（如「文章」）。
添加對應的字段（如 標題、正文、日期），確保字段名稱與 JSON 資料的鍵名一致或可映射。

創建 Feeds 匯入器：
前往 結構 > Feeds 類型 > 添加 Feeds 類型。
設置：
- 名稱：例如「JSON 文章匯入」。
- 目標內容類型：選擇剛創建的內容類型（如「文章」）。
選擇解析器：
在「解析器」設置中，選擇 JSONPath Parser（來自 Feeds Extensible Parsers）。
配置 JSONPath 表達式，例如：
- 上下文：$.*（選擇 JSON 陣列中的每個物件）。
- 字段映射：
- title: $.title
- body: $.body
- date: $.date
映射字段：
在「映射」設置中，將 JSON 資料的鍵映射到內容類型的字段，例如：
- title（JSON） → 標題（內容類型）。
- body（JSON） → 正文（內容類型）。
- date（JSON） → 日期（內容類型）。
設置資料來源：
在「提取器」設置中，選擇資料來源：
- 檔案上傳：指定本地 JSON 檔案路徑。
- HTTP 提取器：輸入 JSON 資料的 URL（如 API 端點）。
可啟用「定期匯入」以自動從 URL 更新資料。
添加 Tamper 規則（可選）：
若需要資料轉換（如日期格式調整），前往「Tamper」標籤。
添加規則，例如將 Y-m-d 格式轉換為 Drupal 的日期格式。