Dagens öppettider användardokumentation
2(15)
Introduktion Dagens öppettider är en tilläggsfunktion i Arena. Den bygger på Google Calendars API. Förutsättningen är alltså att biblioteket har ett konto på Google samt en kalender med aktuella öppettider. Axiell implementerar utifrån detta kopplingen mellan denna kalender och Arena. Denna instruktion beskriver funktionaliteten ur ett användarperspektiv. 3(15)
Google Calendar Logga in i Google med bibliotekets konto och öppna Google Calendar. Klicka på kugghjulet i övre högra hörnet och därefter på Inställningar. Klicka på Kalendrar. Under rubriken Kalender finns en förteckning över tillgängliga kalendrar (det kanske bara finns en). Klicka på Dela den här kalendern för den kalender som ska användas till de dynamiska öppettiderna. Markera kryssrutan Gör denna kalender offentlig och klicka sedan på Spara. Klicka på Tillbaka till kalender. Om biblioteket redan har en uppdaterad kalender behöver du därefter endast kontrollera att rubriken för respektive biblioteks öppettider innehåller bibliotekets namn, så som det ska visas i Arena, till exempel Almtuna bibliotek. Detta namn måste matchas exakt med namnet i formuläret där du ska lägga in enheterna. Det är alltså mycket viktigt att detta namn inte ändras efter att funktionen Dagens öppettider är implementerad. 4(15)
Om biblioteket inte har några öppettider inlagda ska du börja med att lägga in dem. Dubbelklicka på det ställe i kalendern där du vill börja lägga in, till exempel dagens datum. Ange bibliotekets namn i fältet överst (Händelse utan namn). Du har även möjlighet att fylla i plats (Var) och beskrivning (Beskrivning). Ange tidpunkt då biblioteket har öppet, t ex 10.00 till 20.00. Du behöver inte ändra själva datumet. Markera kryssrutan Upprepa. Välj inställningar i dialogrutan som öppnas: 5(15)
Exemplet ovan visar de ordinarie öppettiderna måndagar fredagar. Klicka på Klar och därefter på Spara. Klicka därefter på nästkommande lördag och lägg in motsvarande öppettider för lördagen. Spara. Klicka på Klar och därefter på Spara. Gör på motsvarande sätt om biblioteket har öppet även på söndagar. Om kalendern alltså saknar en händelse för aktuellt datum anger den Stängt i Dagens öppettider i Arena. Lägg därefter in undantag. Till exempel har biblioteket troligen inte öppet på midsommarafton. Bläddra dig fram till midsommarafton via kalendern och klicka på det aktuella datumet. Klicka på Radera. Klicka på Endast den här förekomsten. 6(15)
Klicka på Spara. Gör på samma sätt med de övriga dagar då biblioteket är stängt och alltså avviker från de ordinarie öppettiderna. 7(15)
Inställningar i Arena Dagens öppettider visas i Arena via Liferay-portleten Visa artiklar. Artikeln för detta ändamål består av ett formulär. Detta formulär lägger en konsult från Axiell på plats i samband med implementeringen, samt lägger in en av enheterna som exempel. Välj mallen calendarevents. Titeln är Öppettider Alla eller Bibliotekets namn öppettider (om endast ett bibliotek finns i listan). Mallen består av följande fält: municipalityname = Kommunnamn/gruppering* Denna översta nivå visas bara om Arena innehåller flera olika kommuner libraryname = Bibliotekets namn (måste matcha det i kalendern)* libraryurl = URL till annan sida om kalendern inte ska uppdateras på samma sida. noofdays = Antalet dagar som visas samtidigt efter klick på en enhets namn eller när endast ett bibliotek finns i listan (standardvärde finns) instanceid = Om du vill ha flera instanser på samma sida ska du ge varje kalender ett eget id (som du bestämmer själv) till 8(15)
exempel i1, i2, osv. calendarid = Google-konto (e-post)* apikey = API-nyckel* issinglelineperdayeventformat = Markera kryssrutan om du vill visa varje händelse på en rad. Rekommenderas om du inte vill visa plats och beskrivning. isshowlocation = Visa plats. isshowdescription = Visa beskrivning. librarylinktarget = target-attribut för länk (om den används). _self (samma flik) _blank (ny flik)(standardvärde _self) txtnext = Ledtext för bläddringsknapp Nästa (standardvärde finns) txtprevious = Ledtext för bläddringsknapp Föregående (standardvärde finns) txtback = Ledtext för bläddringsknapp Tillbaka (standardvärde finns) txtclosed = Ledtext för status Stängt (standardvärde finns) txtshowmore =Title-text för enheternas namn (visas vid hovring): Visa fler öppettider för xxx bibliotek (standardvärde finns) De obligatoriska fälten är markerade med en asterisk. Kryssrutorna Localizable används inte. Tänk på att lägga in kommuner och enheter i den ordning du vill visa dem i Arena, till exempel alfabetisk. För att lägga in fler bibliotek gör så här: Om du ska lägga in öppettider för en ny kommun klicka på plustecknet efter fältet Municipality name Därmed skapas en kopia av den kommuns enhet som är inlagd. De nya fälten har ljusblå bakgrund och lägger sig nedanför. Ändra fälten till det som gäller för denna kommun. 9(15)
Var noga med att matcha namnet i fältet libraryname exakt med det som är angivet i Google Calendar. Om du ska lägga in öppettider för en ny enhet klicka på plustecknet efter fältet libraryname. Därmed skapas en kopia av den kommuns enhet som är inlagd. De nya fälten har ljusblå bakgrund och lägger sig nedanför. Ändra fälten till det som gäller för denna kommun. Var noga med att matcha namnet i fältet libraryname exakt med det som är angivet i Google Calendar. Skapa egna öppettider på separata bibliotekssidor. Grundinställningen i öppettiderna är att när man klickar på ett bibliotek så laddas hela veckans öppettider direkt i portletten för det specifika biblioteket. Detta går dock att ändra. Man kan bygga så att när man klickar på ett bibliotek i öppettider så kommer man till en undersida, där man oftast då har biblioteksspecifik information och endast detta bibliotekets öppettider. Här är en instruktion för hur man bygger kalendereventfunktionaliteten i Arena med länkar till undersidor. Dvs hur ni lägger in länkarna samt sätter upp öppettiderna på undersidorna. I instruktionen utgår vi alltså från att ni redan skapat era undersidor för respektive bibliotek och att ni redan har fungerande öppettider på plats på startsidan. På startsidans öppettider, klicka på redigera artikel-symbolen i portletten. För varje bibliotek som ligger inlagt där, skriv i den dynamiska sökvägen till undersidan ni vill länka till i fältet libraryurl, se nedan bild. Portletten kommer då automatiskt känna av detta och länka till undersida vid klick i stället för att ladda in ny data. 10(15)
Länkadressen finner ni genom att gå till den undersida ni vill länka till och kopiera följande del av URLen: När detta är gjort för varje bibliotek i öppettiderna på startsidan är länkningen till undersidorna klar. På undersidorna ni länkar till behöver ni nu lägga upp öppettiderna för endast de specifika biblioteken. Så gå till undersidorna/undersidan ni vill göra detta på. För att lägga till artikeln och dess mall, gör följande. Se till att vara inloggad mot Liferay och under menyn Lägg till, lägg till portletten Visa artiklar. Se till att du har Edit controls checkat och lägg sedan till en artikel i portletten du precis lagt in. Klicka på kugghjulet för Mall. Välj mallen som heter CalendarEvents (eller snarlikt namn). Efter det ska formuläret komma fram för att kunna fyllas i. Fyll i följande information för biblioteket (Fast med er data för ert specifika bibliotek). Ni ska alltså bara fylla i information för detta specifika bibliotek till skillnad mot startsidans öppettider som har samtliga bibliotek, exempelvis: 11(15)
När detta är ifyllt. Hämta ert calendarid samt apikey från er artikel som visar samtliga öppettider på startsidan och skriv in dem. När detta är klart, spara. Nu ska öppettiderna för detta specifika bibliotek visas. Gör om detta på varje undersida/bibliotekssida ni vill ha specifika öppettider på. 12(15)
Inställningar för bokbuss - Google Logga in på Google med bibliotekets konto och öppna Google Calendar. Skapa en ny kalender och döp den till Bokbussen, namnet måste vara exakt då det matchas senare. Skapa dina bokbusskalenderhändelser på följande vis: Skapa titeln Bokbussen på varje händelse, namnet måste vara exakt då det matchas senare. Varje kalenderhändelse i kalendern Bokbussen ska ha denna titel. Lägg in din start- och stopptid på kalenderhändelserna. Välj om du vill att tiden ska upprepas i framtiden. I fältet var lägger du till hållplatsnamnet för varje kalenderhändelse. Så en kalenderhändelse för bokbussen ska så exempelvis se ut så här: Titel: Tid: Var: Bokbussen Måndag 08:00 09:00 (Upprepas varje vecka) Almtuna Skola Upprepa denna procedur tills alla kalenderhändelser/hållplatser för bokbussen är på plats. När alla kalenderhändelser är klara, klicka på kugghjulet i övre högra hörnet och därefter på Inställningar. Klicka på Kalendrar. Under rubriken Kalender finns en förteckning över tillgängliga kalendrar. Klicka på Dela den här kalendern för Bokbussen som ska användas till de dynamiska öppettiderna. Markera kryssrutan Gör denna kalender offentlig och klicka sedan på Spara. Klicka sedan på fliken Kalendrar och sedan på Bokbussen. 13(15)
På denna sida finns det en iframe-ruta med en del kod (Embedd-kod) som kan kopieras. Koden i sig är inte viktig, men du behöver plocka ut calendarid för bokbussen, då den inte kan vara samma som till din andra bibliotekskalender. Koden ser ut ungefär så här: <iframe src="https://www.google.com/calendar/embed? src=ipmtishqzjyep0hcge9287181%40group.calen dar.google.com&ctz=europe/stockholm" style="border: 0" width="800" height="600" frameborder="0" scrolling="no"></iframe> Det som är markerat i orange är calendarid t för kalendern Bokbussen och är helt unikt för denna kalender. Kopiera ut detta då det ska användas i Arena för att koppla kalendern. Inställningar för bokbussen - Arena Bokbussens öppettider visas i Arena via Liferay-portleten Visa artiklar. Artikeln för detta ändamål består av ett formulär. Nedan visas endast de nödvändiga fälten/inställningarna för Bokbussen, för samtliga möjliga inställningar se Inställningar i Arena ovan. För att lägga till artikeln och dess mall, gör följande. Inloggad i Liferay, under menyn Lägg till lägg till portletten Visa artiklar. Se till att du har Edit controls klickat och lägg sedan till en artikel i portletten. Klicka på kugghjulet för Mall. Välj mallen som heter CalendarEvents (eller snarlikt namn). Efter det ska formuläret ligga rätt för att kunna fyllas i. Mallen består av följande fält: municipalityname = Skriv Bokbussen (Kalendernamnet) libraryname = Skriv Bokbussen (Namnet på alla kalenderevent) 14(15)
calendarid = Google-konto (Exempelvis ipmtishqzjyep0hcge9287181%40group.calendar.google.com, se beskrivning ovan för att hämta rätt calendarid) Så här: apikey = Kopiera och klistra in denna från er artikel med era fasta bibliotek. isshowlocation = Klicka i checkboxen. Spara. 15(15)