WordPress: Create Block Theme Plugin – Fehler beim Klonen

Dieser Beitrag zeigt dir einen Fehler, den das WordPress Plugin Create Block Theme Plugin macht, wenn du ein Block Theme klonst.

Das Kernproblem: Mismatch zwischen Slug und Dateiname

Kurz Zusammenfassung:

Das Create Block Theme Plugin führt beim Klonen eine Teil-Automatisierung durch, die zu folgendem Fehler führt:

• Slug-Änderung in der Datei: Das Plugin scannt die .html-Dateien (Templates und Template Parts) und ersetzt dort den alten Theme-Slug durch den neuen.
• Fehlende Dateiumbenennung: Die physischen Dateien im Ordner
  (z. B. unter /parts/
   oder /templates/) behalten jedoch oft ihre ursprünglichen Namen oder Pfade, wenn diese den alten Slug enthielten.
• Die Folge: WordPress sucht nun nach einer Datei, die dem neuen Slug entspricht, findet aber im Dateisystem nur die alte Benennung. Das führt dazu, dass Header, Footer oder ganze Templates im Site-Editor als „gelöscht oder nicht verfügbar“ angezeigt werden. 

Was ist das Create Block Theme Plugin ?

Das ist ein super gutes und hilfreiches Plugin, da von den WordPress Core Entwicklern zur Verfügung gestellt wird.

👉 Da WordPress Editor bei Block Themes alles nur in die Datenbank speichert, macht dieses Plugin, dass alles in die echten Theme Dateien gespeichert wird.

Allerdings verhaspelt sich das Plugin , zumindest bei mir.

Ausgangs Situation:

Ein erstelltes Custom Block Theme mit 3 Headern und 1 Footer. Dieses Block Theme habe ich geklont und mit Create Block Theme Plugin umbenannt in – Magnolia – .

Dann habe ich einen weiteren Header und einen Footer in dem Klon erstellt. Und dann bin ich draufgekommen, dass der Name Magnolia schon belegt war.

Also musse ich einen weiteren Klon erstellen, mit einem anderen Namen. Also ich habe verschiedenes versucht:

• magnolie
• magnolia-block
• magnoliadesign etc.

Im Prinzip hat nichts funktioniert, denn :

Im Editor erstellter Header und Footer

Header und Footer fehlen im Frontend

Der Header und der Footer haben gefehlt im Frontend.

Die Lösung:

Ich habe oben – siehe Bild – im Editor einfach die beiden Template Teile gelöscht und dann die richtigen hinzugefügt:

• magnolia-header-01
• magnolia-footer

Die Template Teile sind ja vorhanden, nur hat sie das CBT Plugin nicht gefunden.

Warum hat CBT Plugin den Header und Footer nicht gefunden ?

Nachdem ich die richtigen Header und Footer eingefügt habe, habe ich das ganze einmal gespeichert über das CBT Plugin. Danach habe ich mir die Dateien im Block Theme Ordner angesehen.

CBT Plugin benennt die Slugs um ..

ändert aber nicht die Namen der Template Parts im Block Theme.

Richtig ist:

<!-- wp:pattern {"slug":"magnolie/magnolia-header-01"} /--> und 

<?php
/**
 * Title: magnolia-header-01
 * Slug: magnolie/magnolia-header-01
 * Inserter: no
 */
?>

Falsch ist:

<!-- wp:template-part {"slug":"magnolie-header-01"} /-->

Weil die Datei heißt : magnolia-header-01.html . Dadurch, dass das CBT Plugin den Slug ändert, findet er natürlcih nicht die Datei, weil er sucht: mangolie-header-01.html, die es ja nicht gibt.

Lösungen:

1 – Slug anpassen

Die einfachste Lösung ist, sich die Theme Dateien ansehen, und schauen, was das CBT Plugin da reingeschrieben hat. Wenn das nicht mit dem richtigen Dateinamen übereinstimmt, einfach den Sug ausbessern

2 – Fehlende Dateien im Editor neu hinzufügen

Oder man löscht die leeren Template Teile und ersetzt sie durch die richtigen. Danach noch einmal alles über das CBT Plugin speichern .

Schlechte Namens Wahl

Im Prinzip schaut das jetzt so aus, wie wenn ich schlechte Namen gewählt hätte. Allerdings stimmt das so nicht . Ich habe es mit verschiedenen Namen versucht. Es war immer dasselbe Ergebnis.

Fehler ist bereits bekannt .

Dieser Fehler dürfte schon ein alter Bekannter sein. Das heißt dieser Fehler wurde schon 2023 im WordPress Forum gemeldet :

issues 228 auf Github

und issue 429 auf Github – hier wird genau mein beschriebener Fehler auf Github mit Fotos dokumentiert, genauso wie bei mir. Von 2023.

Das Create Block Theme (CBT) Plugin ersetzt beim Klonen oft nur den Slug innerhalb von Dateien, benennt physische Dateien oder Ordner jedoch nicht konsequent um, was zu Fatal Errors führt. Da das Plugin primär als Entwicklungswerkzeug dient und eine automatisierte Korrektur als schwierig gilt, ist eine manuelle Umbenennung der Dateien im neuen Theme-Ordner erforderlich. Dokumentierte Diskussionen und der aktuelle Stand des Problems sind im GitHub Repository zu finden.

👉 Das heißt: sie wissen es ! Es ist zu kompliziert, das zu beheben. Da es als Entwickler Plugin gilt, nimmt man an, dass die Leute die es verwenden , wissen was sie tun.

Create Block Theme Plugin und die theme.json

Also, Achtung, die neu angelegten Template Parts welche über den Editor angelegt werden, werden vom Plugin nicht ! in die theme.json geschrieben. Es ist anscheinend nicht notwendig, es wir auch so erkannt.

Allerdings, wer ein sauberes Block Theme erstllen möchte, der sollte es per hand in die theme.json einfügen.

Fazit :

Ich finde das Create Block Theme Plugin ein super Plugin, das einem sehr viel Arbeit erspart. Aber so wie es da von WordPress angepriesen wird,

Jeder kann jetzt sein Custom WordPress Block Theme erstellen mit Create Block Theme Plugin ..

Das ist eigentlich eine Mähr, weil wenn sich jemand nicht mit den Theme Dateien auskennt, und nicht nachsieht, ob das Plugin gerade was falsch macht, der wird dann auch keine Freude haben. 🙅‍♀️