pSEO Wizard Handleiding 🧙♂️
Welkom bij de complete technische gids voor pSEO Wizard. Deze documentatie vat weken aan architectuurbeslissingen samen in één workflow om u te helpen 1.000+ pagina's veilig te lanceren.
💡 Quick Tip: Gebruik de zijbalknavigatie om tussen secties te springen, of scroll door de complete gids.
🚀 Deel 1: De Kernworkflow
Voordat u in de code duikt, begrijp hoe de "Fabriek" werkt:
1. Projectconfiguratie
Selecteer uw Doeltaal zorgvuldig. Dit stelt de locale-vlag in de JSON-uitvoer in.
2. Patroonlogica
Gebruik variabelen zoals {City} of {Service}. Houd patronen kort voor betere SEO.
3. Datageneratie
We gebruiken Cartesiaans Product logica. 10 Diensten × 10 Steden = 100 Pagina's.
🛡️ 4. De "Veiligheids" Waarschuwing
In Stap 4 waarschuwen we u om onder /blog te publiceren. Programmatische content op het hoofddomein publiceren is een snelle manier om door Google gedeïndexeerd te worden.
👨💻 Deel 2: Ontwikkelaar Integratie
De Gouden Standaard
📘 Note: De volgende gids beveelt de beste architectuur aan voor uw Next.js-applicatie om onze geëxporteerde bestanden te verwerken.
De "Raw HTML" Strategie
Aangezien pSEO Wizard volledige, gestileerde HTML-pagina's genereert, veroorzaakt het verpakken in een standaard React Layout stijlconflicten.
✅ De Oplossing: We gebruiken een Next.js Route Handler om de HTML raw te serveren.
// 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' } });
}Het JSON Drop-in Systeem
Vergeet databasemigraties. We hebben een systeem gebouwd op basis van Bestandssysteem Aggregatie.
- 📁Directory:
src/app/data/posts-json/ - 🔄Workflow: Gewoon "Drag & Drop" uw geëxporteerde JSON-bestanden hier.
- ✨Magie: De blog-posts.ts aggregator leest automatisch alle bestanden en publiceert ze direct.
Dynamische "Slimme" Sitemap
Uw sitemap.ts is locale-bewust. Het scant de JSON-bestanden en genereert locale-specifieke URLs.
Dit voorkomt "Duplicate Content" straffen van Google.
🏛️ Deel 3: Technische Architectuur
Waarom Cryptomus?
We kozen Cryptomus boven Stripe om specifieke strategische redenen:
🌍 Wereldwijd Bereik
Accepteert cryptobetalingen van overal (lost regionale bankbeperkingen op en maakt wereldwijde toegang mogelijk).
⚡ Directe Ontgrendeling
Het Webhook-systeem ontgrendelt de "Export" knop direct bij transactiebevestiging.
Anti-Spam Architectuur
Ons systeem is ontworpen om uw domeinautoriteit te beschermen:
- Alle programmatische content leeft onder de /blog subdirectory
- Elke pagina heeft unieke, AI-gegenereerde content
- Interne links volgen SEO best practices
- Juiste lang en dir attributen voor meertalige content
🚑 Deel 4: Probleemoplossing
Veelvoorkomende problemen en hun oplossingen:
❌ Wit Scherm / Ongestileerde Tekst
Oorzaak: Tailwind CDN is geblokkeerd.
Oplossing: Controleer CSP-headers in next.config.js.
⚠️ Kapotte Interne Links
Oorzaak: AI-generatie artefacten.
Oplossing: Zorg dat uw route.ts de "Smart Regex" cleaner heeft.
🔍 404 op Gegenereerde Posts
Oorzaak: Slug mismatch.
Oplossing: Gebruik decodeURIComponent(slug).
✅ CTA Knoppen Gaan naar /blog
Oorzaak: Regex vervangt alle links.
Oplossing: Gebruik aparte patronen voor homepage vs blog links.
Gemaakt met ❤️ door het pSEO Wizard Team
Laatst bijgewerkt: December 2024