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

16 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.


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.