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

250 lines
16 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.
---
## 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, tilpassing og kva tredjepartsmarkup temaet støttar.
---
## 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. |
| 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. |
| 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. |
| 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, også `single` og `page` der ho er meiningslaus. |
| 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.
2. **Klassenamn frå plugins og kjerne skal ikkje endrast.** Desse må halde fram å fungere:
- RSS: `.rss-feed`, `.rss-title`
- Slideshow: `.super-simple-slideshow`, `img.super-simple-slide`, `.active`
- bbPress: alle `.bbp-*`, `#bbp_*`, `.forums`, `.favorite-toggle`, `#subscription-toggle`, `.pw-weak`, `#new-post`, `.bbp-form`, `.bbp-submit-wrapper`
- WP-kjerne: `.screen-reader-text`, `.wp-block-*`, `.alignnone`, `.has-fixed-layout`, `.pagination`, `.page-numbers`, `.entry-title`, `.entry-meta`, `.entry-content`, `.search-container`, `.search-form`, `.search-field`, `.search-submit`
3. **Menyplasseringa `header-menu` skal behalde slug-en sin.** Endrar ein slug, mistar nettstaden menyoppsettet ved temabytte.
4. **Ingen eksterne CDN-førespurnader.** Fontar og ressursar skal liggje lokalt i temaet.
5. **Ingen byggesteg.** Rein CSS og vanleg PHP. Ingen npm, ingen minifisering.
6. **Ingen nye funksjonar.** Berre fornying, opprydding og namnbyte.
---
## 5. Design-tokens
### Fargepalett (mot blå bakgrunn `#1F3E6B`)
| Token | Verdi | Rolle | Kontrast |
|---|---|---|---|
| `--sswt-bg` | `#1F3E6B` | Sidebakgrunn | – |
| `--sswt-text` | `#FFFFFF` | Brødtekst, titlar | 10,7:1 (AAA) |
| `--sswt-text-muted` | `#C6D3E8` | Dato, kategori, kjeldenamn | 7,1:1 (AAA) |
| `--sswt-link` | `#FFD479` | Lenkjer | 7,6:1 (AAA) |
| `--sswt-link-hover` | `#FFFFFF` | Lenkje hover/fokus | 10,7:1 |
| `--sswt-border` | `#6C8CBF` | Skiljelinjer, rammer | 3,1:1 (≥3:1 UI) |
| `--sswt-accent-bg` | `#FFD479` | Knappebakgrunn | – |
| `--sswt-accent-text` | `#1F3E6B` | Knappetekst | 7,6:1 |
Mørk-blå `#1F3E6B` er vald fordi han held kvit tekst på AAA-nivå og held det
same visuelle uttrykket som dagens `#38629F`. Dagens farge held berre 6,1:1.
### Typografi
| Token | Verdi |
|---|---|
| `--sswt-font` | `Manrope, "Segoe UI", system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif` |
| `body` storleik | `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` |
| Knapp / trykkflate | min. `44px` høgd |
`html` skal ha `font-size: 100%` (aldri px), slik at brukarane sine eigne
skriftinnstillingar vert respekterte. 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, gjerast i wp-admin).
- [ ] Slett `rss-feed.php` (M4) — daud kode, erstatta av `super-simple-rssreader`.
### 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, `<header>`, `<nav>` med `aria-label`, og opne `<main id="main">`.
- [ ] `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).
- [ ] `index.php`: behald `shortcode_exists()`-vakt rundt `[super_simple_rssreader]`.
- [ ] `footer.php`: render berre paginering på arkiv, framside og søk (M11) — eller fjern ho heilt frå `single`/`page`.
- [ ] Fjern kommentert-ut daukode i malane.
### 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-link); outline-offset: 2px; }`. Fjern alle `outline: none`.
- [ ] Visuelt-skjult-klasse for `.screen-reader-text` i staden for `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).
- [ ] 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.
- [ ] **Ta stilling til** `h3.wp-block-heading { font-size: inherit }` (H4), `a.wp-block-file__button { display: none }` og `.wp-block-details`-reglane. Desse er truleg medvite valde — stadfest før endring.
### 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.
- [ ] Fiks `input#user_login` så tekst ikkje vert kvit på kvit (K6).
- [ ] 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.
- [ ] 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.
- [ ] 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. Opne spørsmål
1. **Skal Manrope faktisk brukast?** I dag vert fonten ikkje lasta opp. Alternativ A: slett han frå stacken og bruk systemfontar. Alternativ B: legg han lokalt i `assets/fonts/` med `@font-face` og `font-display: swap`.
2. **Skal arkivsidene vise heile innhaldet (`the_content()`) eller berre ingress (`the_excerpt()`)?** I dag viser framsida fulle innlegg over 13 sider. Eit samandrag ville gjere sida lettare å lese.
3. **Skal `.screen-reader-text` endrast til korrekt visuelt-skjult-teknikk?** Eg tilrår ja — det er ei reell tilgjengeforbetring, og elementet er framleis usynleg.
4. **Skal paginering og slideshow liggje i footer på alle malar?** Eg tilrår å halde slideshow i footer, men avgrense paginering til arkiv.
5. **Bytte fargepalett til `#1F3E6B`, eller halde dagens `#38629F`?** Dagens farge held berre AA på brødtekst og AA-fail på metatekst.