Documentation使用說明
Complete guide to installing and using PlacesImporter with ListingPro.
PlacesImporter 完整安裝與使用指南。
Requirements系統需求
| Component項目 | Minimum最低需求 |
|---|---|
| WordPress | 5.8+ |
| PHP | 7.4+ |
| ListingPro Theme | v2.6+ |
| SerpApi Key | Free tier available有免費方案 |
| Google AI Studio Key | Free tier available (AI features)有免費方案（AI 功能用） |
Installation安裝方式
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 後點擊立即安裝。
Activate the Plugin啟用外掛
After installation, click Activate Plugin. A new menu item Places Importer will appear in your WordPress admin sidebar.
安裝完成後點擊 啟用外掛，WordPress 後台側邊欄會出現 Places Importer 選單。
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 取得免費金鑰。
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 → 匯入，按照以下步驟操作：
- Enter a search query — e.g. "Tokyo restaurants" or "London gyms"
- 輸入搜尋條件 — 例如「東京 餐廳」或「倫敦 健身房」
- Set minimum rating — default is 3.0★, adjustable from 0–5
- 設定最低星等 — 預設 3.0★，可調整 0–5
- Choose import options — toggle photos, reviews, hours, social links
- 選擇匯入選項 — 可單獨開關照片、評論、營業時間、社群連結
- Click Import — each business is processed and created as a ListingPro listing
- 點擊匯入 — 每個店家自動建立為 ListingPro 列表
AI FeaturesAI 功能 PRO
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背景自動同步 PRO
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 天）。
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封面照片 | SerpApi | Downloaded locally下載至本機 |
| Gallery Photos相簿照片 | SerpApi | Up to 12 images (Pro only)最多 12 張（Pro 限定） |
| GPS CoordinatesGPS 座標 | SerpApi | — |
| Reviews顧客評論 | SerpApi + Gemini AI | AI translated (Pro only)AI 翻譯（Pro 限定） |
| Tags標籤 | Gemini AI | AI generated (Pro only)AI 自動產生（Pro 限定） |
| Category分類 | Gemini AI | Matched from existing categories (Pro only)從現有分類中比對（Pro 限定） |
| Facebook / Instagram | SerpApi | Detected from website URL (Pro only)從網站網址偵測（Pro 限定） |
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?匯入數量有限制嗎？
The only limit is your SerpApi monthly quota (free tier: 250 searches/month). PlacesImporter itself does not impose any cap on search results.
唯一的上限是您的 SerpApi 月配額（免費方案每月 250 次搜尋）。PlacesImporter 本身不限制搜尋結果筆數。
Upgrading to Pro升級至 Pro 版
Pro unlocks unlimited imports, Gemini AI translation & tagging, full gallery sync, social link import, and background auto-sync.
Pro 版開啟無限匯入筆數、Gemini AI 翻譯與標籤、完整相簿同步、社群連結匯入，以及背景自動同步功能。
Purchase a License購買授權
Visit the Pro checkout page and complete the purchase. You'll receive a download link via email.
前往 Pro 購買頁面 完成結帳，之後會收到包含下載連結的確認信件。
Download the Pro ZIP下載 Pro 版 ZIP
After purchase, download places-importer-pro.zip from the link in your confirmation email or from your Freemius account dashboard.
購買後，從確認信件中的連結或 Freemius 帳號後台下載 places-importer-pro.zip。
Install the Pro Version安裝 Pro 版
In your WordPress admin, go to Plugins → Add New → Upload Plugin. Upload the Pro ZIP. When prompted, choose Replace current with uploaded. All your settings are preserved.
進入 WordPress 後台 外掛 → 安裝外掛 → 上傳外掛，上傳 Pro 版 ZIP。提示覆蓋時選擇 以上傳的版本取代目前版本，所有設定將完整保留。