18 KiB
TODO — Super Simple WordPress Theme
Fornying og namnbyte av WordPress-temaet (tidlegare NTKF) for Norske Tau- og Kabelbaners Forening.
| 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
- Namnbyte —
NTKF→Super Simple WordPress Themei tema-header, text domain, funksjonsprefiks og CSS-variablar. - Lesbarheit for alle aldrar — rolegare typografi, høgare kontrast, kortare linelengd, tydeleg visuelt hierarki.
- Fungerer på pc og mobil — ingen faste pikselbreidder, reflow ned til 320 px, trykkflater på minst 44×44 px.
- Tilgjenge (WCAG 2.2 AA) — kontrast, synleg fokusmarkering, landemerke,
<h1>, skip-link, tastaturnavigasjon. - Bakoverkompatibilitet — bbPress,
super-simple-rssreaderogsuper-simple-slideshowskal 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.mdi 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
- 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. - 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». - 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.
- Menyplasseringa
header-menuskal behalde slug-en sin. - Ingen eksterne CDN-førespurnader. Ingen webfont vert lasta ned.
- Ingen byggesteg. Rein CSS og vanleg PHP. Ingen npm, ingen minifisering.
- 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 prefikssswt_på alle funksjonar.functions.php:sswt_setup()påafter_setup_thememedtitle-tag,post-thumbnails,html5,responsive-embeds,automatic-feed-links,customize-selective-refresh-widgets,align-wideogload_theme_textdomain().functions.php:sswt_register_menus()— behald slugheader-menu.functions.php:sswt_enqueue_assets()medwp_enqueue_style()ogwp_get_theme()->get('Version')som versjon.functions.php: bytstr_replace-tittelfiksen motprivate_title_format/protected_title_format-filter (M7).functions.php: leggfunction_exists()-vakt rundtis_bbpress()(M8).functions.php: gjer e-postadresse og org.nr. tilapply_filters()-bare verdiar (M9).header.php: legg innwp_head(),body_class(),wp_body_open(), skip-link,<main id="main">ogaria-labelpå<nav>.header.php:<title>ut av malen —title-tagtek over.header.php: leggaltpå logo-biletet og fallback vissget_site_icon_url()er tom.footer.php: lukk</main>, legg innwp_footer(), og vakt shortcode-utskrifta medshortcode_exists()(K4).
Fase 2 — PHP: malar
index.php,category.php,author.php,search.php: same struktur, men korrekt__()/esc_html__()med text domainsuper-simple-wp-theme, og escapade titlar.single.phpogpage.php:entry-titleskal vere<h1>, ikkje<h2>(K7). Klassenamnetentry-titlestår urørt.index.php: behaldshortcode_exists()-vakt rundt[super_simple_rssreader].- Fjern kommentert-ut daukode i malane.
- Ikkje flytt paginering, slideshow eller søk. Dei vert liggjande i
footer.phpslik 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% },bodymed 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 alleoutline: none. .screen-reader-text: bytdisplay: nonemot korrekt visuelt-skjult-teknikk (clip-path: inset(50%),position: absolute, 1×1 px,overflow: hidden) med ein:focus-regel som syner skip-linken. Fjernh2.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-classog#nav-grid. - Fjern den verknadslause
align-items: centerpåheader(M3). - Responsiv
.entry-titleog.wp-block-heading(H3). - Søkefelt utan fast px-breidde (H1).
- Fjern
!importantder han ikkje trengst (M10). .wp-block-image img→max-width: 100%; height: auto(H5)..wp-block-table→overflow-x: autofor 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,.activeogaspect-ratio: 16 / 9. - RSS: behald
.rss-feed,.rss-title, og byt kjeldenamn-fargen frå--a-hovertil--sswt-text-muted(K5). - Kopier
display: none !important-lista for bbPress ordrett. Fjern berre.screen-reader-textfrå 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. Fiksinput#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-expandedog litennav.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 -lpå 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.pngmed eit bilete av den nye sida (1200×900). - Bump versjon til
2.0.0og skriv endringslogg istyle.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_DEBUGpå). - 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-rssreaderellersuper-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. |