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

18 KiB
Raw Blame History

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

  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.