Nyheter

Nyheter är föreningens egna meddelanden: korta notiser ("Bastun stängd 10–12 juni"), kallelser ("Årsmöte 26/1") och ibland ett längre inlägg med bild. Det ni publicerar här syns på tre ställen samtidigt: på er publika sida (/k/er-förening/nyheter), på hem-fliken i medlemsportalen och i appen. Dessutom kan er egen webbplats hämta dem via ett öppet API.

Har ni Anslagstavlan påslagen hamnar varje publicerad nyhet också där, där medlemmarna kan gilla och kommentera den.

Funktionen är avstängd tills ni slår på den under Inställningar → Funktioner → Kommunikation → Nyheter. Nyheter är en del av Kommunikation, så Kommunikation måste vara påslaget först. Därefter hittar ni fliken Nyheter under Kommunikation i menyn, bredvid Meddelanden.

Skillnaden mot Meddelanden och Utskick

  • Nyheter är varaktiga och har en egen adress. De ligger kvar, går att länka till och är publika.
  • Meddelanden (fliken bredvid) är driftnotiser som visas som en banner för inloggade medlemmar, ofta med en allvarlighetsgrad. De har ingen egen sida.
  • Utskick går ut via e-post. En nyhet kan skickas som utskick med ett klick, se nedan.

Skriva och publicera

Klicka på Ny nyhet. Fyll i:

  • Rubrik: en rad. Adressen (slug) skapas automatiskt ur rubriken, till exempel bastun-stangd. Du kan ändra den så länge inlägget är ett utkast; efter första publiceringen låses den så att länkar som redan delats fortsätter fungera.
  • Text: skriv som i ett vanligt dokument. Fetstil, kursiv, rubriker, punktlistor, länkar och bilder stöds. Klistra in en länk till en PDF (kallelse, protokoll) som en vanlig länk.
  • Utdrag (valfritt): den korta text som visas i listor och som beskrivning när inlägget delas. Lämnar du fältet tomt används inledningen av texten.
  • Går ut (valfritt): efter den tidpunkten försvinner inlägget från publika sidan, portalen och appen av sig självt, men finns kvar här. Passar "stängd 10–12 juni".
  • Fäst överst: fästa inlägg ligger först i alla listor.

Spara utkast sparar utan att visa något. Publicera gör inlägget synligt. Publiceringsdatumet sätts första gången och ändras inte när du redigerar senare. Avpublicera döljer det igen, Arkivera lägger det åt sidan. Ett inlägg som aldrig publicerats kan raderas; ett som har varit publikt arkiveras i stället.

Skicka som utskick

Knappen Skicka som utskick på ett inlägg skapar en e-postmall av inlägget (rubriken blir ämne, texten blir innehåll, med länk till inlägget på webben) och ett utkast till kampanj, och öppnar kampanjguiden där du väljer mottagare och skickar. Ett inlägg kan skickas en gång; efteråt visar listan när det gick ut och till hur många.

På publika sidan

Sektionen Nyheter i sidbyggaren (Inställningar → Publik sida) visar de tre senaste inläggen på /k/er-förening med länk till alla. Den finns med i layouten så fort funktionen är på; hade ni redan anpassat layouten tidigare ligger den avstängd längst ned tills ni slår på den.

Hämta nyheterna till er egen webbplats

Nyheterna finns som ett öppet, oautentiserat JSON-API som vilken webbplats som helst kan läsa, även från en annan domän. Bara publicerade och inte utgångna inlägg lämnas ut.

Enklast är att öppna API på nyhetssidan i GlennBook: där ser ni era egna adresser, kan prova anropen direkt och kopiera färdiga kodexempel. Den fullständiga specifikationen finns som Swagger UI på /api/public/docs och som OpenAPI-fil på /api/public/openapi/v1.json.

# De tre senaste (utan brödtext)
curl "https://glennbook.se/api/public/v1/organisations/er-forening/news?limit=3"

# Med färdigrenderad HTML i listan
curl "https://glennbook.se/api/public/v1/organisations/er-forening/news?limit=10&includeBody=true"

# Ett inlägg
curl "https://glennbook.se/api/public/v1/organisations/er-forening/news/bastun-stangd"

# RSS/Atom-flöde
curl "https://glennbook.se/api/public/v1/organisations/er-forening/news/feed.atom"

Svaret för listan ser ut så här:

{
  "items": [
    {
      "id": "…",
      "slug": "bastun-stangd",
      "title": "Bastun stängd",
      "excerpt": "Den 10–12 juni är bastun stängd.",
      "bodyHtml": null,
      "bodyBlocks": null,
      "publishedAt": "2026-06-01T08:12:00Z",
      "updatedAt": "2026-06-01T08:12:00Z",
      "expiresAt": "2026-06-13T00:00:00Z",
      "pinned": false,
      "url": "https://glennbook.se/k/er-forening/nyheter/bastun-stangd"
    }
  ],
  "nextCursor": null,
  "organisation": { "slug": "er-forening", "name": "Er förening" }
}

Bra att veta för den som bygger:

  • Sortering: fästa först, sedan nyast först. Fler än limit inlägg hämtas med ?cursor=<nextCursor>. limit är högst 50.
  • bodyHtml är sanerad HTML (stycken, fet/kursiv, listor, länkar, bilder, rubriker h2/h3, citat) och kan renderas direkt. bodyBlocks är samma innehåll som JSON-block för den som hellre bygger sin egen rendering.
  • Svaren har Cache-Control: public, max-age=60, s-maxage=300, stale-while-revalidate=600 och en ETag; skicka If-None-Match så får ni 304 när inget ändrats. En ny nyhet syns alltså inom några minuter utan att ni behöver göra något.
  • Alla datum är UTC i ISO 8601.
  • Ett inlägg som inte är publikt ger 404, aldrig 403.

Autentiserade anrop och API-nycklar

Att läsa nyheter kräver ingen nyckel. Vill er webbplats eller en automation i stället skapa nyheter, till exempel spegla inlägg från ert eget CMS, behövs en API-nyckel med rättigheten news:write.

  1. Skapa nyckeln under Inställningar → API-nycklar: ge den ett namn och bocka i de rättigheter den ska ha. Nyckeln visas en enda gång; kopiera den direkt. Vi sparar bara ett fingeravtryck av den.
  2. Skicka den i varje anrop som Authorization: Bearer gbk_… (eller X-Api-Key: gbk_…).
  3. Kontrollera att den fungerar med GET /api/public/v1/me, som svarar med vilken förening nyckeln tillhör och vad den får göra.
# Vem är nyckeln?
curl -H "Authorization: Bearer gbk_…" "https://glennbook.se/api/public/v1/me"

# Skapa och publicera en nyhet
curl -X POST "https://glennbook.se/api/public/v1/organisations/er-forening/news" \
  -H "Authorization: Bearer gbk_…" -H "Content-Type: application/json" \
  -d '{"title":"Bastun stängd 10–12 juni","bodyMarkdown":"Bryggdäcket **renoveras**.","publish":true}'

En nyckel tillhör en förening och kan bara agera på den. Saknar den rättigheten svarar API:t 403, är den återkallad eller felaktig 401. Återkalla en nyckel så fort ni misstänker att den kommit på avvägar. Det slår igenom omedelbart. På nyhetssidans API-flik kan ni prova de autentiserade anropen med en nyckel.

Flytta in gamla nyheter

Har ni nyheter i ett annat system kan de importeras en gång via Importera på nyhetssidan. Klistra in en JSON-lista med title, bodyMarkdown och publishedAt (samt valfritt slug, excerpt, expiresAt, pinned). Inläggen skapas som publicerade med sina ursprungliga datum. Importen hoppar över inlägg vars adress redan finns, så det går bra att köra den igen. Bilder som länkar till ett annat system laddas ner och sparas hos oss, så att de fortsätter fungera när det gamla systemet stängs.

Vanliga frågor

Kan jag ändra en nyhet efter att den publicerats? Ja. Texten uppdateras direkt överallt. Publiceringsdatumet och adressen behålls.

Syns nyheterna för gäster? Ja, de är publika, både på /k-sidan och via API:t. Skriv inget här som bara medlemmar ska se; använd Meddelanden för det.

Varför står det "Inget att visa" på publika sidan? Sektionen visar bara publicerade inlägg som inte gått ut. Kontrollera status och "Går ut" på inlägget.