Communitygithub.com

WordPress-Theme-Build

Verwandle ein statisches HTML/CSS/JS-Design in ein individuelles WordPress-Theme, das der Kunde bearbeiten kann – inklusive Theme-Struktur, theme.json, Einbinden von Skripten, Block-Patterns, benutzerdefinierten Beitragstypen und editierbaren Inhalten. Verwende dies, wenn jemand ein Design oder eine statische Seite in WordPress umwandeln, ein individuelles oder Block-Theme erstellen, Abschnitte im Gutenberg-Editor bearbeitbar machen, GSAP oder andere Skripte korrekt einbinden möchte oder fragt, warum Theme-Änderungen verloren gehen oder Inhalte hart codiert sind.

Was ist WordPress-Theme-Build?

Diese Skill-Anleitung beschreibt den Prozess, ein statisches HTML/CSS/JS-Design in ein voll funktionsfähiges WordPress-Theme zu überführen, bei dem das Design im Code festgelegt ist und der Inhalt im Editor bearbeitet werden kann. Sie erklärt die Wahl zwischen Block-Theme (theme.json, HTML-Templates), hybridem klassischem Theme (PHP-Templates plus theme.json und Block-Patterns) und Child-Theme, abhängig von den Anforderungen des Projekts. Der Workflow umfasst das Aufteilen der statischen Seite in Vorlagenteile, das Verschieben von Design-Token in theme.json, das korrekte Einbinden von Assets (z. B. GSAP) ohne Hard-Coding und die Umsetzung editierbarer Inhalte – von Custom Post Types über Block-Patterns bis hin zu benutzerdefinierten Feldern. Die Anleitung gibt Best Practices für die Ausgabe-Escaping, Theme-Supports, Bilder-Handling und einen Übergabe-Checkliste, damit der Kunde alle Texte, Bilder und Menüs ohne Code-Änderungen bearbeiten kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/wordpress-theme-build

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht WordPress-Theme-Build?

Das Ziel ist ein Theme, bei dem das Design im Code festgelegt ist und der Inhalt im Editor bearbeitet werden kann. Hart codierter Text in Templates ist der häufigste Grund, warum Kunden für triviale Änderungen zurückkommen.

Ansatz wählen

AnsatzWählen, wenn …
Block-Theme (theme.json, HTML-Templates)Neubau, der Kunde bearbeitet im Site-Editor, der Inhalt besteht hauptsächlich aus Standard-Blöcken
Hybrides klassisches Theme (PHP-Templates plus theme.json und Block-Patterns)Komplexes, individuelles Markup oder umfangreiche Animationen, die exakte HTML-Kontrolle erfordern
Child-ThemeÄnderung eines bestehenden Themes; bearbeite niemals ein Parent-Theme direkt, da Updates es überschreiben würden

Für animierte, designgetriebene Marketing-Seiten ist der hybride Ansatz meist pragmatisch: präzises Markup in PHP, editierbarer Inhalt durch Patterns, Felder und den Block-Editor.

Minimale Struktur

mein-theme/
├── style.css            # Theme-Header-Kommentar (erforderlich)
├── functions.php        # Setup, Einbindungen, Registrierungen
├── theme.json           # Palette, Schriftgrößen, Abstände, Layout-Breiten
├── index.php            # Fallback-Template (klassisch/hybrid)
├── front-page.php       # Startseite
├── header.php  footer.php
├── template-parts/      # eine Datei pro Abschnitt
├── patterns/            # Block-Patterns (automatisch registriert)
├── assets/css  assets/js  assets/media
└── screenshot.png       # 1200x900

style.css-Header:

/*
Theme Name: Mein Theme
Author: Dein Name
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: mein-theme
*/

Konvertierungs-Workflow

  1. Statischen Build einfrieren. HTML, CSS und JS zuerst fertigstellen und validieren. Die Konvertierung eines beweglichen Ziels verdoppelt die Arbeit.
  2. In Teile aufteilen. Header und Footer kommen in header.php und footer.php mit wp_head() und wp_footer(). Jeder Startseiten-Abschnitt wird eine Datei in template-parts/, eingebunden mit get_template_part().
  3. Tokens in theme.json verschieben (Palette, Schriftgrößen, Abstände, Inhaltsbreite), damit der Editor dieselben Auswahlmöglichkeiten bietet wie das Frontend. Behalte dieselben Werte wie in CSS-Custom-Properties bei; WordPress generiert --wp--preset--*-Variablen, die du aliasen kannst. Falls die webcraft-CLI verfügbar ist, schreibt webcraft tokens "#brand" --format theme-json -o theme.json eine Version-3-Datei aus denselben Werten wie tokens.css.
  4. Assets einbinden, niemals hart codieren:
add_action('wp_enqueue_scripts', function () {
    $v = wp_get_theme()->get('Version');
    $uri = get_theme_file_uri('assets');
    wp_enqueue_style('mein-theme', "$uri/css/main.css", [], $v);
    wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
    wp_enqueue_script('mein-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});

Binde Bibliotheken möglichst lokal und nicht von einem CDN ein; das vermeidet eine Drittanbieter-Anfrage und eine Consent-Frage. 5. Inhalte editierbar machen. Pro Abschnitt wählen:

  • Wiederkehrende Elemente mit eigenen Seiten (Dienstleistungen, Portfolio, Testimonials): ein benutzerdefinierter Beitragstyp, abgefragt mit WP_Query.
  • Einmalige Abschnittstexte und -bilder: Block-Patterns, die der Kunde einfügt und bearbeitet, oder benutzerdefinierte Felder.
  • Globale Elemente (Telefon, Social Links, Footer-Text): der Customizer oder eine kleine Optionsseite.
  • Navigation: register_nav_menus() und wp_nav_menu().
  1. Alles bei der Ausgabe escapen: esc_html(), esc_attr(), esc_url(), wp_kses_post() für Rich Text. Strings mit __() oder esc_html__() und dem Text-Domain umschließen.
  2. Bilder: wp_get_attachment_image() verwenden, damit srcset, sizes, Abmessungen und Lazy Loading generiert werden. Benötigte Größen mit add_image_size() registrieren.
  3. Theme-Supports: title-tag, post-thumbnails, editor-styles, responsive-embeds, html5, wp-block-styles.

Animationen in WordPress

  • Skripte, die Inhalte verstecken, dürfen nicht im Block-Editor laufen. Binde sie nur im Frontend ein (wp_enqueue_scripts, nicht enqueue_block_assets).
  • Die Admin-Leiste verschiebt sticky Header um 32px (46px auf Mobilgeräten); kompensiere mit body.admin-bar .header { top: var(--wp-admin--admin-bar--height, 32px); }.
  • Caching- und Optimierungs-Plugins, die JS verzögern oder zusammenfassen, können die Ladereihenfolge stören. Deklariere Abhängigkeiten korrekt, damit sie berücksichtigt werden, und teste mit aktiviertem Plugin.
  • Im Editor hinzugefügte Inhalte haben deine Animations-Attribute nicht. Wende Animationen entweder per Block-Klasse in JS an oder stelle Patterns bereit, die die Attribute enthalten.

Nicht tun

  • WordPress Core oder ein Parent-Theme bearbeiten.
  • Funktionalität, die einen Theme-Wechsel überleben soll (Custom Post Types, Shortcodes), ins Theme packen, wenn der Kunde möglicherweise das Theme wechselt; ein kleines Plugin ist der richtige Ort.
  • Abfragen in Loops ohne Zurücksetzen (wp_reset_postdata()).
  • Mit WP_DEBUG-Notices ausliefern. Entwickle mit aktiviertem WP_DEBUG.
  • Bezahlte Plugins oder Assets bündeln, deren Lizenz keine Weiterverteilung erlaubt.

Übergabe-Checkliste

  • Der Kunde kann jeden sichtbaren Text, jedes Bild, jeden Menüpunkt und jedes Kontaktdetail ändern, ohne Code zu berühren.
  • Startseite unter Einstellungen, Lesen festgelegt; Permalinks auf Beitragsnamen gesetzt.
  • Favicon (Site-Icon), 404-Template, Such-Template, Datenschutzseite vorhanden.
  • Ein einseitiger Bearbeitungsleitfaden mit Screenshots.
  • Dann führe die Skill launch-qa aus.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Verwandte Skills