Innehållslistning

Modulen Filtrerbar listning låter er lista artiklar och sidor på er webbplats, med möjlighet för både redaktör och besökare att filtrera, sortera och kategorisera dessa utifrån ett gäng olika faktorer.

Era redaktörer kan på några minuter sätta upp en ny listning av innehåll från webbplatsen utifrån ett urval som de själva bestämmer. Dessa presenteras på ett snyggt och tillgängligt sätt som ger besökarna en överskådlig, filtrerbar vy där de snabbt kan hitta det innehåll de söker.

En perfekt modul för att lista allt från nyhetsartiklar och evenemang till menyingångar och olika typer av kategorieserat innehåll utspritt över webbplatsen.

Allmän konfiguration

Nedan följer en beskrivning av de olika konfigurationsmöjligheterna. För förteckning över temavariabler se Temainställningar.

Urval

Under sektionen Urval finns det möjlighet att peka ut ett valfritt antal noder i webbsidans struktur som ska fungera som startpunkter för listningen. Genom att klicka på knappen "Lägg till" under listan kan ni lägga till en ny startpunkt. För att redigera en befintlig startpunkt dubbelklickar ni bara på den raden i listan, så kommer öppnas inställningarna.

Det finns även möjlighet att peka ut enstaka sidor eller artiklar som ska visas i listningen, vilket kan vara bra om ni exempelvis har enstaka sidor utspridda över webbplatsen som ska listas. Detta gör ni i så fall genom att klicka på knappen "Lägg till", och sedan vidare på pilen uppe i det vänstra hörnet. Välj här "Enskild sida", och välj den sida som ska läggas till i listningen.

I de fall ni lägger till en startpunkt i urvalslistan så hämtas som standard samtliga underliggande sidor och artiklar i den strukturgren som pekas ut, men genom att bocka i rutan "Begränsa urvalet till att endast innefatta direkt underliggande sidor" kan ni låsa funktionen till att endast hämta de undersidor som ligger direkt under den utpekade noden. Observera att detta av tekniska skäl är en relativt prestandakrävande operation, och endast bör användas i de fall som den utpekade noden har ett mindre antal undersidor.

Under sektionen Urval finns även en inställning för att endast visa artiklar med samma språk som listningssidan. Om detta alternativ är markerat så kommer endast sidor eller artiklar som överensstämmer med språket på listningssidan att visas.

Mer information om språk i Sitevision hittar ni på Sitevisions hjälpwebb:
https://help.sitevision.se/pageSettingsHelp.html#h-Sprak Länk till annan webbplats.

Paginering

Klicka i kryssrutan "Aktivera paginering" för att dela upp de olika sidorna i listningen på flera sidor. En paginering kommer att skrivas ut längst ner på sidan för besökarna med möjlighet att bläddra mellan de paginerade sidorna. Under nummerfältet "Antal objekt per sida" går det att ställa in hur många träffar som ska visas för varje sida. I de fall paginering inte är aktiverad så används värdet i denna ruta för att begränsa det totala antal träffar som ska visas i listningen.

När paginering är aktiverad kan ni välja typ av paginering. Alternativet "Sidnavigering" skriver ut en vanlig sidnavigering längst ner i listningen, med möjlighet för besökaren att bläddra mellan sidor. Alternativet "Visa fler-knapp" visar i stället en knapp som laddar in fler träffar i samma lista.

Filtreringsalternativ för besökare

Under denna sektion finns alla inställningar som rör besökarens filtreringsmöjligheter. Modulen Filtrerbar listning kan naturligtvis även användas som ren listningsmodul utan att ge besökarna möjlighet att filtrera. Undvik i så fall bara att göra några inställningar i den här sektionen, så visas aldrig filtreringen.

Genom att markera alternativet Låt besökaren filtrera genom fritextsök aktiverar ni möjligheten till fritextsökning bland sidorna i listningen. Detta presenteras i filtreringssektionen som ett textsökfält. Ni kan välja om sökningen ska göras i allt indexerat sidinnehåll eller endast i sidans namn. Ni kan också välja hur sökfrasen ska matchas: att ordet börjar med, slutar med, matchar eller innehåller sökfrasen.

Alternativet Låt besökaren filtrera på Kategori aktiverar möjligheten för besökaren att filtrera på de kategorier som finns konfigurerade i modulen. Mer information om hur ni sätter upp dessa hittar ni längre ner under sektionen "Kategorier".

Alternativet Låt besökaren filtrera på bokstav (A-Ö) gör det möjligt för besökaren att filtrera listningen alfabetiskt. Filtreringen utgår från sidans namn och visar de sidor som börjar med vald bokstav.

Alternativet Låt besökaren filtrera på ett datumspann gör det möjligt för besökaren att filtrera på ett fråndatum och ett tilldatum. När ni markerar det här alternativet fälls en inställningssektion ut där ni väljer vilket datumfält filtreringen ska gälla för. Ni kan antingen använda ett metadatafält via identifierare eller ett systemvärde, till exempel publiceringsdatum, senaste publiceringsdatum, datum då sidan skapades eller datum då sidan senast ändrades.

I de fall ni tillåter filtrering på datumspann via metadata finns det även möjlighet att använda slutdatum, genom att markera alternativet Använd slutdatum. Genom att markera detta alternativ har ni möjlighet att ange identifieraren för ytterligare ett datumfält. Innehåll kommer i så fall att visas så länge någon del av tidsspannet mellan dessa två datumfält infinner sig inom tidsspannet för besökarens filtrering. Detta alternativ kan alltså med fördel användas vid listning av evenemang.

Med inställningen Begränsa datumväljaren till framtida datum går det att hindra besökaren från att välja datum som redan har passerat.

Med inställningen Låt besökaren filtrera på förbestämda regler är det möjligt att sätta upp filtreringsalternativ där en viss regel behöver uppfyllas för att få träff på en viss sida. Detta kan vara metadatabaserade regler som att ett metadatafält ska ha ett visst värde, eller datumbaserade regler som att datumet i ett metadatafält ska/inte ska ha passerat.

När denna inställning är aktiverad kan ni välja en etikett för den filtreringssektion som ska innehålla de regelstyrda filtreringsalternativen, och sedan lägga till alternativ i listan nedan. När ni skapar en ny regel finns dels alternativet "Metadatafält ska matcha ett värde" där det är möjligt att ange ett metadatafält och ett värde som ska överensstämma för att en sida ska visas. Ni har också alternativet "Sidan ska ha en eller flera etiketter" där endast sidor som är taggade med en eller flera etiketter ska användas. Sist finns alternativet "Datum ska matcha ett värde", som gör det möjligt för besökaren att selektera ut sidor där den nuvarande tidpunkten inträffar innan, efter eller mellan två datumfält.

Under sektionen "Filtreringsalternativ för besökare" finns även alternativet Visa endast listan vid filtrering. När detta är markerat visas inte listan med träffar förrän besökaren har gjort en filtrering.

Under samma funktio finns även ett alternativet Använd knapp för att posta filtreringsformuläret. Som standard postas filtreringsformuläret automatiskt när besökaren gör ett val. I de fall denna inställning är markerad kommer istället en "Filtrera"-knapp att visas som besökaren behöver klicka på innan resultatet uppdateras. Denna inställning kan användas för ännu bättre tillgänglighet.

Kategorier

Under sektionen Kategorier kan ni sätta upp de kategorier som ska användas i listningen. Dessa kategorier kan sedan sedan användas för besökaren att filtrera på, eller visas intill respektive listobjekt om så önskas. Kategorier hämtas som etiketter eller metadatafält från sidorna i listningen, och måste vara av typen envalsfält eller flervalsfält.

Mer information om Metadatafält och etiketter går att hitta på Sitevisions hjälpwebb:

https://help.sitevision.se/metadataHelp.html Länk till annan webbplats.
https://help.sitevision.se/siteTagsHelp.html Länk till annan webbplats.

För att lägga till en ny kategori i listan, klicka på knappen "Lägg till" under listan med kategorier. Genom att klicka på pilen i det vänstra hörnet i modalfönstret som visas kan ni sedan välja om ni vill lägga till ett metadatafält som finns uppsatt på den aktuella sidan, ett metadatafält genom fältets identifierare som ni anger på egen hand, eller etiketter från eller eller flera etikettgrupper.

Alternativet Metadatafält på den aktuella sidan innebär att det filtrerbara fältet ni vill filtrera på måste finnas uppsatt som fält på sidan där listningsmodulen är utplacerad eller finnas uppsatt som metadatafält för mallar under webbplatsinställningar. Detta alternativ är alltså bra i de fall metadatafältet för kategori är uppsatt på mallen för sidorna som ska listas, eller i de fall ni ska lista samtliga underliggande sidor och metadatafältet är uppsatt på listningssidan för att ärvas nedåt.

Alternativet Metadatafält från identifiererare ger er möjlighet att på egen hand peka ut valfritt metadatafält utifrån fältets identifierare. Detta gör det möjligt att peka ut fält som är uppsatta på en annan strukturgren än den listningen ligger på. Väljer ni detta alternativ får ni först och främst peka ut den källsida där metadatafältet finns uppsatt, och sedan ange fältets identifierare.

Alternativet Etikettgrupper kan användas för att peka ut en eller flera etikettgrupper på webbplatsen, och göra det möjligt att filtrera på gruppens etiketter.

Vid uppsättning av en ny kategori är det även möjligt att bocka i huruvida kategorin ska visas i listningen, och om denna i så fall ska vara länkad. Väljer ni att visa kategorin i listningen så kommer de valda alternativet för respektive artikel i listan att skrivas ut tillsammans med övrig information om sidan. Väljer ni att den ska vara länkad så kommer texten dessutom att vara klickbar, och skicka besökaren till en förfiltrerad version av listningen där det här kategorivärdet är angivet i filtreringen. Observera att denna länkfunktion endast kan användas om filtrering på kategori är aktiverad under sektionen Filtreringsalternativ för besökare. Observera också denna funktionalitet kan avvika i de fall ni använder anpassade mallar för modulen, då dessa i så fall måste utformas för att stödja denna funktionalitet.

I fältet Namn för filtrering är kan ni ange det som ska användas för filtreringsfältet ut mot besökaren sedan. Detta fält kommer endast att användas om filtrering på kategori är aktiverad.

I fältet Typ av filtrering är det möjligt att välja vilken typ av fält som ska användas för det här filtreringsfältet. Alternativen Radioknappar eller Dropdown ger besökaren möjlighet att välja ett alternativ åt gången att filtrera på. Alternativet Checkboxar ger besökaren möjlighet att filtrera på flera alternativ åt gången.

Mallar och utseende

Under den här sektionen hittar ni inställningar för modulens utseende och mallar.

I fältet Mall för listningen är det möjligt att peka ut den mall som ska användas för den aktuella listningen. Som är den medföljande mallen "Kortvy" alltid tillgänglig i listan och aktiverad, men ni har själva möjlighet att sätta upp ett obegränsat antal mallar under modulens globala inställningar som sedan blir valbara i det här fältet. Läs mer om dessa mallar längre ner under rubriken "Globala inställningar".

Om någon av de medföljande mallarna används finns det inställningar för grundnivå för rubriker och om hela ytan för varje listobjekt ska länkas. För alla mallar finns inställningar för om rubriken ska hämtas från sidans namn eller sidans rubrik. Om sidans rubrik används kan ni välja ett metadatafält för rubrik. Om inget fält anges, eller om fältet saknar värde, används den första textmodulen med namnet "Rubrik".

Det finns också inställningar för att visa bild, ingress och datum i listningen. Bild kan hämtas från ett metadatafält eller, om inget metadatafält anges eller saknar värde, från den första bildmodulen med namnet "Bild". Ingress kan hämtas från ett metadatafält eller, om inget metadatafält anges eller saknar värde, från den första textmodulen med namnet "Ingress". För ingressen kan ni även ange maximalt antal tecken.

För datum kan ni välja publiceringsdatum, senaste publiceringsdatum, datum från metadatafält eller datumspann från metadatafält. Vid enskilt datum kan ni ange datumformat. Vid datumspann anger ni identifierare för både startdatum och slutdatum.

Om den valda anpassade mallen har egna fält visas dessa som separata inställningar. Där kan redaktören aktivera respektive fält och peka ut vilket metadatafält som ska användas i listningen.

Texter

Uppe i flikmenyn under modulens inställningar finns en sektion för texter. Under den här fliken finns möjlighet att redigera de fasta texter som används i modulens filtreringssektion, paginering och knappar. För de fält som lämnas tomma används modulens standardtext.

Det går bland annat att ange etikett till sökfält, etiketter till från- och tilldatum, knapptext för filtrering, knapptext för att nollställa filtreringen, knapptext för "Visa fler", standardvärde för dropdownfält samt texter för A-Ö-filtreringen.

Det går också att skriva ut dolda rubriker för skärmläsare ovanför träfflistan och ovanför filtreringen. Dessa rubriker kan ge bättre struktur för hjälpmedel utan att påverka den visuella presentationen.

Observera att texten som standard är översatt till svenska och engelska. Detta innebär att ni som redigerar dessa texter på en flerspråkig webbplats bör sätta upp separata instanser av modulen för de olika språken om ni vill bibehålla språkstödet. Detta kan exempelvis åstadkommas med hjälp av vyer i Sitevision.

Mer information om vyer hittar ni på Sitevisions hjälpwebb:
https://help.sitevision.se/65656565663323.html Länk till annan webbplats.

Avancerad konfiguration

Uppe i flikmenyn under modulens inställningar finns även en sektion för avancerad konfiguration. Under den här fliken kan ni göra lite mer avancerade inställningar såsom egen sortering eller regler för exludering av artiklar baserat på metadatavärde eller datum.

Sortering

Som standard sorteras listan utifrån publiceringsdatum (senast först), men genom dessa inställningar kan ni anpassa sorteringsordningen efter behov.

Under sektionen Sortering finns en lista med möjlighet att sätta upp olika sorteringsregler. Dessa avgör ordningen för hur innehållet kommer att flöda. Klicka på knappen "Lägg till" för att lägga till en ny sorteringsregel.

Genom att klicka på pilen i fönstrets vänstra hörn går det at välja vilken typ av information som regeln ska filtrera på - ett visst metadatafält eller ett systemvärde.

Väljer ni metadatasortering så kan ni antingen peka ut ett metadatafält direkt genom gränssnittet, eller ange en identifierare för metadatafältet på egen hand. Ni har även inställningar för om ordningen ska vara stigande eller fallande, samt om ni vill använda ett anpassat sökindex för det här fältet.

Väljer ni systemvärde som sortering så får ni specificera vilket systemvärde sorteringen ska gå på, samt om det ska vara fallande eller stigande sortering.

Väljer ni att lägga till flera regler för sortering i listan så rangordnas dessa med den första regeln som starkaste faktor. Ni har möjlighet att flytta runt reglerna i listan genom att dra och släppa dessa i den ordning ni önskar.

Urval

Under sektionen Urval finns det möjlighet att sätta upp regler för att exkludera vissa typer av inlägg. För att lägga till en regel klickar ni på knappen "Lägg till" under listan med Regler för urval baserat på metadata/etiketter. I samband med att ni sätter upp en ny regel får ni genom pilen i modalens övre vänstra hörn välja om urvalet ska göras baserat på metadata, metadataidentifierare eller etiketter. Om ni väljer att lägga till flera regler i en och samma modul så kräver det att samtliga regler är uppfyllda för att sidan ska visas.

Urval baserat på metadata
Vid urval baserat på metadata kan regeln peka på ett metadatafält som väljs i gränssnittet eller på ett metadatafält som anges med identifierare. Ni kan välja förhållanden som "Lika med", "Ej lika med", "Innehåller", "Innehåller inte", "Har ett värde" och "Saknar ett värde".

För datumfält kan ni även välja reglerna "Tidpunkten har passerat" och "Tidpunkten har inte passerat". Dessa kan utgå från fältets angivna värde, en förskjuten tidpunkt, dagens början eller dagens slut.

För målgruppsmetadata finns alternativet "Överensstämmer med målgrupp". Då kan ni välja en eller flera målgrupper, eller använda besökarens egna målgrupper.

Urval baserat på etiketter
I det fall urvalet baseras på etiketter så får ni först välja vilket förhållande sidan ska ha till de valda etiketterna. Antingen kan sidor med dessa etiketter inkluderas eller exkluderas. Därefter väljer ni en eller flera etiketter som regeln ska gälla.

Övrigt
Under sektionen Urval finns även en äldre inställning för att "Exkludera sidor vars datum har passerat". När denna inställning är aktiverad kan ni ange identifieraren för ett metadatafält av typen datum, så kommer sidor vars datum passerat att döljas i listningen. Inställningen är markerad som utgående i modulen och bör ersättas med en urvalsregel.

Prestanda

Under sektionen Prestanda finns inställningar som kan vara användbara för stora listningar eller listningar med många filter.

Inställningen Inaktivera funktion för att endast visa bokstäver som innehåller träffar vid A-Ö-filtrering kan öka prestandan när A-Ö-filtrering används och urvalet innehåller många träffar. När inställningen är aktiv behöver modulen inte kontrollera vilka bokstäver som faktiskt ger träffar.

Inställningen Inaktivera funktion för att endast visa kategorier som innehåller träffar kan öka prestandan när många kategorifält används, eller när fälten innehåller många alternativ. När inställningen är aktiv kan kategorier visas även om de inte ger träffar i den aktuella listningen.

Inställningen Inaktivera automatisk omförstoring av bilder kan öka prestandan i de fall bilderna redan är optimerade för listningen. När inställningen är aktiv används bildens befintliga URI i stället för en automatiskt skalad version. SVG-bilder skalas inte om automatiskt.

Inställningen Ta hänsyn till behörigheter när antalet träffar räknas gör att antalet träffar och pagineringen inte räknar med sidor som besökaren saknar behörighet till. Detta ger mer rättvisande antal träffar för behörighetsstyrt innehåll, men kan ge påtaglig prestandaförlust om listningen innehåller många sidor och är i de flesta fall inte nödvändig.

Globala inställningar

Under modulens globala inställningar finns det möjlighet att sätta upp valbara mallar som kan användas i de olika modulerna på webbplatsen. De valbara mallarna påverkar själva listningens utformning, och kan användas för att skräddarsy listningens utseende och innehåll enligt önskemål.

Valbara mallar

Som standard är den medföljande mallen för "Kort" aktiverad och valbar som standard. Under listan med Egna mallar kan ni sedan lägga till egna mallar, och anpassa dessa genom velocity.

Ni kan läsa mer om velocity på Sitevisions developer-webb:
https://developer.sitevision.se/docs/velocity Länk till annan webbplats.

För att lägga till en ny mall, klicka på knappen "Lägg till" under listan. Klicka på pilen i fönstrets vänstra hörn för att välja mellan fil och editor. Med alternativet Velocityfil har ni möjlighet att peka ut en .vm-fil från webbplatsens filarkiv som ska användas för att rendera listningen.

Med alternativet Velocityeditor får ni tillgång till en editor direkt i fönstret där ni kan skriva den Velocity-kod som ska exekveras. Under detta redigeringsfält får ni även upp en lista över de variabler som finns tillgängliga att använda i Velocity-kontexten.

I fältet Namn på mallen kan ni ange det namn som sedan ska visas i inställningarna för de olika listningsmodulerna runtom på webbplatsen. I fältet Namn på CSS-klass kan ni ange en modifierare för den CSS-klass som appliceras på modulen när mallen används. Om inget värde anges används mallens namn.

För anpassade mallar kan ni också välja att inaktivera modulens medföljande CSS för filtreringen eller listningen. Detta är användbart när mallen har helt egen struktur eller egen styling.

Under Anpassade fält för mallen kan ni lägga till metadatafält som ska bli valbara i modulinställningarna när den anpassade mallen används. För varje fält anger ni namn, en unik identifierare och typ av metadatafält. De tillgängliga typerna är "Text/Enval", "Flerval" och "Relaterad information".

För en komplett specifikation över de variabler som finns att tillgå vid utveckling av egna mallar, se sidan Variabler för anpassade mallar.

Vanliga frågor och problem

1. En eller flera sidor visas inte i listningen

Sidorna måste vara indexerade i Sitevisions sökindex för att dessa ska listas i modulen. Detta styrs vanligtvis med hjälp av inställningen "Visa i sökresultat" under sektionen "Sök" på de sidor som ni valt att lista.

Mer information om hur ni kommer åt denna inställning hittar ni på Sitevisions hjälpwebb: https://help.sitevision.se/12704211.html Länk till annan webbplats..

Notera att det kan ta en liten stund från det att inställningen har aktiverats tills det att sidan indexerats i sökindexet och visas i listningen. Om ni vill påskynda processen för en enskild sida, klicka på knappen "Indexera om" i samma vy för att indexera om sidan. Sidan måste även vara publicerad för att kunna indexeras.

2. En indexerad sida uppmärkt med en kategori visas inte vid filtrering på denna kategori.

Det metadatafält som används för filtrering måste ha alternativet "Indexera fältet i sökmotorn" aktiverat för att det ska vara möjligt att filtrera på detta fält. Om denna inställning aktiverats i efterhand (efter det att sidorna som använder detta metadatafält satts upp) så krävs en omindexering av alla dessa sidor för att sökindexet ska uppdateras och filtreringen ska fungera igen.

3. En/flera kategorier visas inte i filtreringen trots att det finns sidor uppmärkta med den aktuella kategorin.

Detta beror oftast på någon av anledningarna ovan - att metadatafältet antingen inte är markerat att indexeras i Sitevisions sökindex, eller att det inte finns några publika/indexerade sidor inom den aktuella kategorin.

Obsevera att modulen endast visar kategorival i filtreringen som har träffar. Om en kategori saknar träffar så visas inte denna i filtreringen.

4. Mitt metadatafält finns inte med i listan när jag skapar en ny filtrerbar kategori.

I listan över metadatafält visas endast fält av typen enval eler flerval som antingen:

1. Finns uppsatt/tillgängligt på sidan som listningen är installerad på.
2. Finns uppsatt som metadatafält för mallar under webbplatsinställningar.

Om ni vill använda ett metadatafält för filtrering som endast finns uppsatt på en annan gren av webbplatsen än den gren där själva listningen ligger, så behöver detta konfigureras genom alternativet "Metadatafält för identifierare". Detta gör ni genom följande steg:

1. Tryck Lägg till under Kategorier.
2. Ändra från Metadatafält på den aktuella sidan tilll Metadatafält från identifierare (se bild nedan).
3. Peka ut sidan som metadatafältet är tillagt på
4. Skriv in metadatafältets identifierare