v10.0

Documentation使用說明

Complete guide to installing and using PlacesImporter with ListingPro.

PlacesImporter 完整安裝與使用指南。

Requirements系統需求

Component項目Minimum最低需求
WordPress5.8+
PHP7.4+
ListingPro Themev2.6+
SerpApi KeyFree tier available有免費方案
Google AI Studio KeyFree tier available (AI features)有免費方案（AI 功能用）

Installation安裝方式

01

Upload the Plugin上傳外掛

In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the places-importer.zip file and click Install Now.

進入 WordPress 後台，前往 外掛 → 安裝外掛 → 上傳外掛，選擇 places-importer.zip 後點擊立即安裝。

02

Activate the Plugin啟用外掛

After installation, click Activate Plugin. A new menu item Places Importer will appear in your WordPress admin sidebar.

安裝完成後點擊 啟用外掛，WordPress 後台側邊欄會出現 Places Importer 選單。

03

Verify ListingPro is Active確認 ListingPro 已啟用

PlacesImporter requires ListingPro theme to be active. The plugin will show a notice if it cannot detect ListingPro.

PlacesImporter 需要 ListingPro 佈景主題已啟用。若偵測不到，外掛會顯示提示訊息。

API SetupAPI 金鑰設定

SerpApi

SerpApi is used to fetch live Google Maps data. Get your free API key at serpapi.com.

SerpApi 負責抓取 Google 地圖的即時資料。前往 serpapi.com 取得免費金鑰。

Tip: SerpApi's free plan includes 100 searches/month — enough to import hundreds of businesses.SerpApi 免費方案每月 100 次搜尋，足以匯入數百間店家。

Google AI Studio (Gemini)

Required only for AI features (review translation, auto-tagging). Get a free key at aistudio.google.com.

僅 AI 功能需要（評論翻譯、自動標籤）。前往 aistudio.google.com 取得免費金鑰。

Entering Your Keys填入金鑰

Go to Places Importer → Settings in your WordPress admin. Paste your keys and click the Test button to verify connectivity.

進入 WordPress 後台的 Places Importer → 設定，貼上金鑰後點擊測試按鈕確認連線正常。

Importing Businesses匯入店家

Navigate to Places Importer → Import and follow these steps:

前往 Places Importer → 匯入，按照以下步驟操作：

  1. Enter a search query — e.g. "Tokyo restaurants" or "London gyms"
  2. 輸入搜尋條件 — 例如「東京 餐廳」或「倫敦 健身房」
  3. Set minimum rating — default is 3.0★, adjustable from 0–5
  4. 設定最低星等 — 預設 3.0★，可調整 0–5
  5. Choose import options — toggle photos, reviews, hours, social links
  6. 選擇匯入選項 — 可單獨開關照片、評論、營業時間、社群連結
  7. Click Import — each business is processed and created as a ListingPro listing
  8. 點擊匯入 — 每個店家自動建立為 ListingPro 列表
Duplicate Protection:防重複： Businesses already imported are grayed out in the list — you won't accidentally re-import them.已匯入的店家在列表中會顯示灰色，不會重複匯入。

AI FeaturesAI 功能

When a Gemini API key is configured, PlacesImporter enhances each imported listing with:

設定 Gemini API 金鑰後，每筆匯入的店家資料將自動強化：

  • Review Translation — Customer reviews are translated into your site's language
  • 評論翻譯 — 顧客評論自動翻譯成網站語言
  • Review Summarization — A concise summary is generated from top reviews
  • 評論摘要 — 從精選評論自動生成簡潔摘要
  • Auto-Tagging — 5–8 relevant tags are generated and applied to the listing
  • 自動標籤 — 自動生成 5–8 個相關標籤並套用
  • Category Matching — AI selects the best matching ListingPro category
  • 分類比對 — AI 自動選擇最適合的 ListingPro 分類
  • SEO Image Alt Text — Descriptive alt text is generated for all imported photos
  • 圖片 SEO Alt 文字 — 自動為所有匯入照片生成描述性 Alt 文字

Background Auto Sync背景自動同步

PlacesImporter can automatically refresh imported listings on a schedule via WP-Cron.

PlacesImporter 可透過 WP-Cron 定期在背景自動更新已匯入的店家資料。

How to Enable如何啟用

Go to Places Importer → Settings, enable Auto Sync, and choose an interval (7 / 14 / 30 days).

進入 Places Importer → 設定，啟用 自動同步 並選擇更新間隔（7 / 14 / 30 天）。

Note:注意： Auto Sync updates star ratings and review counts. It runs at midnight server time and processes up to 5 listings per cycle.自動同步會更新評分與評論數，每次於伺服器午夜執行，每個週期最多處理 5 筆。

Imported Fields Reference匯入欄位參考

Field欄位Source來源Notes備註
Business Name店家名稱SerpApi—
Full Address完整地址SerpApi—
Phone Number聯絡電話SerpApi—
Website URL官方網站SerpApi—
Opening Hours營業時間SerpApi—
Google RatingGoogle 評分SerpApi—
Cover Photo封面照片SerpApiDownloaded locally下載至本機
Gallery Photos相簿照片SerpApiUp to 12 images最多 12 張
GPS CoordinatesGPS 座標SerpApi—
Reviews顧客評論SerpApi + Gemini AIAI translatedAI 翻譯
Tags標籤Gemini AIAI generatedAI 自動產生
Category分類Gemini AIMatched from your existing categories從現有分類中比對
Facebook / InstagramSerpApiDetected from website URL從網站網址偵測

FAQ

Does it work if I don't have a Gemini key?沒有 Gemini 金鑰也能使用嗎？

Yes. All AI features are optional. Without a Gemini key, businesses are imported with their original data from SerpApi — no translation or AI tagging.

可以。所有 AI 功能均為選配。沒有 Gemini 金鑰時，仍可正常匯入 SerpApi 的原始資料，只是不會有翻譯和 AI 標籤。

Can I re-import a business to update it?可以重新匯入已存在的店家來更新資料嗎？

Yes. PlacesImporter detects the existing listing by Google Place ID and updates it in place rather than creating a duplicate.

可以。PlacesImporter 會透過 Google Place ID 找到既有的列表並直接更新，不會產生重複。

Is there a limit on how many businesses I can import?匯入數量有限制嗎？

No hard limit from the plugin itself. Limits depend on your SerpApi plan's monthly search quota.

外掛本身沒有限制，實際上限取決於您的 SerpApi 方案每月配額。