Riktiga Vykort Partner webb Teknisk beskrivning I denna tekniska beskrivning finns instruktioner om hur du skall konfigurerar din webb för att kunna skicka bilder som Riktiga Vykort. Har du frågor kontaktar du i första hand PostNord kundservice via e-post, kundservice.digital.se@postnord.com. 2015-11- 01
Information 1. Behörighet och logotype I PostNords system Riktiga Vykort skall information om din webb samt ditt företags logga läggas in för att du skall få behörighet att skicka dina bilder som vykort. Information om din webb hämtar PostNord från Orderformuläret. Instruktion om vilket format din logga skall ha, se nedan. 2. Konfigurera din webb Din webb skall konfigureras så att bilderna kan skickas som Riktiga Vykort på PostNords webb, http://rv.posten.se 3. Har din webb en responsive webbdesign? Om din webb har responsive webbdesign så kan du konfigurera din webb så att bilderna även kan skickas som vykort från appen Riktiga Vykort. Surfar man till din webb från en dator, ipad eller Android tablet, så kommer bilden att skickas som vykort från PostNords webb, http://rv.posten.se. Surfar man till din webb från en smartphone, så kan du konfigurera din webb så att bilden skickas som vykort från PostNords app Riktiga Vykort. PostNords app Riktiga Vykort finns både i ios och i Android. Behörighet 1. Domän Din hemsidas Domän skall vara registrerat hos PostNord t ex www.ftg.se. Detta ger din hemsida behörighet i Riktiga Vykort och att föra över bilden som skall skickas som vykort tillsammans med den information som skall printas på baksidan på vykortet. Du anger din hemsidas Domän i Orderformuläret när du tecknar avtal om tjänsten. Om dina bilder 1. URL till bilderna Den URL där dina bilder ligger skall vara registrerad hos PostNord, t ex http://url.to.your/photos/ Du anger URL i Orderformuläret när du tecknar avtal om tjänsten. 2
2. Logotype till bilderna Ditt företags logotype skall finnas inlagd i PostNords system. Logotypen bör vara kvadratisk för att synas bra. Filformat skall vara JPEG Max 250 x 250 pixlar Bildstorlek max 300 kb 10 pixlars marginal runt logotypen Loggan skall ha vit bakgrund 3. Bilder i rätt format Bilderna skall vara högupplösta enligt följande: Bilder för A5 och A4 Filformat skall vara JPEG Bildstorlek 2551x1819 px Filstorlek 500 800 kb Bilder i Instagram -format Filformat skall vara JPEG Bildstorlek 1819x1819 px Filstorlek 500 800 kb Notera också att 3 mm runt om bilden stansas bort när vykortet trycks. Bilderna kan också vara i annat format än ovan angivet, men ifall proportionerna skiljer sig från ovan angivet så kommer inte hela bilden kunna användas till vykortet. Till varje bild skickar du med information. Se nästa avsnitt. 4. Möjlighet att kunna redigera bild eller inte Informera PostNord om det skall vara möjligt för användaren att kunna redigera bilden i appen Riktiga Vykort eller inte. Med redigering menas att t ex zooma i bilden och lägga till ramar till bilden. Default är att PostNord har spärrat bild för redigering som hämtas från annan webb. Du anger detta i Orderformuläret när du tecknar avtal om tjänsten. 3
Konfigurera din webb mot Riktiga Vykort på PostNords webb I detta avsnitt beskrivs hur du konfigurerar din webb för att skicka bild till Riktiga Vykort på Posten.se. 1. Parametrar som skickas med bilden Domän Bild Transaktionsid Beskrivning Kategori = Ditt domännamn, som t.ex mittföretag.com, denna måste skickas med för att appen ska kunna läsa in bilden, samt att ditt id måste registreras innan användning. = Filnamnet på bilden, ex dittfoto.jpg = Id på eventuell transaktionen hos avsändande webb (optional) = Bildbeskrivning på bilden, max 40 tecken (Skrivs ut på baksidan på vykortet) = Ett id som kan användas för att gruppera dina bilder, detta får du efter att du registrerat dig hos oss. 2. Att öppna Riktiga Vykort på PostNords webb och skicka med en bild För att skicka bilden till Riktiga Vykort på PostNords webb så börjar du med http://rv.posten.se/#page/index/. Efter sökvägen skickar du med parametrar enligt ovan som kopplar ihop bilden till ditt vykort. För att anropa Riktiga Vykort från en hemsida och skicka med en bild se följande exempel: http://rv.posten.se/#page/index/www.domain.com/dittfoto.jpg/transaktionsid/beskrivnin g/kategori 3. Implementera knappen Skicka som Riktiga Vykort Här kommer html kod och script som automatiskt hämtar knappen från PostNord: <a href=" http://rv.posten.se/#page/index/www.domain.com/ditt.foto.jpg/ditttransaktions-id/beskrivning/kategori "><img src="https://rv.posten.se/archive/images/button_send.png" width="214" height="45" /></a> Om du vill, kan du ändra width och height i a href bilden, just nu är den satt till 50%, så vill du ha full storlek på knappen så blir det width="428" height="90" 4
Konfigurera din webb mot appen Riktiga Vykort I detta avsnitt beskrivs hur du konfigurerar din webb för att skicka bild till appen Riktiga Vykort. Detta avsnitt gäller endast om din webb har en responsive webbdesign. 1. Parametrar som skickas med bilden id Transaktionsid title category mode = Ditt domännamn, som t.ex mittföretag.com, denna måste skickas med för att appen ska kunna läsa in bilden, samt att ditt id måste registreras innan användning. = Id på eventuelll transaktionen hos avsändande webb (optional) = Bildbeskrivning på bilden, max 40 tkn (Skrivs ut på baksidan på vykortet) = Ett id kopplat till dina bilder, detta får du efter att du registrerat dig hos oss. = Måste skickas som web för att det ska identifieras korrekt av appen. (Används endast om bilden skall öppnas i appen Riktiga Vykort) 2. Att kunna öppna appen Riktiga Vykort För att anropa Riktiga Vykort från en hemsida utan att skicka med en bild ange: posten-rv:// 3. Att öppna appen Riktiga Vykort och skicka med en bild Normalt sett skickar du en länk till din bild med http:// följt av sökvägen till bilden, för att istället skicka bilden till appen Riktiga Vykort så ersätter du http:// med posten-rv://. Efter sökvägen kan du skicka med parametrar som låter dig styra hur bilden ska visas, mer om detta i nästa del. För att anropa Riktiga Vykort med javascript från en hemsida och skicka med en bild se följande exempel: posten-rv://your.photo.name.jpg?id= www.domain.com&title=fin utsikt över staden Barcelona&category=kategori&mode=web Innan denna skickas måste länken formateras, här följer ett exempel: <a href="javascript:sendpostcard();">vykort</a> <script> function sendpostcard() { var formattedurl = "posten-rv:// dittfoto.jpg?" + encodeuricomponent("id=www.domain.com&title=fin utsikt över staden Barcelona&category=kategori&mode=web"); window.open(formattedurl,"_self"); } </script> 5
4. Implementera knappen Skicka som Riktiga Vykort Här kommer html kod och script som automatiskt hämtar knappen från PostNord: <a href="javascript:sendpostcard();"><img src="https://rv.posten.se/archive/images/button_send.png" width="214" height="45" /></a> Här följer ett exempel: <script> function sendpostcard() { var formattedurl = "posten-rv://dittfoto.jpg?" + encodeuricomponent("id=www.domain.com&title=fin utsikt över staden Barcelona&category=your.category&mode=web"); window.open(formattedurl,"_self"); } </script> Om du vill, kan du ändra width och height i a href bilden, just nu är den satt till 50%, så vill du ha full storlek på knappen så blir det width="428" height="90" 5. Pop-up När användaren klickar på Vykorts -knappen skall en pop-up visas. I pop-up:en visas text samt ikonen för Riktiga Vykort. Ikon Riktiga Vykort Länken till ikonen som skall visas i pop-up https://rv.posten.se/archive/images/iconriktigavykort.png OBS. Ikonen kan ändras över året, så lägg inte länken i en klass som cachar bilden utan ställ in så att appen alltid hämtar aktuell bild. 6
6. Informera om att appen Riktiga Vykort krävs Du skall också lägga in följande information på din hemsida: *För att kunna skicka vykort krävs att PostNords app Riktiga Vykort är installerad, samt att det ligger länkar till App Store och Google Play för att användaren lätt skall kunna hämta appen. Du kan använda följande html-kod: <div class="app-text">* För att kunna skicka vykort krävs att Postens app Riktiga Vykort är installerad.</div> <div class="app-links"> <img src=" https://rv.posten.se/archive/images/app_links.png" width="254" height="45" usemap="#app_links" border="0" /> <map name="app_links" id="app_links"> <area shape="rect" coords="47,6,144,39" href="http://itunes.apple.com/se/app/riktigavykort/id444458799?mt=8" target="_self" alt="appstore" /> <area shape="rect" coords="150,6,246,40" href="https://play.google.com/store/apps/details?id=se.posten.riktigavykort" target="_self" alt="googleplay" /> </map> </div> Baksidan på vykortet Utifrån inkomna parametrar så skrivs bildinformation, logga och fotograf ut på baksidan av vykortet. 7