update

.paul/codebase/integrations.md

@@ -0,0 +1,43 @@
+# Integrations
+
+## WordPress
+
+- Standardowy runtime WordPress dostarcza routing, hooki, cron, AJAX, post meta, transients i admin UI.
+- `wp-content/plugins/elementor-addon/elementor-addon.php` używa `add_action()`, `add_filter()`, `WP_Query`, `$wpdb`, `dbDelta()`, `wp_schedule_event()`, `wp_send_json_success()` i `wp_send_json_error()`.
+
+## Elementor
+
+- Własna wtyczka rejestruje widgety w hooku `elementor/widgets/register`.
+- Widgety:
+  - `Elementor_Apartaments` w `wp-content/plugins/elementor-addon/widgets/apartaments.php`.
+  - `Elementor_Parking_Spots` w `wp-content/plugins/elementor-addon/widgets/parking-spots.php`.
+- Motyw Hello Elementor pozostaje aktywnym fundamentem layoutu i integruje lokalizacje Elementor Theme Builder.
+
+## ACF / ACF Pro
+
+- Lokale używają pól `information_*`, `gallery` i `documents`.
+- Miejsca postojowe używają ACF options `miejsce_postojowe_zwykle` i `miejsce_postojowe_rodzinne`.
+- Mapa garażu używa ACF option `garage_spots`.
+- Kod używa zarówno `get_field()`, jak i `get_post_meta()`; to ważne przy zmianie nazw pól lub sposobu zwracania wartości przez ACF.
+
+## dane.gov.pl
+
+- `apartamenty_generate_datagov_xml()` generuje XML katalogu dla procesu `dane.gov.pl`.
+- Dokumentacja wskazuje URL katalogu `https://wyszynskiego12.pagedev.pl/dane-gov-pl.xml`.
+- Dane katalogu zawierają hardcodowane identyfikatory i opis inwestycji, np. `wyszynskiego12-ceny-mieszkan-v1`.
+
+## CDN i biblioteki JS/CSS
+
+- Fancybox jest ładowany z `cdn.jsdelivr.net` w `wp-content/plugins/elementor-addon/elementor-addon.php`.
+- Swiper jest lokalny w `wp-content/plugins/elementor-addon/plugins/swiper/`.
+- AJAX frontendowy idzie do `admin-ajax.php` przez zmienną `apartamentsData.ajaxUrl`.
+
+## Cache i optymalizacja
+
+- XML cen jest cache'owany w transiencie `apartamenty_price_xml_cache`.
+- W repo obecne są `litespeed-cache`, `webp-express` i `wordfence`; mogą wpływać na cache, obrazki, bezpieczeństwo i zachowanie publicznych endpointów.
+
+## Administracja i utrzymanie
+
+- Strona admina `Jawność Cen` jest dodawana przez `add_management_page()` w `wp-content/plugins/elementor-addon/elementor-addon.php`.
+- Po wdrożeniu zmian rewrite rules trzeba odświeżyć bezpośrednie odnośniki w WordPress.