=== Adresy.app — Weryfikacja adresów WooCommerce ===
Contributors: adresyapp
Tags: woocommerce, address validation, autocomplete, shipping, poland, PRG, TERYT
Requires at least: 5.8
Tested up to: 6.7
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Weryfikacja i autouzupełnianie adresów wysyłkowych w WooCommerce na podstawie oficjalnych danych PRG (GUGiK).

== Description ==

Wtyczka automatycznie weryfikuje adresy wysyłkowe klientów z oficjalną bazą PRG (Państwowy Rejestr Granic) prowadzoną przez GUGiK. Ponad 30 milionów punktów adresowych w Polsce.

**Funkcje:**

* **Autocomplete** — klient wpisuje adres, system podpowiada prawidłowe ulice i numery budynków
* **Walidacja przy checkout** — adres jest sprawdzany z bazą PRG przed złożeniem zamówienia
* **Auto-korekta kodu pocztowego** — jeśli klient wpisze błędny kod, wtyczka poprawi go automatycznie
* **Tryb ostrzeżenia lub blokady** — konfigurujesz, czy klient może złożyć zamówienie mimo nieprawidłowego adresu
* **Tylko Polska** — wtyczka działa tylko dla adresów z kraju PL, nie blokuje zagranicznych zamówień

**Wymaga klucza API** z [adresy.app](https://api.adresy.app/auth/register). Plan Free (30 req/min) wystarczy dla małych sklepów.

== Installation ==

1. Zainstaluj wtyczkę (wgraj ZIP lub wyszukaj "Adresy.app" w katalogu wtyczek)
2. Aktywuj wtyczkę
3. Przejdź do Ustawienia → Adresy.app
4. Wklej klucz API (uzyskasz go po rejestracji na api.adresy.app → Panel klienta → Klucze API)
5. Gotowe — autocomplete i walidacja działają na stronie checkout

== Frequently Asked Questions ==

= Czy potrzebuję płatnego konta? =

Plan Free daje 30 zapytań/min i 3 000 req/mies bez opłat. Dla sklepów z ruchem rekomendujemy plan Starter (39 zł/mies, 200 req/min, 100k req/mies).

= Czy wtyczka spowalnia checkout? =

Nie. Zapytania API trwają poniżej 50 ms. Autocomplete ma wbudowany debounce (200 ms).

= Co z adresami zagranicznymi? =

Wtyczka waliduje tylko adresy z Polski (country = PL). Adresy zagraniczne nie są blokowane.

= Czy dane klientów są przechowywane? =

Nie. Adresy.app nie przechowuje zapytań API. Zapytanie zawiera tylko tekst adresu — bez danych osobowych.

== Changelog ==

= 1.0.0 =
* Pierwsza wersja
* Autocomplete na polach adresowych checkout
* Walidacja adresu z bazą PRG (tryb warn/block)
* Auto-korekta kodu pocztowego
* Panel ustawień z testem klucza API
