Aria Spain — Rebuild

Dashboard postępu projektu · WP All Import Pro

Ostatnia aktualizacja 2026-04-04 19:00
Postęp projektu
7 z 11 etapów ukończone
64%
📊

Status projektu

✅
Cleanup staging
Usunięto 35k importów, zachowano 10.5k ręcznych wpisów (Katarzyna + legacy).
Gotowe
✅
Mini-plugin aria-inwestycja
CPT inwestycja + dedykowany template + filtr archiwum /oferta/.
Gotowe
✅
Polylang fix
Naprawiono powiązania tłumaczeń między wpisami po cleanup.
Gotowe
✅
Template fix
Przywrócono domyślny szablon ofert po zmianach w FSE theme.
Gotowe
✅
Import inwestycji + ofert (custom PHP)
Skrypty importu w functions.php — parsują feed MetaInmo i tworzą posty inwestycji i ofert.
Gotowe
✅
Testowy import
End-to-end test zakończony — 976 inwestycji, ~2 534 oferty zaimportowane.
Gotowe
⏳
Kompresja zdjęć
Setup ShortPixel lub Imagify przed pełnym importem obrazków.
Oczekuje
⏳
QA na staging
Weryfikacja archiwum, stron inwestycji i linków do ofert.
Oczekuje
⏳
Deploy na produkcję
Wdrożenie na ariaspain.com po pozytywnym QA.
Oczekuje
🏗️

Architektura systemu

Przepływ danych

Feed XML
MetaInmo · 105 MB
→
WP All Import Pro
v5.0.5
→
Import 1

Inwestycje (kompleksy)

Grupowanie po complex_id
→ CPT inwestycja

Import 2

Oferty (jednostki)

Indywidualne mieszkania/domy
→ CPT oferta (hidden from archive if has complex_id)

Przepływ użytkownika

/oferta/ archiwum
inwestycje + manual offers
→
klik inwestycja
CPT inwestycja
→
dedykowany template
lista jednostek
→
klik jednostka
CPT oferta
→
single oferta
Gutenberg + CF7
🗄️

Stan bazy danych (staging)

Metryka Liczba Uwagi
Łączna liczba wpisów oferta 13,102 Stan po imporcie (cleanup + nowe wpisy)
Ręczne (Katarzyna) ~2,200 Wpisy dodawane ręcznie, zachowane w całości
Legacy (sprzed marca) ~8,300 Stare importy, zachowane celowo
Wpisy inwestycja 976 ✅ Zaimportowane z feeda MetaInmo
Zaimportowane oferty (z feeda) ~2,534 ✅ Powiązane z inwestycjami przez complex_id
Nieruchomości w feedzie ~2,661 Indywidualne oferty z MetaInmo
Kompleksy w feedzie ~976 Unikalne complex_id — zaimportowane jako inwestycje
⚙️

Stack technologiczny

📥
WP All Import Pro
v5.0.5 · importer XML/CSV
📋
Contact Form 7
+ reCAPTCHA v3
🌐
Polylang Pro
PL only (tłumaczenia później)
🔌
aria-inwestycja
v1.0.0 · custom plugin (mini)
🎨
wp-arai
FSE block theme
🖥️
home.pl
Hosting staging
📝

Dziennik decyzji

Data Decyzja Uzasadnienie
2026-04-04 Pivot z custom plugin → WP All Import Pro Zbyt wiele problemów z własnym importerem
2026-04-04 CPT inwestycja (nie taksonomia) Łatwiejsze mieszanie w pre_get_posts na /oferta/
2026-04-04 Tylko PL, tłumaczenia później Unikamy złożoności Polylang na starcie
2026-04-04 Zdjęcia importowane do media library Shared między oferta + inwestycja, z kompresją
2026-04-04 Zachować wszystkie wpisy sprzed marca Legacy + ręczne Katarzyny muszą zostać
2026-04-04 Eksport tłumaczeń DeepL do CSV Backup przed cleanup — możliwość przywrócenia
🔗

Pliki i zasoby

📡 Feed XML (MetaInmo)
spain.metainmo.com/…/kyero/b81ba461…xml
105 MB · ~2,661 nieruchomości
🔬 Staging
staging.ariaspain.com
Środowisko testowe · home.pl
🌍 Produkcja
ariaspain.com
Live site — nie modyfikować bez QA
🔧 WP Admin (staging)
staging.ariaspain.com/wp-admin/
Panel administracyjny WordPress
🎨 HTML Mockup
inwestycja-design-v1.html
Lokalny plik · design strony inwestycji
📄 Backup tłumaczeń
translations-backup-staging.tsv
Eksport DeepL przed cleanup · CSV format
✅

Next Steps

0%
ukończono
0 z 11 zadań
🚀

8. Instrukcja Deploy na LIVE

⚠️ ZANIM ZACZNIESZ: Zrób pełny backup strony live (baza danych + pliki) przez panel home.pl lub WPvivid. Upewnij się, że masz dostęp do WP Admin na live (ariaspain.com/wp-admin/). Cały proces zajmie ok. 30–60 minut. Najlepiej robić to w godzinach niskiego ruchu (np. rano, weekend).
1
Zainstaluj plugin aria-inwestycja
1.1 Pobierz plugin ze staging
  1. Wejdź na staging.ariaspain.com/wp-admin/
  2. Idź do Wtyczki → WP File Manager
  3. Nawiguj do: wp-content/plugins/aria-inwestycja/
  4. Zaznacz cały folder aria-inwestycja → kliknij prawym → Archive (lub Download)
  5. Pobierz plik ZIP na swój komputer
Alternatywnie: plugin ZIP jest też zapisany w workspace projektu. Poproś agenta o plik.
1.2 Wgraj plugin na live
  1. Wejdź na ariaspain.com/wp-admin/
  2. Idź do Wtyczki → Dodaj nową → Wyślij wtyczkę
  3. Kliknij Wybierz plik → wybierz pobrany ZIP aria-inwestycja.zip
  4. Kliknij Zainstaluj
  5. Po instalacji kliknij Aktywuj wtyczkę
1.3 Odśwież permalinki
  1. Idź do Ustawienia → Bezpośrednie odnośniki
  2. Nie zmieniaj nic — po prostu kliknij Zapisz zmiany
  3. To odświeży reguły URL i zarejestruje /inwestycja/ jako nowy endpoint
2
Dodaj skrypty importu do functions.php
  1. Wejdź na ariaspain.com/wp-admin/
  2. Idź do Wygląd → Edytor plików motywu (Theme File Editor)
  3. Po prawej wybierz plik: functions.php
  4. Przewiń na sam dół pliku
  5. Wklej pełny kod skryptów importu (patrz komentarze poniżej)
  6. Kliknij Aktualizuj plik
⚠️ Ważne: Skrypty importu są za długie żeby je tu wkleić. Poproś agenta: "daj mi pełny kod importu inwestycji i ofert do wklejenia w functions.php na live". Agent wygeneruje gotowy blok do skopiowania.
Podgląd struktury kodu (placeholdery) 
// ═══════════════════════════════════════════════════
// ARIA IMPORT — Inwestycje z feeda MetaInmo
// Uruchomienie: WP Admin → Narzędzia → Import Inwestycji
// lub: /wp-admin/admin-ajax.php?action=aria_import_inwestycje
// ═══════════════════════════════════════════════════

// [TU WKLEJ PEŁNY KOD SKRYPTU aria-import-inwestycje.php]
// Poproś agenta o aktualny kod

// ═══════════════════════════════════════════════════
// ARIA IMPORT — Oferty z feeda MetaInmo
// Uruchomienie: WP Admin → Narzędzia → Import Ofert
// lub: /wp-admin/admin-ajax.php?action=aria_import_oferty
// ═══════════════════════════════════════════════════

// [TU WKLEJ PEŁNY KOD SKRYPTU aria-import-oferty.php]
// Poproś agenta o aktualny kod
3
Uruchom import inwestycji

W przeglądarce wejdź na (musisz być zalogowana w WP Admin):

https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_inwestycje
⚠️ Czekaj — strona będzie się ładować ok. 2–5 minut. Nie zamykaj przeglądarki!

Zobaczysz output zakończony komunikatem:

=== ARIA IMPORT INWESTYCJI ===
Feed: https://spain.metainmo.com/storage/feeds/...
Downloading feed...
Feed size: 109957297 bytes
Parsed: 2661 properties, 1 without complex_id
Unique complexes: 976
Created: 100, Updated: 0...
...
=== DONE ===
Created: 976

Weryfikacja: Idź do WP Admin → Inwestycje — powinieneś zobaczyć listę ~976 inwestycji. Kliknij dowolną → Zobacz — powinna wyświetlić się strona z galerią, opisem, mapą.

4
Uruchom import ofert (w batchach)

Import ofert działa w partiach po 500. Musisz go uruchomić kilka razy.

Batch 1 (offset=0) https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_oferty&batch=500&offset=0
Batch 2 (offset=500) https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_oferty&batch=500&offset=500
Batch 3 (offset=1000) https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_oferty&batch=500&offset=1000
Batch 4 (offset=1500) https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_oferty&batch=500&offset=1500
Batch 5 (offset=2000) https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_oferty&batch=500&offset=2000
Batch 6 (offset=2500) https://ariaspain.com/wp-admin/admin-ajax.php?action=aria_import_oferty&batch=500&offset=2500

Kontynuuj aż zobaczysz: Done: YES

⚠️ Timeout? Zmniejsz batch: zamiast batch=500 daj batch=200

Weryfikacja: Wejdź na dowolną inwestycję — powinna wyświetlać listę jednostek z cenami. Kliknięcie jednostki → strona oferty.

5
Wyczyść cache
  1. Idź do LiteSpeed Cache → Dashboard
  2. Kliknij Purge All (wyczyść cały cache)
  3. Odczekaj minutę
  4. Sprawdź stronę: ariaspain.com/oferta/ — powinny być widoczne inwestycje + ręczne oferty
  5. Sprawdź pojedynczą inwestycję — galeria, units, formularz, mapa
🔄
Jak robić PONOWNY import (aktualizacja danych)

Gdy MetaInmo zaktualizuje feed, wystarczy:

  1. Inwestycje: wejdź na URL z Kroku 3. Skrypt sam sprawdza czy inwestycja już istnieje — aktualizuje dane, nie tworzy duplikatów.
  2. Oferty: uruchom batche jak w Kroku 4 (od offset=0). Skrypt sprawdza _aria_external_id — istniejące oferty są aktualizowane, nowe tworzone.
  3. Purge cache po każdym imporcie.
Częstotliwość: co 1–2 tygodnie lub gdy Katarzyna zobaczy nowe oferty na MetaInmo.
🔧
Rozwiązywanie problemów
Strona inwestycji pokazuje 404
Idź do Ustawienia → Bezpośrednie odnośniki → kliknij Zapisz (odświeża rewrite rules)
Jednostki się nie wyświetlają
Oferty nie zostały zaimportowane. Uruchom import ofert (Krok 4).
Import się zawiesza / timeout
Zmniejsz batch: zamiast batch=500 daj batch=200
Formularz kontaktowy nie działa
Formularz używa CF7 ID 4c4ea7b. Sprawdź czy na live jest formularz o takim hash. Jeśli nie — w pliku templates/single-inwestycja.php zmień hash na poprawny z live.
Zdjęcia się nie ładują
Zdjęcia są hotlinkowane z CDN MetaInmo (es-metainmo.ams3.cdn.digitaloceanspaces.com). Jeśli MetaInmo zmieni URLe — trzeba re-importować.
Na /oferta/ nie widać inwestycji
Sprawdź czy plugin aria-inwestycja jest aktywny. Zrób purge cache.
📊
Dane techniczne
ElementWartość
Feed URLhttps://spain.metainmo.com/storage/feeds/kyero/b81ba461-0add-4408-b8bd-595f88a2b4ca.xml
Feed rozmiar~105 MB
Ofert w feedzie~2 661
Kompleksów (inwestycji)~976
CPT inwestycja slug/inwestycja/
Meta prefix inwestycji_cx_*
Meta prefix ofert_aria_*
Klucz linkujący_aria_complex_id ↔ _cx_complex_id
Formularz CF7 hash4c4ea7b (Formularz sprzedaż PL)
Ukrywanie ofert z archiwum_aria_hide_from_archive = 1

✅ Checklist po deploy