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,
[email protected].
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