Manuale pSEO Wizard 🧙♂️
Benvenuto nella guida tecnica completa di pSEO Wizard. Questa documentazione condensa settimane di decisioni architetturali in un unico flusso di lavoro per aiutarti a lanciare oltre 1.000 pagine in sicurezza.
💡 Quick Tip: Usa la navigazione laterale per saltare tra le sezioni, o scorri la guida completa.
🚀 Parte 1: Il Flusso di Lavoro Principale
Prima di immergerti nel codice, comprendi come funziona la "Fabbrica":
1. Configurazione Progetto
Seleziona attentamente la tua Lingua Target. Questo imposta il flag locale nell'output JSON.
2. Logica dei Pattern
Usa variabili come {City} o {Service}. Mantieni i pattern brevi per un SEO migliore.
3. Generazione Dati
Usiamo la logica del Prodotto Cartesiano. 10 Servizi × 10 Città = 100 Pagine.
🛡️ 4. L'Avviso "Sicurezza"
Nel Passaggio 4, ti avvisiamo di pubblicare sotto /blog. Pubblicare contenuto programmatico sul dominio root è un modo veloce per essere deindicizzati da Google.
👨💻 Parte 2: Integrazione Sviluppatori
Lo Standard d'Oro
📘 Note: La seguente guida raccomanda la migliore architettura per la tua applicazione Next.js per gestire i nostri file esportati.
La Strategia "Raw HTML"
Poiché pSEO Wizard genera pagine HTML complete e stilizzate, avvolgerle in un Layout React standard causa conflitti di stile.
✅ La Soluzione: Usiamo un Route Handler Next.js per servire l'HTML grezzo.
// 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' } });
}Il Sistema JSON Drop-in
Dimentica le migrazioni del database. Abbiamo costruito un sistema basato sull'Aggregazione del File System.
- 📁Directory:
src/app/data/posts-json/ - 🔄Flusso di lavoro: Semplicemente "Trascina e Rilascia" i tuoi file JSON esportati qui.
- ✨Magia: L'aggregatore blog-posts.ts legge automaticamente tutti i file e li pubblica istantaneamente.
Sitemap Dinamica "Intelligente"
La tua sitemap.ts è consapevole del locale. Scansiona i file JSON e genera URL specifici per locale.
Questo previene le penalità di "Contenuto Duplicato" da Google.
🏛️ Parte 3: Architettura Tecnica
Perché Cryptomus?
Abbiamo scelto Cryptomus rispetto a Stripe per ragioni strategiche specifiche:
🌍 Portata Globale
Accetta pagamenti in crypto da qualsiasi luogo (risolvendo restrizioni bancarie regionali e abilitando accesso globale).
⚡ Sblocco Istantaneo
Il sistema Webhook sblocca il pulsante "Esporta" istantaneamente alla conferma della transazione.
Architettura Anti-Spam
Il nostro sistema è progettato per proteggere l'autorità del tuo dominio:
- Tutto il contenuto programmatico vive sotto la sottodirectory /blog
- Ogni pagina ha contenuto unico generato da IA
- I link interni seguono le best practice SEO
- Attributi lang e dir corretti per contenuto multilingue
🚑 Parte 4: Risoluzione Problemi
Problemi comuni e loro soluzioni:
❌ Schermo Bianco / Testo Non Stilizzato
Causa: CDN Tailwind bloccato.
Soluzione: Controlla gli header CSP in next.config.js. Permetti cdn.tailwindcss.com.
⚠️ Link Interni Rotti
Causa: Artefatti di generazione IA.
Soluzione: Assicurati che il tuo route.ts abbia il pulitore "Smart Regex".
🔍 404 sui Post Generati
Causa: Mismatch dello Slug.
Soluzione: Assicurati di usare decodeURIComponent(slug).
✅ Pulsanti CTA Vanno a /blog
Causa: Regex sostituisce tutti i link.
Soluzione: Usa pattern separati per i link homepage vs blog.
Fatto con ❤️ dal Team pSEO Wizard
Ultimo aggiornamento: Dicembre 2024