Nasz moduł Jawne ceny dla WordPressa, zaprojektowany jako stabilny silnik eksportowy dla projektów opartych na WordPress, w których liczy się zgodność, powtarzalność i automatyzacja procesu raportowania danych. Wtyczka generuje komplet plików CSV + XML + MD5 dla eksportu cen ofert – w sposób zgodny z wymaganiami publikacji danych (np. dane.gov.pl).

Kompleksowe rozwiązanie dla zarówno dla opiekunów stron firm deweloperskich jak i samych użytkowników końcowych i małych deweloperów zarządzających własną stroną WWW. Dzięki kompatybilności z różnymi wtyczkami oraz standardowymi polami WordPress obsługuje wszystkie kluczowe źródła danych w ekosystemie WordPress:

• ACF (Advanced Custom Fields),

• JetEngine (Crocoblock) – także w trybie Custom Meta Storage, gdy pola zapisują się w osobnych tabelach (custom tables), a nie w wp_postmeta,

• standardowe pola WordPress (post_meta).

W praktyce oznacza to jedno: wdrażasz eksport bez migracji danych i bez przebudowy strony. Konfigurujesz mapowanie pól w panelu, a wtyczka zapewnia stały, przewidywalny format plików oraz automatyzację generowania (ręcznie lub przez CRON) — tak, aby cały proces był odporny na zmiany, aktualizacje i rozwój serwisu. W razie czego jesteśmy też skłonni rozwijać moduł o kolejne funkcjonalności.

Kompatybilność: ACF (Advanced Custom Fields)

Masz pola z ACF i chcesz generować pliki bez ręcznego kopiowania danych?
Wtyczka pobiera wartości po nazwie pola ACF (stabilnie i przewidywalnie).

Co działa w praktyce (pełen zakres funkcji):

• eksport CSV + XML + MD5 z ofert (CPT),

• mapowanie kolumn eksportu na pola ACF (text/number/select i inne wartości),

• obsługa pola „Typ lokalu / Typ oferty” – możesz wskazać pole ACF, które określa typ (np. select),

• kolumny zależne od typu + automatyczna wartość „nie dotyczy”,

• sortowanie CSV po wybranym polu (np. kolejnosc) – również jeśli to pole pochodzi z ACF,

• możliwość wykluczania pojedynczych ofert z eksportu jednym przełącznikiem,

• automatyzacja przez CRON oraz e-mail po udanym eksporcie (opcjonalnie).

Kompatybilność: Standardowe pola WordPress (post_meta)

Nie używasz ACF ani JetEngine? Dane są zapisane jako standardowe meta WordPress (post_meta)?
Wtyczka działa również na „czystym” WordPressie – bez dodatkowych zależności.

Co działa w praktyce (pełen zakres funkcji):

• eksport CSV + XML + MD5 z ofert (CPT),

• mapowanie kolumn eksportu na standardowe meta (meta_key),

• obsługa pola „Typ lokalu / Typ oferty” – możesz wskazać zwykły klucz meta, z którego ma być pobierany typ,

• kolumny zależne od typu + automatyczna wartość „nie dotyczy”,

• sortowanie CSV po wybranym polu (np. kolejnosc) – także jeśli to zwykłe meta,

• możliwość wykluczania pojedynczych ofert z eksportu jednym przełącznikiem,

• automatyzacja przez CRON oraz e-mail po udanym eksporcie (opcjonalnie).

Kompatybilność: JetEngine (Crocoblock)

Masz oferty zbudowane w JetEngine i pola zapisane w Custom Meta Storage (czyli w oddzielnych tabelach), a nie w standardowym wp_postmeta?
Wtyczka odczytuje te dane bezpośrednio – bez migracji i bez obejść.

Co działa w praktyce (pełen zakres funkcji):

• eksport CSV + XML + MD5 z ofert (CPT),

• mapowanie kolumn eksportu na pola JetEngine (text/number/select i inne wartości),

• obsługa pola „Typ lokalu / Typ oferty” (np. mieszkanie, lokal usługowy) – możesz wskazać, z którego pola JetEngine ma być pobierany typ,

• kolumny zależne od typu (np. pewne pola tylko dla wybranych typów) + automatyczna wartość „nie dotyczy”,

• sortowanie CSV po wybranym polu (np. kolejnosc) – także wtedy, gdy pole jest w tabeli JetEngine,

• możliwość wykluczania pojedynczych ofert z eksportu jednym przełącznikiem w edycji wpisu,

• automatyzacja przez CRON oraz e-mail po udanym eksporcie (opcjonalnie).

Funkcjonalności – opis szczegółowy

Eksport CSV z mapowaniem kolumn

Wtyczka umożliwia skonfigurowanie struktury pliku CSV poprzez zdefiniowanie kolumn eksportu.

W praktyce oznacza to, że:

• tworzysz listę kolumn, które mają znaleźć się w pliku CSV (np. „Nazwa inwestycji”, „Cena”, „Metraż”, „Piętro”),
• dla każdej kolumny wskazujesz, z którego pola ma zostać pobrana wartość (pole ACF, pole JetEngine lub standardowe pole meta WordPress),
• możesz ustawić wartość domyślną, która zostanie wpisana do CSV wtedy, gdy wskazane pole w danym wpisie jest puste lub nie zawiera wartości,
• wynikowy plik CSV ma stały układ kolumn i stałą kolejność, zgodną z konfiguracją, co ułatwia publikację oraz integracje z systemami zewnętrznymi.

„Typ lokalu” i kolumny zależne od typu

Wtyczka umożliwia rozróżnianie wpisów według typu (np. „mieszkanie”, „lokal usługowy”, „garaż”) i stosowanie różnych kolumn w zależności od tego typu.

W praktyce oznacza to, że:

• wskazujesz pole, z którego ma być odczytywany „typ lokalu / typ oferty” (może to być pole ACF, JetEngine lub standardowe pole meta WordPress),
• możesz przypisać kolumny jako:
  • kolumny ogólne – wypełniane dla wszystkich typów,
  • kolumny przypisane do wybranych typów – wypełniane tylko wtedy, gdy wpis ma jeden z określonych typów,
• jeżeli dana kolumna nie została przypisana do typu wpisu, wtyczka wpisuje w tej kolumnie wartość zastępczą „nie dotyczy” (domyślnie może to być „X”; wartość ta jest konfigurowalna w ustawieniach).

Metabox „Uwzględnij w eksporcie” dla pojedynczego wpisu

Wtyczka dodaje w edycji wpisu (np. oferty) dodatkową sekcję umożliwiającą włączenie lub wyłączenie eksportu dla konkretnego wpisu.

W praktyce oznacza to, że:

• dla każdego wpisu możesz określić, czy ma zostać uwzględniony w eksporcie,
• jeżeli w danym wpisie nie ustawiono żadnej wartości, wtyczka traktuje wpis jako przeznaczony do eksportu,
• jeżeli wyłączysz eksport dla wpisu, ten wpis nie zostanie uwzględniony w generowanych plikach (zarówno podczas generowania ręcznego, jak i podczas generowania uruchamianego harmonogramem CRON).

Sortowanie rekordów w CSV

Wtyczka umożliwia ustawienie kolejności wierszy w pliku CSV na podstawie wskazanego pola (np. pola „kolejność”).

W praktyce oznacza to, że:

• wskazujesz pole, według którego wiersze mają zostać posortowane (może to być standardowe meta WordPress, pole ACF lub pole JetEngine),
• wybierasz kierunek sortowania: rosnąco (ASC) lub malejąco (DESC),
• określasz sposób sortowania:
  • numeryczny (gdy wartości są liczbami, np. 1, 2, 3),
  • tekstowy (gdy wartości są tekstem),
• w przypadku JetEngine wtyczka obsługuje sortowanie także wtedy, gdy wartości pól są przechowywane w tabelach Custom Meta Storage (oddzielnych tabelach bazy danych).

Generowanie pliku XML

Wtyczka generuje plik XML zgodny z wymaganiami publikacji danych.

W praktyce oznacza to, że:

• plik XML jest tworzony automatycznie na podstawie ustawień wtyczki,
• użytkownik nie musi ręcznie edytować pliku XML,
• XML jest generowany razem z eksportem, aby można było udostępnić komplet plików wymaganych do publikacji danych.

Generowanie pliku MD5 dla XML (suma kontrolna)

Wtyczka generuje plik MD5 będący sumą kontrolną dla wygenerowanego pliku XML.

W praktyce oznacza to, że:

• po utworzeniu pliku XML obliczana jest jego suma kontrolna MD5,
• wynik jest zapisywany do osobnego pliku MD5,
• plik MD5 jest zapisywany w tej samej lokalizacji co plik XML.

Harmonogram CRON (automatyczne uruchamianie eksportu) i utrzymanie harmonogramu

Wtyczka może wykonywać eksport automatycznie według harmonogramu CRON oraz umożliwia uruchomienie eksportu ręcznie.

W praktyce oznacza to, że:

• możesz włączyć automatyczne generowanie eksportu w ustalonych odstępach czasu,
• możesz uruchomić eksport ręcznie z panelu wtyczki,
• po zapisaniu ustawień wtyczka aktualizuje harmonogram uruchomień zgodnie z konfiguracją,
• jeżeli harmonogram CRON przestanie być zarejestrowany (np. po aktualizacji wtyczki lub migracji strony) i opcja CRON jest włączona, wtyczka rejestruje zdarzenie ponownie, aby utrzymać automatyczne działanie.

Wysyłanie wiadomości e-mail po wykonaniu eksportu (CSV jako załącznik)

Wtyczka umożliwia automatyczne wysyłanie wiadomości e-mail po zakończeniu generowania eksportu, z dołączonym plikiem CSV.

W praktyce oznacza to, że:

• wiadomość e-mail jest wysyłana po zakończeniu procesu generowania eksportu,
• wiadomość e-mail jest wysyłana wyłącznie wtedy, gdy plik CSV został utworzony i jest dostępny w lokalizacji eksportu,
• możesz wskazać wielu odbiorców; adresy mogą być rozdzielane przecinkiem lub średnikiem,
• w temacie i treści e-maila można używać tokenów:
  • {Y} – rok,
  • {Y-m} – rok i miesiąc,
  • {Y-m-d} – rok, miesiąc i dzień,
  • {CSV_URL} – adres URL do pliku CSV,
• wiadomość e-mail zawiera plik CSV jako załącznik oraz może zawierać link do pliku.

Stała lokalizacja plików eksportu

Wtyczka zapisuje pliki eksportu w stałej lokalizacji w katalogu uploads WordPress.

Lokalizacja: /wp-content/uploads/acf-dane-gov/

Przykładowe pliki:

• ceny-ofertowe-YYYY-MM-DD.csv
• xml.xml
• xml.md5

Stała lokalizacja ułatwia udostępnianie plików oraz integracje, ponieważ adresy i ścieżki nie zmieniają się wraz z kolejnymi eksportami.

REST API (opcjonalnie)

Wtyczka może udostępniać endpointy REST API do uruchomienia eksportu lub pobrania plików eksportu (jeżeli funkcja REST API jest włączona w ustawieniach).

Przykładowe endpointy:

• /wp-json/acf-dane-gov/v1/csv
• /wp-json/acf-dane-gov/v1/xml