Eine WordPress-Theme-Seite für ein Redesign in Figma importieren

Eine WordPress-Theme-Seite importierst du in Figma, indem du die gerenderte Seite erfasst, nicht die Theme-Dateien. Schritte, Grenzen und Kontrollen.

TUTORIALDESIGNERVeröffentlicht

Um eine WordPress-Theme-Seite nach Figma zu holen, erfasst du die Seite so, wie sie im Browser gerendert wird, und importierst diese Datei. Die PHP- oder Block-Template-Dateien des Themes brauchst du für den Import nicht. Dieses Tutorial setzt voraus, dass die Seite in deinem Browser lädt und dass UnHTML in Figma installiert ist.

Die Schritte sind kurz, und jeder davon hat einen klaren Zweck: Du erfährst vorab, was du ersetzt, bekommst eine Datei, die das Plugin lesen kann, und weißt nach dem Import, wo du nacharbeiten musst. Finde heraus, welches Template die Seite rendert, erfasse das gerenderte Ergebnis, importiere es, lies den Bericht und ordne am Ende des Redesigns jeden Frame einem Template zu.

Das Template finden, das die Seite rendert

Ein Redesign einer WordPress-Seite endet in Template-Dateien. Deshalb hilft es zu wissen, welche Datei die Seite erzeugt, die du gleich importierst. Tu das, bevor du irgendetwas erfasst. Die Antwort sagt dir, wie viele Frames du brauchst.

Warum das Template wichtig ist

Die Seite, die du im Browser siehst, stammt aus genau einer Template-Datei des Themes. Das Design, das du in Figma baust, ersetzt später das Markup dieser Datei. Importierst du die Seite "Über uns", das Theme rendert sie aber mit einem generischen Template, betrifft dein neues Design jede Seite, die dieses Template nutzt.

Die Suchreihenfolge

WordPress wählt das Template für eine statische Seite in einer festen Reihenfolge, laut WordPress-Theme-Handbuch:

  1. Ein der Seite zugewiesenes eigenes Template
  2. page-{slug}.php
  3. page-{id}.php
  4. page.php
  5. singular.php
  6. index.php

Die Startseite hat eine eigene Kette. Existiert front-page.php, hat sie Vorrang vor home.php. Block-Themes verwenden HTML-Dateien statt PHP-Dateien, und laut Handbuch ist die Hierarchie dieselbe. Eine slug-spezifische Datei schlägt page.php, und der erste Treffer in der Liste ist der, der verwendet wird.

Die gerenderte Seite erfassen

UnHTML nimmt keine URL direkt entgegen. Es liest eine Datei, also musst du zuerst eine erzeugen. Laut der UnHTML-Website akzeptiert das Plugin drei Eingabearten: eine eigenständige .html-Datei, ein Safari-.webarchive oder eine scene.json aus der Open-Source-CLI oder dem Bookmarklet.

Eine Erfassungsmethode wählen

  1. Rendert die Theme-Seite ihren Inhalt ohne Skripte, speichere sie als eigenständige HTML-Datei oder als Safari-Webarchiv. Beide bringen ihre eigenen Assets mit.
  2. Wird die Seite per JavaScript aufgebaut, lädt sie Remote-Assets oder willst du von einer Live-URL starten, nutze die CLI. Führe node capture/cli/capture.js mit der Seiten-URL aus und nenne die Ausgabedatei scene.json.
  3. Ziehe die entstandene Datei in die Ablagezone des Plugins in Figma.

Die UnHTML-Website empfiehlt scene.json für Live-Seiten, Remote-Assets und per JavaScript aufgebaute Seiten. Baut dein Theme Abschnitte mit Skripten auf, behandle es als per JavaScript aufgebaut und nutze die CLI. Prüfe deine eigene Seite, bevor du etwas annimmst.

Eine Faustregel für die Wahl: Je mehr die Seite beim Laden nachträglich verändert wird, desto eher lohnt sich der Weg über die CLI und scene.json. Eine statische Seite, die du in Sekunden als Datei speicherst, ist dagegen schneller importiert. Probiere im Zweifel beides an derselben Seite und vergleiche, welcher Import weniger Nacharbeit verlangt. So lernst du, wie sich dein Theme verhält, bevor du ein ganzes Projekt darauf aufbaust.

Seiten hinter einem Login

Eine Staging-Kopie einer WordPress-Seite ist oft gesperrt. Den Weg für diesen Fall beschreibt eine Seite hinter einem Login erfassen.

Was die Erfassung sendet

Mit den Standardeinstellungen löst der Import keine Netzwerkanfragen aus, und Skripte, Inline-Event-Handler und javascript:-URLs werden vor dem Rendern aus dem Markup entfernt. Das Laden von Remote-Assets ist eine Option zum Einschalten und standardmäßig aus. Die CLI ist anders: Ihr Headless-Browser lädt beim Erfassen einer URL Remote-Assets, also nutze sie nur für Seiten, die du laden darfst.

Importieren und den Bericht lesen

Ist die Datei importiert, öffne den Importbericht, bevor du die Arbeitsfläche anfasst. Er zeigt dir, was das Tool umgehen musste.

Ebenenlimit

Die kostenlose Stufe begrenzt einen Import auf 500 Ebenen. Eine lange Theme-Seite mit vielen verschachtelten Wrapper-Elementen kann diese Zahl überschreiten. Pro (39 USD einmalig pro Editor, Stand 2026) hebt das Limit auf. Erreicht deine Seite die Grenze, importiere einen Abschnitt nach dem anderen oder wechsle zu Pro.

Auto Layout und absolute Position

Der Importer ordnet das CSS der Seite dort Auto Layout zu, wo es möglich ist. Frames, die die erfasste Geometrie nicht abbilden können, fallen auf absolute Position zurück. In einem WordPress-Theme passiert das oft bei tief verschachtelten Wrappern von Page Buildern, rechne also damit, einige Frames von Hand zu vereinfachen.

Schriftarten

Schriftarten, die auf deinem Rechner nicht installiert sind, werden ersetzt, standardmäßig durch Inter, und jede Ersetzung steht im Bericht. Theme-Seiten laden oft eigene Webfonts, lies also zuerst die Schriftliste. Wie fehlende Schriftarten ersetzt werden erklärt, wie du das löst.

Was nach dem Import zu prüfen ist

Ein Import ist ein Ausgangspunkt für das Redesign, keine fertige Datei. Er ist kein exakter Klon der Seite, behandle ihn also nicht so.

Figmas eigene Seitenerfassung hat dieselbe Grenze. Das Hilfecenter sagt, Erfassungen kämen als einfache Figma-Ebenen an, nicht zugeordnet zu den Komponenten oder Stilen deiner Bibliothek, und aufwendige JavaScript-Animationen, Canvas-Rendering und virtualisierte Listen würden sich womöglich nicht sauber übertragen (siehe Figmas Anleitung zum Umwandeln von Webseiten in editierbare Ebenen). Erwarte bei jedem Importweg einfache Ebenen. Plane ein, sie danach zu Komponenten zu machen.

Wirkt das Ergebnis insgesamt unruhig, ist es oft besser, nicht die ganze Seite auf einmal zu erfassen. Figma empfiehlt in seiner Hilfe, bei Seiten mit Animationen vor der Erfassung bis ans Seitenende zu scrollen und, wenn die Erfassung der ganzen Seite schlecht aussieht, einen einzelnen Abschnitt zu erfassen. Dieselbe Überlegung hilft bei einem Theme: Hero-Bereich, Footer und Inhaltsblöcke lassen sich getrennt prüfen und einzeln nachbessern.

Eine kurze Checkliste für eine Theme-Seite:

  • Vergleiche den Frame mit der Live-Seite bei derselben Viewport-Breite.
  • Lösche Ebenen, die zum Beiwerk des Themes gehören und nicht zum Design, etwa Cookie-Banner und schwebende Widgets.
  • Prüfe Textumbrüche, die vom Browser abweichen.
  • Löse die Schriftersetzungen aus dem Bericht auf.

Sehen die Frames richtig aus, geh das Aufräumen eines Imports durch, bevor du Komponenten baust.

Frames den Templates zuordnen

Ziel eines Redesigns sind neue Templates, also organisiere die Figma-Datei so, wie das Theme organisiert ist. Gib jedem relevanten Template einen eigenen Frame: einen für front-page, einen für das Standard-Template page, einen für die Einzelbeitrags-Ansicht und einen für das Archiv. Benenne die Frames nach den Template-Dateien, die sie ersetzen.

Nutzt die Seite ein Child-Theme, denk daran, dass eine Datei im Child-Theme dieselbe Datei im Parent-Theme überschreibt. Schau zuerst im Child-Theme nach, wenn du entscheidest, welches Template ein Frame ersetzt, denn die Parent-Datei läuft womöglich nie. Führe eine kurze Liste mit den Frames, der Template-Datei hinter jedem und der Viewport-Breite, mit der du verglichen hast, damit die nächste Person deine Prüfungen wiederholen kann.

So bleibt die Übergabe ehrlich. Wer die Datei liest, sieht, dass der Frame "page" die Datei page.php ersetzt und dass eine spezifische Datei wie page-about.php nur dann einen eigenen Frame braucht, wenn ihr Layout abweicht. UnHTML liefert die Ausgangsebenen; die Zuordnung zu den Templates entscheidest du.

Fazit

Erfasse die gerenderte Seite, importiere sie, lies den Bericht und behandle das Ergebnis als editierbare Ebenen, nicht als Klon. Wer die Template-Hierarchie vorab kennt, weiß, wie viele Seiten er wirklich importieren muss, und Frames nach Template-Dateien zu benennen macht die Übergabe des Redesigns einfach.

Häufig gestellte Fragen

Kann UnHTML eine WordPress-Seite über ihre URL importieren?

Nicht direkt. Das Plugin nimmt eine eigenständige HTML-Datei, ein Safari-Webarchiv oder eine scene.json entgegen. Um von einer Live-URL zu starten, erfasst die Open-Source-CLI sie als scene.json, die du dann importierst.

Brauche ich die PHP-Dateien des Themes, um eine Seite zu importieren?

Nein. Der Import arbeitet mit der gerenderten Seite. Die PHP- oder Block-Dateien des Themes spielen erst eine Rolle, wenn du das fertige Design den Templates zuordnest.

Warum kommen manche Abschnitte mit absoluter Position an?

Frames, die die erfasste Geometrie mit Auto Layout nicht abbilden können, fallen auf absolute Position zurück. Tief verschachtelte Wrapper von Page Buildern sind eine häufige Ursache.

Reicht die kostenlose Stufe für eine komplette Theme-Seite?

Die kostenlose Stufe begrenzt einen Import auf 500 Ebenen. Eine lange, mit einem Page Builder gebaute Seite kann das überschreiten, dann hebt Pro das Limit auf.