=== GeoBuddy ===  
Contributors: buddydevelopers
Tags: geodirectory, social media, custom fields, virtual tour, business directory  
Requires at least: 5.0  
Tested up to: 6.8  
Requires PHP: 7.2  
Stable tag: 1.0.6
License: GPLv2 or later  
License URI: http://www.gnu.org/licenses/gpl-2.0.html  

Enhance your GeoDirectory listings with modern social media fields and virtual tour integration.

---

## Description

**GeoBuddy** is a powerful enhancement plugin built specifically for users of GeoDirectory.

It helps you extend your directory website with modern social media integration, virtual tours, and a growing ecosystem of advanced addons — all designed to improve user engagement and listing quality.

Built by BuddyDevelopers, GeoBuddy acts as a **foundation plugin** that enables additional premium and free addons to seamlessly integrate with your GeoDirectory-powered website.

Whether you're building a local directory, niche marketplace, or global discovery platform, GeoBuddy gives you the tools to stand out.

---

## Core Features

### 🌐 Social Media Fields for Listings

Add modern social media profile links directly inside GeoDirectory listings:

- YouTube Profile 
- LinkedIn Profile 
- WhatsApp  
- TikTok Profile

Enhance credibility and improve user engagement by allowing visitors to connect instantly.

---

### 🎥 Virtual Tour Integration

Allow businesses to embed:

- 360° Virtual Tours  

Perfect for restaurants, hotels, real estate, gyms, clinics, and more.

---

### 🗂️ Site Templates — One-Click Demo Importer

GeoBuddy includes a built-in **Site Templates** tab inside the Settings panel. It lets you browse and import ready-made, fully functional GeoDirectory demo sites in just a few clicks.

**What gets imported:**

- Required theme (auto-installed and activated)
- Required plugins (auto-installed and activated)
- Pages and content via WXR import
- Page builder data (Elementor or Block Theme)
- GeoDirectory categories, listings, and reviews
- GeoDirectory settings
- Navigation menus and homepage assignment

**Import modes:**

- **Additive** — Adds the template content alongside your existing site. Safe for testing.
- **Full Reset** — Replaces all existing content with the template. Requires confirmation. Cannot be undone — always back up first.

**Free vs Premium templates:**

- Free templates are available to everyone — no account needed.
- Premium templates require an active **GeoBuddy Bundle Membership** license.
- Enter your license key directly in the Templates tab to unlock premium demos.

---

### ⚡ Lightweight & Developer Friendly

- Clean WordPress coding standards  
- Optimized performance  
- Works seamlessly with GeoDirectory custom post types  
- Extendable architecture for future addons  

---

## Available Addons

GeoBuddy is built as a platform. You can enhance it further using the following addons:

### 🔹 Multistep Form  

Transform the default “Add Listing” page into a clean step-by-step submission process with progress bar support. Reduce form abandonment and increase listing completion rates.

### 🔹 Private Message  

Allow users and business owners to communicate directly through private messaging.

### 🔹 Confetti  

Celebrate successful listing submissions or actions with animated confetti effects to improve user experience.

### 🔹 Announcement Bar  

Display important announcements across your directory website.

### 🔹 Weather Forecast  

Show real-time weather data on listing pages based on location.

### 🔹 Broadcasting  

Send broadcast messages or notifications to selected users or listing owners.

---

## Requirements

- WordPress 5.0 or higher  
- PHP 7.2 or higher  
- GeoDirectory plugin (required)  

---

## Installation

1. Upload the `geobuddy` folder to the `/wp-content/plugins/` directory  
   OR install via **Plugins → Add New → Upload Plugin**
2. Activate the plugin through the ‘Plugins’ menu in WordPress  
3. Ensure GeoDirectory is installed and activated  
4. Configure settings from the GeoBuddy settings panel  

---

## Screenshots

1. **Welcome Dashboard** – Overview page with addon cards and quick access options.
2. **Add-Ons Page** – View, manage, and activate available GeoBuddy addons.
3. **Settings Page – Custom Fields** – Enable or disable social media fields and 360° virtual tour URL from the settings panel.
4. **Site Templates Tab** – Browse free and premium demo templates, filter by builder or plan, and import with one click.
5. **Import Modal – Mode Selection** – Choose between Additive (safe) or Full Reset import modes before starting.
6. **Import Progress** – Step-by-step progress screen showing theme, plugins, content, GeoDirectory data, and site configuration stages.

---

## Frequently Asked Questions

### Does GeoBuddy work without GeoDirectory?

No. GeoBuddy requires the GeoDirectory plugin to function.

### Is this plugin lightweight?

Yes. GeoBuddy is optimized for performance and follows WordPress development standards.

### Are addons included in the main plugin?

Some features are included, while advanced functionality is available via separate addons.

### Is it developer-friendly?

Yes. Developers can extend and customize functionality using WordPress hooks and filters.

### What is the Site Templates feature?

The Site Templates tab lets you import pre-built GeoDirectory demo sites directly from your WordPress admin. It handles everything — theme, plugins, pages, GeoDirectory data, and menus — in a single guided import flow.

### Do I need a license to use templates?

Free templates are available to everyone. Premium templates require an active GeoBuddy Bundle Membership license, which you can enter directly in the Templates tab.

### Will importing a template overwrite my existing site?

Only if you choose **Full Reset** mode. The default **Additive** mode adds the template content alongside your existing site. Full Reset permanently removes all existing posts, pages, and media — always back up before using it.

### What page builders are supported for templates?

Currently Elementor and Block Themes (native WordPress Full Site Editing) are supported.


## Changelog

### 1.0.6

- Updated readme with Site Templates / demo importer documentation
- Removed outdated "Coming Soon" notice from welcome screen

### 1.0.5

- Added Site Templates tab — browse and import pre-built GeoDirectory site templates
- Added GeoDirectory native data import (categories, listings, reviews, settings)
- Added GeoBuddy Bundle Membership license activation for premium templates
- Fixed block theme filtering not working in backend template selection
- Fixed image handling on template reimport
- Fixed duplicate nav menus created during WXR import
- Fixed GeoDirectory CPT posts cleanup on full reset import
- Added link to GeoBuddy Bundle Membership page in templates description

### 1.0.4

- Improved compatibility with latest WordPress version
- Minor performance improvements
- UI refinements

### 1.0.3

- Enhanced social media field validation  
- Bug fixes  

### 1.0.0

- Initial release  

---

## License

This plugin is licensed under the GPLv2 or later.  
See: http://www.gnu.org/licenses/gpl-2.0.html  
