=== MapYourProjects ===
Contributors: contractorwebzone, mapyourprojects
Tags: map, project, mapyourprojects, portfolio, contractor
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 8.2
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Seamlessly display your dynamic MapYourProjects portfolios, project locations, and automated SEO sitemaps.

* **MapYourProjects Website:** https://mapyourprojects.com/
* **Terms of Service:** https://mapyourprojects.com/terms-conditions.php
* **Privacy Policy:** https://mapyourprojects.com/privacy-policy.php
* **Account Creation:** A MapYourProjects account is required to generate API and Map Keys. Sign up at https://portal.mapyourprojects.com/signup

== Description ==

Transform your website with **MapYourProjects**, an interactive project mapping platform designed for contractors, builders, and service providers. This plugin seamlessly bridges your WordPress site with your MapYourProjects dashboard, allowing you to showcase your real-world project history, service areas, and job portfolios on a stunning, dynamic map.

This plugin dynamically intercepts your chosen URL path (e.g., `/project`) to serve a fast map shell directly on your domain.

= Key Features: =
* **Dynamic Map Integration:** Embed your MapYourProjects interactive map on any custom path of your choice.
* **Deep-Linked Project Pages:** Every project on your map gets its own clean, search-engine-friendly landing page automatically routed on your domain.
* **SEO & Sitemap Engine:** Automatically registers a custom sitemap provider with native WordPress Core Sitemaps, keeping Google and Bing updated with your latest project locations.
* **Modern React-Powered Dashboard:** Manage your API connectivity and map configurations through a clean, intuitive native admin interface.
* **Secured & Lightweight:** Optimized codebase built following strict WordPress security and performance standards.

== External Services ==

This plugin relies on the following external services to display maps:

1. **MapYourProjects API (https://mapyourprojects.com)**
   * **Use Case:** Fetches map templates, project data, and XML sitemap fragments.
   * **Data Sent:** Dynamic authentication keys (Map Key & API Key) and project lookup slugs.
   * **Links:** [Terms of Service](https://mapyourprojects.com/terms-conditions.php) | [Privacy Policy](https://mapyourprojects.com/privacy-policy.php)

2. **Google Maps API (https://maps.googleapis.com)**
   * **Use Case:** Renders map and its contained data (pins, map styling).
   * **Data Sent:** Sends map interaction events. No personal user identification data is sent.
   * **Links:** [Google Terms of Service](https://policies.google.com/terms) | [Google Privacy Policy](https://policies.google.com/privacy)

== Installation ==

1. Upload the `mapyourprojects` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress admin panel.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **MYP Settings** under the core WordPress Settings menu.
4. Enter your **MYP API Key** and **MYP Map Key** (generated in your MapYourProjects dashboard, it is recommended that these be different).
5. Choose your desired **Map Path** (e.g., `/project`) and save settings.
6. Sync your sitemap and visit the newly created map on your site!

== Frequently Asked Questions ==

= Where do I get my API and Map Keys? =
Log into your MapYourProjects Dashboard, navigate to Home → Map, and generate a key with **API** enabled (for your API Connection Settings) and another with **Embed** enabled (for your Map Display Settings).

= Does this plugin slow down my site? =
No. The map and project pages are dynamically resolved. Static assets are loaded directly from the MapYourProjects high-speed CDN to keep your server overhead minimal.

= How does the sitemap synchronization work? =
Under **Settings → MYP Settings**, click "Update Sitemap Now" to fetch your dynamic project XML fragment. This registers a custom sitemap provider under WordPress's native sitemap index (`/wp-sitemap.xml`) automatically.

== Changelog ==

= 2.0.0 =
* Complete architecture rewrite.
* Native WordPress Core Sitemaps integration.
* Secure parameter serialization and robust admin input sanitization.
* Dynamic, responsive React-powered admin dashboard panel.
* Added subfolder installation compatibility for nested WordPress instances.

= 1.0.0 =
* Initial release.

== Source ==
The source for the admin dashboard is available at: [Repo Address](https://bitbucket.org/cwz-myp/mapyourprojects-wordpress-portal/src/master/)