# AI coder prompt — Super Simple WordPress Theme
Copy everything below the line into the AI coder. It is self-contained.
---
## Role
You are a senior WordPress theme developer. You write plain PHP and plain CSS —
no frameworks, no build step, no dependencies. You prioritise correct, simple,
robust and maintainable code. You do not over-engineer.
## Repository
- Project key: `super-simple-wp-theme`
- Repository: `ai-bot/super-simple-wp-theme`
- Base branch: `main`
- Work on a new branch: `theme-refresh-2.0`
## Objective
Refresh and rename the WordPress theme currently called **NTKF** into
**Super Simple WordPress Theme** (version `2.0.0`, text domain
`super-simple-wp-theme`).
The theme runs the site — a Norwegian
association site (Nynorsk) about cable cars and aerial tramways. It must stay
easy to read for both older and younger visitors, on desktop and on mobile.
This is a refresh, not a redesign. Do not add features, do not change the
information architecture, do not introduce a block theme or `theme.json`.
**The overriding principle: the site must behave and look the same as it does
today — only cleaner, more readable and more accessible. Do not break any
existing markup, class name or ID.**
## Deliverables
| File | Action |
|---|---|
| `style.css` | Rewrite (keep the theme header comment at the top) |
| `functions.php` | Rewrite |
| `header.php` | Rewrite |
| `footer.php` | Rewrite |
| `index.php` | Update |
| `single.php` | Update |
| `page.php` | Update |
| `category.php` | Update |
| `author.php` | Update |
| `search.php` | Update |
| `rss-feed.php` | **Delete** |
| `README.md` | Create (English) |
| `screenshot.png` | Leave alone, note in README that it should be replaced |
## Non-negotiable constraints
1. **Do not rename any existing HTML class name or ID.** The site owner may
have custom CSS under Appearance → Customize → Additional CSS that targets
them. Keep all of these exactly as they are: `.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`, every
`.bbp-*`, every `.wp-block-*`, `.screen-reader-text`, `.alignnone`,
`.has-fixed-layout`.
You may **add** new class names, but never remove or rename an existing one.
2. **Keep every third-party class name working.** RSS plugin: `.rss-feed`,
`.rss-title`. Slideshow plugin: `.super-simple-slideshow`,
`img.super-simple-slide`, `.active`. bbPress: every `.bbp-*`, `#bbp_*`,
`.forums`, `.favorite-toggle`, `#subscription-toggle`, `.pw-weak`,
`#new-post`, `.bbp-form`, `.bbp-submit-wrapper`.
3. **Everything hidden today must stay hidden.** Copy the existing
`display: none !important` selector list for bbPress verbatim, reindented
only. The single exception is `.screen-reader-text`, which must be changed
to a proper visually-hidden technique. It stays invisible to the eye — it
just becomes readable by screen readers again.
4. **Keep the nav menu location slug `header-menu`.** Renaming it would make
the site lose its menu assignment on theme switch.
5. **Keep content, pagination, slideshow, search and RSS exactly where they are
today.** Do not move them, do not add conditional guards around them beyond
the shortcode check described below.
6. **No external requests.** No Google Fonts, no CDNs. No webfont is
downloaded.
7. **No build step.** Plain CSS in `style.css`. No npm, no minification.
8. **No `!important`** outside the preserved hide list.
9. Escape all output: `esc_html()`, `esc_attr()`, `esc_url()`, `wp_kses_post()`.
10. Comments in code in English. User-facing strings in Norwegian Nynorsk,
wrapped in `__()` / `esc_html__()` / `esc_attr__()` with the text domain
`super-simple-wp-theme`.
## Design tokens to implement
Palette. The current `#38629F` only reaches 6.1:1 with white text, and the
muted colour `#AAA` on it fails at 2.6:1. The new palette stays in the same
blue family but is darker, so that **all text reaches AAA (7:1)** and all
functional borders reach 3:1. A second surface colour makes it impossible for
form fields to end up white-on-white.
| Token | Value | Role |
|---|---|---|
| `--sswt-bg` | `#1F3E6B` | page background |
| `--sswt-surface` | `#2A4E80` | form fields, notice boxes, table headers |
| `--sswt-text` | `#FFFFFF` | body text, headings |
| `--sswt-text-muted` | `#C6D3E8` | date, category, feed source, meta text |
| `--sswt-link` | `#FFD479` | links |
| `--sswt-link-hover` | `#FFFFFF` | link hover |
| `--sswt-rule` | `#6C8CBF` | decorative separators |
| `--sswt-border` | `#8FA9D4` | form field and button borders |
| `--sswt-accent-bg` | `#FFD479` | button background |
| `--sswt-accent-text` | `#1F3E6B` | button text |
| `--sswt-focus` | `#FFFFFF` | focus outline |
Measured contrasts — do not regress these:
| Combination | Contrast | Level |
|---|---|---|
| `--sswt-text` on `--sswt-bg` | 10.7:1 | AAA |
| `--sswt-text` on `--sswt-surface` | 8.4:1 | AAA |
| `--sswt-text-muted` on `--sswt-bg` | 7.1:1 | AAA |
| `--sswt-text-muted` on `--sswt-surface` | 5.6:1 | AA |
| `--sswt-link` on `--sswt-bg` | 7.6:1 | AAA |
| `--sswt-link` on `--sswt-surface` | 6.0:1 | AA |
| `--sswt-accent-text` on `--sswt-accent-bg` | 7.6:1 | AAA |
| `--sswt-rule` on `--sswt-bg` | 3.1:1 | ≥3:1 (UI) |
| `--sswt-border` on `--sswt-surface` | 3.5:1 | ≥3:1 (UI) |
| `--sswt-focus` on `--sswt-bg` | 10.7:1 | AAA |
Typography and layout:
| Token | Value |
|---|---|
| `--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` — body text column |
| `--sswt-wide` | `64rem` — header, nav, footer |
| `h1` | `2.25rem` |
| `h2` | `1.75rem` |
| `h3` | `1.375rem` |
| `h4` | `1.15rem` |
| interactive target | minimum `44px` tall |
Manrope stays first in the stack but is **not downloaded**. Visitors who have it
locally get it; everyone else gets their system font. No external requests, no
layout shift.
`html` must be `font-size: 100%` — never a pixel value. All sizes in `rem` so
that user font-size settings are respected.
## Work order
Work through the tasks in this order. One file at a time. Finish a file, verify
it, then move on. Do not batch unrelated changes.
### A. Preparation
1. Create branch `theme-refresh-2.0`.
2. Delete `rss-feed.php`. It is dead code — the `include` is commented out in
`index.php` — and it fetches a remote URL with `simplexml_load_file()`. The
`super-simple-rssreader` plugin replaces it.
### B. `functions.php`
1. Prefix every function with `sswt_`.
2. `sswt_setup()` hooked on `after_setup_theme`:
`load_theme_textdomain( 'super-simple-wp-theme', get_template_directory() . '/languages' )`,
and `add_theme_support()` for `title-tag`, `post-thumbnails`, `automatic-feed-links`,
`responsive-embeds`, `customize-selective-refresh-widgets`, `align-wide`, and
`html5` with `search-form`, `comment-form`, `comment-list`, `gallery`, `caption`, `style`, `script`.
3. `sswt_register_menus()` hooked on `init` — register location `header-menu`
with the label `Header Menu`. Keep the slug exactly as it is today.
4. `sswt_enqueue_assets()` — `wp_enqueue_style( 'sswt-style', get_stylesheet_uri(), array(), wp_get_theme()->get( 'Version' ) )`.
Remove the manual `` from `header.php`.
5. Replace `remove_private_title_prefix()` with filters on
`private_title_format` and `protected_title_format` that return `'%s'`.
Drop the locale-dependent `str_replace( 'Privat: ', ... )`.
6. Keep the bbPress login redirect. Guard `is_bbpress()` with `function_exists()`.
7. Keep the commented-out bbPress profile redirect, but make it toggleable via
`apply_filters( 'sswt_redirect_bbpress_profile', false )`.
8. Keep the logout link helper as `sswt_logout_link()`. Escape the URL.
9. Keep the `wp_mail_from` / `wp_mail_from_name` filters, but read the values
through `apply_filters( 'sswt_mail_from', ... )` and
`apply_filters( 'sswt_mail_from_name', ... )` so they are configurable.
10. Do not add anything else. No new features.
### C. `header.php`
1. Add `wp_head()` inside `