دليل pSEO Wizard 🧙♂️
مرحباً بك في الدليل التقني الكامل لـ pSEO Wizard. هذه الوثائق تختصر أسابيع من القرارات المعمارية في سير عمل واحد لمساعدتك على إطلاق أكثر من 1,000 صفحة بأمان.
💡 Quick Tip: استخدم القائمة الجانبية للتنقل بين الأقسام، أو مرر للأسفل لقراءة الدليل الكامل.
🚀 الجزء 1: سير العمل الأساسي
قبل الغوص في الكود، افهم كيف يعمل "المصنع":
1. إعداد المشروع
اختر اللغة المستهدفة بعناية. هذا يحدد علامة locale في مخرجات JSON.
2. منطق النمط
استخدم متغيرات مثل {City} أو {Service}. اجعل الأنماط قصيرة لتحسين SEO.
3. توليد البيانات
نستخدم منطق Cartesian Product. 10 خدمات × 10 مدن = 100 صفحة.
🛡️ 4. تنبيه "الأمان"
في الخطوة 4، ننبهك للنشر تحت /blog. نشر المحتوى البرمجي على النطاق الجذري طريقة سريعة للإزالة من فهرسة Google.
👨💻 الجزء 2: تكامل المطورين
المعيار الذهبي
📘 Note: الدليل التالي يوصي بأفضل بنية لتطبيق Next.js الخاص بك للتعامل مع ملفاتنا المصدرة.
استراتيجية "Raw HTML"
بما أن pSEO Wizard ينشئ صفحات HTML كاملة ومنسقة، فإن لفها في Layout React القياسي يسبب تعارضات في الأنماط.
✅ الحل: نستخدم Route Handler في Next.js لتقديم HTML الخام.
// 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' } });
}نظام JSON Drop-in
انسى migrations قاعدة البيانات. بنينا نظاماً يعتمد على File System Aggregation.
- 📁المجلد:
src/app/data/posts-json/ - 🔄سير العمل: فقط "اسحب وأفلت" ملفات JSON المصدرة هنا.
- ✨السحر: يقرأ blog-posts.ts تلقائياً جميع الملفات وينشرها فوراً.
Sitemap ديناميكي "ذكي"
ملف sitemap.ts الخاص بك يدعم اللغات. يفحص ملفات JSON وينشئ روابط خاصة بكل لغة.
هذا يمنع عقوبات "المحتوى المكرر" من Google.
🏛️ الجزء 3: البنية التقنية
لماذا Cryptomus؟
اخترنا Cryptomus بدلاً من Stripe لأسباب استراتيجية محددة:
🌍 وصول عالمي
يقبل مدفوعات العملات الرقمية من أي مكان (يحل قيود البنوك الإقليمية ويتيح الوصول العالمي).
⚡ فتح فوري
نظام Webhook يفتح زر "التصدير" فوراً عند تأكيد المعاملة.
بنية مضادة للسبام
نظامنا مصمم لحماية سلطة نطاقك:
- كل المحتوى البرمجي يقع تحت مجلد /blog
- كل صفحة لها محتوى فريد منشأ بالذكاء الاصطناعي (بدون محتوى ضعيف)
- الروابط الداخلية تتبع أفضل ممارسات SEO
- سمات lang و dir صحيحة للمحتوى متعدد اللغات
🚑 الجزء 4: استكشاف الأخطاء
المشاكل الشائعة وحلولها:
❌ شاشة بيضاء / نص غير منسق
السبب: Tailwind CDN محظور.
الحل: تحقق من headers CSP في next.config.js. اسمح بـ cdn.tailwindcss.com.
⚠️ روابط داخلية معطلة (/og/ أو //)
السبب: مخلفات توليد الذكاء الاصطناعي.
الحل: تأكد أن route.ts لديه منظف "Smart Regex".
🔍 خطأ 404 في المنشورات المولدة
السبب: عدم تطابق Slug (غالباً ترميز عربي).
الحل: تأكد من استخدام decodeURIComponent(slug) في route handler.
✅ أزرار CTA تذهب إلى /blog
السبب: Regex يستبدل كل الروابط بمسار blog.
الحل: استخدم أنماط منفصلة لروابط الصفحة الرئيسية مقابل روابط blog.
صنع بـ ❤️ من فريق pSEO Wizard
آخر تحديث: ديسمبر 2024