pSEO Wizard Handbuch 🧙♂️
Willkommen zum vollständigen technischen Leitfaden für pSEO Wizard. Diese Dokumentation fasst wochenlange Architekturentscheidungen in einen einzigen Workflow zusammen, um Ihnen beim sicheren Start von über 1.000 Seiten zu helfen.
💡 Quick Tip: Verwenden Sie die Seitennavigation, um zwischen Abschnitten zu springen, oder scrollen Sie durch den vollständigen Leitfaden.
🚀 Teil 1: Der Kern-Workflow
Bevor Sie in den Code eintauchen, verstehen Sie, wie die "Fabrik" funktioniert:
1. Projektkonfiguration
Wählen Sie Ihre Zielsprache sorgfältig. Dies setzt das locale-Flag in der JSON-Ausgabe.
2. Muster-Logik
Verwenden Sie Variablen wie {City} oder {Service}. Halten Sie Muster kurz für besseres SEO.
3. Datengenerierung
Wir verwenden Kartesische Produkt-Logik. 10 Dienste × 10 Städte = 100 Seiten.
🛡️ 4. Die "Sicherheits"-Warnung
In Schritt 4 warnen wir Sie, unter /blog zu veröffentlichen. Programmatischen Inhalt auf der Root-Domain zu veröffentlichen ist ein schneller Weg, von Google deindexiert zu werden.
👨💻 Teil 2: Entwickler-Integration
Der Gold-Standard
📘 Note: Der folgende Leitfaden empfiehlt die beste Architektur für Ihre Next.js-Anwendung zur Handhabung unserer exportierten Dateien.
Die "Raw HTML"-Strategie
Da pSEO Wizard vollständige, gestylte HTML-Seiten generiert, verursacht das Einwickeln in ein Standard-React-Layout Stilkonflikte.
✅ Die Lösung: Wir verwenden einen Next.js Route Handler, um das HTML roh zu liefern.
// src/app/[locale]/blog/[slug]/route.ts
export async function GET(request, { params }) {
const post = getPostBySlug(params.slug);
if (post.locale !== params.locale) return 404;
const finalHtml = `<head><script src="https://cdn.tailwindcss.com"></script></head>
<body>${post.body_html}</body>`;
return new Response(finalHtml, { headers: { 'Content-Type': 'text/html' } });
}Das JSON Drop-in System
Vergessen Sie Datenbankmigrationen. Wir haben ein System basierend auf Dateisystem-Aggregation gebaut.
- 📁Verzeichnis:
src/app/data/posts-json/ - 🔄Workflow: Einfach Ihre exportierten JSON-Dateien hier "Drag & Drop".
- ✨Magie: Der blog-posts.ts Aggregator liest automatisch alle Dateien und veröffentlicht sie sofort.
Dynamische "Intelligente" Sitemap
Ihre sitemap.ts ist locale-bewusst. Sie scannt die JSON-Dateien und generiert locale-spezifische URLs.
Dies verhindert "Duplicate Content"-Strafen von Google.
🏛️ Teil 3: Technische Architektur
Warum Cryptomus?
Wir haben Cryptomus aus spezifischen strategischen Gründen gegenüber Stripe gewählt:
🌍 Globale Reichweite
Akzeptiert Krypto-Zahlungen von überall (löst regionale Bankbeschränkungen und ermöglicht globalen Zugang).
⚡ Sofortige Freischaltung
Das Webhook-System schaltet den "Export"-Button sofort bei Transaktionsbestätigung frei.
Anti-Spam-Architektur
Unser System ist darauf ausgelegt, Ihre Domain-Autorität zu schützen:
- Aller programmatischer Inhalt lebt unter dem /blog-Unterverzeichnis
- Jede Seite hat einzigartigen, KI-generierten Inhalt (kein dünner Inhalt)
- Interne Verlinkung folgt SEO-Best-Practices
- Korrekte lang- und dir-Attribute für mehrsprachigen Inhalt
🚑 Teil 4: Fehlerbehebung
Häufige Probleme und ihre Lösungen:
❌ Weißer Bildschirm / Ungestylter Text
Ursache: Tailwind CDN ist blockiert.
Lösung: Überprüfen Sie CSP-Header in next.config.js. Erlauben Sie cdn.tailwindcss.com.
⚠️ Defekte Interne Links (/og/ oder //)
Ursache: KI-Generierungsartefakte.
Lösung: Stellen Sie sicher, dass Ihre route.ts den "Smart Regex"-Cleaner hat.
🔍 404 bei Generierten Posts
Ursache: Slug-Nichtübereinstimmung (oft arabische Kodierung).
Lösung: Stellen Sie sicher, dass decodeURIComponent(slug) in Ihrem Route Handler verwendet wird.
✅ CTA-Buttons Gehen zu /blog
Ursache: Regex ersetzt alle Links durch Blog-Pfad.
Lösung: Verwenden Sie separate Muster für Homepage-Links vs. Blog-Links.
Mit ❤️ vom pSEO Wizard Team erstellt
Letzte Aktualisierung: Dezember 2024