=== Web 2.0 Directory ===
Contributors: salephpscripts
Donate link: https://www.salephpscripts.com/
Tags: maps, google maps, mapbox, maplibre, markers, store locator, directory, listings, map search, clusters
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build powerful, searchable, responsive maps (Google Maps, Mapbox, MapLibre) with custom markers, clustering, frontend submission and advanced search.

== Description ==

Web 2.0 Directory lets you build custom, searchable maps for WordPress in minutes and place them anywhere with a shortcode. Choose your map engine — Google Maps, Mapbox or MapLibre — add high-quality markers, group them into a searchable listings directory, and let visitors filter by category, location, content fields or distance.

**Key features**

* Three map engines: Google Maps, Mapbox, and MapLibre (with MapTiler tiles).
* Custom markers with Font Awesome icons, per-category icons, and marker clustering.
* Advanced search: by category, location, custom content fields, address + radius, and free-hand "draw area" polygon search.
* Listings directory: sidebar list, listings below the map, InfoWindow popups, directions and read-more.
* Frontend submission form so visitors can add their own markers/listings, with optional moderation, expiration and renewal.
* Google reCAPTCHA support on contact and submission forms.
* CSV import/export for bulk marker/listing management.
* Translation-ready: ships a POT file you can translate with any standard gettext/PO editor.
* Powerful settings panel with per-map configuration.
* Fast and lightweight: marker clustering plus on-demand REST loading keep maps, listings and popups responsive even with thousands of markers - quick to load, display and search.

See the live demo: https://maps.salephpscripts.com/

This plugin connects to external services (map providers, reCAPTCHA, and the Web 2.0 Directory license/update server). Please read the **External Services** section below.

== Installation ==

1. Upload the `w2dc` folder to `/wp-content/plugins/`, or install the ZIP via Plugins -> Add New -> Upload Plugin.
2. Activate **Web 2.0 Directory** through the Plugins menu.
3. Open the Web 2.0 Directory settings page, choose your map engine and enter the matching API key/token (Google Maps API key, Mapbox token, or MapTiler key).
4. Create a map, add markers/listings, and place the map on any page with the provided shortcode.

== Frequently Asked Questions ==

= Which map engine should I use? =
Any of Google Maps, Mapbox or MapLibre. Google and Mapbox require an API key/token from the provider; MapLibre renders open tiles (for example from MapTiler) using your key.

= Do I need API keys? =
Yes. Map providers require their own key/token, which you enter on the settings page. The keys are stored on your site and are never sent to us.

= Is it translation ready? =
Yes. A `languages/rmaps.pot` template is included; translate it with any standard gettext/PO editor.

= Can visitors submit their own listings? =
Yes, through the frontend submission form, with optional moderation, expiration and renewal.

== External Services ==

Web 2.0 Directory relies on the following third-party services. Each is used only in the situation described, and all map-provider API keys/tokens are supplied by you.

1. Web 2.0 Directory license & update server (salephpscripts.com)
Used in wp-admin only, when checking for plugin updates or validating your purchase code. It sends your purchase code and your site URL so the server can verify the license and return update information.
Terms & privacy: https://maps.salephpscripts.com/

2. Google Maps Platform (maps.googleapis.com) - only when the Google engine is selected
The browser loads the Google Maps JavaScript API (with your API key) and sends map view coordinates and address/search queries in order to render maps and autocomplete addresses.
Terms: https://cloud.google.com/maps-platform/terms - Privacy: https://policies.google.com/privacy

3. Mapbox (api.mapbox.com) - only when the Mapbox engine is selected
The browser loads Mapbox GL JS (with your access token) and requests map tiles and styles.
Terms: https://www.mapbox.com/legal/tos - Privacy: https://www.mapbox.com/legal/privacy

4. MapLibre / map tiles - only when the MapLibre engine is selected
The MapLibre GL JS library is loaded in the browser, and map tiles are requested from the tile provider you configure (for example MapTiler) using your key.
MapTiler terms: https://www.maptiler.com/terms/ - Privacy: https://www.maptiler.com/privacy-policy/

5. Google reCAPTCHA (www.google.com/recaptcha) - optional, only when enabled
When you enable reCAPTCHA for the contact/submission forms, the browser loads reCAPTCHA and sends interaction signals to Google to score the request.
Terms: https://policies.google.com/terms - Privacy: https://policies.google.com/privacy

== Screenshots ==

1. A map with clustered custom markers.
2. Listings sidebar.
3. Address + radius search.
4. The map with sidebar search.
5. Price markers.
6. The frontend submission form.
7. The Web 2.0 Directory settings panel.

== Changelog ==

= 1.1.0 =
* New: 10 Google Maps and 10 MapLibre map style presets (colourful to dark).
* New: branded rocket marker icon and a matching map starting-point marker.
* Improve: faster marker loading on maps that use a listings limit.
* Fix: list / select / checkbox field values not showing in listings, popups and search.
* Fix: duplicated markers and gallery images on some listings.
* Fix: MapLibre style switching in the map editor's live preview.
* Fix: search-form fade animation and minor UI polish.

= 1.0.0 =
* Initial CodeCanyon release.
