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
| Ansatz | Wä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
- Statischen Build einfrieren. HTML, CSS und JS zuerst fertigstellen und validieren. Die Konvertierung eines beweglichen Ziels verdoppelt die Arbeit.
- In Teile aufteilen. Header und Footer kommen in
header.phpundfooter.phpmitwp_head()undwp_footer(). Jeder Startseiten-Abschnitt wird eine Datei intemplate-parts/, eingebunden mitget_template_part(). - Tokens in
theme.jsonverschieben (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 diewebcraft-CLI verfügbar ist, schreibtwebcraft tokens "#brand" --format theme-json -o theme.jsoneine Version-3-Datei aus denselben Werten wietokens.css. - 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()undwp_nav_menu().
- Alles bei der Ausgabe escapen:
esc_html(),esc_attr(),esc_url(),wp_kses_post()für Rich Text. Strings mit__()oderesc_html__()und dem Text-Domain umschließen. - Bilder:
wp_get_attachment_image()verwenden, damitsrcset,sizes, Abmessungen und Lazy Loading generiert werden. Benötigte Größen mitadd_image_size()registrieren. - 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, nichtenqueue_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 aktiviertemWP_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-qaaus.