Skapa en kalender som hämtar kommande aktiviteter för en församling/ett pastorat inom Svenska kyrkan. All information hämtas automatiskt från kalender på svenskakyrkan.se via Svenska kyrkans API.
Har du tillgång till en PHP-server så kan du ladda upp filerna där, det är allt som behövs för att komma igång med en egen kalender.
Du behöver en API-nyckel för att hämta kalenderaktivteter. Det kan du skaffa på api.svenskakyrkan.se.
API-nyckeln kan du ange på två sätt.
Antingen genom att du placerar en fil som heter api
bredvid filen index.php. I filen klistrar du in din api-nyckel. Enklast är att du gör en textfil, klistrar in nyckeln, sparar och sedan tar bort filändelsen (.txt).
Viktigt! - Se till att filen api inte går att komma åt från internet, exempelvis genom att undanta den i .htaccess-filen eller på annat sätt skydda den.
Det andra sättet är att skicka med api-nyckeln som parametern api=
till länken till sidan, se exempel längre ned.
Du kanske inte har koll på ID-numret för organisationen? Ett sätt som jag har använt för att hitta vårt ID var att gå in på Botkyrka församlings hemsida (på svenskakyrkan.se) och klicka på kalender-knappen nedanför den stora sökrutan uppe till höger. Sedan tittar jag i adressfältet i webbläsaren och kopierar siffrorna som står efter "&orgId=".
OrganisationsID:t skickar du med som parametern orgID=
till länken, se exemplen längre ned.
Aktiviteterna kan också filtreras baserat på vilken lokal de äger rum i, detta åstadkoms genom att skicka med platsens ID som återfinns i platsadministrationen.
Exempel på IDn:
Härnösands domkyrka = 5dab016f-18f3-4973-92d8-69779653a1ef
Säbrå kyrka = 26a876d9-3cf6-4a8b-8e11-7c78eaaef4d9
ID:t skickar du med i länken med parametern locationID=
När du filterar aktiviteten baserat på en plats så är det onödigt att platsen skrivs ut efter varje aktivitetstitel. Platsen läggs istället in i "headern" längst till höger. Namnet hämtas från platsadministrationen..
Aktiviteterna kan också filtreras baserat på händelsetyp, detta åstadkoms genom att använda parametern csg=
och ID:t för händelsetypen
Det går att skicka med godtyckligt antal händelsetyper, dessa seperaras med ett kommatecken ,
. Filtreringen är en s.k. "eller"-filtrering och tar med de aktiviteter som har t.ex. ID 101 eller 105 i fallet csg=101,105
.
Här är en lista på händelsetyper och deras ID:n
101 = Gudstjänst & mässa
102 = Mötas & umgås
103 = Kropp & själ
104 = Barnverksamhet
105 = Musik & kör
106 = Stöd & omsorg
107 = Konst& kultur
108 = Studier & samtal
109 = Skapande och kreativitet
110 = Ungdomsverksamhet
111 = Drop-in
Rubriken som visas är som standard Svenska kyrkan, men detta kan du själv ställa om med parametern header=
, dit du t.ex. kan fylla i ert enhets namn , ex. Svenska kyrkan Härnösand
.
Själva titeln i webbläsaren visar Kalender för [Svenska kyrkan]
som standard, denna kan du också styra via parametern orgName=
.
Som standard används den mörkröda färgen från Svenska kyrkans grafiska profil, men du kan ändra via parametern color=
till andra färger enligt listan nedan:
'mörkkyrkröd' => '#91160f',
'mörkkyrklila' => '#522583',
'mörkkyrkgrön' => '#4a6a21',
'mörkkyrkgul' => '#f59c00',
'mörkkyrkblå' => '#005884',
'kyrkröd' => '#d51317',
'kyrklila' => '#a71680',
'kyrkgrön' => '#6b9531',
'kyrkgul' => '#fdc300',
'kyrkblå' => '#006fb9',
'ljuskyrkröd' => '#ed6d91',
'ljuskyrklila' => '#bb71ac',
'ljuskyrkgrön' => '#afca0b',
'ljuskyrkgul' => '#ffdf43',
'ljuskyrkblå' => '#63c3d1',
'ljusastkyrkröd' => '#f5b3bd',
'ljusastkyrklila' => '#d1bcdc',
'ljusastkyrkgrön' => '#dddf4b',
'ljusastkyrkgul' => '#ffe37e',
'ljusastkyrkblå' => '#bee2e9'
https://kalender.minserver.se/?orgID=20271
https://kalender.minserver.se/?orgID=20271&locationID=5dab016f-18f3-4973-92d8-69779653a1ef
Visa kalendern för aktiviteter i Härnösands pastorat samt rubriken Svenska kyrkan Härnösand och titeln i webbläsaren "Härnösands pastorat"
https://kalender.minserver.se/?orgID=20271&header=Svenska kyrkan Härnösand&orgName=Härnösands pastorat
Observera att webbläsaren antagligen lägger till %20
istället för mellanslag, men du kan behöva göra det själv.
https://kalender.minserver.se/?orgID=20271&locationID=26a876d9-3cf6-4a8b-8e11-7c78eaaef4d9&color=mörkkyrklila
https://kalender.minserver.se/?orgID=20271&csg=101
Visa kalendern för aktiviteter av händelsetypen Gudstjänst & mässa, samt Musik & kör i Härnösands pastorat
https://kalender.minserver.se/?orgID=20271&csg=101,105
Många församlingar har digitala skärmar med mjukvara från Playipp. Kalendern kan enkelt läggas in på dessa skärmar.
- Gå som vanligt först till Publicera och välj den skärm du vill använda. Klicka på den modul/sektion av skärmen där du vill ha kalendern och välj sedan Lägg till.
- Under Ny media & fil väljer du Webblänk. Klistra in kalenderadressen (inkl. ert ID-nummer) i det översta textfältet. Ändra därefter gärna från Ladda om länken vid varje visning till Ange tidsintervall för omladdning av länken och låt det stå 60 minuter i rutan intill. Tryck sedan på Nästa steg.
- Ge nu kalendern ett namn och välj hur länge den ska visas. Välj också en mapp där den ska sparas (i Playipp). Tryck sedan en gång till på Nästa steg.
- Till sist väljer du en schemaläggning för när kalendern ska visas. Avsluta med att trycka på Publicera.