Dokumentacja Deweloper GOV

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.