RSS-Flöden

Med RSS-flöden kan du samla innehåll från en eller flera delar av webbplatsen i RSS-flöden. Besökare kan prenumerera på innehållet i en RSS-läsare och följa nyheter eller andra uppdateringar.

Du kan skapa flera flöden med egna adresser, exempelvis ett flöde för alla nyheter och ett för ett visst ämne. Innehållet kan väljas ut med hjälp av metadata, etiketter och datum. Varje artikel länkar till sin sida på webbplatsen och kan kompletteras med beskrivning, bild, datum, skribent och kategorier.

Modulen levererar flöden i formatet RSS 2.0. Hur innehållet presenteras beror på RSS-läsaren eller tjänsten som använder flödet.

Installation

Tillåt åtkomst för oinloggade användare

Som standard har endast inloggade användare behörighet att hämta RSS-flödena. För att flödena ska vara tillgängliga för personer som inte är inloggade måste du ge Anonym behörighet till HTTP-metoden GET, som används för att hämta flödena.

1. Öppna tilläggets Egenskaper / Restriktioner.
2. Kontrollera att Tillåt anrop är aktiverat.
3. Under Behörighet, lägg till Anonym och ge behörighet till GET. Spara inställningarna.

Läs mer om inställningarna på Sitevisions hjälpsida om RESTApps – Restriktioner Länk till annan webbplats, öppnas i nytt fönster..

Ändra tilläggets namn och RSS-adresser

Under tilläggets Egenskaper / Inställningar kan du ändra tilläggets namn i fältet Namn. Namnet används i RSS-flödenas adresser direkt efter URL-segmentet rest-api. Genom att ändra namnet kan du anpassa denna del av sökvägen för samtliga flöden.

Om tillägget exempelvis heter rss-feeds och flödets sökväg är nyheter, blir adressens sökväg /rest-api/rss-feeds/nyheter. Ändrar du tilläggets namn till rss, blir sökvägen i stället /rest-api/rss/nyheter.

Obs! Om du ändrar namnet i efterhand kommer tidigare länkar till RSS-flödena att sluta fungera. Befintliga länkar och prenumerationer behöver då uppdateras med de nya adresserna. Välj därför helst tilläggets namn innan du börjar dela flödenas adresser.

Modulinställningar

Klicka på Lägg till RSS-flöde för att skapa ett flöde. Inställningarna för flödet är uppdelade på flikarna Allmänt, Urval och Artikelinnehåll.

Ange en rubrik och en unik sökväg och lägg till minst en källa. Spara sedan flödet och modulens inställningar. Använd Kopiera vid sökvägen för att kopiera RSS-adressen. Adressen kan användas i en RSS-läsare eller som mål för en länk på webbplatsen.

Fliken Allmänt

Under fliken Allmänt anger du flödets rubrik, adress och språk. Här kan du också lägga till en beskrivning, bild och kontaktuppgifter för flödet.

Rubrik för flödet

Ange flödets rubrik, till exempel ”Nyheter från kommunen”. Rubriken används både i RSS-flödet och som namn i modulens lista över flöden. Fältet är obligatoriskt.

Sökväg

Ange den sista delen av flödets adress, till exempel "nyheter". Använd små bokstäver a–z, siffror och bindestreck mellan ord. Fältet är obligatoriskt. Ge varje flöde en egen, unik sökväg.

Adressens inledande del visas framför fältet. Knappen Kopiera kopierar den fullständiga RSS-adressen. Om du ändrar sökvägen behöver länkar och prenumerationer uppdateras till den nya adressen.

Namnet som RSS-modulen får när den installeras på webbplatsen avgör adressdelen mellan /rest-api/ och flödets sökväg. Du kan ändra namnet under RESTAppens egenskaper/inställningar. Om du gör det behöver eventuella länkar och prenumerationer uppdateras till den nya adressen.

Kort beskrivning av flödet

Beskriv kort vilket innehåll flödet innehåller. Beskrivningen kan visas tillsammans med flödets rubrik i tjänster som läser RSS.

Språk

Välj det språk som artiklarna är skrivna på. Svenska är förvalt. Du kan även välja engelska, danska, norska, finska, tyska, franska och spanska.

Välj Annat för att ange en Egen språkkod, till exempel `it` för italienska. Inställningen anger flödets språk och översätter inte innehållet.

Rättighetstext och bild

I fältet Rättighetstext kan du ange information om rättigheter till innehållet. I fältet Bild kan du välja en bild som representerar hela flödet. Båda fälten är valfria.

Bilder för enskilda artiklar väljer du separat under Källa för bild på fliken Artikelinnehåll.

Ansvarig redaktör

Aktivera Visa ansvarig redaktör för att lägga till kontaktuppgifter för den som ansvarar för innehållet. Ange e-postadress och, om du vill, namn. Kontaktuppgiften tas med när en e-postadress har angetts.

Kontaktuppgifter till webmaster

Aktivera Visa kontaktuppgifter till webmaster för att lägga till kontaktuppgifter för webbplatsens tekniskt ansvariga. Ange e-postadress och, om du vill, namn. Kontaktuppgiften tas med när en e-postadress har angetts.

Länk till webbplats

Under Avancerade inställningar väljer du vilken webbadress flödet ska hänvisa till. Webbplatsens primäradress är förvalt, och är oftast det naturliga valet för webbplatser som inte använder flera domäner under samma hus.

Välj Eget värde om flödet exempelvis ska använda en underwebbs egen domän. Ange då den fullständiga webbadressen i fältet Eget värde, till exempel https://nyheter.exempel.se. Adressen används både för flödets övergripande länk och som bas för artikellänkarna och flödets hänvisning till sin egen RSS-adress. Varje artikel länkar till sin egen sida under den angivna adressen.

Publiceringsverktyg

Under Avancerade inställningar kan du även ange namnet på publiceringsverktyget. Värdet tas med som information i RSS-flödet. Lämna fältet tomt om uppgiften ska utelämnas.

Fliken Urval

Under fliken Urval väljer du vilka sidor och artiklar som ska ingå i flödet. Här anger du källor, filterregler, maximalt antal artiklar och sorteringsordning.

Källor för artiklar

Lägg till en eller flera poster i **Källor för artiklar** och välj typ av källa. Innehåll från källorna samlas i samma flöde. Minst en källa krävs.

Alla underliggande sidor

Välj sida under Välj sida att hämta artiklar från. Innehåll under den valda sidan hämtas även från djupare nivåer. Den valda sidan själv ingår inte.

Aktivera Inkludera endast sidor som ligger direkt under den valda sidan för att begränsa urvalet till närmast underliggande nivå. Använd detta vid ett mindre antal direkt underliggande sidor, eftersom ett stort antal kan påverka prestandan.

En enskild sida/artikel

Välj den sida eller artikel som ska ingå i flödet under Välj en enskild artikel. Även en enskilt vald sida omfattas av flödets filterregler.

Filterregler

Lägg till poster i Filterregler för att begränsa innehållet från källorna. Välj mellan Metadatafält, Etiketter och Datum. Alla tillagda filterregler måste vara uppfyllda för att en sida ska ingå. Om listan är tom används inga extra filter.

När du väljer metadata kan du välja ett globalt fält med Välj metadatafält eller använda Ange identifierare för ett fält som exempelvis bara finns på en del av webbplatsen. Ange då fältets identifierare.

Metadatafält

Välj Metadatafält att kontrollera och ange Jämförelse:

• Lika med eller Inte lika med jämför med det angivna värdet.
• Innehåller eller Innehåller inte kontrollerar om det angivna värdet ingår.
• Har ett värde eller Saknar värde kontrollerar om fältet har något värde.

Ange Värde för de fyra första jämförelserna. För de två sista behövs inget jämförelsevärde. Fältväljaren stöder text, enkelval, flerval, etiketter och målgrupper.

Etiketter

Välj Villkor för etiketter och markera en eller flera etiketter under Välj etiketter. Du kan söka i listan för att hitta rätt etiketter.

• Någon av etiketterna ska finnas tar med sidor som har minst en av de valda etiketterna.
• Ingen av etiketterna får finnas utesluter sidor som har någon av de valda etiketterna.
  

Datum

Under Datum som ska kontrolleras väljer du senaste publiceringsdatum, första publiceringsdatum, skapad datum eller senast ändrad. Välj Annat metadatafält och ange Datumfält om datumet ska hämtas från metadata av typen datum.

Välj sedan Villkor för datum:

• Datumet har passerat tar med innehåll vars datum är fram till och med den aktuella tidpunkten.
• Datumet har inte passerat tar med innehåll vars datum ligger efter den aktuella tidpunkten.
• Datumet är efter valt datum eller Datumet är före valt datum jämför med det datum du anger i Välj datum.

Ett valt datum jämförs vid dagens början, klockan 00.00. Villkoret ”före” tar därför inte med innehåll från den valda dagen.

Maximalt antal artiklar

Ange hur många artiklar flödet som mest ska innehålla. Ange ett heltal som är minst 1. Om fältet lämnas tomt används 20 artiklar. Sorteringsordningen avgör vilka artiklar som kommer med när fler matchar urvalet.

Sorteringsregler

Lägg till en eller flera poster i Sorteringsregler. Reglerna används i listans ordning; nästa regel avgör ordningen när artiklar har samma värde enligt föregående regel.

Systemvärde

Välj Namn/Titel, Skapad datum, Senast ändrad, Senast publicerad eller Publiceringsdatum. Välj sedan stigande eller fallande Ordning. För datum innebär fallande ordning att de senaste datumen kommer först.

Metadata

Under Typ av metadata väljer du Utpekat metadatafält och väljer ett fält, eller Identifierare för metadata och anger fältets identifierare. Välj sedan stigande eller fallande Ordning.

Fältet Anpassat sökindex är till för avancerad sortering och kan normalt lämnas tomt, om inget speciellt sökindex används på webbplatsen.

Om inga sorteringsregler anges sorteras artiklarna med senaste första publiceringsdatum först. Lägg till en regel för Senast publicerad om ompublicerade artiklar ska flyttas upp i flödet.

Fliken Artikelinnehåll

Under fliken Artikelinnehåll bestämmer du vilka uppgifter som ska skickas med varje artikel. Här väljer du källor för titel, beskrivning, bild och datum samt om skribent och kategorier ska tas med.

Källa för titel

Välj Sidans namn eller Metadatafält. Vid metadata väljer du ett textfält under Metadatafält för titel. Om metadatavärdet saknas används sidans namn.

Källa för beskrivning

Välj vilket innehåll som ska användas som artikelns beskrivning:

• Ingen beskrivning utelämnar beskrivningen. Detta är förvalt.
• Textmodulen "Ingress" hämtar text från en textmodul med namnet Ingress.
• Textmodulen "Innehåll" hämtar text från en textmodul med namnet Innehåll.
• Annan textmodul hämtar text från den textmodul vars namn du anger i fältet Textmodulens namn.
• Metadatafält hämtar text från det textfält du väljer under Metadatafält för sammanfattning.
• Dynamisk text låter dig kombinera egen text med variabler i Text för beskrivning.

Kontrollera textmodulernas namn om du väljer en textmodul. Om den aktuella textmodulen saknas blir beskrivningen tom.

Dynamisk text

För dynamisk text skriver du `$` i textfältet för att infoga en variabel. Knappen Variabler öppnar en dialog där du också kan lägga till egna variabler som hämtar värden från metadata.

Textmallen utvärderas för varje sida eller artikel i flödet.

Egna metadatavariabler läggs till via Variabler och Lägg till variabel. Ange Visningsnamn och koppla ett Metadatafält.

Källa för bild

Välj vilken bild som ska skickas med varje artikel:

• Ingen bild utelämnar artikelbilden. Detta är förvalt.
• Bildmodulen "Bild" hämtar bilden från en modul med namnet Bild, om den finns.
• Bildmodulen "Mediaflow" hämtar bilden från en modul med namnet Mediaflow om den finns, och behandlar den som en bildmodul från Mediaflow.
• Annan bildmodul hämtar bilden från den första bildmodul som hittas bland de namn du anger i fältet Bildmodulens namn.
• Metadatafält hämtar bilden från det fält du väljer under Metadatafält för bild. Fältväljaren stöder länkmetadata som pekar på en bild och metadata som hämtar en bild från en bildmodul. Du kan också använda Ange identifierare för att ange fältets identifierare.

Vid Annan bildmodul anger du ett eller flera modulnamn separerade med kommatecken. Modulerna prioriteras enligt angiven ordning, och den första som hittas används.

Om du exempelvis anger Mediaflow, Bild hämtas bilden från Mediaflow om den modulen finns i första hand. Annars används Bild, om den finns. Om ingen av modulerna hittas skickas ingen artikelbild med.

Bilden skickas med som en separat bildresurs i flödet. Hur den visas beror på RSS-läsaren eller tjänsten som använder flödet.

Källa för datum

Välj Senaste publiceringsdatum, Första publiceringsdatum eller Metadatafält. Senaste publiceringsdatum är förvalt. Vid metadata väljer du ett datumfält under Metadatafält för datum.

Inställningen styr datumet som skickas med varje artikel. Sorteringsordningen ställs in separat på fliken Urval. Om ett datum saknas utelämnas artikelns datum i flödet.

Visa skribent

Aktivera Visa skribent och välj Metadatafält för skribent. Välj ett textfält som innehåller en e-postadress eller ett användarfält. Från ett användarfält hämtas användarens e-postadress och namn. Om e-postadressen saknas utelämnas skribentuppgiften.

Källor för kategori

Lägg till en eller flera poster i Källor för kategori för att skicka med kategorier för varje artikel. Kategorierna från alla källor tas med. Om listan är tom skickas inga kategorier.

Metadatafält

Välj Metadatafält för kategori. Fältväljaren stöder enkelval, flerval, etiketter och målgrupper. Om fältet innehåller flera värden skickas de som separata kategorier. För etiketter och målgrupper används deras namn.

Etiketter

Ange under Välj etikettgrupper vilka grupper artikelns kategorier ska hämtas från. Du kan söka i listan och välja flera grupper. Om ingen grupp väljs används artikelns etiketter från alla grupper.