diff --git a/TODO.md b/TODO.md deleted file mode 100644 index 7acf7ec..0000000 --- a/TODO.md +++ /dev/null @@ -1,281 +0,0 @@ -# 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. - -**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` | `` 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. |