Čo je Houzez ZR?
Houzez ZR je WordPress plugin navrhnutý pre realitné kancelárie, ktoré používajú prémiovú tému Houzez a zároveň inzerujú nehnuteľnosti na portáli Zoznamrealit.sk (používajú správcovský systém BackOFFICE) . Plugin prepája tieto dva systémy – namiesto manuálneho zadávania dát na dvoch miestach zabezpečí automatickú synchronizáciu maklérov a ponúk priamo z BackOFFICE do vášho WordPress webu.
Celá komunikácia prebieha cez oficiálne zoznamrealit.sk API s autentifikáciou OAuth 1.0a (2-legged), čo zaručuje bezpečnosť aj spoľahlivosť prenosu dát.
Čo tento plugin obsahuje?
1. Inteligentná synchronizácia cez hash
Plugin neaktualizuje každý záznam pri každom spustení. Pre každého makléra aj každú ponuku si ukladá MD5 hash dát z API. Pri ďalšom spustení porovná hash – ak sa nič nezmenilo, záznam preskočí. Výsledkom je rýchlejší sync a minimálne zaťaženie databázy.
2. Automatická správa životného cyklu záznamov
Okrem importu nových a aktualizovania zmenených záznamov plugin sleduje aj záznamy, ktoré v API už nie sú – maklérov a ponuky, ktoré zmizli zo Zoznam Realit, automaticky presúva do WordPress koša. Databáza webu tak vždy odráža aktuálny stav portálu.
3. Flexibilné spúšťanie synchronizácie
Sync možno spustiť dvoma spôsobmi:
- Manuálne z adminu – tlačidlom priamo na stránke pluginu
- REST API endpoint s API kľúčom – pre napojenie na cron hostingu
Poznámka: od riešenia cez WordPress WP-Cron sme upustili, pretože sa spúšťa až pri návšteve stránky.
4. Bezpečný externý cron
Plugin generuje pri aktivácii unikátny náhodný API kľúč (32-znakový hex token). Externé volania cronu bez tohto kľúča sú zamietnuté s HTTP 403. Volania z prehliadača (s cookies) sú pri automatickom crone tiež blokované – cron je určený výhradne pre servery.
5. Natívna integrácia s Houzez témou
Plugin nevytvára vlastné post typy ani taxonómie – pracuje priamo s tými, ktoré Houzez používa (houzez_agent, property, property_type, property_status a ďalšie). Žiadna duplicita, žiadne konflikty.
Čo dokáže správca webu robiť z WordPress adminu?
Nastavenia (Houzez ZR → Nastavenia)
- Zadanie Consumer Key a Consumer Secret pre API zoznamrealit.sk
- Nastavenie API base URL
- Zapnutie / vypnutie importu jedným prepínačom
- Prehľad všetkých aktuálne uložených hodnôt vrátane maskovania citlivých údajov (secret sa zobrazuje ako bodky)
- Možnosť resetu ľubovoľného nastavenia na predvolenú hodnotu
Test pripojenia (Houzez ZR → Test pripojenia)
- Jedným kliknutím overí, či sú API kľúče správne a či je API Zoznam Realit dostupné
- Zobrazí počet aktívnych inzerátov a počet maklérov priamo z API
- V prípade chyby zobrazí debug výpis odpovede servera
- Hromadný reset hash kľúčov
Správa maklérov (Houzez ZR → Makléri)
- Spustenie synchronizácie maklérov – import nových, aktualizácia zmenených, presun zrušených do koša
- Prehľad všetkých maklérov v tabuľke s údajmi: meno, email, ZR Broker ID a kontrolný stav
- Automatická detekcia duplicitných emailov (zvýraznených červenou farbou)
- Funkcia „Napĺň broker ID podľa emailu“ – pre prípad, že makléri už existujú na webe, ale ešte nemajú priradené ID z portálu; plugin ich spáruje automaticky podľa zhody emailovej adresy (používa sa v prípade, že bol web predtým napojený na Realsoft)
Správa ponúk (Houzez ZR → Ponuky)
- Spustenie synchronizácie ponúk s nastaviteľným limitom (napr. 1, 10 alebo viac položiek naraz)
- Prehľad importovaných ponúk s názvom, ZR Advert ID, skráteným hash-om a stavom inzerátu
Cron (Houzez ZR → Cron)
- Zobrazenie pripravenej URL adresy pre nastavenie cronu na hostingu – adminovi stačí skopírovať a vložiť do cpanelu
- Tlačidlo manuálneho spustenia cronu priamo z prehliadača s určeným parametrom
Rozšírené admin stĺpce
V zozname agentov (houzez_agent) plugin dopĺňa stĺpce BO ID (broker ID z portálu) a Poradie (menu_order), pričom stĺpec Poradie je zoraditeľný. Podobne sa pridáva ID pre importované ponuky.
Technické poznámky
Plugin je kompatibilný s PHP 7.4+, testovaný po PHP 8.3 a WordPress 6.0+. Všetky synchronizačné operácie loguje (pri zapnutom WP_DEBUG) do štandardného WordPress error logu, takže ladenie je jednoduché. Aktivácia pluginu automaticky nastaví predvolené hodnoty a vygeneruje cron API kľúč – bez nutnosti manuálnej konfigurácie databázy.
Aktuálna verzia v čase písania tohto článku: 1.1.2.
