Jak połączyć WordPress z portalem Dane.gov.pl?

**Jeśli Twoja strona deweloperska działa na WordPressie, zapewne zastanawiasz się, jak spełnić wymóg codziennego raportowania cen mieszkań do WordPress jako system zarządzania treścią (CMS) jest niezwykle popularny -- także w branży deweloperskiej wiele stron prezentujących inwestycje korzysta z WP i różnych wtyczek nieruchomości. Nowe przepisy (tzw. ustawa o jawności cen 2025) nakładają jednak dodatkową warstwę integracji: codzienny eksport cen mieszkań do rządowego portalu danych. W tym artykule wyjaśniamy, jak praktycznie połączyć WordPressa z używając platformy Eksporta. Dowiesz się, jak Eksporta pobiera dane z Twojej strony, generuje wymagane pliki XML i MD5 oraz jakie są plusy takiego zautomatyzowanego rozwiązania.

WordPress jako strona dewelopera -- jakie stawia wyzwania?

WordPress słynie z elastyczności -- istnieją dziesiątki wtyczek i motywów pozwalających prezentować oferty nieruchomości. Być może używasz dedykowanej wtyczki deweloperskiej, custom post type do lokali mieszkalnych albo nawet WooCommerce zmodyfikowanego na potrzeby sprzedaży mieszkań. Niezależnie od podejścia, dane o Twoich ofertach (mieszkaniach, domach) siedzą w bazie WordPressa. Standardowo WordPress nie posiada funkcji eksportu danych na zewnętrzny portal w określonym formacie -- trzeba to zrealizować dodatkowymi narzędziami. Część deweloperów zleca napisanie własnej wtyczki do generowania pliku XML na inni korzystają z gotowych rozwiązań oferowanych przez firmy zewnętrzne. Eksporta jest właśnie takim rozwiązaniem zewnętrznym, ale zamiast działać jako wtyczka wewnątrz WordPressa, pracuje jako oddzielna platforma integracyjna. To podejście ma wiele zalet: odciążenie Twojej strony, większą niezawodność i wsparcie specjalistów. Zobaczmy, jak wygląda integracja krok po kroku.

Jak Eksporta integruje się z WordPress?

Integracja z WordPress może przybierać różne formy, w zależności od tego, jak masz zorganizowane dane o mieszkaniach. Eksporta oferuje elastyczne podejście, by dopasować się do Twojej sytuacji:

• Pobieranie danych przez API WordPressa: WordPress posiada wbudowane REST API, które umożliwia pobieranie zawartości (postów, stron, custom fields) w formacie JSON. Jeśli Twoje oferty mieszkaniowe są np. wpisami typu "oferta" albo "lokal" z polami meta (metadanymi) dotyczącymi cen, powierzchni itp., Eksporta może skorzystać z API aby regularnie odczytać te dane. Konfigurujemy zapytania tak, by zebrać wszystkie aktualne oferty -- podobnie, jak robi to Twoja strona przy wyświetlaniu listy mieszkań. To rozwiązanie nie wymaga instalacji dodatkowej wtyczki i działa z większością standardowych motywów/wtyczek, o ile dane są dostępne poprzez API (większość nowoczesnych rozwiązań na WP na to pozwala).
• Dedykowana wtyczka integracyjna: W niektórych przypadkach, zwłaszcza jeśli używasz mocno zmodyfikowanego WordPressa lub niestandardowej bazy danych, lepsze jest podejście z małą wtyczką. Eksporta udostępnia lekką wtyczkę WordPress, której zadaniem jest wyciągnięcie danych o ofertach i przekazanie ich do platformy Eksporta. Taka wtyczka może np. dodawać specjalny endpoint (adres URL) na Twojej stronie, pod którym Eksporta odbierze spakowane dane. Zaletą jest to, że można ją dostosować do niemal każdego schematu danych -- niezależnie od tego, jak egzotyczne masz rozwiązanie, jesteśmy w stanie napisać parę linijek kodu, by je obsłużyć. Wtyczka dba o bezpieczeństwo (autoryzacja dostępu), więc dane nie trafią w niepowołane ręce.
• Przesyłanie danych z WP do Eksporta (Webhook/PUSH): Alternatywnie, można skonfigurować WordPress tak, by to on "popychał" dane do Eksporta. Np. gdy zmienisz cenę mieszkania w panelu WP, wtyczka od razu wysyła informację do API Eksporta o zmianie. Wówczas nasza platforma aktualizuje swoje repozytorium danych i generuje nowe pliki. Takie podejście (tzw. webhooki) zapewnia natychmiastową aktualizację, choć w kontekście wymagań ustawy nie jest to konieczne (wystarczy raz dziennie). Może jednak być przydatne, jeśli chcesz mieć pewność, że każda zmiana od razu trafi do kolejnego eksportu.

Niezależnie od metody, efekt jest taki, że Eksporta codziennie dysponuje aktualnym zestawem danych o Twoich lokalach. Następne etapy są analogiczne jak w innych integracjach:

• Generacja pliku XML: Z zebranych z WordPressa danych Eksporta tworzy plik XML zgodny z wymogami portalu Konieczne jest tutaj dopasowanie pól z WP do pól wymaganych przez ministerstwo. Na szczęście większość informacji pokrywa się -- zapewne w WordPressie masz wprowadzone ceny brutto, metraże, liczby pokoi, itp. Być może brakuje historii zmian cen (chyba że ręcznie ją prowadziłeś na stronie) -- Eksporta może ją zbudować na podstawie wcześniej zarejestrowanych danych (nasz system może przechowywać poprzednią wartość ceny i datę zmiany, by umieścić ją w XML). Gotowy plik zawiera wszystkie inwestycje i lokale z Twojej strony, przedstawione w wymaganej strukturze.
• Generacja pliku MD5: Równolegle powstaje plik MD5 -- suma kontrolna wygenerowanego XML. To standardowa procedura, która pozwala potem systemowi rządowemu zweryfikować integralność  krótki%20plik%20tekstowy%2C,Przykład).
• Udostępnienie plików: Eksporta udostępnia XML i MD5 pod stałym URL (może to być np. poddomena Twojej strony lub inne ustalone miejsce). Możliwe, że zechcesz, aby pliki były dostępne bezpośrednio na Twojej domenie (np. aby zachować spójność -- jest taka opcja, konfigurujemy wtedy odpowiednie przekierowanie lub publikację. Ewentualnie udostępniamy pliki w naszej chmurze z unikalnym adresem. Najważniejsze, że codziennie pobierze te pliki automatycznie**, więc Twoja rola ogranicza się do zgłoszenia linku do ministerstwa i... to wszystko.

Z punktu widzenia wydajności, integracja zewnętrzna (Eksporta) ma tę zaletę, że nie obciąża Twojego WordPressa generowaniem dużych plików każdego dnia -- ciężar przetwarzania bierze na siebie nasz serwer. Twoja strona nadal działa szybko dla użytkowników, a integracja odbywa się w tle.

Pliki XML i MD5 -- jak wyglądają dla strony na WordPressie?

Być może chcesz wiedzieć, jakie konkretnie informacje z Twojej strony trafią do pliku XML wysyłanego do Ogólnie, będą to wszystkie pola wymagane ustawą, czyli:

• Informacje o deweloperze -- nazwa firmy, adres siedziby, NIP, oraz osoba do kontaktu (to zwykle podaje się raz, możemy to wpisać ręcznie podczas konfiguracji).
• Informacje o inwestycji -- jeśli Twoja strona WP prezentuje wiele inwestycji, każda z nich będzie osobno opisana w pliku. Dane obejmują nazwę inwestycji, adres (ulica, miejscowość), unikalny identyfikator (np. możemy użyć slug-a z WP lub innego ID), link do strony inwestycji (URL w Twoim serwisie) oraz link do prospektu informacyjnego (np. PDF do pobrania, jeśli udostępniasz).
• Lista lokali -- dla każdej inwestycji wyszczególnione będą wszystkie oferowane lokale. Z WordPressa pobierzemy dla każdego lokalu takie pola jak: nazwa lub numer lokalu, metraż, liczba pokoi, cena brutto, cena za m², status (dostępny/zarezerwowany/sprzedany), piętro, opcjonalnie przynależności (tu czasem w WP są to osobne pola lub taksonomie, np. „garaż: tak/nie, cena garażu"). Jeśli używasz jakiejś wtyczki nieruchomości, zwykle te dane są wprowadzone -- musimy je tylko zmapować. Eksporta zadba, by niczego nie pominąć, nawet jeżeli w WP pewne informacje były w niestandardowej formie (np. wpisane w treści opisu -- wtedy możemy rozważyć ich wydobycie).
• Historia cen -- to element, którego standardowe strony deweloperskie wcześniej nie pokazywały, ale teraz jest wymagany. Jeżeli Twoja wtyczka WordPress nie przechowuje historii, Eksporta ją dla Ciebie zbuduje i utrzyma. Oznacza to, że gdy cena lokalu się zmieni i zaktualizujesz ją w WP, my zachowamy informację o poprzedniej cenie i dacie zmiany, by umieścić ją w następnym pliku XML. Dzięki temu spełnisz wymóg pokazywania historycznych cen (co jest też wymagane na Twojej stronie zgodnie z art. 19a -- możemy pomóc w wyświetlaniu tego na stronie, jeśli chcesz).

Sam plik XML ma dość czytelną strukturę -- jest podzielony na bloki odpowiadające powyższym elementom. Plik MD5 zawiera natomiast tylko jeden wiersz z sumą kontrolną i nazwą pliku XML, np.:

d41d8cd98f00b204e9800998ecf8427e ofertymieszkan.xml

(tutaj przykład sumy kontrolnej). Portal użyje go, by sprawdzić poprawność pobranego XML -- to wszystko dzieje się automatycznie.

Jakie korzyści daje automatyzacja WordPress + Eksporta?

Rozwiązanie oparte na WordPressie często bywa szyte na miarę, a deweloperzy lubią mieć nad nim kontrolę. Może zastanawiasz się, czy wprowadzać do tego dodatkowy system jak Eksporta. Oto argumenty, dlaczego warto:

• Bezobsługowe spełnienie nowych przepisów: Dzięki integracji Twoja strona na WP z automatu spełnia ustawę o jawności cen. Nie musisz codziennie generować żadnych plików ani ich nigdzie wysyłać -- po jednokrotnym skonfigurowaniu, Eksporta przejmuje ten obowiązek. Unikasz stresu i ryzyka kar, które w skrajnym przypadku mogłyby wynieść do 10% obrotu za uchylanie się od Twoja strona pozostaje źródłem prawdy o cenach, a Eksporta dba, by prawda ta trafiała też do rządowego systemu.
• Brak wpływu na wydajność i bezpieczeństwo strony: Wtyczki tworzone szybko pod nowe wymagania mogą obciążać WordPress albo wprowadzać luki bezpieczeństwa. Wybierając integrację przez Eksporta, odciążasz swoją stronę -- generowanie pliku i udostępnianie go odbywa się poza WordPressem. Twoja strona nie będzie narażona na spowolnienie działania czy potencjalne problemy z powodu dodatkowego kodu tworzącego XML. Dodatkowo, dane przekazujemy w sposób bezpieczny -- np. przez autoryzowane API -- więc nie musisz wystawiać publicznie żadnych wrażliwych endpointów poza tym finalnym plikiem XML/MD5 (który i tak zawiera tylko informacje, które muszą być jawne).
• Oszczędność czasu przy wdrożeniu: Tworzenie dedykowanej wtyczki od zera lub ręczne eksporty to czasochłonne i podatne na błąd przedsięwzięcia. Eksporta oferuje gotowe, sprawdzone rozwiązanie, z którego korzysta wielu deweloperów. Wdrożenie integracji zajmuje zazwyczaj kilka godzin do maksymalnie kilku dni (przy bardzo niestandardowych stronach). To szybko, zważywszy na złożoność zadania. Ty nie musisz zagłębiać się w techniczne szczegóły -- nasi eksperci pomogą dobrać najlepszą metodę integracji i wszystko skonfigurują.
• Profesjonalne wsparcie i aktualizacje: Korzystając z Eksporta, zyskujesz partnera, który śledzi zmiany w wymaganiach i reaguje na nie. Jeśli np. ministerstwo zmodyfikuje format danych (np. doda nowe pole do raportowania), my zaktualizujemy system, a Ty nawet nie odczujesz różnicy. Gdybyś miał własną wtyczkę, sam musiałbyś dokonywać takich poprawek. Do tego dochodzi wsparcie -- w razie pytań czy problemów masz się do kogo zwrócić. To ważne, bo integracja z portalem rządowym to coś nowego i dobrze jest mieć zaplecze w postaci doświadczonego zespołu.
• Skupienie się na tym, co ważne: Twoja strona WordPress ma sprzedawać mieszkania i dobrze wyglądać -- to jej główne zadania. Integracja z choć istotna prawnie, jest dodatkiem, który nie musi zaprzątać Ci głowy codziennie. Automatyzując ją, zyskujesz spokój ducha i możesz w pełni skupić się na marketingu inwestycji oraz obsłudze klientów. Systematyczne raportowanie cen dzieje się gdzieś w tle, a Ty możesz praktycznie o nim zapomnieć (oczywiście pamiętając, by nadal aktualizować ceny na stronie, co i tak robiłeś).

Na koniec warto wspomnieć: jawne publikowanie cen i ich automatyczne raportowanie może przynieść także wizerunkowe korzyści. Klienci widzą, że deweloper jest transparentny, a dane są zawsze aktualne -- to buduje zaufanie. Ponadto, portal stanie się źródłem informacji dla wielu potencjalnych nabywców i analityków rynku; dobrze, aby Twoje inwestycje również tam figurowały rzetelnie. Dzięki Eksporta masz pewność, że tak będzie każdego dnia.

Jeżeli chcesz zobaczyć, jak integracja WordPress z wygląda w praktyce -- zapraszamy do kontaktu. Pokażemy Ci krok po kroku, jak Eksporta może usprawnić Twoje raportowanie cen i zapewnić pełną zgodność z przepisami, bez komplikacji na stronie WWW.

Umów demo Eksporta.