=== Places Importer for ListingPro ===
Contributors: mydymaibox
Tags: listingpro, directory, google maps, import, serpapi
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 2.2.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Import Google Maps business listings into ListingPro with one click via SerpApi.

== Description ==

**Places Importer for ListingPro** populates your ListingPro directory with real business data sourced from Google Maps via SerpApi.

Enter a search query (e.g. "Taipei coffee shop"), and the plugin will pull matching businesses — complete with name, address, phone, website, cover photo, operating hours and rating — and import them as ListingPro listings.

= Features =
* One-click import from Google Maps via SerpApi
* Imports: business name, address, phone, website, cover photo, operating hours, ratings
* Minimum-rating filter to skip low-quality entries
* Duplicate detection (re-running an import updates existing listings)
* Standard ListingPro meta fields (`lp_listingpro_options`, etc.)

= Requirements =
* [ListingPro Theme](https://listingprowp.com/) (the listing post type comes from this theme)
* [SerpApi Account](https://serpapi.com/) — free tier available

= Pro version (separate plugin) =
A separate Pro plugin with AI translation (Google Gemini), full multi-photo gallery sync, AI-curated review import, auto-categorisation, social profile import and background daily auto-sync is offered on the developer's website at [placesimporter.com](https://placesimporter.com/). The Pro version is not part of this WordPress.org release; this WordPress.org release is fully functional on its own.

== Installation ==

1. Upload the `places-importer-for-listingpro` folder to `/wp-content/plugins/`
2. Activate through the **Plugins** menu in WordPress
3. Go to **Places Importer** in the admin sidebar
4. Enter your SerpApi key and click **Test** to verify
5. Choose a category, location, and enter a search query
6. Click **Launch Engine** and select listings to import

== Frequently Asked Questions ==

= Do I need a SerpApi key? =
Yes. SerpApi provides the Google Maps data. They offer a free tier with 250 searches/month — enough for small directories.

= Which themes are supported? =
Currently the ListingPro theme only — the plugin writes to ListingPro's listing post type and meta fields.

== Screenshots ==

1. Admin dashboard.
2. Search results grid with status badges.
3. Real-time import progress.
4. Import summary report.

== Changelog ==

= 2.2.1 =
* Removed all locked/gated feature code; the WordPress.org release is now fully functional with no usage limits.
* Renamed all PHP/JS prefixes to a unique 4+ character prefix (`placimfo_` / `PLACIMFO_`) to avoid name collisions.
* Synchronised the plugin text domain with the WordPress.org slug (`places-importer-for-listingpro`).
* Cleaned up readme and external service references (SerpApi terms/privacy URLs).

= 2.1.0 =
* Added API connectivity tester.
* Improved security for settings and media sideloading (SSRF guard, MIME validation).
* Standardised JS translations using wp.i18n.
* Added import summary report.

= 2.0.3 =
* Initial stable logic with recursive operating-hours parser.

== Upgrade Notice ==

= 2.2.1 =
Compliance and naming refresh; fully functional on WordPress.org.

== External Services ==

This plugin connects to a third-party service. Use of that service requires your own API key and is subject to its terms and privacy policy.

= SerpApi (required) =
Used to fetch business listing data from Google Maps.

* Service URL: https://serpapi.com/
* Terms of Service: https://serpapi.com/legal
* Privacy Policy: https://serpapi.com/legal

Data sent: your search query, language preference (locale), and pagination offset. Data is sent only when you click **Launch Engine** in the plugin admin page or click **Test** to verify your API key. No data is stored on any server other than your own WordPress installation.

---

== 繁體中文說明 ==

**Places Importer for ListingPro** 讓您透過 SerpApi 一鍵將 Google Maps 商家資料匯入 ListingPro 目錄網站。

輸入搜尋關鍵字（例如「台北 咖啡館」），外掛即自動抓取符合的商家，包含名稱、地址、電話、網站、封面照片、營業時間與評分，並直接建立為 ListingPro 清單頁面。

= 功能特色 =
* 透過 SerpApi 一鍵從 Google Maps 匯入商家
* 匯入欄位：商家名稱、地址、電話、網站、封面照片、營業時間、評分
* 最低評分過濾，自動跳過品質不佳的商家
* 重複偵測：對同一商家再次執行匯入會自動更新，不建立重複資料
* 完整支援 ListingPro 原生 Meta 欄位（`lp_listingpro_options` 等）

= 使用需求 =
* [ListingPro 佈景主題](https://listingprowp.com/)（商家清單文章類型由此主題提供）
* [SerpApi 帳號](https://serpapi.com/)——提供免費方案（每月 250 次搜尋）

= Pro 版本（獨立外掛）=
開發者網站 [placesimporter.com](https://placesimporter.com/) 提供獨立的 Pro 版外掛，具備以下額外功能：AI 翻譯（Google Gemini）、完整多張相簿同步、AI 評論摘要匯入、自動分類與標籤生成、社群資料匯入，以及背景每日自動同步。Pro 版本不包含在此 WordPress.org 版本中；本 WordPress.org 版本本身已是完整可用的外掛。

== 安裝說明 ==

1. 將 `places-importer-for-listingpro` 資料夾上傳至 `/wp-content/plugins/`
2. 在 WordPress 後台的「外掛」選單中啟用
3. 前往後台左側選單「Places Importer」
4. 輸入您的 SerpApi 金鑰並點擊「連線測試」
5. 選擇分類與地區，並輸入搜尋關鍵字
6. 點擊「啟動引擎」，勾選要匯入的商家後開始匯入

== 常見問題 ==

= 需要 SerpApi 金鑰嗎？ =
需要。SerpApi 提供 Google Maps 資料，有免費方案（每月 250 次搜尋），對小型目錄網站已足夠。

= 支援哪些佈景主題？ =
目前僅支援 ListingPro 主題，外掛直接寫入 ListingPro 的清單文章類型與 Meta 欄位。
