pSEO Wizard Kılavuzu 🧙‍♂️

pSEO Wizard için eksiksiz teknik kılavuza hoş geldiniz. Bu dokümantasyon, 1.000+ sayfayı güvenle başlatmanıza yardımcı olmak için haftalarca süren mimari kararları tek bir iş akışında özetler.

💡 Quick Tip: Bölümler arasında geçiş yapmak için kenar çubuğu navigasyonunu kullanın veya tüm kılavuzu okuyun.

🚀 Bölüm 1: Temel İş Akışı

Koda dalmadan önce "Fabrika"nın nasıl çalıştığını anlayın:

1. Proje Yapılandırması

Hedef Dilinizi dikkatli seçin. Bu, JSON çıktısında locale bayrağını belirler.

2. Desen Mantığı

{City} veya {Service} gibi değişkenler kullanın. Daha iyi SEO için desenleri kısa tutun.

3. Veri Üretimi

Kartezyen Çarpım mantığı kullanıyoruz. 10 Hizmet × 10 Şehir = 100 Sayfa.

🛡️ 4. "Güvenlik" Uyarısı

Adım 4'te /blog altında yayınlamanız konusunda sizi uyarıyoruz. Programatik içeriği kök domain'de yayınlamak Google'dan kaldırılmanın hızlı bir yoludur.

👨‍💻 Bölüm 2: Geliştirici Entegrasyonu

Altın Standart

📘 Note: Aşağıdaki kılavuz, dışa aktarılan dosyalarımızı işlemek için Next.js uygulamanız için en iyi mimariyi önerir.

"Raw HTML" Stratejisi

pSEO Wizard tam, stilize HTML sayfaları oluşturduğundan, bunları standart React Layout'a sarmak stil çakışmalarına neden olur.

✅ Çözüm: HTML'yi ham olarak sunmak için Next.js Route Handler kullanıyoruz.

// 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 Sistemi

Veritabanı migration'larını unutun. Dosya Sistemi Agregasyonuna dayalı bir sistem oluşturduk.

📁
Dizin: src/app/data/posts-json/
🔄
İş Akışı: Dışa aktarılan JSON dosyalarınızı buraya "Sürükle ve Bırak" yapın.
✨
Sihir: blog-posts.ts aggregator tüm dosyaları otomatik okur ve anında yayınlar.

Dinamik "Akıllı" Sitemap

sitemap.ts dosyanız yerel ayar farkındadır. JSON dosyalarını tarar ve yerel ayara özel URL'ler oluşturur.

Bu, Google'dan "Yinelenen İçerik" cezalarını önler.

🏛️ Bölüm 3: Teknik Mimari

Neden Cryptomus?

Belirli stratejik nedenlerle Stripe yerine Cryptomus'u seçtik:

🌍 Küresel Erişim

Her yerden kripto ödemelerini kabul eder (bölgesel bankacılık kısıtlamalarını çözer ve küresel erişim sağlar).

⚡ Anında Kilit Açma

Webhook sistemi, işlem onaylandığında "Dışa Aktar" düğmesinin kilidini anında açar.

Anti-Spam Mimarisi

Sistemimiz domain otoritenizi korumak için tasarlandı:

Tüm programatik içerik /blog alt dizini altında
Her sayfada benzersiz, AI tarafından oluşturulmuş içerik (ince içerik yok)
Dahili bağlantılar SEO en iyi uygulamalarını takip eder
Çok dilli içerik için uygun lang ve dir özellikleri

🚑 Bölüm 4: Sorun Giderme

Yaygın sorunlar ve çözümleri:

❌ Beyaz Ekran / Stilsiz Metin

Neden: Tailwind CDN engellendi.

Çözüm: next.config.js CSP header'larını kontrol edin. cdn.tailwindcss.com'a izin verin.

⚠️ Bozuk Dahili Bağlantılar (/og/ veya //)

Neden: AI üretim kalıntıları.

Çözüm: route.ts dosyanızda "Smart Regex" temizleyicisi olduğundan emin olun.

🔍 Oluşturulan Gönderilerde 404

Neden: Slug uyuşmazlığı (genellikle Arapça kodlama).

Çözüm: Route handler'ınızda decodeURIComponent(slug) kullanıldığından emin olun.

✅ CTA Düğmeleri /blog'a Gidiyor

Neden: Regex tüm bağlantıları blog yolu ile değiştiriyor.

Çözüm: Ana sayfa bağlantıları ile blog bağlantıları için ayrı desenler kullanın.

pSEO Wizard Ekibi tarafından ❤️ ile yapıldı

Son güncelleme: Aralık 2024