Ein Child-Theme kann Anpassungen eines vorhandenen WordPress-Themes in einem eigenen Verzeichnis organisieren. Damit bleiben die Änderungen nachvollziehbarer als direkte Eingriffe in Dateien des Parent-Themes. Es ist jedoch kein automatischer Schutz vor jeder Inkompatibilität. Wenn sich das übergeordnete Theme grundlegend verändert, müssen eigene Vorlagen und Funktionen weiterhin geprüft werden. Dieser Ratgeber beschreibt die Voraussetzungen, den grundlegenden Aufbau und einen Arbeitsweg, der spätere Updates nicht zum Rätsel macht.
Sie benötigen Zugriff auf die Theme-Dateien, einen Editor und eine getrennte Testumgebung. Vorhandene Änderungen sollten zuerst gesichert und dokumentiert werden. Das Ziel ist ein kleines Child-Theme mit einem klaren Zweck, nicht eine vollständige unübersichtliche Kopie des Parent-Themes. Manche Anpassungen lassen sich bereits über Einstellungen oder globale Styles sauber umsetzen. Prüfen Sie deshalb zuerst, ob eine eigene Datei wirklich nötig ist. Ein zusätzlicher technischer Aufbau sollte einen konkreten Vorteil für das Projekt besitzen.
Den vorhandenen Themeaufbau verstehen
Notieren Sie Name, Version und Verzeichnis des aktiven Themes. Prüfen Sie, ob bereits ein Child-Theme verwendet wird. Eine ähnliche sichtbare Bezeichnung im Backend reicht nicht als Nachweis; die tatsächliche Zuordnung steht in den Themedateien. Sichten Sie bestehende Sonderanpassungen und klären Sie ihren Zweck. Wer direkt Dateien verändert hat, sollte die Änderungen vor einem Update vergleichen können. Ohne Ausgangsstand lässt sich schwer unterscheiden, was vom Hersteller stammt und was lokal ergänzt wurde.
Überlegen Sie auch, welche Art von Theme vorliegt. Ein klassisches Theme nutzt andere Vorlagen als ein Block-Theme, auch wenn beide Child-Themes unterstützen können. Die offizielle Dokumentation zu Child-Themes beschreibt den Zusammenhang. Verwenden Sie keine fremde minimale Beispielstruktur ungeprüft für jeden Bestand. Ein Theme kann eigene Konventionen für Styles, Hooks und Ressourcen besitzen. Lesen Sie die zugehörige Herstellerdokumentation und testen Sie die notwendige Erweiterung am tatsächlichen Stand.
Geeignete und ungeeignete Anpassungen unterscheiden
Ein Child-Theme eignet sich etwa für ausgewählte Templateänderungen und projektspezifische Gestaltung. Eine dauerhaft benötigte fachliche Funktion sollte dagegen häufig in einer eigenen Erweiterung liegen. Wenn ein Themewechsel sonst Datenmodelle oder wichtige Geschäftsabläufe verschwinden lässt, wurden Inhalt und Gestaltung zu eng verbunden. Diese Trennung ist eine Planungsentscheidung. Sie verbessert die spätere Pflege, bedeutet aber nicht, dass jede kleine Codezeile sofort ein eigenes umfangreiches Plugin benötigt.
Schreiben Sie den Zweck jeder Anpassung auf. „Linkstil für besser sichtbare Navigation“ ist konkret; „Optimierung“ allein ist es nicht. Legen Sie außerdem fest, welche Änderung mit Bordmitteln möglich ist und welche Code braucht. Ein globaler Farbwert kann möglicherweise im vorgesehenen Stilbereich gepflegt werden. Ein neuer PHP-Ausgabeschritt benötigt dagegen einen nachvollziehbaren Eingriff. Vermeiden Sie mehrere gleichzeitig wirksame Stellen für denselben Stil. Sonst ändern Sie später einen Wert und sehen wegen eines anderen Vorrangs scheinbar keine Wirkung.
| Änderung | Möglicher Ort | Entscheidungskriterium |
|---|---|---|
| Grundfarbe | Themeeinstellung oder globaler Stil | Vorgesehene Pflegefunktion vorhanden? |
| Eigene Templateausgabe | Child-Theme | An die Gestaltung gebunden? |
| Dauerhafte Inhaltsfunktion | Eigene Erweiterung | Soll bei Themewechsel bleiben? |
| Einzelner Absatz | Inhalt im Editor | Keine Codeänderung nötig |
Verzeichnis und Kennzeichnung anlegen
Legen Sie ein eigenes Verzeichnis im Themebereich an. Der Name sollte das Projekt und seinen Zweck erkennen lassen. Die erforderliche Kennzeichnung in der style.css benennt unter anderem den Theme-Namen und das Parent-Theme über dessen Verzeichnisnamen. Der sichtbare Name und der tatsächliche Ordner des Parent-Themes können voneinander abweichen. Genau diese Verwechslung führt häufig dazu, dass ein Child-Theme nicht korrekt zugeordnet wird. Kontrollieren Sie daher die vorhandenen Verzeichnisse.
Halten Sie die Datei klein und ergänzen Sie eine kurze Projektbeschreibung. Verwenden Sie keine falschen Herstellerangaben oder erfundenen Versionskompatibilitäten. Eine eigene Versionsnummer kann Ihren Änderungsstand kennzeichnen, sollte aber tatsächlich gepflegt werden. Archivieren Sie den ersten funktionierenden Stand. Ein Child-Theme ist eine eigene zu wartende Komponente. Sein Name allein erklärt später nicht, welche Änderungen enthalten sind. Eine kurze README mit Zweck, Dateien und Prüfschritten macht den Aufbau für andere Personen verständlicher.
Styles nach dem tatsächlichen Parent-Theme laden
Prüfen Sie, wie das Parent-Theme seine Styles ausgibt. Je nach Aufbau lädt es Styles bereits selbst oder erwartet eine bestimmte Ergänzung. Die Dokumentation zur Einbindung von CSS und JavaScript beschreibt den vorgesehenen WordPress-Weg über Enqueue-Funktionen. Kopieren Sie keinen alten @import-Ansatz allein deshalb, weil er in einer beliebigen Anleitung steht. Ein korrekt eingebundener Stil lässt sich hinsichtlich Abhängigkeiten und Versionierung nachvollziehbarer verwalten.
Kontrollieren Sie im Browser die geladenen Dateien und ihre Reihenfolge. Ein doppelt eingebundenes Stylesheet kann unnötige Übertragung verursachen und die Fehlersuche erschweren. Wenn eine Änderung nicht sichtbar wird, prüfen Sie Selektor, Vorrang und Cache. Erhöhen Sie nicht sofort jede Regel mit !important. Eine begründete Ausnahme kann sinnvoll sein; eine große Sammlung davon zeigt häufig, dass die Struktur nicht verstanden wurde. Korrigieren Sie bevorzugt den eigentlichen Konflikt und dokumentieren Sie die Entscheidung.
Funktionen ergänzen, ohne das Parent-Theme zu kopieren
Die functions.php eines Child-Themes ersetzt nicht einfach die entsprechende Datei des Parent-Themes. Die WordPress-Dokumentation zu Themefunktionen erläutert ihre Rolle. Kopieren Sie daher keine gesamte fremde Funktionsdatei in das Child-Theme. Doppelte Funktionen können Fehler verursachen, und umfangreiche Kopien erschweren Updates. Ergänzen Sie nur den benötigten Schritt und nutzen Sie vorhandene Hooks, wenn das Theme eine geeignete Erweiterungsmöglichkeit bietet.
Geben Sie eigenen Funktionen eindeutige projektspezifische Namen. Prüfen Sie Eingaben, Ausgabe und notwendige Berechtigungen bei Funktionen, die Daten verarbeiten. Ein Theme ist keine sichere Ausnahmezone für beliebigen Code. Vermeiden Sie Geheimnisse in Themedateien. Zugangsdaten für Dienste gehören in einen geschützten vorgesehenen Konfigurationsweg. Testen Sie PHP-Änderungen zuerst in der separaten Umgebung, damit ein Syntaxfehler nicht die laufende Website blockiert. Halten Sie den vorherigen funktionierenden Stand griffbereit.
Templates nur gezielt übernehmen
Wenn eine Vorlage angepasst werden muss, übernehmen Sie nur die tatsächlich betroffene Datei beziehungsweise die vorgesehene Vorlage. Notieren Sie die zugrunde liegende Parent-Version und den Grund der Abweichung. Eine vollständige Kopie aller Templates führt dazu, dass viele spätere Herstellerverbesserungen nicht mehr automatisch in der lokalen Ausgabe ankommen. Das Child-Theme kann dann äußerlich korrekt weiterlaufen, während es einen immer älteren Sonderstand trägt. Ein kleiner nachvollziehbarer Unterschied ist leichter zu warten.
Prüfen Sie auch, ob ein Hook oder eine begrenzte Stiländerung die Aufgabe erfüllt. Nicht jede zusätzliche Bildunterschrift verlangt eine kopierte Gesamtvorlage. Wenn Sie eine Vorlage übernehmen, vergleichen Sie nach einem Parent-Update die relevante Datei erneut. Dabei geht es um Struktur, Ausgabe und notwendige Änderungen, nicht nur um eine Versionszahl. Testen Sie reale Inhalte und mehrere Seitentypen. Eine Anpassung am Einzelbeitrag kann unbeabsichtigt auch Archive oder die Suche beeinflussen, wenn gemeinsame Teile betroffen sind.
Aktivierung und bestehende Einstellungen prüfen
Aktivieren Sie das Child-Theme zunächst in Staging. Kontrollieren Sie Navigation, Widgets oder andere themebezogene Einstellungen, soweit sie im konkreten Bestand genutzt werden. Ein Wechsel der aktiven Themeidentität kann die Zuordnung einzelner Einstellungen beeinflussen. Prüfen Sie die tatsächliche Ausgabe, statt eine unveränderte Darstellung anzunehmen. Halten Sie fest, was neu zugeordnet werden musste. Die bestehenden Inhalte sollten weiterhin erreichbar bleiben und ihre relevanten Funktionen behalten.
Testen Sie anschließend die redaktionelle Bearbeitung. Stimmen Editor und Frontend ausreichend überein? Sind wichtige Formatierungen verständlich? Kann eine zweite Person ein Bild austauschen, ohne Code zu verändern? Eine technisch korrekte Aktivierung ist nur ein Teil der Aufgabe. Das Child-Theme muss im Alltag pflegbar sein. Wenn einfache Inhaltsänderungen regelmäßig Sondercode benötigen, sollten Sie den Aufbau vereinfachen oder geeignete editierbare Bereiche ergänzen. Dokumentieren Sie diese Pflegewege in wenigen konkreten Beispielen.
Responsive Verhalten und Bedienung kontrollieren
Prüfen Sie schmale Ansichten mit langen deutschen Titeln und realen Menüpunkten. Achten Sie auf überlaufende Tabellen, abgeschnittene Schaltflächen und zu enge Textflächen. Testen Sie Tastaturfokus und die Reihenfolge interaktiver Elemente. Eine Stiländerung an Rahmen oder Farben kann Fokusmarkierungen unbeabsichtigt unsichtbar machen. Kontrollieren Sie daher nicht nur den ruhenden Zustand. Links müssen auch bei Hover und Fokus verständlich bleiben, und Informationen dürfen nicht allein von einer Farbe abhängen.
Bei Bewegungen respektieren Sie die Einstellung für reduzierte Animation. Ein aufklappbarer Hinweis sollte seinen Zustand sofort ändern; eine kurze Überblendung kann den Wechsel begleiten. Wenn die Bewegung entfällt, muss die Funktion weiterhin vollständig nutzbar sein. Vermeiden Sie animierte Leseinhalte, die ohne Nutzeraktion verrutschen. Für ein Child-Theme gelten dieselben Qualitätsanforderungen wie für ein neu entwickeltes Theme. Der geringe Dateiumfang ist kein Ersatz für eine reale Browserprüfung.
Updates mit einem begrenzten Vergleich durchführen
Vor einem Parent-Update sichern Sie den aktuellen Stand und prüfen Sie die Änderungshinweise. Aktualisieren Sie zuerst die Testumgebung. Wiederholen Sie die wichtigsten Nutzeraufgaben und vergleichen Sie die lokal übernommenen Templates mit dem neuen Parent-Stand. Erfassen Sie neue Fehler konkret. Ein bloßer erfolgreicher Login beweist nicht, dass Navigation, Inhalt und Formulare korrekt geblieben sind. Der Update-Ratgeber hilft bei einem wiederkehrenden Ablauf mit klaren Zuständigkeiten.
Wenn eine Anpassung nach dem Update nicht mehr sinnvoll ist, entfernen oder überarbeiten Sie sie bewusst. Veralteter Sondercode bleibt sonst als unsichtbare Last erhalten. Dokumentieren Sie auch solche Bereinigungen. Der Zielzustand ist ein kleines Child-Theme, dessen Dateien und Zwecke bekannt sind, dessen Darstellung überprüft wurde und dessen Rückweg vorhanden ist. Es ermöglicht eigenständige Gestaltung mit nachvollziehbarer Pflege. Für vollständige visuelle Templatearbeit in einem Block-Theme bietet der Site-Editor-Ratgeber den passenden ergänzenden Weg.
Eine kurze Änderungsakte für jede Datei führen
Ergänzen Sie zu jeder eigenen Datei eine knappe Notiz: Welche sichtbare Aufgabe erfüllt sie, welche Parent-Funktion nutzt sie und welcher Prüffall bestätigt ihr Verhalten? Dadurch lässt sich bei einem späteren Update gezielt nachsehen, ob der Eingriff noch gebraucht wird. Schreiben Sie keine langen privaten Kommentare mit Zugangsdaten in den Code. Eine sachliche Erklärung im Quellpaket reicht. Notieren Sie außerdem, wer die Anpassung technisch pflegen kann und wie der funktionierende Stand wiederhergestellt wird. Wenn ein neues Teammitglied den Zweck einer Datei nicht erkennt, ist das ein guter Anlass zur Dokumentation oder Vereinfachung. Eine nachvollziehbare kleine Erweiterung bleibt eher wartbar als ein großer Bestand unklarer Ausnahmen.