Manuel pSEO Wizard 🧙♂️
Bienvenue dans le guide technique complet de pSEO Wizard. Cette documentation condense des semaines de décisions architecturales en un seul flux de travail pour vous aider à lancer plus de 1 000 pages en toute sécurité.
💡 Quick Tip: Utilisez la navigation latérale pour passer d'une section à l'autre, ou faites défiler le guide complet.
🚀 Partie 1: Le Flux de Travail Principal
Avant de plonger dans le code, comprenez comment fonctionne l'"Usine":
1. Configuration du Projet
Sélectionnez votre Langue Cible avec soin. Cela définit le flag locale dans la sortie JSON.
2. Logique des Motifs
Utilisez des variables comme {City} ou {Service}. Gardez les motifs courts pour un meilleur SEO.
3. Génération de Données
Nous utilisons la logique du Produit Cartésien. 10 Services × 10 Villes = 100 Pages.
🛡️ 4. L'Alerte "Sécurité"
À l'Étape 4, nous vous avertissons de publier sous /blog. Publier du contenu programmatique sur le domaine racine est un moyen rapide d'être désindexé par Google.
👨💻 Partie 2: Intégration Développeur
Le Standard d'Or
📘 Note: Le guide suivant recommande la meilleure architecture pour votre application Next.js pour gérer nos fichiers exportés.
La Stratégie "Raw HTML"
Puisque pSEO Wizard génère des pages HTML complètes et stylisées, les envelopper dans un Layout React standard cause des conflits de styles.
✅ La Solution: Nous utilisons un Route Handler Next.js pour servir le HTML brut.
// 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' } });
}Le Système JSON Drop-in
Oubliez les migrations de base de données. Nous avons construit un système basé sur l'Agrégation du Système de Fichiers.
- 📁Répertoire:
src/app/data/posts-json/ - 🔄Flux de travail: Faites simplement "Glisser-Déposer" vos fichiers JSON exportés ici.
- ✨Magie: L'agrégateur blog-posts.ts lit automatiquement tous les fichiers et les publie instantanément.
Sitemap Dynamique "Intelligent"
Votre sitemap.ts est conscient du locale. Il analyse les fichiers JSON et génère des URLs spécifiques au locale.
Cela évite les pénalités de "Contenu Dupliqué" de Google.
🏛️ Partie 3: Architecture Technique
Pourquoi Cryptomus?
Nous avons choisi Cryptomus plutôt que Stripe pour des raisons stratégiques spécifiques:
🌍 Portée Mondiale
Accepte les paiements crypto de partout (résolvant les restrictions bancaires régionales et permettant un accès mondial).
⚡ Déblocage Instantané
Le système Webhook débloque le bouton "Exporter" instantanément lors de la confirmation de la transaction.
Architecture Anti-Spam
Notre système est conçu pour protéger l'autorité de votre domaine:
- Tout le contenu programmatique vit sous le sous-répertoire /blog
- Chaque page a un contenu unique généré par IA (pas de contenu mince)
- Les liens internes suivent les meilleures pratiques SEO
- Attributs lang et dir corrects pour le contenu multilingue
🚑 Partie 4: Dépannage
Problèmes courants et leurs solutions:
❌ Écran Blanc / Texte Non Stylisé
Cause: Le CDN Tailwind est bloqué.
Solution: Vérifiez les en-têtes CSP dans next.config.js. Autorisez cdn.tailwindcss.com.
⚠️ Liens Internes Cassés (/og/ ou //)
Cause: Artefacts de génération IA.
Solution: Assurez-vous que votre route.ts a le nettoyeur "Smart Regex".
🔍 404 sur les Posts Générés
Cause: Décalage de Slug (souvent encodage arabe).
Solution: Assurez-vous d'utiliser decodeURIComponent(slug) dans votre route handler.
✅ Les Boutons CTA Vont vers /blog
Cause: Regex remplace tous les liens par le chemin blog.
Solution: Utilisez des motifs séparés pour les liens de page d'accueil vs liens blog.
Fait avec ❤️ par l'Équipe pSEO Wizard
Dernière mise à jour: Décembre 2024