WordPress Entwickler in Wuppertal

Viele Websites im Bergischen Land laufen auf einem Theme, das vor Jahren gekauft oder in Auftrag gegeben wurde. Es hat Shortcodes in den Texten, einen Page Builder für die Startseite und einen Footer, den niemand mehr anfasst. Das funktioniert, bis ein Update bricht oder jede Änderung am Layout zur Bastelei wird. Dann steht die Frage im Raum, ob ein Umstieg auf ein Block-Theme sinnvoll ist.

Ich bin Mariusz Szatkowski, ein einzelner WordPress-Entwickler in Gdynia, seit 2006 mit WordPress befasst, ohne Büro in Wuppertal. Ich arbeite remote und schriftlich, es gibt keine Meetings und keine Telefonate. Layout, Mockups und Wireframes kommen von Ihnen, ich setze sie um. Diese Seite beschreibt, wie ein Umstieg abläuft, was dabei mit Shortcodes und Page-Builder-Inhalten passiert und woran Sie vorher selbst prüfen können, ob er sich lohnt.

#Wann sich der Umstieg lohnt und wann nicht

Die Bergische IHK hat am 16. Oktober 2026 die Ergebnisse ihrer Herbst-Konjunkturumfrage veröffentlicht. 504 Unternehmen mit 18.100 Beschäftigten nahmen teil. 33 Prozent bezeichneten ihre Lage als schlecht, 18 Prozent als gut, der Geschäftslagesaldo lag bei minus 15 Punkten. Mehr als ein Viertel der Betriebe wollte Stellen abbauen. In dieser Lage ist ein Komplett-Relaunch selten die richtige Antwort. Ein Umstieg in kleinen Schritten, der jederzeit angehalten werden kann, passt besser.

Ich rate zum Block-Theme, wenn eines dieser Dinge zutrifft:

• Ihre Redaktion braucht für jede Layoutänderung einen Entwickler, weil Farben, Abstände und Schriften im Theme-Code verstreut sind.
• Header und Footer lassen sich nur über das Theme oder einen Builder ändern, und niemand weiß mehr, wo.
• Das Theme wird nicht mehr gepflegt und die Updates des Anbieters sind ausgeblieben.

Ich rate nicht dazu, wenn die Seite stabil läuft, die Redaktion zufrieden ist und das einzige Argument “die anderen machen das auch” lautet. Dann reicht die Wartung. Das Theme Handbook führt Classic-Themes weiter als unterstützt.

Foto: Atamari, CC BY-SA 3.0, Wikimedia Commons.

#Was theme.json steuert

Die Datei theme.json ist laut Theme Handbook eine Konfigurationsdatei für globale Einstellungen und Stile eines Themes. Sie bietet unter anderem Farbpaletten, Schriftarten, Abstände, eigene CSS-Variablen und das Ein- und Ausschalten von Editor-Funktionen. Auf der obersten Ebene kennt sie die Bereiche settings, styles, customTemplates, templateParts und patterns.

Für einen Umstieg ist ein Satz aus dem Handbuch entscheidend: Die Datei funktioniert mit Block- und mit Classic-Themes. Ich kann sie also in Ihr bestehendes Theme legen, bevor irgendein Template angefasst wird. Das ist der erste und ungefährlichste Schritt. Farben und Abstände, die bisher in mehreren CSS-Dateien lagen, stehen dann an einer Stelle, und der Editor kennt sie.

Das Handbuch nennt Themes, die ein Classic-Theme um solche Funktionen ergänzen, Hybrid-Themes. Es ist keine offizielle Kategorie, solche Themes bleiben technisch Classic-Themes. Für Sie heißt das: Sie können auf diesem Zwischenstand lange bleiben, wenn der weitere Umbau gerade nicht ansteht.

Schriften sind ein Beispiel, bei dem theme.json im Alltag viel erledigt. Eigene Web-Schriften lassen sich über den Eintrag fontFace mit einem Pfad der Form file:./assets/fonts/name.woff2 aus dem Theme-Ordner einbinden. Die Schrift liegt dann auf Ihrem Server und nicht bei einem Drittanbieter. Welche Schriften Sie verwenden dürfen, klärt Ihre Lizenz, ich baue sie ein.

Was theme.json nicht erledigt: Eigene PHP-Funktionen bleiben in der functions.php, die laut Handbuch in Block- und Classic-Themes gleichermaßen geladen wird. Ich räume sie beim Umstieg auf, schreibe sie aber nicht um, wenn sie ihren Zweck erfüllen.

#Template Parts: Header und Footer als eigene Dateien

In einem Classic-Theme stehen Header und Footer in PHP-Dateien. Im Block-Theme sind sie Template Parts, also HTML-Dateien im Ordner parts, die nur Block-Markup enthalten. Ein Template bindet sie über den Template-Part-Block und den Slug ein, WordPress sucht dann parts/header.html oder parts/footer.html im Theme-Ordner.

Ein Block-Theme braucht nach dem Handbuch mindestens zwei Dateien: style.css und templates/index.html. Alles andere, auch parts, patterns und styles, ist optional.

Beim Footer prüfe ich immer dasselbe: Das Impressum muss nach § 5 Digitale-Dienste-Gesetz leicht erkennbar und unmittelbar erreichbar sein und ständig verfügbar gehalten werden. Die Landesbeauftragte für Datenschutz und Informationsfreiheit Nordrhein-Westfalen (LDI NRW) verlangt für die Datenschutzhinweise, dass der Link von jeder einzelnen Seite des Webangebots mit einem Klick erreichbar ist. Wenn ein Footer beim Umbau neu entsteht, ist das der Moment, in dem solche Links verloren gehen. Deshalb steht die Prüfung auf meiner Abnahmeliste.

#Shortcodes, Classic-Block und Page-Builder-Inhalte

Das ist der Teil, an dem Umstiege tatsächlich scheitern. Eine Faustregel gibt es nicht, aber ein Verfahren.

Shortcodes im Text. Die WordPress-Dokumentation beschreibt einen Shortcode-Block, in den Sie den Shortcode einfügen. Ein bestehender Shortcode muss also nicht sofort ersetzt werden. Ich zähle auf Staging, welche Shortcodes in welchen Beiträgen vorkommen, und entscheide je Shortcode: bleibt er im Shortcode-Block, wird er durch einen Block ersetzt oder gehört er in ein Pattern.

Alte Beiträge im klassischen Editor. Der Classic-Block sieht aus wie der alte Editor und bietet die Aktion “In Blöcke umwandeln”. Bei reinem Fließtext erwarte ich wenig Aufwand. Bei Beiträgen mit Tabellen, Spalten oder Formular-Shortcodes schaue ich mir das Ergebnis Seite für Seite an.

Page Builder. Elementor speichert laut der Entwicklerdokumentation Seitenlayout und Daten als JSON in den Metadaten des Beitrags, also in einem benutzerdefinierten Feld. Der Inhalt liegt damit nicht als Blöcke im Beitragstext. Ein Umstieg auf ein Block-Theme übersetzt solche Seiten nicht von allein. Für andere Builder lese ich vor dem Angebot nach, wo sie ihre Daten ablegen, und schreibe Ihnen das Ergebnis. Die Frage lautet dann pro Seite: neu aufbauen, im Builder lassen oder stilllegen. Möglich ist eine Mischung: Landingpages mit viel Builder-Logik bleiben zunächst, die Textseiten wechseln.

Menüs und Seitenleisten. Im Classic-Theme werden Menüs in der functions.php registriert. Der Navigation-Block bietet nach der WordPress-Dokumentation die Option, klassische Menüs zu importieren, sofern welche vorhanden sind. Inhalte aus Widget-Bereichen setze ich als Template Part oder Pattern neu zusammen.

#So läuft die gestaffelte Umstellung

1. Inventar. Ich lese das Theme aus und liste Templates, Shortcodes, Menüs, Widget-Bereiche, Builder-Seiten und eigene Funktionen. Sie bekommen die Liste schriftlich.
2. Umfang in Textform. Per E-Mail schreibe ich auf, was umgestellt wird und was bewusst bleibt. Ihre Freigabe steht vor dem ersten Eingriff.
3. theme.json ins bestehende Theme. Farben, Schriften und Abstände wandern an eine Stelle. Die Seite sieht danach gleich aus.
4. Header und Footer als Template Parts. Mit Prüfung der Pflichtlinks.
5. Seitentypen einzeln. Beiträge, Seiten, Archive, Suche und 404 wechseln nacheinander auf Block-Templates. Nach jedem Schritt prüfen Sie auf Staging.
6. Umschalten. Das alte Theme bleibt installiert, bis die Abnahme steht, damit es einen Rückweg gibt.

Ein Detail, das bei Staging-Kopien gern übersehen wird: Das Theme Handbook beschreibt, dass Änderungen der Benutzerinnen und Benutzer im Site-Editor in der Datenbank gespeichert werden und theme.json, Templates und Patterns überschreiben können. Wenn Ihre Redaktion auf der Live-Seite im Site-Editor etwas ändert, während ich auf Staging am Theme arbeite, laufen Datei und Datenbank auseinander. Deshalb vereinbare ich mit Ihnen ein Zeitfenster, in dem am Header, Footer und an den Templates nichts redaktionell geändert wird.

#Datenschutz und Einwilligung nach dem Wechsel

Ein neues Theme lädt andere Dinge als das alte, und das gehört auf die Abnahmeliste. Die LDI NRW schreibt in ihrem Muster für Datenschutzhinweise, dass die Datenschutzerklärung ergänzt werden muss, wenn zum Beispiel Cookies oder andere aktive Inhalte wie Videoplayer, ein Kontaktformular, Kommentarfunktionen oder Social-Media-Plugins eingesetzt werden. Für Cookies und ähnliche Zugriffe auf das Endgerät gilt zusätzlich § 25 TDDDG, der grundsätzlich eine Einwilligung verlangt, soweit keine der Ausnahmen in Absatz 2 greift.

Ich liefere nach dem Umbau eine Liste, welche Einbindungen die Seite lädt (Schriften, Karten, Videos, Skripte, Formulare) und ob sie vor einer Einwilligung nachladen. Ob eine Einbindung notwendig oder einwilligungspflichtig ist, bewertet Ihre Rechtsberatung. Falls die Seite einen Shop enthält, finden Sie die Punkte dazu auf der Seite für WooCommerce in Wuppertal.

#Checkliste vor der Anfrage

#Wie ein Auftrag mit mir abläuft

Sie schreiben mir über das Formular: Adresse der Seite, Ziel, gewünschter Zeitraum und was Sie über das aktuelle Theme wissen. Ich antworte schriftlich an Werktagen, stelle Rückfragen und schlage einen Umfang vor. Für die erste Einschätzung berechne ich nichts. Umgebaut wird auf einer Kopie, nie auf der Live-Seite. Zum Schluss erhalten Sie eine schriftliche Beschreibung: welche Dateien das Theme enthält, wo Farben und Schriften stehen, wie Sie Header und Footer bearbeiten, und eine Liste der verbleibenden Shortcodes und Builder-Seiten.

Wenn die Seite danach laufend betreut werden soll, beschreibt die Seite zur WordPress-Wartung in Wuppertal das Verfahren mit getesteten Updates und monatlichem Bericht. Stunden aus einer Betreuung gelten für den jeweiligen Monat und werden nicht auf den nächsten übertragen. Zum Unterschied zwischen Block-Editor und Page Builder gibt es den Beitrag Gutenberg gegen Elementor und Divi.

#Häufige Fragen

#Muss ich meine Seite komplett neu aufbauen, wenn ich auf ein Block-Theme wechsle?

Nein. Ich stelle schrittweise um: zuerst theme.json, dann Header und Footer als Template Parts, dann Seitentyp für Seitentyp. Jeder Schritt läuft auf Staging und wird von Ihnen abgenommen.

#Was passiert mit meinen Shortcodes?

Es gibt einen Shortcode-Block, in dem ein bestehender Shortcode weiter funktioniert. Ich prüfe je Shortcode, ob er bleiben kann, durch einen Block ersetzt wird oder in ein Pattern gehört.

#Was ist mit Inhalten aus Elementor oder einem anderen Page Builder?

Elementor legt sein Layout als JSON in den Metadaten des Beitrags ab, es liegt nicht als Block im Inhalt. Welche Seiten ich neu aufbaue und welche vorerst im Builder bleiben, entscheidet Ihre Freigabe nach dem Inventar.

#Wer liefert das Design?

Sie. Grafikdesign, Mockups und Wireframes kommen vom Kunden, ich setze sie um. Meist reicht ein ausgefülltes Layout-Raster pro Ansicht.

#Muss ich danach meine Datenschutzerklärung anpassen?

Prüfen müssen Sie sie auf jeden Fall. Die LDI NRW weist darauf hin, dass sie bei Cookies, Videoplayern, Formularen oder Social-Media-Plugins ergänzt werden muss. Ich liefere die Liste der Einbindungen, den Text verantwortet Ihre Rechtsberatung.

#Kommen Sie für den Umbau nach Wuppertal?

Nein. Ich arbeite remote aus Gdynia, ohne Besuche und ohne Telefonate. Alles läuft über das Kontaktformular und per E-Mail.

#Schreiben Sie mir

Wenn Sie in Wuppertal, Solingen oder Remscheid eine Seite haben, die sich schwer ändern lässt, schicken Sie mir über das Kontaktformular die Adresse der Seite, Ihr Ziel, den gewünschten Zeitraum und den Namen des aktuellen Themes. Ich lese die Seite, schreibe Ihnen zurück, was ich sehe, und schicke Ihnen eine erste schriftliche Einschätzung. Dafür berechne ich nichts, und Sie gehen keine Verpflichtung ein.