=== NearbyVibe ===
Contributors: nearbyvibe
Tags: points of interest, places, location, directory, nearby
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show what's nearby - restaurants, attractions, shops and more - in a clean accordion with photos, ratings and descriptions.

== Description ==

NearbyVibe lets you build curated "what's nearby" guides and display them anywhere with a shortcode or block. Perfect for hotels, vacation rentals, venues, real-estate listings and local businesses that want to highlight the places around them.

Add places by hand, or pull rich details (address, phone, website, hours, rating and photos) from Google Places using **your own Google API key** - you stay in full control of the key and any billing.

**Free features**

* Beautiful, responsive **accordion** layout grouped by category (dining, coffee, attractions, shopping, outdoors and more).
* Add locations **manually**, or auto-fill details and photos from Google Places with your own API key.
* **Unlimited** location sets and locations.
* `[poi_display set="your-set"]` **shortcode**, a **block**, and **WPBakery** element.
* Photo caching for fast, stable display.
* Per-category limits, colors and display options.
* CSV import for bulk-adding places.

**NearbyVibe Pro (optional add-on)**

A separate add-on, available from [getnearbyvibe.com](https://getnearbyvibe.com/pricing/), adds:

* **NearbyVibe Connect** - a managed key so you don't need a Google account at all.
* **Auto-discovery** - find highly-rated places around an address and import them.
* **Map, Grid and Cards** layouts.
* **Elementor** widget.

The free plugin is fully functional on its own; Pro is never required.

== External services ==

This plugin can connect to the **Google Maps Platform (Places API)** to look up place details and photos, and **only when you provide your own Google API key** and choose to fetch or import a place. When you do, the plugin sends the search text or place identifier you enter (and your API key) to Google in order to return the matching place's details and photo references. No data is sent to Google until you take one of those actions.

* Service: Google Maps Platform / Places API
* Terms: https://cloud.google.com/maps-platform/terms
* Privacy: https://policies.google.com/privacy

The free plugin does not connect to any NearbyVibe server and does not collect or transmit any data to us. (The optional Pro add-on's "Connect" service is documented separately with its own terms.)

== Installation ==

1. Upload the plugin to `/wp-content/plugins/nearbyvibe`, or install it from Plugins → Add New.
2. Activate it through the Plugins screen.
3. Go to **NearbyVibe → Settings** and (optionally) add your Google Places API key.
4. Create a location set under **NearbyVibe → Location Sets**, add places, then drop `[poi_display set="your-set"]` on any page or use the NearbyVibe block.

**Analytics & privacy**

NearbyVibe shares anonymous usage statistics with the plugin authors: daily aggregate interaction counts only (e.g. clicks on directions links), tied to a one-way hash of your site URL - never visitor IPs, personal data, or page URLs. You can switch this off under NearbyVibe -> Analytics. Upgrading to Pro adds a full on-site dashboard of which places YOUR visitors click.

== Frequently Asked Questions ==

= Do I need a Google API key? =
No - you can add places and details manually. A Google Places API key is only needed if you want the plugin to auto-fill details and photos. You create and control that key in your own Google Cloud account.

= Does the free version send any data to NearbyVibe? =
No. The free plugin talks only to Google (using your key, and only when you fetch a place). It does not contact NearbyVibe's servers.

= Where do the photos come from? =
From Google Places, using your API key. Cached copies are stored in your site's uploads folder for fast display.

= What's the difference between Free and Pro? =
Free includes the accordion layout, manual/own-key place data, shortcode, block and WPBakery, with unlimited sets and locations. Pro (a separate add-on from getnearbyvibe.com) adds the managed Connect key, auto-discovery, Map/Grid/Cards layouts and an Elementor widget.

== Screenshots ==

1. Accordion display of nearby places with photos and ratings.
2. Admin: building a location set and adding places.
3. Settings: add your Google Places API key and display options.

== Changelog ==

= 1.2.2 =
* Fixed: cached images now served over https (no mixed-content). Improved: image viewer works on "near me" results.


= 1.2.1 =
* Fixed: image viewer counter no longer overlaps the caption.


= 1.2.0 =
* New: Fullscreen image viewer - tap a photo to enlarge; swipe on mobile, arrows/keyboard on desktop.


= 1.1.6 =
* Fixed: stylesheet packaging glitch that broke mobile width rules; 95%-width mobile cards now apply.


= 1.1.5 =
* Improved: Mobile cards now use ~95% of screen width (break out of narrow theme container padding).


= 1.1.4 =
* New: Swipe photos on mobile. Improved: accordion side padding, wider mobile cards, restyled Hours.


= 1.1.3 =
* Fixed: Mobile card redesign - photo fills cleanly (no black bars), name/rating no longer overlap the image, card styling restored.


= 1.1.2 =
* Improved: Mobile display is now full-width with proper inner padding.
* Fixed: On mobile the image and text no longer overlap.
* New: Each category section has an anchor id for direct linking.


= 1.1.1 =
* New: Accordion height option - "Show all" or "Fixed height" with a scrollbar (Settings, or height="" / height_px="" on the shortcode).
* Improved: Mobile styling overhaul - overlaps, padding, badges, stacked buttons, single-column grid/cards.
* Fixed: The default-open first accordion item can now be collapsed.


= 1.1.0 =
* New: Fresh brand look - refined accordion, gradient accents, gold ratings, keyboard focus states
* New: Anonymous usage statistics (aggregate counts only, opt-out under NearbyVibe -> Analytics)


= 1.0.0 =
* Initial public release: accordion display, manual/own-key Google Places data, shortcode, block and WPBakery support, photo caching, CSV import.

== Upgrade Notice ==

= 1.0.0 =
Initial release of NearbyVibe.
