Ni kan läsa release notes nedan. Jag rekommenderar alla implementeringsledare att uppdatera era siter med denna version. Den genomgår just nu lite testning ute i det vilda och kommer därefter att publiceras som en 2.0.0-version. Hojta till mig om någon vill testa redan nu på sin site.

2.0.0-rc.0

Med denna release så är detta plugin inne på sin tredje generation. Första generationen (ver. <= 1.2) erbjöd dynamisk inläsning av infopackinnehåll direkt från registry. Med andra generationen infördes synkning av enskilt innehåll till wordpress-databasen vilket bl.a. förbättrade sökbarheten.

Denna tredje version har genomgått i princip en total omskrivning. En helt ny synkmekanism är på plats och pluginet använder nu infopack collections fullt ut och synkar "samlingar" av innehåll istället för varje innehåll för sig.

OBS! Pluginet är inte bakåtkompatibelt, se särskild migrationsguide om din site redan har pluginet installerat.

Infopack collection

Infopack collection är ett helt nytt koncept inom ekosystemet. Tanken med en samling (infopack collection) är att man kan sätta samman infopack innehåll (infopack content) för ett specifikt syfte.

Om vi använder liknelsen med ett pussel så utgör ett samling hela pusslet och infopack materialet är pusselbitarna. Innan denna version så har användaren fått hjälp att versionhantera och hämta pusselbitarna var för sig från Infopack registret men hela "orkestreringen" av hur pusselbitarna sitter samman och grupperas (med s.k. "navigeringssidor") har varit upp till varje site admin att bygga upp och underhålla.

Med samlingar kan material från olika infopack sättas samman och grupperas utifrån användningsbehov. Pluginet hjälper till att importera och bygga navigeringsstrukturen enligt specifikationen i samlingen.

Nyheter

• Det är nu möjligt att läsa in samlingar.
• Innehåll läses in på siten helt baserat på dessa samlingar
• Innehållet är hierarkiskt vilket möjliggör "navigereringssidor".
• Funktionalitet som att bädda in innehåll på en befintlig sida samt omlänkning är helt borttaget.

Detaljerad information

• Generellt: Pluginet använder nu mer av "standard funktionaliten" som wordpress har
  • Det betyder t.ex. att alla sidor som läses blir sökbart i wordpress ordinarie länkhanterare.
  • Sökfunktionen kan se och använda all inläst text
  • Innehållstyperna infopack collection och infopack content får egna redigeringsgränssnitt i admin-gränssnittet på samma sätt som ordinarie innehållstyper posts och pages.
  • Kategori och etikett-funktionerna kan nyttjas fullt ut om man har det behovet.
• Ny funktion för att läsa in en komplett samling.
  • Pluginet kommunicerar med registerservern och lagrar en komplett lista med allt infopack-innehåll som registret hittar baserat på kriterierna i samlingen.
  • Ev. "latest" versiontaggar utlöses till sin faktiska versionsnummer vid denna synk och det är dessa versioner som läses in.
  • Flera samlingar kan läsas in på en site.
    • Detta möjliggör "bakåtkompabilitet" då allt inläst material inordnas under sin respektive samling.
    • En samling kan sättas som aktuell vilket medför att dess versionsnummer och beroeden kan visas upp på siten via specifika shortcodes.
  • Denna funktion ersätter den tidigare "dependency tree"-funktionaliteten
  • @site-symbolen utgår därför helt.
• Ny funktion för att läsa in infopack-innehåll från en samling
  • I tidigare versioner lästes alla material in "platt" under /infopack_content och ev. navigeringsstruktur (parent pages) tappades. Nu skapas navigeringsstrukturen upp med automatik utifrån hur samlingen är specificerad.
  • Begreppet synka blir nu lite missvisande då vi tekniskt sett aldrig "uppdaterar" ett infopack innehåll med ny version mellan olika samlingar utan vi läser den nya versionen på nytt under den nya samlingen.
• Användaren ges full möjlighet att se och redigera innehållet i allt hämtat material.
  • Detta är viktigt för att användaren ska kunna anpassa framförallt "navigeringssidorna".
• Möjligheten att placera infopack innehåll via shortcodes fritt på wordpress-sidor är borttagen
  • Ersätts av den nya innehållstypen "infopack_content"
  • Kommentar: Även om detta skapade en del flexibiltet så krävdes det mycket arbete av adminstratören att skapa upp och ajourhålla "värdsidor" för dessa shortcodes
• Möjligheten att automatiskt får hjälp med omdirigering från gamla sidor till "infopack_content"-sidor är borttagen
  • Kommentar: Vi förstår att en del befintliga siter har ett värde av att kunna bibehålla gamla länkar. Vi har trots valt att ta bort denna möjlighet då det kort sagt inte är helt enkelt att helt automatiskt länka om till den nya strukturen. Om omlänkning behövs så finns det andra tredjeparts-plugin som kan hjälpa till detta.
• "Infopack settings"-länken i admin menyn har flyttats ner under "settings"-menyn.
  • Kommentar: detta följer best practise enl. wordpressutvecklarna

Viktigt! Även om det nu är möjligt att ändra inläst innehåll så avråder vi det bestämt. Hela syftet med infopack ekosystemet är att säkerställa spårbarhet och denna kan lätt undermineras om innehållet på sidan avviker från innehållet i registret.

Ta alltid för vana att om en uppdatering behövs så genomför ändringen i källmaterialet och publicera en ny version av innehållet samt en ny version av samlingen.

Migrationsguide för ver < 2.*

Du kan installera det nya pluginet som vanligt utan att först måsta avaktivera och avsinstallera det gamla pluginet.

Om du har vers >= 1.3.* på din nuvarande site så använder du redan innehållstypen "infopack_content". Denna version använder dock innehållstypen lite annorlunda och det är därför starkt rekommenderat att du raderar allt befintligt innehåll där innan du läser in en infopack collection.

Notera att denna knapp endast visas för .html filer just nu.

Skärmklipp från webbplatsen som visar den nya knappen

Vi tar och undersöker om detta är något som lätt går att fixa eller om det är ett större jobb och återkommer.

Bra att du flaggar!

Detta kan ju förslagsvis göras efter revideringen av ovan nämnd standard är publicerad. Har hört att den skall ses över just nu.

I portalen önskas ett avsnitt "För dig som vill veta vad Nationella Riktlinjer är, börja här"

Begreppslistan i NR är ett exempel på en funktion som kan vara bra att starta med att tillämpa i egen organisation. Det kan vi tipsa om.

När det gäller teman på nätverksaktiviteter så föreslås att både beställare och leverantörer av information får berätta vad som är svårt. Och dela exempel på det som gått bra och inte gått bra. Bra att ta upp frågeställningar om hur man kan definiera vad information ska användas till.

Här kan vi diskutera:

• Förändring av befintligt material
• Förslag eller tankar kring nytt material

• Se och förstå hur vi själva strukturerar källinformationen inför releaser (till registry.infopack.io)
• Se och påverka i alla ärenden (buggar, utvecklingsbehov, förbättringsförslag)
• Hämta en egen kopia (via nedladdningsfunktionen eller via sk. fork)
• Lämna förbättringsförslag via sk. merge request

Du hittar gruppen här.

Nu finns utökat utbildningsmaterial under kursmaterial på Nationella Riktlinjer, länken är här!

Områdena som beskrivs i det nya kursmaterialet är:

• Användning av Nationella Riktlinjers content-plugin
• Uppsättning av projekt med infopack struktur
• Arbeta med innehåll i GITlab
• Arbeta med innehåll i Visual Studio Code + Paketering av innehåll

Framtida utökningar i utbildningsmaterial kommer att förmedlas här och på möten med implementeringsledarna.

// Daniel Paldeak

Slår ett slag för BIM Alliance "BIM-frukost" 21 september där Robert Grahm från Skanska pratar Nationella riktlinjer. Länk till inspelning finner ni nedan:

https://www.youtube.com/watch?v=YgHgKkdizJ4&t=1166s