Documentația widgetului

Cum instalezi widgetul în paginile de anunț ale agenției și ce parametri are.

Versiunea 1 · Ultima actualizare: 17 noiembrie 2026

Versiune de lucru. Biblioteca widget/v1.js e în dezvoltare; documentația descrie cum va funcționa. Adresa auditurban.com devine activă la lansare.

1. Instalare rapidă

Codul se pune o singură dată, în șablonul paginii de anunț, acolo unde vrei să apară banda widgetului. Valorile între acolade sunt câmpurile anunțului din platforma ta.

<div class="zona-widget"
     data-cheie="CHEIA_TA"
     data-lat="{{anunt.latitudine}}" data-lon="{{anunt.longitudine}}"
     data-strada="{{anunt.strada}}"
     data-varianta="gratuit"></div>
<script src="https://auditurban.com/widget/v1.js" async></script>

Scriptul se include o singură dată pe pagină, chiar dacă pagina are mai multe widgeturi. Codul gata configurat îl copiezi de pe pagina Pentru firme.

2. Parametrii

Toți parametrii sunt atribute data- pe elementul zona-widget.

Obligatorii

AtributValoriCe face
data-cheiecheia ta, sau DEMOidentifică agenția; funcționează doar pe domeniile înregistrate
data-lat, data-longrade zecimale (WGS84), cu punct: 44.4352poziția anunțului; alternativ, data-rebs-id
data-rebs-idID-ul numeric al anunțului din CRM REBSîn locul coordonatelor, pentru site-urile REBS (secțiunea 4)

Opționali, ambele variante

AtributValoriImplicitCe face
data-variantagratuit, completgratuitvarianta afișată; complet cere o cheie plătită
data-stradanumele străzii—afișat ca „în zona străzii …”; fără el, „în această zonă”. Folosit și la verificarea poziției
data-culoareculoare hex: #1f6f5c#1f6f5cculoarea butoanelor
data-fontsite, sistemsitesite preia fontul paginii tale
data-colturi0–20 (pixeli)10rotunjirea colțurilor

Doar varianta completă

AtributValoriImplicitCe face
data-temelistă separată prin virgulă: transport, scoli, servicii, verdeata, aer, zgomot, caldura, risc, sectorprimele șaptetemele afișate, în ordinea dată
data-modtoate, puncte-fortetoatepuncte-forte arată doar plusurile temelor alese, cu titlul „Puncte forte ale zonei, selectate de agenție”
data-fisada, nudabutonul „Tipărește fișa” (A4)
data-cererida, nunuformularul de cereri (secțiunea 6)

Cu o cheie plătită, setările se pot ține și în contul tău. Atributele din cod au prioritate față de setările din cont.

3. Sursa coordonatelor

Widgetul are nevoie de poziția anunțului. Sunt trei variante, de la cea mai sigură la cea mai simplă:

  1. Coordonatele din șablon. Aproape orice pagină de anunț are o hartă, deci coordonatele există deja în platforma ta. Le treci în data-lat și data-lon.
  2. ID-ul anunțului din CRM REBS. Coordonatele le luăm noi din CRM (secțiunea 4).
  3. Adresa ca text. În pregătire; o adăugăm pentru agențiile care nu au coordonate în pagină.

Pinul de pe harta anunțului e uneori mutat intenționat. Dacă trimiți și data-strada, verificăm ca punctul să fie la cel mult 300 m de stradă; altfel widgetul nu se afișează (secțiunea 7).

4. Site-uri făcute cu CRM REBS

Dacă anunțurile vin din CRM REBS, ajunge ID-ul anunțului:

<div class="zona-widget" data-cheie="CHEIA_TA" data-rebs-id="{{id_proprietate}}"></div>

Pentru asta ne trebuie cheia API REBS a agenției tale. O ceri de la echipa REBS ([email protected]), cu managerul agenției în copie, și ne-o transmiți pe un canal sigur. Cu ea:

  • citim din CRM doar ID-ul și coordonatele anunțurilor active; nu citim prețuri, descrieri, imagini sau date despre proprietari;
  • calculăm zona fiecărui anunț nou înainte de prima afișare (prin notificările de modificare ale REBS, unde sunt activate);
  • trimitem cererile vizitatorilor în CRM, dacă formularul de cereri e activ.

Cheia o păstrăm criptat și o folosim doar pentru aceste trei operații. Poți cere oricând ștergerea ei.

5. Pagini care se schimbă fără reîncărcare

Dacă site-ul tău schimbă anunțul afișat fără să reîncarce pagina, actualizează widgetul din cod:

ZonaWidget.actualizeaza({ lat: 44.4352, lon: 26.0784, strada: "Strada Exemplu" });
// sau, pentru REBS:
ZonaWidget.actualizeaza({ rebsId: 1234 });

Funcția actualizează primul widget de pe pagină. Pentru altul, dă-i un id și trimite-l ca al doilea argument: ZonaWidget.actualizeaza({…}, "widget2").

6. Cererile vizitatorilor

Doar în varianta completă, cu data-cereri="da".

  1. În fereastra widgetului apare formularul „Primește raportul complet al zonei pe e-mail”: nume (opțional) și e-mail.
  2. Vizitatorul bifează, separat, acordul ca datele să fie transmise agenției tale pentru acel anunț. Fără bifă, formularul nu se trimite.
  3. Vizitatorul primește raportul zonei pe e-mail.
  4. Cererea ajunge la tine:
    • CRM REBS: apare în CRM, la anunțul respectiv, cu sursa „AuditUrban”. În CRM trebuie să existe o sursă de cereri cu exact acest nume;
    • alte platforme: pe e-mailul agenției, până la integrarea cu CRM-ul tău.

După trimitere nu păstrăm datele vizitatorului. Agenția e operatorul acestor date, iar noi le prelucrăm în numele ei, conform termenilor pentru firme. În panou vezi lunar numărul de cereri, pe anunț.

7. Când nu se afișează

Regula e simplă: decât o zonă greșită, mai bine nimic. Widgetul nu apare, iar motivul se vede în jurnalul din contul tău, când:

  • punctul e în afara Bucureștiului (deocamdată singurul oraș acoperit);
  • coordonatele lipsesc sau nu sunt valide;
  • punctul e la peste 300 m de strada trimisă în data-strada;
  • ID-ul REBS nu există sau anunțul nu mai e activ;
  • cheia nu e validă pentru domeniul paginii;
  • s-a depășit limita lunară de afișări a abonamentului.

Când nu apare, widgetul nu lasă un spațiu gol: elementul rămâne cu înălțimea zero.

8. Precizie și confidențialitate

  • Faptele se calculează pentru centrul unei zone fixe de circa 200 m, nu pentru adresa anunțului. Toate anunțurile din aceeași zonă primesc aceleași fapte.
  • Coordonatele primite se transformă imediat în zonă; nu le păstrăm exacte, nici în memorie, nici în jurnale.
  • Widgetul nu spune nimic despre clădirea din anunț.
  • Fără formularul de cereri, widgetul nu colectează date personale și nu folosește cookie-uri. Contorizăm afișările și deschiderile doar agregat, pe anunț.

9. Detalii tehnice

  • Izolare. Banda și fereastra se afișează într-un iframe de pe domeniul nostru. Stilurile site-ului tău nu le afectează, iar ale noastre nu-ți afectează pagina.
  • Dimensiuni. Banda ocupă toată lățimea containerului și are circa 100–120 px înălțime pe calculator; pe telefon, faptele trec unele sub altele. Fereastra se deschide peste pagină; pe telefon, pe tot ecranul.
  • Încărcare. Scriptul e asincron și nu blochează pagina. Conținutul ferestrei se încarcă doar la clic.
  • Content-Security-Policy. Dacă site-ul tău o folosește, adaugă https://auditurban.com la script-src și frame-src.
  • Browsere. Versiunile actuale de Chrome, Edge, Firefox și Safari, pe calculator și pe telefon.
  • Actualizarea datelor. Lunar pentru facilități și șantiere; la fiecare ediție nouă pentru sursele oficiale. Data datelor apare în widget.

10. Atribuirile obligatorii

Widgetul afișează singur sursele datelor, inclusiv „© OpenStreetMap contributors”, cerută de licența ODbL, și marca AuditUrban. Ascunderea lor, prin CSS sau în alt mod, încalcă licențele surselor și termenii pentru firme.

11. Cheia DEMO și cheia ta

CheiaUnde mergeCum o obții
DEMOdoar pe adresa demo (44.4352, 26.0784), pe orice domeniue publică, pentru teste
Gratuitătoate anunțurile din București, pe domeniile talela cerere, prin e-mail:
Completăla fel, cu toate opțiunile variantei completedupă activarea abonamentului; prima lună e de probă

Întrebări despre integrare: . Pentru platformele folosite de mai multe agenții (CRM-uri, teme WordPress), facem integrarea împreună cu tine.