# Deweloper GOV 2.0 — instrukcja obsługi

Instrukcja konfiguracji, codziennej pracy i aktualizacji. Dane w dołączonym przykładzie oraz galerii są demonstracyjne.

## Konfigurator krok po kroku

### 1. Powitanie i osoba odpowiedzialna

W menu WordPressa otwórz Deweloper GOV → Konfigurator. Po pierwszej pojedynczej aktywacji nowej instalacji kreator otworzy się automatycznie. Wpisz osobę odpowiedzialną oraz adresy e-mail do kontaktu i powiadomień.

Klikaj Zapisz i przejdź dalej. Jeśli musisz przerwać, zapisz wersję roboczą. Przycisk Wznów konfigurator pozwala wrócić do zapisanego miejsca; samo otwarcie kroku nie oznacza jego ukończenia.

### 2. Sprawdzenie gotowości strony

Odczytaj wyniki kontroli WordPressa, PHP, rozszerzeń oraz możliwości zapisu plików. Dla 2.0 wymagane są co najmniej WordPress 6.4 i PHP 8.2. Błąd środowiska przekaż osobie obsługującej hosting.

Na localhost można sprawdzać konfigurację i pliki, ale taki adres nie jest dostępny dla dane.gov.pl. Produkcyjne udostępnianie wymaga publicznego HTTPS.

### 3. Aktywacja licencji

Wprowadź dane licencji otrzymane przy zakupie i uruchom aktywację dla właściwej domeny. Sprawdź pokazany plan i termin ważności. Nie wysyłaj klucza w zgłoszeniu ani na zrzucie ekranu.

Przejście do dalszej konfiguracji danych wymaga aktywnej licencji. Jeżeli aktywacja nie działa, sprawdź domenę, poprawność klucza i połączenie serwera z systemem licencji. Nie twórz drugiej instalacji jako obejścia.

### 4. Dane firmy

Wpisz rzeczywistą nazwę i formę prawną firmy, identyfikatory rejestrowe, telefon, e-mail oraz adres strony. Korzystaj z dokumentów firmy, a nie danych przykładowych widocznych w galerii.

Zweryfikuj zera na początku identyfikatorów i poprawność pól wymaganych dla wybranej formy prawnej. Wskazany błąd popraw przed przejściem dalej.

### 5. Adres siedziby

Wybierz województwo i uzupełnij powiat, gminę, miejscowość, ulicę, numer budynku, ewentualny numer lokalu oraz kod pocztowy.

Siedziba firmy, biuro sprzedaży i lokalizacja inwestycji to różne adresy. Nie wpisuj jednego w miejsce drugiego tylko po to, żeby zniknął komunikat.

### 6. Domyślne biuro sprzedaży

Uzupełnij adres biura, jego telefon, e-mail oraz sposób kontaktu. Podaj odpowiedni prospekt lub adres dokumentu zgodnie z przygotowaną ofertą.

Dokument ma być rzeczywiście dostępny. Niesprawdzony albo niedostępny prospekt nie jest pokazywany klientowi jako działający przycisk. Po zmianie pliku ponów kontrolę.

### 7. Publikacja oferty

Podaj nazwę przedsięwzięcia, daty oraz tytuł i opis zbioru. W polu Strona z cenami i dostępnością wskaż rzeczywistą stronę oferty, którą odwiedzi klient.

Adres pliku dla dane.gov.pl przygotowuje wtyczka. Nie wymyślaj adresu XML i nie podawaj adresu lokalnego jako produkcyjnego. Publiczny identyfikator zbioru uzupełnisz po utworzeniu zbioru w portalu.

### 8. Źródło danych

W Standard wybierz ręczne zarządzanie ofertą w WordPressie. W PRO dostępne są również importy oraz integracja EstiCRM. Wybierz jednoznacznie, gdzie zespół będzie aktualizował ceny.

Przy łączeniu źródeł ostatni zapis wygrywa. Późniejszy import lub synchronizacja może zastąpić ręczną zmianę; źródło zmiany trafia do audytu. Sam wybór EstiCRM nie uruchamia poprawnego połączenia.

### 9. Pierwsza nieruchomość

Dodaj inwestycję i przypisz do niej ofertę. Wybierz rodzaj, oznaczenie, status, lokalizację, powierzchnię oraz ceny brutto i daty ich obowiązywania. Status wpisu WordPress określa widoczność na stronie, a aktywność GOV udział inwestycji w raporcie.

Dla mieszkania lub domu cena raportowa wynika z powierzchni użytkowej i ceny za m². Sprawdź oba pola, jeśli różni się od wcześniej wpisanej kwoty. Nie dopasowuj danych fikcyjnie; aktualizacja wtyczki nie uzgadnia za Ciebie błędnych cen.

Dla dodatków określ relację do ceny, obowiązkowość i właściwą formę prawną. Cena konfiguracji jest osobną, jawną kwotą zatwierdzaną przez administratora — dodatki nie są automatycznie sumowane.

### 10. Kontrola przed publikacją

Uruchom rzeczywistą kontrolę danych i plików. Otwieraj wskazane linki naprawcze, poprawiaj pola i ponawiaj kontrolę, aż znikną błędy. Nie wystarczy obejrzeć ekranu ani zaznaczyć potwierdzenia.

Błąd jednego publikowanego rekordu blokuje cały nowy raport. Poprzedni poprawny zestaw pozostaje dostępny. Wynik lokalnego testu struktury nie jest dowodem pobrania plików przez portal.

### 11. Automatyzacja i powiadomienia

Ustaw godzinę publikacji i sprawdź strefę czasową WordPressa. Wybierz WP-Cron lub zewnętrzny harmonogram zgodnie z możliwościami hostingu. Uzupełnij właściwy adres powiadomień.

W Diagnostyce uruchom Przetestuj harmonogram i sprawdź rzeczywiste wykonanie. Sama obecność zadania nie potwierdza jego działania. Automatyczny watchdog, alerty i ponowienia należą do PRO.

### 12. Formalności dane.gov.pl

Otwórz Pomoc i dane.gov.pl. Klikaj kolejne pozycje checklisty: konto dostawcy, rola Edytora, kontrola plików, wniosek o importer i potwierdzenie widoczności zbioru. Rozwijane instrukcje opisują warunek ukończenia każdego punktu.

Dopiero dla poprawnej publikacji pod publicznym HTTPS przekaż właściwe adresy administratorowi portalu. Zapisz publiczny URL lub ID swojego zbioru i użyj Sprawdź dane.gov.pl. Nie zgłaszaj plików demonstracyjnych z tej strony.

### 13. Podsumowanie i pierwsza publikacja

Sprawdź podsumowanie, stronę widoczną dla klienta, historię cen i dokumenty. Pierwszą publikację uruchom świadomie na przygotowanej domenie produkcyjnej, po usunięciu błędów.

Rozróżniaj poprawność plików, dostępność przez HTTPS i potwierdzenie zasobu w dane.gov.pl. To trzy osobne etapy. Po uruchomieniu sprawdź także następne wykonanie harmonogramu.

## Codzienna obsługa

### Codzienna praca: inwestycja, lokal i historia cen

Inwestycje → Dodaj inwestycję: uzupełnij dane przedsięwzięcia. Osobno ustaw widoczność na stronie i udział w GOV. Każda aktywna inwestycja GOV musi należeć do dokładnie jednego aktywnego zbioru.

Nieruchomości → Dodaj lokal: wybierz inwestycję, rodzaj i oznaczenie, wprowadź parametry, cenę brutto i datę. Zapisz i sprawdź podgląd strony. Listę można filtrować po inwestycji, statusie i nazwie.

Zmiany cen zapisują historię. Błędny historyczny wpis koryguj z powodem, bez usuwania poprzedniej wartości. Pokaż pełną historię odsłania wpisy starsze niż podgląd trzech ostatnich zdarzeń.

### Samodzielne miejsce postojowe, garaż lub komórka

Na liście nieruchomości wybierz Dodaj miejsce postojowe albo w edytorze wybierz samodzielną część. Taka oferta nadal należy do inwestycji, ale nie musi być przypisana do mieszkania.

Uzupełnij oznaczenie, cenę brutto, datę oraz kwalifikację wynikającą z dokumentów sprzedaży. Nie wybieraj sztucznie rodzaju mieszkanie tylko po to, by zapisać parking.

Pomieszczenie przynależne i prawo korzystania mają odrębne pola. Wtyczka nie rozstrzyga, jaki tytuł prawny ma dany składnik. Wątpliwość wyjaśnij na podstawie dokumentów; nie zastępuj jej dowolnym wyborem w formularzu.

### Wygląd oferty bez zmiany całej strony

W Prezentacji oferty osobno wybierz sposób wyświetlania inwestycji, listy i pojedynczej oferty: dotychczasowy motyw, szablon wtyczki, stronę Gutenberg albo zapisany szablon Elementor.

W edytorze Gutenberg dodaj właściwy blok Deweloper GOV i ustaw jego kontekst. W Elementorze wybierz widget oraz źródło oferty. Techniczna nazwa bloku nie jest shortcode'em do wklejenia w tekst strony.

Lista archiwum i adresy pojedynczych ofert mają niezależne przełączniki. Można je wyłączyć i używać osadzonych bloków lub widgetów; sprawdź wtedy odnośniki na własnej stronie. Aktualizacja istniejącej instalacji nie włącza automatycznie nowych szablonów.

Dodaj własne zdjęcia i dokumenty. Zrzuty demo nie są materiałami do Twojej oferty. Działanie formularza kontaktowego sprawdź, odbierając prawdziwą wiadomość na skrzynce biura.

### Standard, PRO i wygaśnięcie licencji

Standard: CSV/XML/MD5, historia cen, konfigurator, szablony inwestycji i lokali, Gutenberg i Elementor oraz aktualizacje w okresie aktywnej licencji.

PRO dodatkowo: EstiCRM, automatyczny monitoring i alerty, ponowienia po błędzie, import CSV/XLSX oraz REST API i webhooki. Eksport CSV w Standard nie oznacza dostępu do importu ofert.

Po wygaśnięciu wcześniej aktywnej licencji pozostają frontend, ręczna edycja, historia oraz lokalna publikacja prawna z harmonogramem. Aktualizacje i funkcje PRO są blokowane. Licencja cofnięta, nieważna lub przypisana do innej domeny nie jest tym samym co wygasła.

Integracja z rzeczywistym kontem EstiCRM wymaga osobnego sprawdzenia w środowisku klienta. Ta galeria nie potwierdza uruchomionej synchronizacji na takim koncie.

### Dwa importy PRO: co dokładnie zostanie zmienione

Import oferty zapisuje inwestycje i nieruchomości w WordPressie. Wgraj CSV lub XLSX, ustaw mapowanie i sprawdź cały podgląd. Dowolny błędny wiersz blokuje zapis. Wymagane są identyfikatory źródła, inwestycji i lokalu.

Patch: puste pole nie zmienia wartości, a brakujący rekord pozostaje. Snapshot: puste pole może wyczyścić pole opcjonalne, a brakujące rekordy są archiwizowane dopiero po dodatkowym potwierdzeniu. Przed snapshotem zrób kopię.

Import gotowego raportu służy tylko do walidacji i publikacji kanonicznego CSV. Nie dodaje lokali i nie aktualizuje cen na stronie. Wymaga dokładnie 58 kolumn; nie myl go z importem oferty.

Obsługiwane są CSV i XLSX, nie stary XLS ani makra. Formuły nie są wykonywane. Limit to 10 000 wierszy i 20 MB lub niższy limit hostingu.

### Aktualizacja z 1.5.1 oraz starszej gałęzi 1.4

Przed zmianą zachowaj kopię bazy, plików wtyczki i katalogu opublikowanych raportów. Sprawdź PHP 8.2+ i WordPress 6.4+. Aktualizację wykonaj najpierw na kopii witryny.

Dla zweryfikowanej starej licencji 1.5.1 migracja uzupełnia plan Standard bez ponownego wpisywania klucza i bez przedłużania terminu. Licencja wygasła nie otrzymuje w ten sposób nowych aktualizacji ani PRO.

Dane, historia i poprzednie pliki pozostają zachowane. Sprawdź raport migracji, powiązania inwestycji i pola wymagające uzupełnienia. Brakującej kwalifikacji prawnej dodatku nie uzupełniamy za klienta.

Dla 1.4.1 przewidziana jest ścieżka przez 1.5.1. Nie zakładaj, że każdą zmodyfikowaną wersję 1.4 można bezpośrednio zastąpić 2.0 bez testu. Osobno sprawdź własny motyw, shortcode'y i integracje.

Jeżeli dotąd korzystasz z EstiCRM, zaplanuj PRO przed migracją do nowych planów. Po aktualizacji potwierdź ceny, historię, wygląd strony, licencję, kontrolę plików i kolejne wykonanie crona. W razie potrzeby odtwarzaj razem kod i zgodną kopię bazy.

### Plik poprawny, HTTPS dostępny, zasób w portalu — trzy różne stany

CSV zawiera dane ofert; XML opisuje zbiór i jego zasoby; MD5 jest sumą kontrolną XML. Wersjonowane CSV nie powinny być ręcznie nadpisywane ani usuwane. Nie kasuj starych zasobów, by naprawić bieżący błąd.

Kontrola struktury sprawdza m.in. 58 kolumn, dane cenowe i XSD. Kontrola dostarczenia sprawdza publiczny HTTPS, odpowiedź serwera i zgodność pobranych bajtów. Potwierdzenie w portalu jest osobnym wynikiem odczytu API dane.gov.pl.

W Standard sprawdzenie portalu uruchamiasz ręcznie; PRO może monitorować cyklicznie. Brak zasobu tuż po lokalnej publikacji może oznaczać oczekiwanie na portal, a nie błąd utworzonego pliku.

Wtyczka nie zastępuje formalności po stronie dostawcy danych ani oceny prawnej treści oferty. Przykładowy zestaw do pobrania służy wyłącznie poznaniu formatu.

### Rozwiązywanie problemów i zgłoszenie do wsparcia

Cena różni się od wpisanej: sprawdź powierzchnię użytkową, cenę za m², cenę brutto i datę. Otwórz Popraw dane ceny; nie próbuj usuwać ostrzeżenia przez ukrycie ceny na froncie.

Brak prospektu: sprawdź właściwy dokument, odpowiedź serwera i MIME. Brak aktualnego raportu: otwórz Publikacja GOV, przeczytaj pełne błędy i przejdź przez linki naprawcze.

Cron nie działa: użyj próby wykonania w Diagnostyce. Przy braku uruchomienia poproś hosting o poprawny zewnętrzny harmonogram. Nie uznawaj samej zaplanowanej daty za udane wykonanie.

Do wsparcia prześlij wersje wtyczki, WordPressa i PHP, kroki odtworzenia, oczekiwany i rzeczywisty wynik oraz zanonimizowany zrzut. Użyj raportu wsparcia z Diagnostyki. Nie dołączaj kluczy licencyjnych, tokenów, haseł ani danych nabywców.

## Katalog funkcji 2.0

### Uruchomienie i konfiguracja — Standard i PRO

- Automatyczne otwarcie konfiguratora po pierwszej pojedynczej aktywacji nowej instalacji.
- 13 kroków prowadzących od danych osoby odpowiedzialnej i aktywacji licencji do kontroli plików i pierwszej publikacji.
- Zapis postępu, wersja robocza i wznowienie konfiguracji w zapisanym miejscu.
- Dane firmy, siedziby i biura sprzedaży w jednym miejscu: identyfikatory, adresy, telefony i e-maile.
- Kontrola wymaganych pól i komunikaty wskazujące, co poprawić przed przejściem dalej.

### Inwestycje i codzienna praca z ofertą — Standard i PRO

- Zarządzanie wieloma inwestycjami i przypisanymi do nich nieruchomościami w jednym WordPressie.
- Osobne edytory inwestycji i oferty: oznaczenie, adres, parametry, status sprzedaży i materiały.
- Wyszukiwanie oraz filtrowanie listy ofert według inwestycji i statusu.
- Niezależne ustawienia widoczności inwestycji na stronie i jej udziału w publikacji GOV.
- Przegląd brakujących danych oraz bezpośrednie przejście z komunikatu do poprawy oferty.

### Lokale, domy i samodzielne części — Standard i PRO

- Oferty lokali mieszkalnych i domów jednorodzinnych oraz lokali użytkowych, dla których potwierdzono właściwy zakres obowiązku publikacji.
- Samodzielnie sprzedawane miejsce postojowe, garaż lub komórka jako osobna oferta w inwestycji, bez przypisywania do mieszkania.
- Części nieruchomości, pomieszczenia przynależne, prawa i inne świadczenia opisane w odrębnych polach.
- Oznaczenie składnika jako wliczonego w cenę albo mającego własną cenę oraz jako obowiązkowego albo opcjonalnego.
- Pola formy prawnej i potwierdzenia zakresu publikacji. Właściwą kwalifikację wybierasz na podstawie dokumentów sprzedaży — wtyczka nie podejmuje tej decyzji za Ciebie.

### Ceny i historia zmian — Standard i PRO

- Ceny brutto, daty obowiązywania i cena za m²; precyzyjne obliczenia dziesiętne bez błędów zmiennoprzecinkowych.
- Podgląd ceny raportowej i ostrzeżenie o rozbieżności z wcześniej zapisaną kwotą.
- Jawnie zatwierdzana cena konfiguracji z wariantem i datą. Dodatki nie są automatycznie doliczane do ceny lokalu.
- Historia zmian ceny lokalu oraz osobno raportowanych składników: data, poprzednia i nowa wartość oraz źródło zmiany.
- Korekty z powodem i operatorem, bez usuwania poprzedniego zapisu; wyraźne oznaczenie wartości nieobowiązującej.
- Pełna historia na stronie, w shortcode, Gutenbergie i Elementorze. Podgląd ostatnich wpisów można rozwinąć bez utraty dostępu do starszych zdarzeń.

### Raporty CSV, XML i MD5 — Standard i PRO

- Generowanie CSV z 58 kolumnami, pliku XML opisującego zbiory i zasoby oraz sumy kontrolnej MD5.
- Wspólna walidacja danych, cen i pól wymaganych oraz kontrola XML według schematu XSD aktywnego kontraktu danych.
- Kontrola przed publikacją bez zastępowania aktualnego zestawu. Błąd jednego publikowanego rekordu blokuje cały nowy raport.
- Obsługa wielu zbiorów i źródeł publikacji z przypisaniem inwestycji do właściwego zbioru.
- Kontrola limitu zasobów: ostrzeżenie przy 900 i blokada przekroczenia 1000 zasobów w jednym źródle.
- Wersjonowane pliki i zachowanie poprzedniego poprawnego zestawu w razie błędu; stałe adresy latest.xml i latest.md5.

### Harmonogram i kontrola dane.gov.pl — Standard i PRO

- Codzienna publikacja o wybranej godzinie z uwzględnieniem strefy czasowej WordPressa.
- Obsługa WP-Cron oraz konfiguracji zewnętrznego harmonogramu na hostingu.
- Ręczne uruchomienie kontroli lub publikacji i podgląd ostatniego wyniku oraz następnego zadania.
- Sprawdzenie dostępności zasobów przez publiczny HTTPS i zgodności pobranych plików przed ich udostępnieniem jako aktualnych.
- Ręczne sprawdzenie aktualnego zasobu w publicznym API dane.gov.pl według zbioru, daty danych i adresu pliku. Poprawny plik, dostępny HTTPS i potwierdzenie portalu mają osobne statusy.

### Oferta na Twojej stronie — Standard i PRO

- Gotowe widoki inwestycji, listy nieruchomości i pojedynczej oferty z filtrowaniem i sortowaniem listy.
- Galeria własnych zdjęć, ceny, statusy, parametry, składniki oferty, dokumenty i historia cen.
- Wybór sposobu prezentacji: istniejący motyw, szablon wtyczki, strona Gutenberg albo zapisany szablon Elementor.
- Globalne ustawienia prezentacji oraz nadpisanie szablonu dla konkretnej inwestycji.
- Niezależne wyłączenie archiwum i pojedynczych adresów ofert, jeśli chcesz pokazywać je tylko w osadzonej tabeli lub kartach.
- Kontrola prospektu przed pokazaniem odnośnika oraz formularz kontaktowy z ochroną przed automatycznym spamem i limitem wysyłek.

### Bloki Gutenberg — Standard i PRO

- Tabela nieruchomości, siatka ofert i karta pojedynczej nieruchomości.
- Wybrane pole oferty, prezentacja ceny oraz historia zmian cen.
- Mapa lokalizacji i galeria zdjęć nieruchomości.
- Lista części nieruchomości, dane dewelopera i podsumowanie inwestycji.
- Wybór kontekstu inwestycji lub nieruchomości we właściwym bloku; dane pochodzą z oferty zapisanej we wtyczce.

### Widgety Elementor — Standard i PRO

- Tabela danych, siatka nieruchomości, karta oferty i porównanie ofert.
- Pole nieruchomości, cena, historia cen i oznaczenie statusu sprzedaży.
- Galeria zdjęć, mapa lokalizacji oraz lista części i dodatków.
- Informacje o inwestycji i deweloperze, odnośnik do prospektu oraz formularz kontaktowy.
- Łącznie 15 widgetów i wybór zapisanego szablonu Elementor. Elementor jest opcjonalny — nie jest wymagany do działania podstawowych funkcji wtyczki.

### Pomoc, diagnostyka i bezpieczeństwo danych — Standard i PRO

- Klikalna checklista formalności dane.gov.pl z instrukcjami krok po kroku i szablonem wiadomości do administratora portalu.
- Diagnostyka WordPressa, PHP, rozszerzeń, plików, licencji, połączeń i harmonogramu.
- Próba rzeczywistego wykonania crona zamiast samego sprawdzenia, czy zadanie jest zaplanowane.
- Historia operacji, błędy z linkami do naprawy i raport wsparcia z usuwaniem sekretów oraz danych osobowych.
- Ekran zgodności pokazujący wymagania i aktywny kontrakt danych; dostęp administracyjny ograniczony do uprawnionych użytkowników.
- Wybór zakresu odinstalowania: zachowanie wszystkich danych, usunięcie danych technicznych albo świadome pełne usunięcie. Historia cen i publiczne pliki nie są automatycznie kasowane przez zwykłą retencję.

### Licencja, aktualizacje i starsze instalacje — Standard i PRO

- Aktywacja licencji dla domeny, podgląd planu, terminu i dostępnych funkcji.
- Aktualizacje z poziomu WordPressa przy aktywnej licencji z uprawnieniem do aktualizacji; kontrola podpisu i integralności paczki.
- Przeniesienie zweryfikowanej starej licencji 1.5.1 do Standard bez ponownego wpisywania klucza i bez zmiany terminu ważności.
- Migracja zachowująca istniejące oferty, historię i pliki oraz raportująca dane wymagające uzupełnienia. Nowe szablony nie włączają się automatycznie na starej stronie.
- Po wygaśnięciu wcześniej aktywnej licencji nadal działają frontend, ręczna edycja, historia i publikacja prawna z harmonogramem. Aktualizacje i funkcje PRO wymagają odnowienia.

### Importy CSV i XLSX — Tylko PRO

- Import oferty do WordPressa z mapowaniem kolumn i podglądem błędów przed zatwierdzeniem.
- Tryb patch: puste pole nie zmienia wartości, a brakująca oferta pozostaje bez zmian.
- Tryb snapshot: puste pole może wyczyścić wartość opcjonalną; archiwizacja brakujących ofert wymaga dodatkowego potwierdzenia.
- Osobny import gotowego raportu do walidacji i publikacji. Nie tworzy ofert ani nie zmienia cen na froncie WordPressa.
- Kontrola całego importu, trwały status operacji, zabezpieczenia przed powtórnym wykonaniem oraz historia zmian cen.
- Do 10 000 wierszy i 20 MB lub niższy limit hostingu. Obsługiwane są CSV i XLSX bez makr; formuły i stary format XLS są odrzucane.

### Integracja EstiCRM — Tylko PRO

- Konfiguracja połączenia z EstiCRM i sprawdzenie dostępu do API.
- Synchronizacja inwestycji, ofert, parametrów i cen do danych używanych przez wtyczkę.
- Ręczne uruchomienie synchronizacji oraz niezależny harmonogram, oddzielony od godziny publikacji raportu.
- Rejestr wyniku i błędów synchronizacji oraz oznaczanie źródła zmian. Przy łączeniu edycji ręcznej i synchronizacji obowiązuje ostatni zapis.
- Wymaga własnego dostępu do EstiCRM i konfiguracji dla konta klienta. Subskrypcja EstiCRM oraz niestandardowe wdrożenie nie są częścią licencji wtyczki.

### Automatyczny nadzór i ponowienia — Tylko PRO

- Watchdog wykrywający zbyt długo trwający proces, brak zadania i brak poprawnej publikacji po terminie.
- Automatyczne ponowienia po błędzie z odstępami 5, 15 i 60 minut.
- Cykliczna kontrola bieżącego zasobu w publicznym API dane.gov.pl.
- Ostrzeżenie o przedłużającym się oczekiwaniu na portal i wyczerpanych próbach ponowienia.
- Alerty w panelu i e-mail z ograniczeniem powtarzających się powiadomień o tym samym problemie.

### REST API i webhooki — Tylko PRO

- REST API v2 do odczytu stanu, importu oferty i raportu, kontroli przed publikacją oraz uruchamiania publikacji.
- Odczyt statusu importu i stronicowanych pozycji bez pobierania całego dużego pliku w jednej odpowiedzi.
- Webhook zmian nieruchomości z podpisem HMAC, kontrolą czasu i ochroną przed ponownym użyciem żądania.
- Idempotencja: powtórzenie zakończonego zdarzenia zwraca zapisany wynik, a zmiana treści pod tym samym kluczem jest odrzucana.
- Uwierzytelnianie i kontrola uprawnień; integracje korzystają z tej samej walidacji i zasad licencji co panel.

### Zakres i wymagania

Standard obejmuje codzienną obsługę oferty, raportowanie i prezentację na stronie. PRO zawiera Standard oraz importy, EstiCRM, automatyczny nadzór, retry i integracje API.

Wtyczka przygotowuje i kontroluje dane techniczne. Nie zakłada za Ciebie konta dostawcy w dane.gov.pl, nie przyznaje roli Edytora ani nie uruchamia urzędowego importera. Przyjęcie zasobu przez portal jest osobnym etapem.

Poprawność i kwalifikacja prawna treści oferty wymagają danych z rzeczywistych dokumentów. Walidacja nie jest indywidualną opinią prawną ani gwarancją przyjęcia danych przez portal.

Wymagania wersji 2.0: PHP 8.2+ i WordPress 6.4+. Motyw, pocztę, publiczny HTTPS i połączenia z zewnętrznymi usługami należy skonfigurować dla konkretnej strony.

## Historia zmian

### 2.0 — aktualizacje i bezpieczeństwo

Poprawiono komunikat i obsługę odmowy aktualizacji na liście wtyczek WordPressa. Fokus i kolejka aktualizacji pozostają obsługiwane także w WordPressie 7.1.

Aktualizator weryfikuje uprawnienia licencji, podpis oraz integralność pobieranej paczki.

### 2.0 — najważniejsze zmiany względem 1.5.1

Nowy panel, 13-krokowy konfigurator z zapisem postępu, model inwestycji i własne edytory ofert. Plany Standard i PRO oraz migracja starych licencji do Standard z zachowaniem terminu.

Pełna historia cen i korekty, obsługa samodzielnych części, rozdzielenie widoczności strony i publikacji GOV, kontrola dokumentów oraz wspólna walidacja danych i plików.

Kontrolowane importy CSV/XLSX, wersjonowane pliki, monitoring, zabezpieczenia webhooków oraz dopracowane widoki Gutenberg i Elementor. Istniejące strony zachowują swój motyw; archiwum i pojedyncze oferty można niezależnie wyłączyć.

Minimalne wymagania 2.0: PHP 8.2 i WordPress 6.4. Przed aktualizacją przeczytaj instrukcję migracji, szczególnie jeśli korzystasz z EstiCRM.

### 1.5.1 — wydanie publiczne, 23.08.2026

Ujednolicono obliczanie cen w groszach, wprowadzono jawnie zatwierdzaną cenę konfiguracji i pełną historię cen składników. Dodatki nie są automatycznie sumowane.

Dodano walidację całych raportów, wersjonowany kontrakt danych, podpisany kanał aktualizacji i kontrolowany most dla 1.4.1. Niepoprawny nowy cennik nie zastępuje ostatniego poprawnego zestawu.

### Jak czytać ten changelog

Numer widoczny na liście wtyczek WordPressa wskazuje wersję zainstalowaną na Twojej stronie. Dostępne aktualizacje sprawdzisz w panelu administracyjnym.

Przed aktualizacją wykonaj kopię bazy i plików oraz sprawdź wymagania PHP i WordPressa. Po zmianie potwierdź ceny, historię, wygląd oferty i działanie harmonogramu.