diff --git a/AI_CODER_PROMPT.md b/AI_CODER_PROMPT.md deleted file mode 100644 index 7f7e1cc..0000000 --- a/AI_CODER_PROMPT.md +++ /dev/null @@ -1,340 +0,0 @@ -# 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 ``. Add `body_class()` on `` and - `wp_body_open()` right after it. -2. Remove the hardcoded ``; `title-tag` support now handles it. -3. Add a skip link as the first element in `<body>`: - `<a class="skip-link screen-reader-text" href="#main">` with the Nynorsk - label `Hopp til innhald`. -4. Wrap the header in `<header class="site-header">` and the menu in - `<nav class="site-nav" aria-label="…">`. These are new classes — adding them - is fine. -5. **Keep** the existing container class `header-menu-class` and the existing - id `nav-grid` on the menu wrapper. Do not rename them. -6. Give the logo `<img>` an `alt` attribute and handle the case where - `get_site_icon_url()` returns an empty string. -7. Open `<main id="main" class="site-main">` after the header. -8. Keep the viewport meta tag. - -### D. `footer.php` -1. Close `</main>` before the footer. -2. Add `wp_footer()` before `</body>`. -3. Guard the slideshow call: - `if ( shortcode_exists( 'super_simple_slideshow' ) ) { echo do_shortcode( '[super_simple_slideshow]' ); }` - Today, a deactivated plugin prints the raw shortcode text on the page. -4. **Leave the pagination block where it is and as it is.** Do not add - conditions, do not move it. -5. Keep the search form, but replace `get_search_query()` with - `esc_attr( get_search_query() )` and use a single text domain. -6. Keep the footer logo and the organisation number, but move the number into - `apply_filters( 'sswt_org_number', '995 268 698' )`. -7. Use `sswt_logout_link()` instead of the old function name. - -### E. Templates -1. `index.php`, `category.php`, `author.php`, `search.php`: keep the existing - structure and keep `the_content()`. Wrap the archive heading strings in - `esc_html__()` / `esc_html()` and use the correct text domain. -2. `single.php` and `page.php`: the post title must be `<h1 class="entry-title">`, - not `<h2>`. Right now no template outputs an `<h1>` at all. The class name - `entry-title` stays untouched. -3. `index.php`: guard the RSS call with - `if ( shortcode_exists( 'super_simple_rssreader' ) )`. -4. Remove commented-out dead code from the templates. - -### F. `style.css` — header and tokens -1. Write a complete theme header: - `Theme Name: Super Simple WordPress Theme`, `Theme URI`, `Author`, - `Author URI`, `Description`, `Version: 2.0.0`, `Requires at least`, - `Tested up to`, `Requires PHP`, `License`, `License URI`, - `Text Domain: super-simple-wp-theme`, `Tags`. -2. Replace the old `--bg-color`, `--txt-color`, `--a`, `--a-hover`, - `--border-color`, `--font` variables with the `--sswt-*` tokens above. - Delete the commented-out dark palette block. -3. Organise the file in this order and label the sections with comments: - tokens → base → typography → links and focus → layout (header, nav, main, - footer) → entry (title, meta, content) → pagination → search → WordPress - blocks → third-party (slideshow, RSS) → bbPress → utilities → media queries. - -### G. `style.css` — base, typography and focus -1. `html { font-size: 100%; }`, `* { box-sizing: border-box; }`. -2. `body`: 18 px, `line-height: 1.6`, `letter-spacing: 0.01em`. Drop the - `0.08rem` letter spacing — it slows reading down. -3. Heading scale `h1`–`h4` per the tokens table. No fixed `3rem` titles. -4. Links: keep an underline, add `text-underline-offset: 0.15em`. Remove the - underline on hover. -5. Add `:focus-visible { outline: 3px solid var(--sswt-focus); outline-offset: 2px; }` - and delete every `outline: none` rule, including the one on `.bbp-form` inputs. -6. Replace `display: none` on `.screen-reader-text` (and the - `h2.screen-reader-text` rule) with the standard visually-hidden technique: - `clip-path: inset(50%)`, `position: absolute`, `width: 1px`, `height: 1px`, - `overflow: hidden`, plus a `:focus` rule that reveals it — that is what - makes the skip link appear on keyboard focus. The element must remain - invisible in normal use. -7. Add `@media (prefers-reduced-motion: reduce)` that disables transitions - and animations. - -### H. `style.css` — layout and components -1. Header, nav and footer use `--sswt-wide`. Body content uses `--sswt-measure`. -2. Replace the `float: left` menu and the `overflow: hidden` clearfix with - flex or grid. Menu links must be at least 44 px tall. **Keep the existing - `.header-menu-class` and `#nav-grid` names.** -3. Remove the no-op `align-items: center` on `header` (it has no `display`). -4. Search input: remove `calc(640px - 8rem)` and the `100vw` patch in the - media query. Use fluid widths. -5. Images: `.wp-block-image img, .alignnone { max-width: 100%; height: auto; }` - — not `width: 100%`, which upscales small images. -6. Tables: `.wp-block-table { overflow-x: auto; }` so wide tables scroll - horizontally on mobile instead of breaking the page. -7. Keep the 16:9 embed wrapper. -8. Keep block styles for image, file, list, details, quote and caption. -9. **Keep these rules exactly as they are** — they are deliberate fixes dated - 2026-03-05 and must keep working: - `h3.wp-block-heading { font-size: inherit; }`, - `a.wp-block-file__button { display: none; }`, - `.is-vertical .wp-block-file` margin, and the `.wp-block-details` rules. - -### I. `style.css` — third-party and bbPress -1. Slideshow: keep `.super-simple-slideshow`, `img.super-simple-slide`, - `.active`, and `aspect-ratio: 16 / 9` with `object-fit: cover`. -2. RSS: keep `.rss-feed` and `.rss-title`. Change the source span from - `--a-hover` to `--sswt-text-muted` — the current colour is 2.6:1. -3. bbPress: copy the entire `display: none !important` list verbatim, minus - `.screen-reader-text`. Keep every other bbPress selector working. -4. bbPress tables, forms, reply pages, user pages and the new-topic form: keep - the selectors, but convert fixed pixel widths to `rem` or percentages. -5. Form fields (`.search-field`, `.bbp-form input`, `.bbp-form textarea`): - `background: var(--sswt-surface)`, `color: var(--sswt-text)`, - `border: 1px solid var(--sswt-border)`. This fixes - `.bbp-form input#user_login`, which today sets white text on a white - background. -6. Buttons (`.search-submit`, `.bbp-submit-wrapper button`, submit inputs): - `background: var(--sswt-accent-bg)`, `color: var(--sswt-accent-text)`. - Never white-on-light-grey. -7. Give bbPress buttons and links a visible `:focus-visible` style. - -### J. Responsive and accessibility -1. Verify reflow at 320 px, 768 px and 1440 px with no horizontal scrolling. -2. Verify 200% text zoom without loss of content or function. -3. Keyboard walkthrough: skip link → menu → content → pagination → search → footer. -4. Optional: a compact mobile menu using a button with `aria-expanded` and a - small `assets/js/nav.js`. The default is a stacked menu with no JavaScript. - If you add JavaScript it must degrade — the menu must be visible when JS - is off. - -### K. Verification -1. `php -l` on every PHP file. -2. Re-check every colour pair in the tokens table against the background it is - actually used on. -3. Run the WordPress Theme Check plugin. -4. Write `README.md` in English: installation, what the theme is for, the - third-party markup it styles, the customisation filters (`sswt_org_number`, - `sswt_mail_from`, `sswt_mail_from_name`, `sswt_redirect_bbpress_profile`), - an old → new CSS variable mapping table, and a note that `screenshot.png` - needs replacing. -5. Bump `Version` to `2.0.0` and add a short changelog comment in `style.css`. - -## Acceptance criteria - -- The theme appears as "Super Simple WordPress Theme" in Appearance → Themes. -- The menu is still attached to the "Header Menu" location. -- Front page, single post, page, category, author and search render with no PHP - notices while `WP_DEBUG` is on. -- All previously hidden bbPress elements are still hidden. -- Existing Additional CSS still applies — no class name or ID was renamed. -- `[super_simple_rssreader]` and `[super_simple_slideshow]` render correctly — - and print **no raw shortcode text** when the plugins are deactivated. -- Slideshow images fill the width and keep a 16:9 ratio. -- bbPress forum list, topic view, reply view, new-topic form, user profile and - edit-profile screen all render correctly. -- No horizontal scrolling at 320 px. -- Every interactive element has a visible focus indicator. -- No white-on-white or other sub-4.5:1 text. -- No requests to external domains on the front end. - -## Reporting - -After each file, report: the file path, what changed, and anything you had to -decide or could not verify. If a requirement conflicts with the existing site -behaviour, stop and ask instead of guessing.