=== Knowco US Map ===
Contributors: knowco
Tags: map, us map, interactive map, states, svg map
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An interactive, clickable map of the United States. Add it with a shortcode or block, and link every state to a page on your site.

== Description ==

Knowco US Map adds a clean, responsive SVG map of the United States to any
page or post. Visitors hover a state to see its name, and click it to go
wherever you send them.

Every state is configurable. One URL pattern, such as `/states/{state-slug}/`,
links all of them automatically, and you can set each state's own color, label
and name. Small states get labeled boxes beside the map so they stay clickable.

= Free features =

* Clickable map of all 50 states plus DC and Puerto Rico
* Shortcode `[knowco_us_map]` (or the original `[us_interactive_map]`) and a Gutenberg block
* One map, fully configurable (Pro adds unlimited maps)
* A starter template to begin from — a linked map you edit instead of building from blank
* A URL pattern that links every state automatically
* Per-state colors, labels and names
* Hover tooltips showing the state name
* Set your own colors for every state
* Mobile: a tap-friendly state dropdown
* Crawlable state links, JSON-LD, and a no-JavaScript fallback for SEO
* Print stylesheet
* No jQuery, no build step, no external requests

= Configuration =

Everything is set in the WordPress admin under **US Map**. Create a map, choose
your colors and URL pattern, then place the shortcode:

`[knowco_us_map id="my-map"]`

Or add the "Knowco US Map" block in the block editor and pick your map
from the sidebar.

= Pro =

A separate Pro add-on adds unlimited maps, a search box, five color themes, the
container card, the interactive map on mobile with pinch-to-zoom, data
visualization (choropleth maps with a legend), region grouping, guided tours,
click analytics, a full-width mega dropdown, rich popovers with images, and
embedding — letting other websites display your map while you see the traffic
each one sends back.

Pro also covers three per-state settings: a custom URL for one state, your own
text in a state's tooltip, and hiding or disabling individual states. Pro also
includes ten starter templates — the six maps on our showcase page and four
generic starters — that open in the editor ready to change.

The free plugin is fully functional on its own: one map, every state clickable
through the URL pattern, per-state colors and labels, hover tooltips, SEO
output, print support and a mobile dropdown.

Details: https://usmap.knowco.co/

== Installation ==

1. Upload the plugin through **Plugins → Add New → Upload Plugin**, or install
   it from the plugin directory.
2. Activate it.
3. Go to **US Map** and create your first map.
4. Add `[knowco_us_map id="your-map-id"]` to a page or post, or use the
   block editor.

== Frequently Asked Questions ==

= Do I need to know how to code? =

No. Maps are configured in the WordPress admin, and you add one with a
shortcode or the block editor.

= Can I have more than one map? =

The free version includes one map, which is fully configurable. Pro removes the
limit; each map then has its own colors, links, per-state settings and
shortcode ID. Maps you already created keep working if you move to the free
version — you just cannot add new ones.

= What are the starter templates? =

Pre-built maps you open in the editor and change, instead of starting blank.
Add New Map shows them with a preview of each. One, Linked States, is free.
The other nine are part of Pro and cover heat maps, regions, guided tours,
popovers and the mega dropdown, using sample data you replace with your own.

= Where do states link to? =

Set a URL pattern such as `/states/{state-slug}/` and each state links to its
own page automatically. Pro adds a custom URL for an individual state, for when
one of them needs to point somewhere the pattern does not reach.

= Does it work on phones? =

Yes. Below a breakpoint you choose, the map can either switch to a tap-friendly
state dropdown, or stay as a map with pinch-to-zoom and drag-to-pan.

= Does it slow my site down? =

It shouldn't. There are no external requests, no jQuery, and the assets only
load on pages that actually use a map.

= Is it accessible? =

The map has an ARIA label and per-state titles, states are reachable as real
links for screen readers and crawlers, and there is a no-JavaScript fallback
list.

== Screenshots ==

1. An interactive map on the front end.
2. The map settings screen.
3. Per-state settings: colors, labels and names.
4. The mobile view.

== Changelog ==

= 1.0.0 =
* First public release. A clickable map of all 50 states, DC and Puerto Rico:
  one URL pattern links every state, with per-state colors, labels and names,
  hover tooltips, crawlable links and JSON-LD, a print stylesheet, a mobile
  dropdown, a shortcode and a Gutenberg block. One map in the free version;
  the Pro add-on removes the limit and adds data visualization, regions,
  guided tours, rich popovers, the mega dropdown, click analytics, embedding
  and nine of the ten starter templates.
* Starter templates: Add New Map opens a chooser with a blank map and ten
  templates you edit instead of building from scratch, each with a preview.
