Files
super-simple-wp-theme/TODO.md
T

282 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TODO — Super Simple WordPress Theme
Fornying og namnbyte av WordPress-temaet (tidlegare **NTKF**) for
[Norske Tau- og Kabelbaners Forening](https://www.taubaneforeningen.no/).
| | |
|---|---|
| **Repo** | `ai-bot/super-simple-wp-theme` |
| **Branch** | `main` (arbeidsbranch: `theme-refresh-2.0`) |
| **Nytt tema-namn** | Super Simple WordPress Theme |
| **Ny slug / text domain** | `super-simple-wp-theme` |
| **Ny versjon** | `2.0.0` |
| **Prompt til AI-kodar** | `AI_CODER_PROMPT.md` |
---
## 1. Mål
1. **Namnbyte** — `NTKF` → `Super Simple WordPress Theme` i tema-header, text domain, funksjonsprefiks og CSS-variablar.
2. **Lesbarheit for alle aldrar** — rolegare typografi, høgare kontrast, kortare linelengd, tydeleg visuelt hierarki.
3. **Fungerer på pc og mobil** — ingen faste pikselbreidder, reflow ned til 320 px, trykkflater på minst 44×44 px.
4. **Tilgjenge (WCAG 2.2 AA)** — kontrast, synleg fokusmarkering, landemerke, `<h1>`, skip-link, tastaturnavigasjon.
5. **Bakoverkompatibilitet** — bbPress, `super-simple-rssreader` og `super-simple-slideshow` skal sjå like bra ut, og alt som er skjult i dag skal framleis vere skjult.
**Ikkje målet:** nye funksjonar, ny layout-struktur, endringar i plugin-repoa, JS-rammeverk eller byggesteg.
**Overordna prinsipp:** sida skal **oppføre seg og sjå ut som i dag**, berre reinare, meir lesbar og meir tilgjengeleg. Ingen markup skal brytast.
---
## 2. Leveransar
- `TODO.md` — denne planen.
- `AI_CODER_PROMPT.md` — ferdig prompt til AI-kodaren.
- Oppdatert tema (sjå filplan i prompten) på branch `theme-refresh-2.0`.
- Ny `README.md` i temaet (engelsk) med installasjon, tilpassingsfiltrar og tabell over gamle → nye CSS-variablar.
---
## 3. Status no — audit
Temaet er 11 PHP/CSS-filer utan README, utan `wp_head()`/`wp_footer()` og med
hardkoda fargar og breidder. Funn sortert etter alvor:
### Kritisk
| # | Fil | Funn |
|---|---|---|
| K1 | `header.php` | Manglar `wp_head()`. Ingen plugin kan leggje inn CSS/JS via WP-API, admin-bar visest ikkje. |
| K2 | `footer.php` | Manglar `wp_footer()`. Same problem for script som skal lastast seint. |
| K3 | `header.php` | `<title>` er hardkoda til `bloginfo('name')` — alle sider får same tittel. Manglar `add_theme_support('title-tag')`. |
| K4 | `footer.php`, `index.php` | `do_shortcode('[super_simple_slideshow]')` / `[super_simple_rssreader]` vert kalla utan `shortcode_exists()`-vakt. Er pluginen avslått, vert den rå shortcode-teksten skriven ut på sida. |
| K5 | `style.css` | `--a-hover: #AAA` på `--bg-color: #38629F` = **2,6:1**. Brukt på `.date`, `.categories`, `.rss-feed span` og som bakgrunn på søkeknappen (kvit tekst på lys grå = **2,3:1**). Krav: 4,5:1. |
| K6 | `style.css` | `.bbp-form input#user_login { color: var(--txt-color); background-color: var(--border-color); }` → `--border-color` er `#FFF`, altså kvit tekst på kvit bakgrunn. |
| K7 | alle malar | Manglar `<main>`-landemerke, `<h1>`, skip-link, `body_class()` og `wp_body_open()`. |
| K8 | `style.css` | `outline: none` på `.bbp-form … :focus` fjernar all synleg fokusmarkering. |
### Høg
| # | Fil | Funn |
|---|---|---|
| H1 | `style.css` | Faste pikselbreidder: `calc(640px - 8rem)` på søkefelt, `max-width: 640px` / `1024px`. Bryt WCAG 1.4.10 (reflow ved 320 px). |
| H2 | `style.css` | `letter-spacing: .08rem` på `body` (≈1,3 px ved 16 px). Aukar lesetapet; brødtekst bør liggje på ≤0,02em. |
| H3 | `style.css` | `font-size: 3rem` på `.entry-title` og `2.5rem` på `.wp-block-heading` — ikkje responsive, sprenger smale skjermar. |
| H4 | `style.css` | `h3.wp-block-heading { font-size: inherit; }` gjer `h3` lik brødtekst og øydelegg det visuelle hierarkiet. **Medvite vald — skal behaldast.** |
| H5 | `style.css` | `.wp-block-image img, .alignnone { width: 100%; }` skalerer opp små bilete til dei vert uskarpe. Bør vere `max-width: 100%; height: auto`. |
| H6 | `style.css` | Breie tabellar får ikkje horisontal scroll på mobil — `.wp-block-table` manglar `overflow-x: auto`. |
| H7 | `style.css` | Ingen `:focus-visible`, ingen `prefers-reduced-motion` eller `prefers-contrast`. |
| H8 | `style.css` | `font-family: Manrope` utan at fonten vert lasta opp → tilfeldig utfall avhengig av brukaren sitt system. |
| H9 | `header.php` | `language_attributes()` gjev WP sin site language. Sida er nynorsk — bør setjast til `nn_NO` (WordPress-innstilling, ikkje kode). |
### Medium
| # | Fil | Funn |
|---|---|---|
| M1 | `style.css` | `.screen-reader-text` og `h2.screen-reader-text` er sett til `display: none !important`. Det gøymer teksten for skjermlesarar òg — bryt føremålet med klassen. **Godkjend endring: skal skiftast til korrekt visuelt-skjult-teknikk, framleis usynleg.** |
| M2 | `style.css` | Legacy `float: left`-meny med `overflow: hidden` som clearfix. |
| M3 | `style.css` | `header { align-items: center; }` utan `display: flex` — verknadslaus regel. |
| M4 | `rss-feed.php` | Daud kode. Include er kommentert ut i `index.php`, og fila brukar `simplexml_load_file()` mot ekstern URL. **Godkjend sletting** — `super-simple-rssreader` tek over. |
| M5 | fleire | Inkonsekvent text domain (`"textdomain"`, `"your-theme-textdomain"`) og norske strengar utan `__()`. |
| M6 | `functions.php` | Generiske funksjonsnamn (`register_my_menu`, `add_logout_button`) — kollisjonsfare med plugins. |
| M7 | `functions.php` | `remove_private_title_prefix` brukar `str_replace('Privat: ')`. Språkavhengig; bruk `private_title_format`-filteret. |
| M8 | `functions.php` | `is_bbpress()` utan `function_exists()`-vakt. |
| M9 | `functions.php`, `footer.php` | Hardkoda e-postadresse og org.nr. i temaet. |
| M10 | `style.css` | `!important` brukt som symptom på hover-farge på lenkjer. |
| M11 | `footer.php` | Paginering vert rendra på alle malar. **Skal ikkje endrast** — verkar berre på arkiv i praksis. |
| M12 | `style.css` | Tema-headeren manglar `Requires at least`, `Tested up to`, `Requires PHP`, `License`, `Text Domain` og `Tags`. |
---
## 4. Reglar — dette skal ikkje brytast
1. **Skjulte element skal framleis vere skjulte.** Behald `display: none !important`-lista for bbPress **ordrett**, med alle selektorane. Unntak: `.screen-reader-text` (sjå M1), som skal skiftast til korrekt visuelt-skjult-teknikk. Elementet er framleis usynleg.
2. **Ingen HTML-klassenamn eller ID-ar skal bytast namn på.** Behald `.header-menu-class`, `#nav-grid`, `.logo`, `.entry-title`, `.entry-meta`, `.entry-content`, `.date`, `.categories`, `.author`, `.pagination`, `.prev`, `.page-numbers`, `.next`, `.search-container`, `.search-form`, `.search-field`, `.search-submit`, `.footer-logo`, `#logout`, `#org-nr`, `.rss-feed`, `.rss-title`, `.super-simple-slideshow`, `.super-simple-slide`, alle `.bbp-*` og `.wp-block-*`. Nye klassar kan **leggjast til**, men ingen eksisterande skal fjernast eller døypast om — brukaren kan ha eigen CSS under «Tilpass → Tilleggs-CSS».
3. **Ingen endring i markup-struktur utanom det som er lista opp.** Innhald, paginering, slideshow, søk og RSS skal liggje på same plass som i dag.
4. **Menyplasseringa `header-menu` skal behalde slug-en sin.**
5. **Ingen eksterne CDN-førespurnader.** Ingen webfont vert lasta ned.
6. **Ingen byggesteg.** Rein CSS og vanleg PHP. Ingen npm, ingen minifisering.
7. **Ingen nye funksjonar.** Berre fornying, opprydding og namnbyte.
---
## 5. Design-tokens (låst)
Paletten held seg i same blå familie som i dag, men er gjort mørkare slik at
**all tekst når AAA (7:1)** og alle funksjonelle rammer når 3:1. To ekstra
flater gjer at skjema ikkje lenger kan hamne i kvit-på-kvit.
### Fargar
| Token | Verdi | Rolle |
|---|---|---|
| `--sswt-bg` | `#1F3E6B` | Sidebakgrunn |
| `--sswt-surface` | `#2A4E80` | Skjemafelt, varselboksar, tabellhovud |
| `--sswt-text` | `#FFFFFF` | Brødtekst, titlar |
| `--sswt-text-muted` | `#C6D3E8` | Dato, kategori, kjeldenamn, metatekst |
| `--sswt-link` | `#FFD479` | Lenkjer |
| `--sswt-link-hover` | `#FFFFFF` | Lenkje hover |
| `--sswt-rule` | `#6C8CBF` | Dekorative skiljelinjer |
| `--sswt-border` | `#8FA9D4` | Rammar rundt skjemafelt og knappar |
| `--sswt-accent-bg` | `#FFD479` | Knappebakgrunn |
| `--sswt-accent-text` | `#1F3E6B` | Knappetekst |
| `--sswt-focus` | `#FFFFFF` | Fokusmarkering |
Målte kontrastar:
| Kombinasjon | Kontrast | Nivå |
|---|---|---|
| `--sswt-text` på `--sswt-bg` | 10,7:1 | AAA |
| `--sswt-text` på `--sswt-surface` | 8,4:1 | AAA |
| `--sswt-text-muted` på `--sswt-bg` | 7,1:1 | AAA |
| `--sswt-text-muted` på `--sswt-surface` | 5,6:1 | AA |
| `--sswt-link` på `--sswt-bg` | 7,6:1 | AAA |
| `--sswt-link` på `--sswt-surface` | 6,0:1 | AA |
| `--sswt-accent-text` på `--sswt-accent-bg` | 7,6:1 | AAA |
| `--sswt-rule` på `--sswt-bg` | 3,1:1 | ≥3:1 (UI) |
| `--sswt-border` på `--sswt-surface` | 3,5:1 | ≥3:1 (UI) |
| `--sswt-focus` på `--sswt-bg` | 10,7:1 | AAA |
Til samanlikning: dagens `#38629F` gjev 6,1:1 på kvit brødtekst og 2,6:1 på
metafargen `#AAA`.
### Typografi og layout
| Token | Verdi |
|---|---|
| `--sswt-font` | `Manrope, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif` |
| `body` | `font-size: 1.125rem` (18 px), `line-height: 1.6`, `letter-spacing: 0.01em` |
| `--sswt-measure` | `42rem` (~672 px) — brødtekst |
| `--sswt-wide` | `64rem` (~1024 px) — header, nav, footer |
| `h1` | `2.25rem` |
| `h2` | `1.75rem` |
| `h3` | `1.375rem` |
| `h4` | `1.15rem` |
| Trykkflate | min. `44px` høgd |
**Font:** Manrope står først i stacken, men vert **ikkje lasta ned**. Dei som
har han lokalt får han; alle andre får systemfonten sin. Ingen eksterne
førespurnader, ingen layout-hopp. Viss Manrope seinare skal brukast aktivt,
skal filene leggjast i `assets/fonts/` med `@font-face` og `font-display: swap`.
`html` skal ha `font-size: 100%` (aldri px). Alle storleikar i `rem`.
---
## 6. Oppgåver
### Fase 0 — Førebuing
- [ ] Lag branch `theme-refresh-2.0`.
- [ ] Set WordPress site language til `nn_NO` (innstilling i wp-admin).
- [ ] Slett `rss-feed.php` — godkjend, daud kode.
### Fase 1 — PHP: skjelett og WP-standard
- [ ] `functions.php`: skriv om med prefiks `sswt_` på alle funksjonar.
- [ ] `functions.php`: `sswt_setup()` på `after_setup_theme` med `title-tag`, `post-thumbnails`, `html5`, `responsive-embeds`, `automatic-feed-links`, `customize-selective-refresh-widgets`, `align-wide` og `load_theme_textdomain()`.
- [ ] `functions.php`: `sswt_register_menus()` — behald slug `header-menu`.
- [ ] `functions.php`: `sswt_enqueue_assets()` med `wp_enqueue_style()` og `wp_get_theme()->get('Version')` som versjon.
- [ ] `functions.php`: byt `str_replace`-tittelfiksen mot `private_title_format` / `protected_title_format`-filter (M7).
- [ ] `functions.php`: legg `function_exists()`-vakt rundt `is_bbpress()` (M8).
- [ ] `functions.php`: gjer e-postadresse og org.nr. til `apply_filters()`-bare verdiar (M9).
- [ ] `header.php`: legg inn `wp_head()`, `body_class()`, `wp_body_open()`, skip-link, `<main id="main">` og `aria-label` på `<nav>`.
- [ ] `header.php`: `<title>` ut av malen — `title-tag` tek over.
- [ ] `header.php`: legg `alt` på logo-biletet og fallback viss `get_site_icon_url()` er tom.
- [ ] `footer.php`: lukk `</main>`, legg inn `wp_footer()`, og vakt shortcode-utskrifta med `shortcode_exists()` (K4).
### Fase 2 — PHP: malar
- [ ] `index.php`, `category.php`, `author.php`, `search.php`: same struktur, men korrekt `__()`/`esc_html__()` med text domain `super-simple-wp-theme`, og escapade titlar.
- [ ] `single.php` og `page.php`: `entry-title` skal vere `<h1>`, ikkje `<h2>` (K7). Klassenamnet `entry-title` står urørt.
- [ ] `index.php`: behald `shortcode_exists()`-vakt rundt `[super_simple_rssreader]`.
- [ ] Fjern kommentert-ut daukode i malane.
- [ ] **Ikkje** flytt paginering, slideshow eller søk. Dei vert liggjande i `footer.php` slik dei er.
### Fase 3 — CSS: tokens, typografi, base
- [ ] Skriv full tema-header med `Theme Name`, `Version: 2.0.0`, `Requires at least`, `Tested up to`, `Requires PHP`, `License`, `Text Domain: super-simple-wp-theme`, `Tags` (M12).
- [ ] Innfør `--sswt-*`-variablane frå kapittel 5. Fjern dei gamle `--bg-color`-variablane.
- [ ] Base: `box-sizing: border-box`, `html { font-size: 100% }`, `body` med 18 px, `line-height: 1.6`, `letter-spacing: 0.01em`.
- [ ] Typografi-skala for `h1`–`h4`, `p`, `ul`, `ol`, `blockquote`, `figcaption`.
- [ ] Lenkjer: understrek med `text-underline-offset: 0.15em`, hover utan understrek.
- [ ] Fokus: `:focus-visible { outline: 3px solid var(--sswt-focus); outline-offset: 2px; }`. Fjern alle `outline: none`.
- [ ] `.screen-reader-text`: byt `display: none` mot korrekt visuelt-skjult-teknikk (`clip-path: inset(50%)`, `position: absolute`, 1×1 px, `overflow: hidden`) med ein `:focus`-regel som syner skip-linken. Fjern `h2.screen-reader-text { display: none }` (M1).
### Fase 4 — CSS: layout og komponentar
- [ ] Header, nav og footer brukar `--sswt-wide`; innhald brukar `--sswt-measure`.
- [ ] Bytt `float: left`-menyen til flex/grid med jamne trykkflater på minst 44 px (M2). Behald klassane `.header-menu-class` og `#nav-grid`.
- [ ] Fjern den verknadslause `align-items: center` på `header` (M3).
- [ ] Responsiv `.entry-title` og `.wp-block-heading` (H3).
- [ ] Søkefelt utan fast px-breidde (H1).
- [ ] Fjern `!important` der han ikkje trengst (M10).
- [ ] `.wp-block-image img` → `max-width: 100%; height: auto` (H5).
- [ ] `.wp-block-table` → `overflow-x: auto` for breie tabellar (H6).
- [ ] Blokkstilar: bilete, fil, tabell, embed (16:9), liste, detaljar, sitat.
- [ ] **Behald desse reglane uendra** (dei er medvite valde, daterte 2026-03-05): `h3.wp-block-heading { font-size: inherit; }`, `a.wp-block-file__button { display: none; }`, `.is-vertical .wp-block-file`-margen og `.wp-block-details`-reglane.
### Fase 5 — CSS: tredjepart og bbPress
- [ ] Slideshow: behald `.super-simple-slideshow`, `.super-simple-slide`, `.active` og `aspect-ratio: 16 / 9`.
- [ ] RSS: behald `.rss-feed`, `.rss-title`, og byt kjeldenamn-fargen frå `--a-hover` til `--sswt-text-muted` (K5).
- [ ] **Kopier `display: none !important`-lista for bbPress ordrett.** Fjern berre `.screen-reader-text` frå ho (M1).
- [ ] bbPress-tabellar, skjema, innleggsside, forumbrukar og «nytt innlegg»: behald alle selektorar, men flytt faste breidder over til `rem`/prosent.
- [ ] Skjemafelt: bakgrunn `--sswt-surface`, tekst `--sswt-text`, ramme `--sswt-border`. Fiks `input#user_login` (K6).
- [ ] Knappar: bakgrunn `--sswt-accent-bg`, tekst `--sswt-accent-text` (K5).
- [ ] Gjev bbPress-knappar og lenker synleg `:focus-visible` (K8).
### Fase 6 — Responsivt og tilgjenge
- [ ] Test reflow ved 320 px, 768 px og 1440 px — ingen horisontal scroll.
- [ ] Test tekstzoom til 200 % utan tap av innhald.
- [ ] Legg inn `@media (prefers-reduced-motion: reduce)` som slår av overgangar.
- [ ] Vurder `@media (prefers-contrast: more)`.
- [ ] **Valfritt:** kompakt mobilmeny (knapp med `aria-expanded` og liten `nav.js`). Standardvalet er stabla meny utan JS — JS-varianten må degrade slik at menyen er synleg utan JS.
- [ ] Manuell tastaturgjennomgang: skip-link → meny → innhald → paginering → søk → footer.
- [ ] Punktkontroll med skjermlesar på framside, innlegg, forumsliste og emneside.
### Fase 7 — Verifisering og dokumentasjon
- [ ] `php -l` på alle PHP-filer.
- [ ] Verifiser alle kontrastar i kapittel 5 mot bakgrunnen dei faktisk vert brukte på.
- [ ] Test med WordPress Theme Check.
- [ ] Skriv `README.md` (engelsk) i temaet, med tabell over gamle → nye CSS-variablar.
- [ ] Byt ut `screenshot.png` med eit bilete av den nye sida (1200×900).
- [ ] Bump versjon til `2.0.0` og skriv endringslogg i `style.css`.
---
## 7. Verifiseringssjekkliste
- [ ] Temaet heiter «Super Simple WordPress Theme» i wp-admin → Utsjånad → Tema.
- [ ] Menyen under «Utsjånad → Menyar» er framleis knytt til plasseringa «Header Menu».
- [ ] Framside, innlegg, side, kategori, forfattar og søk renderer utan PHP-varsel (`WP_DEBUG` på).
- [ ] Skjulte bbPress-element er framleis skjulte.
- [ ] `[super_simple_rssreader]` og `[super_simple_slideshow]` ser rett ut — og gjev **ingen synleg rå shortcode-tekst** når pluginane er avslått.
- [ ] Slideshow-bileta fyller breidda og held 16:9.
- [ ] Forum: forumbeskrivelse, emneliste, emnevisning, svarvisning, «nytt emne»-skjema, brukarprofil og rediger-brukar ser rett ut.
- [ ] Eksisterande tilleggs-CSS i «Tilpass» slår framleis inn (ingen klassar er bytt namn på).
- [ ] Søkefeltet er brukbart på 320 px.
- [ ] Ingen horisontal scroll ved 320 px.
- [ ] Alle interaktive element har synleg fokusmarkering.
- [ ] Kvit tekst på kvit bakgrunn finst ikkje lenger.
- [ ] Ingen førespurnader til eksterne domene i frontenden.
---
## 8. Utanfor omfang
- Endringar i `super-simple-rssreader` eller `super-simple-slideshow`.
- Ny layout eller ny informasjonsarkitektur.
- Nye funksjonar (søkefilter, arkivsider, mørk modus som val i admin).
- Blokk-tema / `theme.json` / FSE.
- SEO-tillegg, analyse, infokapslar.
---
## 9. Avgjerder (låst)
| # | Spørsmål | Avgjerd |
|---|---|---|
| 1 | Fargepalett | Mørkare blå familie `#1F3E6B` / `#2A4E80` med varm gul aksent `#FFD479`. All tekst når AAA, alle UI-rammer når 3:1. Sjå kapittel 5. |
| 2 | CSS-teknikk | Fagleg fritt fram, men **markup og åtferd skal vere uendra**. `.screen-reader-text` vert skifta til korrekt visuelt-skjult-teknikk — framleis usynleg for auga. |
| 3 | `rss-feed.php` | Slettast. `super-simple-rssreader` tek over funksjonen. |
| 4 | Font | Manrope først i stacken, men utan nedlasting. Systemfont som fallback. |
| 5 | Arkivsider | Uendra — held `the_content()`. |
| 6 | Paginering / slideshow | Uendra plassering i `footer.php`. Ingen vilkår lagde til. |
| 7 | Klassane `.header-menu-class`, `#nav-grid` m.fl. | Vert **ikkje** bytt namn på, slik at tilleggs-CSS held fram å verke. |
| 8 | `h3.wp-block-heading`, `a.wp-block-file__button`, `.wp-block-details` | Uendra — medvitne val frå 2026-03-05. |