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
| Atribut | Valori | Ce face |
|---|---|---|
data-cheie | cheia ta, sau DEMO | identifică agenția; funcționează doar pe domeniile înregistrate |
data-lat, data-lon | grade zecimale (WGS84), cu punct: 44.4352 | poziția anunțului; alternativ, data-rebs-id |
data-rebs-id | ID-ul numeric al anunțului din CRM REBS | în locul coordonatelor, pentru site-urile REBS (secțiunea 4) |
Opționali, ambele variante
| Atribut | Valori | Implicit | Ce face |
|---|---|---|---|
data-varianta | gratuit, complet | gratuit | varianta afișată; complet cere o cheie plătită |
data-strada | numele străzii | — | afișat ca „în zona străzii …”; fără el, „în această zonă”. Folosit și la verificarea poziției |
data-culoare | culoare hex: #1f6f5c | #1f6f5c | culoarea butoanelor |
data-font | site, sistem | site | site preia fontul paginii tale |
data-colturi | 0–20 (pixeli) | 10 | rotunjirea colțurilor |
Doar varianta completă
| Atribut | Valori | Implicit | Ce face |
|---|---|---|---|
data-teme | listă separată prin virgulă: transport, scoli, servicii, verdeata, aer, zgomot, caldura, risc, sector | primele șapte | temele afișate, în ordinea dată |
data-mod | toate, puncte-forte | toate | puncte-forte arată doar plusurile temelor alese, cu titlul „Puncte forte ale zonei, selectate de agenție” |
data-fisa | da, nu | da | butonul „Tipărește fișa” (A4) |
data-cereri | da, nu | nu | formularul 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ă:
- Coordonatele din șablon. Aproape orice pagină de anunț are o hartă, deci coordonatele există deja în platforma ta. Le treci în
data-latșidata-lon. - ID-ul anunțului din CRM REBS. Coordonatele le luăm noi din CRM (secțiunea 4).
- 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".
- În fereastra widgetului apare formularul „Primește raportul complet al zonei pe e-mail”: nume (opțional) și e-mail.
- Vizitatorul bifează, separat, acordul ca datele să fie transmise agenției tale pentru acel anunț. Fără bifă, formularul nu se trimite.
- Vizitatorul primește raportul zonei pe e-mail.
- 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
iframede 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.comlascript-srcșiframe-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
| Cheia | Unde merge | Cum o obții |
|---|---|---|
DEMO | doar pe adresa demo (44.4352, 26.0784), pe orice domeniu | e publică, pentru teste |
| Gratuită | toate anunțurile din București, pe domeniile tale | la cerere, prin e-mail: |
| Completă | la fel, cu toate opțiunile variantei complete | după 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.