WP Transformer — Betriebshandbuch

Übersicht

WP Transformer wandelt WordPress SQL-Dumps in statische HTML-Seiten um.
Jeder Mandant (Kunde) durchläuft eine vierstufige Pipeline mit manuellem Kontrollpunkt.

1. Neuen Mandanten anlegen

1. Dashboard → + Mandant
2. Name — Kundenname (z.B. "MERKUR ASSEKURANZ")
3. Quell-URL — Original-WordPress-URL (z.B. https://www.merkur-assekuranz.de)
4. DB-Prefix — Standard wp_, abweichend wenn der WP-Export anderen Prefix hat
5. → Anlegen

Der Slug wird automatisch aus dem Namen generiert (z.B. merkur).

2. SQL-Dump exportieren (WordPress-Seite)

Empfohlenes Tool: UpdraftPlus

1. WP-Admin → UpdraftPlus → Backup jetzt
2. Nur Datenbank auswählen
3. Download → .sql-Datei

Alternativ: phpMyAdmin → Datenbank → Export → SQL

3. Pipeline ausführen

Schritt 1 — SQL hochladen

• Mandant öffnen → SQL-Dump hochladen
• Datei auswählen (.sql, max. 64 MB)
• Prefix wird automatisch erkannt

Schritt 2a — Parsen

• Button Parsen →
• Liest Artikel, Seiten und Kategorien aus dem Dump
• Prefix wird automatisch erkannt (UpdraftPlus-Header + Scan bis 10.000 Zeilen)
• Ergebnis wird in wpt_posts-Tabelle gespeichert und als content.json gesichert
• Human Review: Anzahl geparster Inhalte prüfen

Schritt 2b — Inhalte bearbeiten

• Button Inhalte bearbeiten → öffnet den Post-Editor
• Titel, Typ (Seite/Beitrag), Slug, Kategorien, Excerpt und Content (HTML) bearbeitbar
• Kategorien als Komma-getrennte Liste eingeben
• Nach Änderungen: ↺ Neu bauen direkt im Editor oder zurück zu Schritt 3

Schritt 3 — Static Build

• Button Build →
• Liest aktuelle Daten aus wpt_posts-DB (nicht aus content.json)
• Generiert HTML-Dateien in tenants/{slug}/public/
• Erzeugt: index.html, {slug}.html pro Post, feed.json, .htaccess
• Theme: Standard (inline HTML) oder corporate (Tailwind, navy/signal-green)
• Human Review: Vorschau über Subdomain prüfen

Schritt 4a — ZIP Download

• Fertiges Paket für manuelle Übergabe
• Enthält komplettes public/-Verzeichnis

Schritt 4b — FTP Deploy

• FTP-Zugangsdaten des Kunden-Servers eintragen
• Host, User, Passwort, Zielpfad (z.B. /public_html/)
• Host und User werden gespeichert, Passwort nie

4. Mandanten-Einstellungen

Corporate Theme

Das corporate-Theme erzeugt eine einseitige Tailwind-Site:
- WP-Seiten (type=page) → Nav-Links + Content-Sections + Slider (erste 3)
- WP-Beiträge (type=post) → "Aktuelles"-Kacheln am Seitenende
- Einzelseiten ({slug}.html) mit Corporate-Chrome (Topbar, Header, Footer)
- Social-Links (LinkedIn, XING, Instagram, YouTube) über brand.social JSON-Feld in DB

5. Subdomain einrichten (ALL-INKL KAS)

1. KAS → Domains → Subdomain hinzufügen
2. Name: ozm (für ozm.wptransformer.org)
3. Zielverzeichnis: tenants/ozm/public
4. DNS wird automatisch gesetzt (Propagation 5–60 Min.)
5. FTP-User optional: KAS → FTP → Neuer Benutzer → Pfad auf tenants/ozm/public beschränken

6. Erstinstallation auf neuem Server

1. Alle Dateien per FTP hochladen
2. phpMyAdmin → init.sql importieren
3. config.local.php per FTP hochladen (DB-Zugangsdaten)
4. https://domain.tld/login.php aufrufen
5. Login: admin / (gesetztes Passwort)
6. Passwort sofort in phpMyAdmin ändern:
   UPDATE wpt_users SET pass_hash="..." WHERE username="admin";
   (Hash per PHP generieren: password_hash('neues_pw', PASSWORD_BCRYPT))

7. Gesamte Pipeline im Kontext

┌─────────────────────────────────────────────────┐
│  RetroPWD + Ollama  (RZ, root, feste IP)        │
│  AI generiert JSON/HTML-Strukturen              │
│  → Human Review                                 │
└────────────────────┬────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────┐
│  WP Transformer  (ALL-INKL, PHP/MySQL)          │
│  SQL Upload → Parse → Build → Deploy            │
│  → Human Review an jedem Schritt                │
└────────────────────┬────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────┐
│  Kunden-Server  (Static HTML)                   │
│  ozm.wptransformer.org → onezeromore.com        │
│  merkur.wptransformer.org → merkur-assekuranz.de│
└─────────────────────────────────────────────────┘

8. Troubleshooting

9. Sicherheitshinweise

• config.local.php enthält DB-Zugangsdaten — nie committen, nie per Browser abrufbar
• FTP-Passwörter werden nicht in der Datenbank gespeichert
• Standard-Passwort admin/password nach Erstinstallation sofort ändern
• FTP-Zugangsdaten nach Nutzung im Chat rotieren
• Verzeichnisschutz (.htaccess) schützt tenants/ außer /public/
• Alle POST-Formulare sind CSRF-geschützt (hash_equals + random_bytes(32))
• Logout ist POST-only — GET-Requests auf /logout.php werden ignoriert