Mis muutus ja kellele see on oluline
Rendimooduli hinnangute süsteemis parandasime kolm asja, mis kõik mõjutavad seda, kui usaldusväärsena kuulutused ja hinnangud sinu saidil paistavad.
Esiteks kindlustasime hinnangukutsete saatmise nii, et üks rentija ei saa kunagi saada sama "kuidas läks?" kirja topelt. Seda tehti ette vaatavalt: praegu töötab üks API konteiner ja topeltsaatmise ohtu tegelikult ei ole, aga kood ise garanteerib nüüd "üks kord, alati" põhimõtte, mitte praeguse serveri seadistuse juhuslik omadus.
Teiseks parandasime hinnangute plokis keskmise hinde kuvamise. Varem võis juhtuda, et server näitas hinnet vormingus 4.8 ja brauser vormingus 4,8, mis tekitas tehnilise vea (hüdratsioonivea) ja pani numbri korraks värelema. Nüüd on hinne kirjas õiges keeles juba enne, kui see lehele jõuab.
Kolmandaks lisandus kuulutuste kaartidele tärnihinnang: keskmine hinne ja arvustuste arv on nüüd nähtaval kataloogivaates ja ehitaja eelvaates, samamoodi nagu need juba olid nähtaval kuulutuse hinnangute plokis. See on oluline kõigile, kes rendivad esemeid, ruume või teenuseid ja kelle klientide otsust mõjutab see, mida teised varem rentinud inimesed on kirjutanud.
Hinnangukutsete saatmine on nüüd lukustatud
Hinnangukutse loogika töötab endiselt samamoodi kui varem: pärast rendiperioodi lõppu saadetakse rentijale kiri küsimusega, kuidas läks, ja seda tehakse iga broneeringu kohta täpselt üks kord. Erinevus on selles, kuidas platvorm nüüd garanteerib, et "üks kord" jääb kehtima ka siis, kui tulevikus töötaks korraga mitu serveriprotsessi.
Varem märgistati broneering saadetuks eraldi käsuga, mis kirjutas ajatempli peale sõltumata sellest, kas broneering oli juba märgistatud. Kui kaks protsessi oleksid samal hetkel sama broneeringut lugenud, oleksid mõlemad saanud loa saata ja rentija oleks saanud kaks identset kirja. Nüüd kasutab süsteem sama põhimõtet, mis juba kehtib portaali sisselogimislingi puhul: märgistus õnnestub ainult siis, kui broneering on veel märgistamata, ja protsess, mis seda tingimust ei täida, kirja ei saadagi.
Sulle kui kasutajale see midagi nähtavalt ei muuda. Tähtaeg, mille jooksul kutse saadetakse, ja rentijale jäetud aeg vastamiseks on samad, mis enne.
Keskmine hinne kuvatakse nüüd õiges keeles
Hinnangute plokk näitab kuulutuse juures keskmist hinnet, näiteks "4,8". Varem arvutas seda numbrit üks kood, mis kasutas serveri vaikimisi keeleseadeid, ja teine kood brauseris, mis kasutas lehe tegelikku keelt. Eesti keeles tähendas see, et server kirjutas "4.8" (punktiga) ja brauser "4,8" (komaga) - kaks erinevat teksti ühe ja sama numbri kohta. Selline lahknevus tekitas tausta tehnilise vea ja jättis vahepeal näha vale numbri.
Nüüd otsustatakse hindele kirjapilt korra, andmete koostamise ajal, ja seda tehakse lehe keele järgi: eestikeelsel lehel "4,8", ingliskeelsel "4.8". Sama põhimõte kehtib ka ehitaja näidisandmete kohta, nii et redigeerimisel näed sama vormingut, mida hiljem näeb ka külastaja. Ekraanilugeja jaoks loetakse ette samast tekstist koostatud lause, mitte tooranumbrit.
Kuulutuste kaartidel on nüüd tärnihinnang
Kuulutuste kaardid näitavad nüüd nime all rida kujul "★ 4,8 (12)": tärn, keskmine hinne ja arvustuste arv. See kehtib kataloogivaates, esiletõstetud kuulutuste plokis, saidi vaikimisi kataloogilehel ja ehitaja eelvaates.
Arvesse läheb ainult avaldatud arvustused avaldatud kuulutuste puhul, samamoodi nagu kuulutuse lehel oleva hinnangute ploki puhul, nii et kaardil ja kuulutuse lehel kuvatav hinne on alati kooskõlas. Ootel või peidetud arvustus tärne ei mõjuta. Kui kuulutusel ei ole veel ühtegi arvustust, ei kuvata tärnirida üldse, mitte "0 tärni" ega tühja rida.
Tärnihinnangu haldamine
Ava rendikuulutuste loend
Mine ekraanile Kuulutused (/rentals) ja vali kuulutus, mille arvustusi tahad kontrollida, või mine ehitajasse, kui tahad muuta kaardi väljanägemist.
Kontrolli lülitit "Hinnang tärnidega"
Kataloogi ja esiletõstetud kuulutuste plokis on see lüliti kaardi teiste osade (tüüp, kokkuvõte, hind) kõrval. Vaikimisi on see sees, ka plokkidel, mis olid loodud enne selle lisandumist.
Muuda ekraanilugeja lauset soovi korral
Välja "Hinnangu sõnad" all saad lause sõnastust kohandada, kasutades kohatäitjaid {rating} ja {count}. Tühjaks jäetud väli võtab kasutusele vaikimisi lause, tärnid ei jää kunagi nimetuseta.
Kaardi tärnid arvestavad ainult avaldatud arvustusi avaldatud kuulutustele, täpselt sama arvutusega, mida kasutab kuulutuse lehe hinnangute plokk. Kaart ja kuulutuse leht ei saa seetõttu üksteisele vastu rääkida.
Näide praktikas
Oletame, et rendid stuudioruumi fotograafidele. Kuulutusel on 12 avaldatud arvustust keskmisega 4,8. Varem näitas kuulutuse leht seda hinnet, kuid kataloogivaates, kus külastaja kuulutusi sirvib, hinnet ei olnud. Nüüd näeb külastaja juba kataloogis rida "★ 4,8 (12)" otse ruumi nime all ja saab sirvimisel usaldusväärsuse põhjal valida, enne kui üldse kuulutust avab.
Kui sul on samas kataloogis uus ruum, mida veel kellelegi ei renditud, ei näe selle kaart tühja tärnirida ega "0 tärni", vaid tärnirida jääb lihtsalt ära, kuni esimene avaldatud arvustus lisandub.

Mida teadlikult ei tehtud
Kaartidele ega kuulutuse lehele ei lisatud otsingumootoritele mõeldud struktureeritud hinnangumärgistust ("AggregateRating"). Sellist märgistust oodatakse lehel, mis näitab ka arvustusi, mida ta kokku võtab, ja kuulutuse kaart seda kunagi ei tee, ning kuulutuse leht seda praegu ei luba.
Kuulutuse lehe põhiplokk (kuulutuse enda vaade) ei näita tärne kaardi kujul - see on eraldi disainiküsimus, mida praegu ei lahendatud.
Korduma kippuvad küsimused
Ei. Lüliti on vaikimisi sees, ka kuulutuste plokkidel, mis on tehtud enne selle lisandumist. Tärnid ilmuvad automaatselt kohe, kui kuulutusel on vähemalt üks avaldatud arvustus.
Ei. Hinne on kuulutuse andmetes valikuline väli, nii et vanemat API-t kasutav sait näitab kaarte ilma tärnideta, mitte veateatega.
Server ja brauser kasutasid numbri kirjutamiseks erinevaid vaikeseadeid. Server kirjutas hinde ingliskeelses vormingus (punktiga), brauser eestikeelses vormingus (komaga), mis tekitas kahe erineva teksti kokkupõrke. Nüüd otsustatakse vorming korra, andmete koostamisel, lehe tegeliku keele järgi.