Realizacja: ceny z API wtyczki na stronie zbudowanej w Elementorze – inwestycja Odsieczy Wiednia No.6
Strona inwestycji Odsieczy Wiednia No.6 miała dopracowane karty domów w Elementorze – z rzutami, galerią i kartami do pobrania. Nie zastępowaliśmy ich tabelą. Wtyczka DeweloperCeny prowadzi cennik i raport dla dane.gov.pl, a ceny, statusy, historia ceny i najniższa cena z 30 dni wczytują się do istniejących kart przez API.
W skrócie
- Yellow Development sprzedaje cztery domy w inwestycji Odsieczy Wiednia No.6 w warszawskim Aninie; strona stoi na WordPressie z Elementorem i ma własne karty lokali.
- Wtyczkę DeweloperCeny wdrożyliśmy z pakietem startowym: dane spółki, inwestycja, lokale, prospekt i karty wgrały się same przy włączeniu wtyczki.
- Karty domów zostały takie, jakie były. Skrypt pobiera z API wtyczki ceny, statusy, metraże, historię ceny i najniższą cenę z 30 dni i podmienia je w kartach.
- Cennik, historia i raport dla dane.gov.pl działają z jednego panelu, więc karta na stronie i raport pokazują te same dane.
Spis treści 6 części
Yellow Development sprzedaje cztery domy w inwestycji Odsieczy Wiednia No.6 w warszawskim Aninie. Strona inwestycji stoi na WordPressie z Elementorem i ma własne, dopracowane karty domów, więc nie zastępowaliśmy ich tabelą: wtyczka DeweloperCeny prowadzi cennik, historię cen i raport dla dane.gov.pl, a ceny, statusy, metraże, historia ceny i najniższa cena z 30 dni wczytują się do istniejących kart przez API wtyczki. Wygląd strony się nie zmienił, a ceny przestały być wpisane ręcznie.
Masz stronę z własnym projektem kart lokali? Jak podłączyć do niej dane z wtyczki, opisujemy na stronie API dla agencji, a przegląd możliwości – w artykule jawność cen na stronie na kreatorze albo własnym CMS.
Punkt wyjścia
Strona inwestycji była gotowa: opis domów, galerie, karty z rzutami parteru, piętra, antresoli i ogrodu oraz komplet kart do pobrania w PDF. Ceny i statusy były jednak wpisane w kartach ręcznie, a dewelopera czekały obowiązki z ustawy o jawności cen: aktualizacja ceny z dniem zmiany, historia od rozpoczęcia sprzedaży, najniższa cena z 30 dni przy obniżce i codzienny raport dla dane.gov.pl.
Najprostsze rozwiązanie – osadzić pod kartami tabelę cen z wtyczki – zostawiłoby na stronie dwa miejsca z cenami: tabelę i karty. A dwie kopie cen to prosta droga do rozbieżności, o której piszemy w artykule dwie ceny tego samego mieszkania na stronie.
Co zrobiliśmy
Pakiet startowy z danymi inwestycji
Dane spółki do raportu, inwestycję, lokale z cenami i datą cennika, prospekt informacyjny i karty lokali przygotowaliśmy jako pakiet startowy dołączony do paczki wtyczki. Wszystko wgrało się samo przy włączeniu wtyczki, bez przepisywania cennika w panelu.
Raport dla dane.gov.pl
Wtyczka wystawia plik XML z sumą kontrolną MD5 i codzienne pliki CSV pod stałymi adresami. Przed zgłoszeniem w portalu sprawdziliśmy plik XML ze schematem portalu.
Skrypt w istniejącej stronie
Na końcu strony inwestycji dopisaliśmy skrypt, który pobiera z API wtyczki listę lokali inwestycji i historię ceny każdego lokalu, a potem dopasowuje dane do kart po numerze lokalu.
Dane w kartach domów
W każdej karcie skrypt ustawia status (w sprzedaży, rezerwacja, sprzedany), cenę, cenę za m² i metraż, wypełnia okno ze szczegółami, pokazuje historię ceny, a przy obniżce – najniższą cenę z 30 dni. W stopce pokazuje datę, na którą obowiązuje cennik.
Reszta strony – teksty, galerie, rzuty i karty PDF – została bez zmian. Zmiana ceny albo statusu w panelu wtyczki od razu pojawia się w karcie domu, w historii ceny i w najbliższym raporcie.
Dlaczego API, a nie tabela
| Tabela z wtyczki pod kartami | Dane z API w istniejących kartach | |
|---|---|---|
| Wygląd strony | Dochodzi nowy element, który trzeba dopasować do projektu | Bez zmian – dane trafiają w miejsca, które już są |
| Miejsca z ceną | Dwa: tabela i karty, chyba że ceny z kart się usunie | Jedno: karty czytają cennik wtyczki |
| Historia ceny i Omnibus | W tabeli, obok kart | W karcie domu, przy cenie |
| Praca przy wdrożeniu | Mniej kodu, więcej projektowania | Skrypt dopasowany do budowy kart |
Publiczne API wtyczki, z którego korzysta ten skrypt, jest tylko do odczytu i zwraca dane w JSON bez klucza – te same, które i tak są publiczne na stronie. Osobne API zapisu dla CRM (od wersji 2.23) jest domyślnie wyłączone i wymaga klucza; tu nie było potrzebne. Ukryte ceny są ukryte także w API, a pole z najniższą ceną z 30 dni jest w danych każdego lokalu.
Czego się nauczyliśmy
Jeśli ceny mają płynąć w drugą stronę – z systemu sprzedaży do cennika – zobacz cztery sposoby połączenia systemu sprzedaży z raportem.
- Numer lokalu to klucz. Skrypt dopasowuje karty do lokali po numerze, więc numeracja w kartach, cenniku, prospekcie i raporcie musi być ta sama.
- Stare ceny trzeba usunąć wszędzie. Poza kartami ceny bywają w starych tabelach, opisach i okienkach – przy wdrożeniu przegląda się całą stronę, nie tylko sekcję z lokalami.
- Kreator zostaje kreatorem. Deweloper dalej edytuje treści strony w Elementorze, a ceny i statusy zmienia w panelu wtyczki – każdy zajmuje się swoim.
Stronę inwestycji zobaczysz pod adresem yellow-development.com. Podobnie działa każda strona, która pozwala wstawić własny kod – także zbudowana w innym kreatorze albo poza WordPressem.
Najczęstsze pytania
Czy da się dodać jawność cen do strony w Elementorze bez zmiany wyglądu?
Tak. Wtyczka DeweloperCeny prowadzi cennik, historię i raport, a do istniejących kart lokali dopisuje się skrypt, który pobiera dane z API wtyczki i wstawia je w karty. Wygląd strony zostaje bez zmian, a ceny przestają być wpisane ręcznie.
Co pobiera skrypt z API na stronie Odsieczy Wiednia No.6?
Status lokalu, cenę, cenę za m², metraż, szczegóły do okna karty, historię ceny i najniższą cenę z 30 dni przed obniżką, a w stopce datę stanu cennika. Karty dopasowuje po numerze lokalu.
Co to jest pakiet startowy wtyczki?
To dane klienta dołączone do paczki wtyczki: dane spółki do raportu, inwestycja, lokale z cenami i datą cennika, prospekt i karty lokali. Wgrywają się same przy włączeniu wtyczki i niczego nie nadpisują, więc wdrożenie nie wymaga przepisywania cennika w panelu.
Źródła i podstawa prawna
Stan prawny na 29 października 2026. Artykuł ma charakter informacyjny i nie jest poradą prawną.
- Ustawa z dnia 20 maja 2021 r. o ochronie praw nabywcy lokalu mieszkalnego lub domu jednorodzinnego oraz Deweloperskim Funduszu Gwarancyjnym (tekst jednolity) Dz.U. 2026 poz. 880
- Ustawa z dnia 9 maja 2014 r. o informowaniu o cenach towarów i usług (tekst jednolity) Dz.U. 2023 poz. 168
- Strona inwestycji Odsieczy Wiednia No.6 (Yellow Development)
- ISAP: ustawa deweloperska, tekst jednolity Dz.U. 2026 poz. 880 (art. 19a, art. 19b)