Deweloper GOV - Wtyczka WordPress

Wtyczka do publikacji oferty nieruchomości deweloperskich na portalu dane.gov.pl zgodnie z wytycznymi Ministerstwa Rozwoju i Technologii.

Wymagania systemowe

• WordPress: 6.4 lub nowszy
• PHP: 8.0 lub nowszy
• MySQL: 5.7 lub nowszy / MariaDB: 10.3 lub nowszy
• Licencja: Aktywna licencja wtyczki

Zalecane rozszerzenia PHP

• curl - komunikacja z API EstiCRM
• mbstring - obsługa polskich znaków
• xml - generowanie plików XML
• zip - import/eksport danych

Funkcje wtyczki

Podstawowe funkcje

• Zarządzanie nieruchomościami - dedykowany typ wpisu dg_property z rozbudowanymi polami
• Automatyczne generowanie - codzienne tworzenie plików CSV, XML i MD5 dla portalu dane.gov.pl
• Historia cen - automatyczne śledzenie zmian cen nieruchomości z wizualizacją
• System licencji - zabezpieczony system aktywacji z automatycznymi aktualizacjami
• Kreator konfiguracji - prosty wizard pierwszego uruchomienia

Integracja z EstiCRM

• Automatyczna synchronizacja nieruchomości z systemu EstiCRM
• Mapowanie pól EstiCRM → WordPress
• Planowane zadania cron dla automatyzacji
• Szczegółowe logi synchronizacji

Integracja z Elementor

Wtyczka dostarcza 16 dedykowanych widgetów Elementor:

1. Properties Grid - siatka nieruchomości z filtrowaniem
2. Property Card - karta pojedynczej nieruchomości
3. Property Comparison - porównywarka nieruchomości
4. Property Contact Form - formularz kontaktowy
5. Property Data Table - tabela z danymi nieruchomości
6. Property Developer Info - informacje o deweloperze
7. Property Field - pojedyncze pole nieruchomości
8. Property Gallery - galeria zdjęć nieruchomości
9. Property Investment Info - dane inwestycji
10. Property Location Map - mapa lokalizacji
11. Property Parts List - lista części (pokoje, piętra)
12. Property Price Display - wyświetlanie ceny
13. Property Price History - historia zmian cen
14. Property Prospekt Download - pobieranie prospektu
15. Property Status Badge - badge statusu (dostępne/sprzedane)
16. Property Base - bazowy widget do rozbudowy

Bloki Gutenberg

• Property Info - kompletne informacje o nieruchomości
• Property List - lista nieruchomości z filtrowaniem
• Property Price - wyświetlanie ceny
• Property Gallery - galeria zdjęć

Instalacja

Metoda 1: Instalacja przez panel WordPress (zalecana)

1. Pobierz plik ZIP wtyczki z Twojego konta na deweloper-gov.pl
2. Zaloguj się do panelu administracyjnego WordPress
3. Przejdź do Wtyczki → Dodaj nową
4. Kliknij Wyślij wtyczkę na serwer
5. Wybierz pobrany plik ZIP
6. Kliknij Zainstaluj a następnie Aktywuj

Metoda 2: Instalacja przez FTP

1. Rozpakuj plik ZIP wtyczki
2. Wgraj folder deweloper-gov do katalogu /wp-content/plugins/
3. W panelu WordPress przejdź do Wtyczki
4. Znajdź "Deweloper GOV" i kliknij Aktywuj

Aktywacja licencji

Po instalacji:

1. Przejdź do Ustawienia → Deweloper GOV → zakładka Licencja
2. Wprowadź klucz licencyjny otrzymany przy zakupie
3. Kliknij Aktywuj licencję
4. Po pomyślnej aktywacji zobaczysz zielony komunikat potwierdzający

Konfiguracja podstawowa

Kreator pierwszego uruchomienia

Po aktywacji wtyczki uruchomi się automatyczny kreator konfiguracji:

Krok 1: Informacje o deweloperze

Wypełnij podstawowe dane:

• Nazwa firmy deweloperskiej
• NIP
• Adres
• Telefon kontaktowy
• Email kontaktowy
• Strona WWW

Krok 2: Konfiguracja publikacji

Ustaw parametry eksportu:

• Częstotliwość generowania: Codziennie o 05:10 (domyślnie)
• Format daty: Y-m-d (2025-11-14)
• Separator CSV: średnik (;)

Krok 3: Przegląd ustawień

Sprawdź poprawność wprowadzonych danych i zakończ kreator.

Ustawienia zaawansowane

Zakładka "Ustawienia"

• Provider Name: Nazwa dostawcy danych (Twoja firma)
• Provider URL: Adres strony WWW
• Contact Name: Osoba kontaktowa
• Contact Email: Email kontaktowy
• Import URL: URL do pliku latest.xml (generowany automatycznie)
• Resource Base URL: Bazowy URL do plików CSV (generowany automatycznie)

Zakładka "EstiCRM"

Jeśli korzystasz z systemu EstiCRM:

1. Company ID: Identyfikator firmy w EstiCRM
2. API Token: Token autoryzacyjny API
3. Inwestycja: Wybierz inwestycję do synchronizacji (po testowym połączeniu)
4. Automatyczna synchronizacja: Włącz/wyłącz cron
5. Częstotliwość: daily (codziennie) / hourly (co godzinę)

Testowanie połączenia:

• Wprowadź Company ID i Token
• Kliknij "Testuj połączenie"
• Po pozytywnym teście kliknij "Załaduj inwestycje"
• Wybierz inwestycję z listy

Jak dodać nieruchomość

Metoda 1: Ręcznie przez panel WordPress

1. Przejdź do Nieruchomości → Dodaj nową
2. Wprowadź tytuł nieruchomości (np. "Apartament 23A - III piętro")
3. Uzupełnij wszystkie wymagane pola w sekcjach:

Sekcja "Dane podstawowe"

• Numer lokalu (unikalne oznaczenie)
• Typ nieruchomości (mieszkanie/dom/lokal)
• Status (dostępne/zarezerwowane/sprzedane)
• Cena całkowita (PLN)
• Powierzchnia całkowita (m²)

Sekcja "Lokalizacja"

• Województwo
• Powiat
• Gmina
• Miejscowość
• Ulica
• Numer budynku
• Kod pocztowy

Sekcja "Szczegóły"

• Liczba pokoi
• Liczba łazienek
• Piętro
• Rok oddania do użytkowania
• Opis (opcjonalnie)

Sekcja "Galeria"

• Dodaj zdjęcia nieruchomości
• Pierwsze zdjęcie będzie miniaturą
• Zalecany format: JPG, PNG
• Zalecany rozmiar: max 2000x2000px

Sekcja "Pliki"

• Prospekt PDF (opcjonalnie)

• Rzut mieszkania (opcjonalnie)

• Kliknij Opublikuj

Metoda 2: Import z EstiCRM

Jeśli masz skonfigurowaną integrację EstiCRM:

1. Przejdź do Ustawienia → Deweloper GOV → zakładka EstiCRM
2. Kliknij Synchronizuj teraz
3. Poczekaj na zakończenie procesu
4. Sprawdź logi synchronizacji
5. Przejdź do Nieruchomości i zweryfikuj zaimportowane dane

Automatyczna synchronizacja:

• Włącz "Automatyczna synchronizacja" w ustawieniach EstiCRM
• Wybierz częstotliwość (codziennie/co godzinę)
• Wtyczka będzie automatycznie pobierać zmiany z EstiCRM

Konfiguracja eksportu do dane.gov.pl

Przygotowanie plików

Wtyczka automatycznie generuje trzy pliki:

1. cennik-YYYYMMDD.csv - plik z ofertami na dany dzień
2. latest.xml - metadane datasetu (główny plik)
3. latest.md5 - suma kontrolna pliku XML

Lokalizacja plików

Pliki są generowane w:

/wp-content/uploads/dane-gov/

URL plików:

https://twoja-domena.pl/wp-content/uploads/dane-gov/latest.xml
https://twoja-domena.pl/wp-content/uploads/dane-gov/latest.md5
https://twoja-domena.pl/wp-content/uploads/dane-gov/cennik-20251114.csv

Rejestracja na dane.gov.pl

Krok 1: Utworzenie konta

1. Wejdź na https://dane.gov.pl
2. Kliknij Zaloguj się → Zarejestruj się
3. Wypełnij formularz rejestracyjny
4. Potwierdź email

Krok 2: Dodanie datasetu

1. Po zalogowaniu kliknij Dodaj dataset
2. Wypełnij formularz:
   • Tytuł: "Oferta nieruchomości deweloperskich - [Nazwa Twojej firmy]"
   • Opis: Krótki opis Twojej oferty
   • Kategoria: Budownictwo, gospodarka nieruchomościami
   • Częstotliwość aktualizacji: Codziennie
   • Licencja: Wybierz odpowiednią licencję

Krok 3: Dodanie zasobu

1. W sekcji "Zasoby" kliknij Dodaj zasób
2. Wybierz Link do zasobu

3. Wprowadź dane:

   • Nazwa: "Plik metadanych XML"
   • URL: https://twoja-domena.pl/wp-content/uploads/dane-gov/latest.xml
   • Format: XML

4. Kliknij Dodaj zasób ponownie dla sumy MD5:

   • Nazwa: "Suma kontrolna MD5"
   • URL: https://twoja-domena.pl/wp-content/uploads/dane-gov/latest.md5
   • Format: TXT

5. Zapisz dataset

Krok 4: Weryfikacja

1. Portal dane.gov.pl automatycznie pobierze Twoje pliki
2. Sprawdź czy nie ma błędów walidacji
3. Dataset pojawi się na portalu po weryfikacji administratora

Automatyczne aktualizacje

Wtyczka automatycznie aktualizuje pliki:

• Codziennie o 05:10 (czas serwera)
• Generuje nowy plik CSV z aktualną ofertą
• Aktualizuje plik latest.xml ze wszystkimi zasobami (ostatnie 30 dni)
• Przelicza sumę MD5

Portal dane.gov.pl pobierze aktualizacje automatycznie.

Widgety Elementor

Jak używać widgetów

1. Otwórz stronę w Elementorze
2. W panelu po lewej znajdź sekcję Deweloper GOV
3. Przeciągnij wybrany widget na stronę
4. Skonfiguruj widget w panelu ustawień

Przykładowe użycie

Strona pojedynczej nieruchomości

1. Property Gallery - galeria zdjęć na górze
2. Property Price Display - wyróżniona cena
3. Property Data Table - tabela z parametrami
4. Property Location Map - mapa lokalizacji
5. Property Contact Form - formularz kontaktowy

Strona z listą ofert

1. Properties Grid - siatka wszystkich nieruchomości
   • Ustaw liczbę kolumn (2, 3 lub 4)
   • Włącz filtry (typ, cena, powierzchnia)
   • Ustaw sortowanie domyślne

Bloki Gutenberg

Jak używać bloków

1. W edytorze Gutenberga kliknij +
2. Wyszukaj "Property" lub "Nieruchomość"
3. Wybierz odpowiedni blok
4. Skonfiguruj blok w panelu po prawej

Property Info Block

Kompletny blok z informacjami o nieruchomości:

• Zdjęcie miniaturowe
• Cena
• Powierzchnia
• Liczba pokoi
• Lokalizacja
• Status

Property List Block

Lista nieruchomości z opcjami:

• Liczba wyświetlanych nieruchomości
• Filtrowanie po statusie
• Sortowanie (cena, powierzchnia, data)
• Widok siatki lub listy

FAQ - Najczęstsze problemy

Nie generują się pliki CSV/XML

Problem: Pliki nie pojawiają się w katalogu uploads/dane-gov/

Rozwiązanie:

1. Sprawdź uprawnienia do katalogu wp-content/uploads/ (powinno być 755)
2. Sprawdź czy cron WordPress działa: Wtyczki → Dodaj nową → WP Crontrol
3. Uruchom generowanie ręcznie: Ustawienia → Deweloper GOV → zakładka Status → "Generuj teraz"
4. Sprawdź logi błędów WordPress w /wp-content/debug.log

Duplikaty nieruchomości po synchronizacji EstiCRM

Problem: Po synchronizacji pojawiają się duplikaty tego samego mieszkania

Rozwiązanie:

1. Usuń wszystkie nieruchomości: Nieruchomości → zaznacz wszystkie → Przenieś do kosza
2. Wejdź do kosza i usuń na stałe
3. Uruchom ponowną synchronizację EstiCRM
4. Sprawdź czy w EstiCRM nie ma duplikatów UUID

Błąd "Nieaktywna licencja"

Problem: Wtyczka zgłasza nieaktywną licencję mimo aktywacji

Rozwiązanie:

1. Sprawdź połączenie internetowe serwera
2. Sprawdź czy domena jest prawidłowa (bez www lub z www)
3. Dezaktywuj i aktywuj licencję ponownie
4. Skontaktuj się z supportem: biuro@gotoweb.pl

Nieruchomości nie wyświetlają się na stronie

Problem: Po dodaniu nieruchomości nie są widoczne na stronie

Rozwiązanie:

1. Sprawdź czy nieruchomość ma status "Opublikowana"
2. Sprawdź czy widget/blok ma prawidłowe filtry
3. Wyczyść cache WordPress (jeśli korzystasz z pluginu cache)
4. Sprawdź uprawnienia użytkownika do przeglądania CPT

Nieprawidłowe ceny w pliku CSV

Problem: Ceny w pliku CSV są inne niż w panelu WordPress

Rozwiązanie:

1. Sprawdź historię cen: edytuj nieruchomość → sekcja "Historia cen"
2. Usuń nieprawidłowe wpisy z historii
3. Zapisz prawidłową cenę
4. Wygeneruj plik ponownie: Ustawienia → Deweloper GOV → "Generuj teraz"

Błąd 403 przy pobieraniu plików przez dane.gov.pl

Problem: Portal dane.gov.pl nie może pobrać latest.xml

Rozwiązanie:

1. Sprawdź plik .htaccess w katalogu dane-gov/:

   <Files "*.xml">
    Header set Content-Type "text/xml; charset=utf-8"
   </Files>
   <Files "latest.xml">
    Require all granted
   </Files>
   

2. Sprawdź czy hosting nie blokuje requestów z zewnątrz
3. Wyłącz tymczasowo wtyczkę security (np. Wordfence)
4. Skontaktuj się z supportem hostingu

Wsparcie techniczne

Dokumentacja

Pełna dokumentacja techniczna: DOCUMENTATION.md (w katalogu wtyczki)

Kontakt

• Email: biuro@gotoweb.pl
• Telefon: +48 XXX XXX XXX
• Strona: https://deweloper-gov.pl
• Support: https://deweloper-gov.pl/support

Zgłaszanie błędów

Przy zgłaszaniu błędu prosimy o podanie:

1. Wersji wtyczki
2. Wersji WordPress
3. Wersji PHP
4. Opisu problemu
5. Kroków do odtworzenia
6. Screenshota (jeśli dotyczy)
7. Logów z debug.log (jeśli dostępne)

Licencja

Wtyczka "Deweloper GOV" jest własnością Gotoweb.pl i jest dystrybuowana na podstawie licencji komercyjnej.

Zakup licencji obejmuje:

• Licencję na jedną domenę
• 12 miesięcy wsparcia technicznego
• 12 miesięcy darmowych aktualizacji

Po okresie 12 miesięcy:

• Wtyczka będzie nadal działać
• Możliwość przedłużenia wsparcia i aktualizacji

Zakaz

• Rozpowszechniania wtyczki bez licencji
• Modyfikacji systemu licencji
• Odsprzedaży wtyczki
• Używania na więcej niż jednej domenie (bez dodatkowej licencji)

Changelog

Pełna historia zmian: CHANGELOG.md

Wersja 1.2.0 (2025-11-14)

Nowe funkcje:

• Refaktoryzacja architektury zgodnie z SOLID
• Nowe klasy: LicenseManager, MigrationManager, AssetManager, CronManager, CptManager
• Nowe handlery AJAX: EstiCrmAjaxHandler, GeneralAjaxHandler
• Kompletna dokumentacja (README.md + DOCUMENTATION.md)

Poprawa jakości kodu:

• Wszystkie docbloki w języku angielskim
• Zgodność z PSR-1 do PSR-20
• Weryfikacja PHPCS i PHPStan
• Usunięcie zbędnych komentarzy

---

Deweloper GOV © 2025 Gotoweb.pl - Wszystkie prawa zastrzeżone