Kmom06: Lagra innehåll i databasen

Detta kursmoment har ett liknande upplägg som föregående och vi fortsätter att jobba med databasen där vi nu fokuserar på att hantera “innehåll” i databasen. Innehåll kan till exempel vara texten till de sidor som bygger upp en webbplats eller innehållet i bloggsidor.

Att lagra innehåll i databasen för att sedan kunna visa upp det i webbplatsen är en kärnfunktionalitet i många webbplatser. Så här långt har vi en fungerande webbplats om använder sig av databas och objektorienterad programmering. Vi fortsätter att använda de teknikerna för att bygga grunden i en databasdriven webbplats där innehåll lagras i databasen och kan redigeras (CRUD) av användaren. Vi skall sedan visa upp innehållet som vanliga sidor i webbplatsen samt en blogg.

Det vi bygger är i grunden ett enkelt Content Mangement System (CMS) där användaren kan redigera webbplatsens innehåll och texter via ett webbaserat gränssnitt.

Utmaningen är att hitta en bra lagringsstruktur i databastabellen, en bra och flexibel struktur som låter oss använda innehållet på ett smidigt sätt i webbplatsen och leder till effektiv SQL. Tänker man till när man skapar lagringsstrukturen så kan man spara ett antal kodrader när man sedan skall redigera, och visa upp innehållet i webbplatsen.

Utmaningen ligger även i hur man väljer att konstruera sina klasser, kanske går det att skapa en generell struktur som klarar både det ena och det andra, när det gäller texter och innehåll i databasen.

(Detta är instruktionen för kursmomentet och omfattar det som skall göras inom ramen för kursmomentet. Momentet omfattar cirka 20 studietimmar inklusive läsning, arbete med övningar och uppgifter, felsökning, problemlösning, redovisning och eftertanke. Läs igenom hela kursmomentet innan du börjar jobba. Om möjligt – planera och prioritera var du vill lägga tiden.)

#Läs & Studera

(ca: 1-2 studietimmar)

#Repetera

I föregående kmom fanns läsanvisningar om PHP PDO, eventuellt vill du gå tillbaka till dem och göra en kort repetition.

I förra kmomet läste du om “Databaser i ramverk” som referensmaterial och fördjupning. Har du tid över så är det bra att gå tillbaka till det stycket och läsa ytterligare lite mer.

#Hantera innehåll i webb och databas

Här finns ett antal lästips som visar hur du kan hantera text i databasen ur ett par olika aspekter. Artiklarna används i övningen och uppgiften som du skall genomföra. Läs igenom artiklarna för att förbereda dig och för att få en känsla för hur innehåll kan hanteras.

• “Gör en läsbar url med slugify()”
• “Reguljära uttryck i PHP ger BBCode formattering”
• “Låt PHP-funktion make_clickable() automatiskt skapa klickbara länkar”
• “Skriv för webben med Markdown och formattera till HTML med PHP (v2)”

#Referens textfiltrering (överkurs)

Finner du detta ämne intressant så kan du även läsa följande tips från coachen.

• Typografiska element för webben med SmartyPants

Vi arbetar inte med det i uppgiften men det kan vara intressant att veta om filtret HTML Purifier som kan filtrera innehåll och struktur på din HTML-kod som genereras från din webbplats.

• HTML Purifier

Även hanteringen av frontmatter är en sak som hanteras med ett textfilter. Här handlar det mest om en YAML parser som konverterar frontmattern till en PHP array. Här kan du läsa om olika YAML parsers inklusive den modulen som vi använder i Anax vilken är symfony/yaml.

• PHP YAML Parsers
• The state of YAML in PHP
• symfony/yaml: The Yaml Component

#Ramverk Anax

Den modulen som berörs i detta kursmoment är anax/textfilter men du kommer inte att använda den då du du istället kommer att göra din egen motsvarighet. Men om du har intresse att studera modulens uppbyggnad och kod så kan du som överkurs studera dess README och källkod.

• anax/textfilter

Modulen används (främst) för att hantera frontmatter och översätta text från markdown till HTML, lösa innehållsförteckningar och revisionshistorik samt sköta länkningen inom ramverket för flatfile content, de filer som ligger i content/ katalogen.

Du har sedan tidigare kännedom om följande moduler.

• anax/commons
• anax/controller
• anax/database
• anax/request
• anax/response
• anax/router
• anax/session
• anax/view

#Video

Det finns generellt kursmaterial i video form.

• Kursen innehåller genomgångar och föreläsningar som spelas in (streamas) och därefter läggs i en spellista. Du kan nå spellistan på “oophp streams vt19”.

1. Uppgifter och övningar kan innehålla extra videomaterial i form av spellistor kopplade till respektive artikel. Ofta syns dessa videor i inledningen av artikeln.

#Övningar & Uppgifter

(ca: 12-16 studietimmar)

#Övningar

Gör följande övning, den förbereder dig inför uppgifterna.

1. 1. Jobba igenom guiden “Lagra innehåll i databas för webbsidor och bloggposter (v2)”. Spara dina eventuella exempelprogram under me/kmom06/content.

#Uppgifter

Följande uppgifter skall utföras och resultatet skall redovisas via me-sidan.

1. Gör uppgiften “Skapa en klass för textfiltrering och formattering (v2)”. Den färdiga klassen integrerar du i me/redovisa. Vill du testa och utveckla i en separat katalog så använder du me/kmom06/textfilter.

2. Gör uppgift “Bygg webbsidor från innehåll i databasen” och spara filerna i me/redovisa.

3. Pusha och tagga ditt repo me/redovisa allt eftersom och sätt en avslutande tagg (6.0.*) när du är klar med alla uppgifter och redovisningstext i kursmomentet. Gör även en avslutande make test som en sista avstämning, innan du sätter sista taggen.

#Resultat & Redovisning

(ca: 1-2 studietimmar)

Läs instruktionen om hur du skall redovisa.

Se till att följande frågor besvaras i texten:

• Hur gick det att jobba med klassen för filtrering och formatting av texten?
• Berätta om din klasstruktur och kodstruktur för din lösning av webbsidor med innehåll i databasen.
• HUr känner du rent allmänt för den koden du skrivit i din me/redovisa, vad är bra och mindre bra?
• Ser du potential till refactoring av din kod och/eller behov av stöd från ramverket?
• Vilken är din TIL för detta kmom?

#Revision history