# 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, `
`, 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` | `` 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 ``-landemerke, `
`, 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, ``, `