=== Tushiyah Store Finder and Browser ===
Contributors: donchen1
Donate link:
Tags: store locator, map, leaflet, ireland, eircode
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Store locator with county grouping, map + search (Eircode/town/store), nearby radius, and an A–Z store browser.

== Description ==

Tushiyah Store Finder and Browser adds a lightweight store locator to WordPress with:

* Locations custom post type
* County taxonomy (assign each store to a county)
* Leaflet map with OpenStreetMap tiles
* Search by store name/address, or geocode an Eircode/town and find stores within a radius
* County count markers on initial map view
* A–Z store browser section
* Basic styling via CSS variables and shortcode attributes

== Installation ==

1. Login to your site's dashbiard, ie /wp-admin.
2. Then go to Plugins -> Add New.
3. Search for Tushiyah Store Finder and Browser.
4. Add and Activate the plugin.
3. Add stores under Locations in WP Admin (include latitude/longitude for map display).
4. Create county terms under Locations → Counties and assign each store to a county.
5. Add the shortcode to a page:

`[tushiyah_store_finder_browser]`

== Usage ==

Add the locator anywhere using:

`[tshsfb_store_finder_browser]`

Optional design overrides using shortcode attributes:

`[tushiyah_store_finder_browser sidebar_width="420px" map_height="620px" primary="#111" primary_text="#fff" card_radius="14px" grid_cols_desktop="4"]`

Supported attributes:

* sidebar_width, sidebar_min, gap, controls_gap, row_gap
* map_height, map_height_mobile, panel_height
* card_padding, card_radius, card_border, card_bg
* primary, primary_text
* alpha_btn_size, alpha_btn_radius, alpha_btn_border, alpha_gap
* grid_gap, grid_cols_desktop, grid_cols_tablet, grid_cols_mobile

== Frequently Asked Questions ==

= Why don’t some stores show on the map? =

Stores require valid Latitude and Longitude fields to appear as markers.

= Does Eircode/postcode search have limits? =

Geocoding uses OpenStreetMap Nominatim and results are cached. Like all free geocoding services, it may be rate-limited under heavy traffic.

= Can I show opening hours? =

Edit a Location and set:

* Hours Text (e.g. “Open today until 8:00 pm”)
* Open Now (checkbox)

== Screenshots ==
1. Location Custom Post Type
2. County Taxonomy
3. Leaflet Map with OpenStreetMap
4. Search by Store Name/Address, or Geocode
5. A–Z store browser section

== Changelog ==

= 1.0.0 =
* Initial release.

