Gravatar-howto
En rask introduksjon til Gravatars (for oss som er sent ute) med implementasjon for eZ Publish.
Hva er en gravatar?
De aller fleste forum osv tillater deg å laste opp en såkalt "avatar" som følger dine innlegg. Men, med den mengden nettsteder man idag forventes å legge igjen litt av seg selv på blir det litt vel mye å laste opp en avatar på alle. Gravatar løser problemet ved å sentralisere avataren og gi forum, blogger osv en enkel mulighet for å benytte avatarer fra gravatar.com.
A gravatar, or globally recognized avatar, is quite simply an avatar image that follows you from weblog to weblog appearing beside your name when you comment on gravatar enabled sites. Avatars help identify your posts on web forums, so why not on weblogs?
Med andre ord; et bilde/logo/illustrasjon som identifiserer deg og som dukker opp ved siden av dine konti, kommentarer og innlegg nettet rundt.
Hvordan funker det?
Det er herlig simpelt. Du oppretter en konto (ja, enda en) på gravatar.com og laster opp et bilde av deg selv. Siden gravataren presenteres i kvadratisk format får du mulighet til å croppe bildet etter å ha lastet det opp. Deretter knyttes din e-postadresse mot din gravatar.
Når du nå legger igjen kommentarer, oppretter konti osv på nettsteder som støtter gravatar, så vil nettstedet finne din gravatar så lenge du benytter samme e-postadresse.
Hvordan implementere gravatar?
Gravataren for en vilkårlig bruker kan finnes ved følgende URL:
http://www.gravatar.com/avatar/[MD5-hash email]
På denne måten er e-postadressen også beskyttet. I tillegg kan man legge til .jpg som filendelse om nødvendig. URL-en reagerer også på følgende parametere:
- s - størrelse på avatar. Alt mellom 1 og 512 (piksler, that is)
- r - rating. Kan være g (default), pg, r eller x. Ikke vet jeg hvem som opererer med "x rated" avatar, men det er tydeligvis noen. Rating angir verste tillatte innhold, så x gir deg alt.
- d - default-bilde. Kan være ingenting, som gir deg den blå G-en, vilkårlig URL (husk å encode) eller en av identicon, monsterid eller wavatar.
Implementere i eZ Publish
Å implementere i eZ Publish er like lett som man skulle forvente. eZ Publish har i utgangspunktet ingen template-operator for å generere md5-hasher, men det er enkelt å eksponere
md5. Åpne en override for template.ini, for eksempel settings/override/template.ini.append.php og finn eller legg til gruppen [PHP]. I denne legger du til md5 i arrayen PHPOperatorList:
[PHP]
PHPOperatorList[md5]=md5
Deretter kan du laste ned og benytte min
gravatar.tpl (lagre i design/dittdesign/templates) på følgende måte:
{include uri="design:gravatar.tpl"
email=$node.object.data_map.email
rating="G"
size=50
alt=concat($node.object.data_map.author.content, "s gravatar")
default=concat("http://www.eksempel.no", "default_gravatar.jpg"|ezimage)}
Kun email-parameteret er påkrevd. Dette kan være enten en e-post som en streng, eller (som i eksempelet over) et
ezContentClassAttribute som inneholder en e-postadresse.
Dokumentasjon av templaten (inkludert øvrige parametere) kan leses på eZGravatar@Github.
Comments are closed