Otopilot
SEO Hata Düzenleyici

Next.js ve PHP Site Bağlayıcı Kurulumu

Hazırlayan Son güncelleme:

Bu Sayfa Ne Yapar

Next.js Bağlayıcı ve PHP Site Bağlayıcı, kendi yazdığınız sitelere Otopilot API kanalını hazır bir paketle kuran indirilebilir bağlayıcılardır: onaylanan blog yazıları sitenize eklenir, SEO düzeltmeleri sayfalara sunucu tarafında uygulanır. API kanalı her altyapıyla çalışır ama düzeltmeleri çekip yazacak kodu sizin yazmanızı ister; bu paketler o kodu hazır getirir, size yalnız yapılandırma ve zamanlayıcı kurmak kalır.

İki ayrı kurulum ekranı vardır. Next.js Bağlayıcı ekranı numaralı üç karttan oluşur: 1. Paketi indirin (sürüm bilgisi ve ZIP indir), 2. Proje kimliği ve API anahtarı (Panel adresi (SP_PANEL_URL), Proje kimliği (SP_PROJECT), API anahtarı (SP_KEY)) ve 3. Kurulum adımları (altı adım, cron örneği ve görsel notu). PHP Site Bağlayıcı ekranında solda Adım adım kurulum, Görseller sitenizin kendi medyasından gelir ve Kendi tablonuza uyarlayın kartları, sağda Paketi indirin kartı (ZIP'i indir, Panel adresi, PROJECT_ID, API anahtarı) bulunur; birden çok projeniz varsa üstte site seçici çıkar.

Bağlayıcı sitenizin sunucusunda zamanlayıcıyla çalışır: Next.js paketi önerilen cron ile 15, PHP paketi 10 dakikada bir panelin SEO Onarım API'sine bağlanır. Yeni yazıları alır, düzeltme kurallarını yerel bir dosyaya (Next.js'te .seopanel/rules.json, PHP'de storage/rules.json) yazar ve sonucu panele bildirir. Next.js tarafında kurallar sayfalara pageOverrides, siteFile ve redirectFor yardımcılarıyla; PHP tarafında ortak giriş dosyasının en üstüne eklenen tek satırlık runtime.php ile uygulanır. Yazı görselleri önce sitenizin kendi medyasında aranır, bulunamazsa indirilip sitenize kaydedilir; dış bağlantı bırakılmaz.

Next.js paketi Node 18.17 ve üstü, kendi sunucusunda (next start) çalışan siteler içindir; Vercel gibi dosya sistemi salt okunur ortamlarda senkron çalışmaz. PHP paketi PHP 7.4 ve üstü ile json ve dom eklentileri ister; yazıları HTML dosyası olarak, PDO ile kendi yazı tablonuza ya da kendi bağdaştırıcı sınıfınızla saklar. İki ekran da bağlı oldukları site için Next.js Bağlayıcı Kurulumu ya da PHP Site Bağlayıcı Kurulumu ürünü alınınca açılır; ikisi de site başına ve tek seferlik ücretlidir, güncel fiyat mağazadaki ürün sayfasında görünür.

Sık yanlış anlama, paketi indirip senkronu çalıştırmanın düzeltmeleri sayfaya taşıdığıdır. Senkron kuralları yalnız dosyaya yazar ve panele "uygulandı" bildirir; Next.js'te yardımcılar sayfalara eklenmeden, PHP'de runtime.php satırı eklenmeden düzeltme sayfada görünmez. Ayrıca SEO düzeltmelerinin bu kanaldan gitmesi için SEO Onarım ekranında aktif kanal Otopilot API olmalıdır.

Anlatılan sayfayı panelde aç(giriş yapınca açılır)

Ön Koşullar

  • Projede bağlayıcının kurulacağı site eklenmiş olmalıdır; proje yoksa ekran "Önce bir site ekleyin" uyarısı gösterir.
  • Bu site için Next.js Bağlayıcı Kurulumu ya da PHP Site Bağlayıcı Kurulumu ürünü alınmış olmalıdır. PHP ekranı satın alma talebiniz kaydedildiği anda da açılır.
  • API anahtarını oluşturmak ve görmek yalnız proje sahibine açıktır; takım arkadaşları paket ve proje kimliğini görür ama anahtar alanında "yalnızca proje sahibi" notu çıkar.
  • Sitenin sunucusunda dosya yazabilmeli ve zamanlanmış görev (cron ya da systemd zamanlayıcısı) kurabilmelisiniz. Next.js için Node 18.17+, PHP için PHP 7.4+ gerekir.

Adım Adım Kullanım

  1. Ekrana ürün sayfasındaki yönetim bağlantısından ya da doğrudan Next.js Bağlayıcı ekranından gidin; PHP için PHP Site Bağlayıcı ekranını açın. Ürün bu site için alınmamışsa Next.js ekranında "Next.js Bağlayıcı Kurulumu bu site için açık değil" ve Modüller sayfasına git, PHP ekranında "Bu site için paket henüz açık değil" ve Ürün sayfasına git görünür.
  2. PHP ekranında birden çok projeniz varsa üstteki site seçiciden doğru siteyi seçin; paketin içindeki yapılandırma seçili sitenin proje kimliğiyle hazırlanır. Next.js ekranı sol menünün üstündeki proje seçicide aktif olan projeyi kullanır.
  3. Paketi indirin: Next.js'te 1. Paketi indirin kartındaki ZIP indir, PHP'de Paketi indirin kartındaki ZIP'i indir düğmesi. Kartta güncel sürüm yazar (ör. Next.js 1.1.1, PHP 1.3.1); Next.js paketi panel adresini, PHP paketi panel adresiyle PROJECT_ID'yi içeren config.php dosyasını hazır getirir. API anahtarı hiçbir pakette yoktur.
  4. API anahtarını alın. Henüz anahtar yoksa Anahtar oluştur düğmesine basın. Anahtar ekranda açık gösterilir, Kopyala ile güvenli bir yere alın. Anahtar daha önce oluşturulduysa yalnız son dört hanesi görünür; Next.js'te Anahtarı göster, PHP'de Göster ile yeniden açabilirsiniz. Bu anahtar Otopilot API kanalının proje anahtarıdır.
  5. Next.js'te ZIP'i açıp seopanel-connector klasörünü projenin köküne kopyalayın ve .env.local dosyasına SP_PANEL_URL, SP_PROJECT, SP_KEY ile sitenizin adresini taşıyan SP_SITE_URL değerlerini ekleyin. Panel adresi (SP_PANEL_URL) ve Proje kimliği (SP_PROJECT) alanlarındaki Kopyala düğmeleri doğru değerleri verir.
  6. PHP'de klasörü web kökünün dışında ya da erişime kapalı bir yere açın; config.php içinde api_key alanına anahtarı, site_url alanına sitenizin adresini yazın. adapter ayarıyla yazıların nereye kaydedileceğini seçin: 'files' her yazıyı HTML dosyası yapar, 'pdo' kendi MySQL ya da SQLite yazı tablonuza sütun eşlemesiyle yazar.
  7. Bağlantıyı deneyin. Next.js'te node seopanel-connector/bin/seopanel-sync.mjs --check komutu anahtarı ve bağlantıyı yazı çekmeden dener, ardından aynı komutu --check olmadan çalıştırarak ilk senkronu yapın. PHP'de php seopanel-sync.php komutunun çıktısında 'icerik' ve 'kurallar' satırları görünmelidir.
  8. Zamanlayıcıyı kurun. Next.js ekranındaki Cron örneği senkronu 15 dakikada bir, PHP ekranındaki örnek 10 dakikada bir çalıştırır. Senkron, sitenin çalıştığı klasörde ve aynı sunucuda çalışmalıdır; kural dosyasını site oradan okur.
  9. Düzeltmeleri sayfalara bağlayın. Next.js'te sayfaların generateMetadata fonksiyonuna pageOverrides ve toMetadata, şema için jsonLdScripts, yönlendirme ve site dosyaları için paketteki middleware ve route şablonlarını ekleyin. PHP'de ekrandaki tek satırlık require_once runtime.php satırını ortak giriş dosyasının (index.php ya da header.php) en üstüne koyun.
  10. Blog yazılarının görünmesini sağlayın. Next.js paketi her yazıyı content/blog/<slug>.json dosyasına yazar; paketteki örnek sayfayı blog sayfanıza uyarlayın ve taslak durumundaki yazıları göstermeyin. PHP'de 'files' bağdaştırıcısının template ayarıyla kendi sayfa şablonunuzu verin.
  11. SEO Onarım sayfasının Kanal & Kurulum görünümünde Otopilot API kartını aktif kanal yapın. İlk senkrondan sonra kart Aktif · Çalışıyor olur; onayladığınız düzeltmeler bir sonraki zamanlanmış senkronda siteye taşınır.

Ekrandaki öğeler

  • Next.js Bağlayıcı başlığı — altında paketin blog yazılarını ve SEO düzeltmelerini siteye taşıdığını anlatan açıklama.
  • 1. Paketi indirin ve ZIP indir — güncel sürümü ve panel adresini içeren Next.js paketini indirir.
  • 2. Proje kimliği ve API anahtarı — Panel adresi (SP_PANEL_URL), Proje kimliği (SP_PROJECT) ve API anahtarı (SP_KEY) alanları; her değerin yanında Kopyala düğmesi.
  • Anahtar oluştur / Anahtarı göster — anahtar yoksa "Henüz anahtar oluşturulmadı." yazar; varsa "Anahtar gizli; son 4 hane: 7f3a" biçiminde gösterilir.
  • 3. Kurulum adımları — altı adımlık liste, Cron örneği satırı ve görsellerin önce sitenizin public/ klasöründe arandığını anlatan not.
  • PHP Site Bağlayıcı başlığı ve Mağazaya dön — başlık sağındaki düğme ürün sayfasına döner.
  • Site seçici — birden çok projeniz varsa PHP ekranının üstünde site adlarıyla görünür; seçili site vurgulanır.
  • Adım adım kurulum — altı adım, 10 dakikalık cron örneği ve runtime.php satırı örneği.
  • Görseller sitenizin kendi medyasından gelir ve Kendi tablonuza uyarlayın kartları — görsel kuralını ve hazır 'files' ile 'pdo' bağdaştırıcılarını, kendi sınıfınızın uygulaması gereken yöntemleri anlatır.
  • Paketi indirin kartı — "Sürüm 1.3.1 — örnek.com için hazırlanmış yapılandırma ile gelir (API anahtarı pakette yoktur)." satırı ve ZIP'i indir düğmesi.
  • Panel adresi, PROJECT_ID, API anahtarı — anahtar ••••7f3a biçiminde maskeli durur; Göster, Gizle, Kopyala ve anahtar yoksa Anahtar oluştur düğmeleri.
  • Kilitli durum kartları — ürün alınmamışsa Next.js'te "bu site için açık değil" ve Modüller sayfasına git, PHP'de "Bu site için paket henüz açık değil" ve Ürün sayfasına git; süre dolmuşsa "modülünün süresi doldu" uyarısı.

Sonuçları nasıl yorumlarsınız

  • Kurulum ekranları bağlantı durumunu göstermez; durum SEO Onarım → Kanal & Kurulum görünümündeki Otopilot API kartında izlenir. İlk senkrondan sonra kart Aktif · Çalışıyor olur, Son senkron zamanı her zamanlanmış çalışmada tazelenir.
  • Otopilot API kanalından bir gün sinyal gelmezse kart Siteye ulaşmıyor olur; bu çoğu zaman cron'un durduğunu ya da anahtarın değiştiğini gösterir. Sunucudaki senkron günlüğüne (ör. storage/sync.log) bakın.
  • Next.js senkronunun çıkış kodu 2 ise hata geçicidir; aynı iş bir sonraki çalışmada yeniden denenir. .seopanel/state.json dosyası imleci tutar; silerseniz bekleyen her şey yeniden çekilir ve işlemler tekrar edilse de sonuç değişmez.
  • Panelde "uygulandı" görünen bir düzeltme, kuralın dosyaya yazıldığını gösterir. Sayfada görünüp görünmediğini panelin doğrulama taraması anlar; doğrulanamayan düzeltmeler genellikle yardımcıların ya da runtime.php satırının eksik olduğu sayfalardadır.

Örnek senaryo

örnek.com, PHP ile yazılmış ve yazılarını kendi MySQL tablosunda tutan bir yerel haber sitesi. Sahibi Otomatik SEO Blog ile haftada üç yazı üretmek ve tarama hatalarını kapatmak istiyor. Mağazadan bu site için PHP Site Bağlayıcı Kurulumu ürününü alıyor; PHP Site Bağlayıcı ekranında ZIP'i indir ile paketi indiriyor, Anahtar oluştur ile anahtarı kopyalıyor. Paketi /home/ornek/seopanel-connector klasörüne açıyor, config.php'de api_key ve site_url alanlarını dolduruyor, adapter ayarını 'pdo' yapıp yazı tablosunun sütunlarını eşliyor.

php seopanel-sync.php komutunun çıktısında 'icerik' ve 'kurallar' satırlarını görünce 10 dakikalık cron'u ekliyor ve header.php'nin en üstüne runtime.php satırını koyuyor. SEO Onarım ekranında Otopilot API kartını aktif kanal yapıyor; kart ilk senkrondan sonra Aktif · Çalışıyor oluyor. Onayladığı meta açıklama düzeltmeleri bir sonraki cron çalışmasında sayfalara yansıyor, yeni blog yazısı yazı tablosuna kayıt olarak ekleniyor ve görseli sitenin kendi medya klasörüne indiriliyor.

İpuçları

  • Anahtarı panelde yenilerseniz bağlayıcının yapılandırmasındaki anahtarı da hemen değiştirin; aynı anahtarı kullanan diğer Otopilot API entegrasyonlarınız da yeni anahtarı ister.
  • Next.js'te yayımlanan yazıların hemen görünmesi için paketteki revalidate şablonunu app/api/revalidate/route.ts olarak ekleyin ve SP_REVALIDATE_SECRET ile SP_REVALIDATE_URL değerlerini tanımlayın.
  • Next.js 15.5 ve üstünde middleware şablonu Node.js çalışma ortamını kullanır; Next.js 16'da dosyayı proxy.ts adıyla kaydedin. Daha eski sürümlerde yönlendirmeleri next.config içinde allRedirects ile verin.
  • PHP'de SEO düzeltmeleri başka bir kanaldan (ör. Pixel) geliyorsa apply_fixes ayarını false yapın ve runtime.php satırını eklemeyin; bağlayıcı yalnız yazı yayınlar.
  • robots.txt, sitemap.xml ve llms.txt düzeltmeleri için PHP'de docroot ayarına web kökünü yazın; aynı adlı dosyanız varsa ilk yazımdan önce bir kez yedeği alınır.
  • Ürün açıklamasına göre Next.js Bağlayıcı Kurulumu ekibimiz tarafından kurulur, PHP Site Bağlayıcı Kurulumu uzaktan kurulum desteği içerir; kurulum için Yardım & Destek sayfasından bize ulaşın.

Sık yapılan hatalar

  • PHP paketini web kökünün içine açmak; config.php ve storage/ klasörü dışarıdan erişilebilir olur. Paketi web kökünün dışına koyun.
  • Next.js sitesini Vercel gibi sunucusuz bir ortamda çalıştırıp bağlayıcıyı kurmak; .seopanel/ klasörü yazılamaz ve her dağıtımda sıfırlanır.
  • Senkronu sitenin çalıştığı klasörden farklı bir yerde çalıştırmak; kural dosyası site tarafından okunmaz.
  • SEO Onarım ekranında aktif kanalı Otopilot API yapmamak; yazılar gelir ama SEO düzeltmeleri bu kanala gönderilmez.

Sık Karşılaşılan Sorunlar

  • Next.js Bağlayıcı Kurulumu bu site için açık değil: Ekrandaki aktif proje için bu ürün alınmamış ya da başka bir siteye alınmış. Sol menünün üstündeki proje seçicide doğru projeyi seçin; yine görünüyorsa Modüller sayfasına git düğmesiyle ürünü bu site için edinin.
  • Bu site için paket henüz açık değil: PHP Site Bağlayıcı Kurulumu seçili site için satın alınmamıştır. Üstteki site seçiciden doğru siteyi seçin ya da Ürün sayfasına git ile ürünü bu site için alın; talep kaydedildiği anda indirme ve kurulum adımları açılır.
  • Anahtarı yalnızca proje sahibi oluşturabilir.: Projeye takım arkadaşı olarak eklenmişsiniz; API anahtarı proje sahibine aittir. Anahtarı proje sahibinden isteyin ya da proje sahibinin hesabıyla ekranı açmasını isteyin.
  • API anahtarı bilgisi yüklenemedi.: PHP ekranı anahtar durumunu panelden okuyamadı; çoğu zaman geçici bir bağlantı sorunudur. Sayfayı yenileyin, sürerse oturumunuzun açık olduğunu kontrol edip Yardım & Destek sayfasından bize yazın.
  • Anahtar işlemi başarısız.: Next.js ekranında anahtar oluşturma ya da gösterme isteği tamamlanamadı. Sayfayı yenileyip yeniden deneyin; proje sahibi olduğunuzdan ve oturumunuzun açık olduğundan emin olun.
  • 401 SP_API_INVALID_KEY: Next.js senkronu anahtarı reddetti: anahtar yanlış kopyalanmış ya da panelde yenilenmiştir. Ekranda Anahtarı göster ile güncel anahtarı alın ve .env.local dosyasındaki SP_KEY değerini değiştirin.
  • Senkron çalışıyor ama sayfalarda değişiklik yok: Senkron kuralları yalnız kural dosyasına yazar. Next.js'te sayfalara pageOverrides yardımcısını, PHP'de ortak giriş dosyasına runtime.php satırını eklediğinizi kontrol edin; Next.js'te statik üretilen sayfalar yeniden üretilmeden yeni etiketleri göstermez.
  • Next.js robots.txt ya da sitemap için çakışma hatası veriyor: Aynı adreste başka bir kaynak var (public/robots.txt, app/robots.ts, public/sitemap.xml ya da app/sitemap.ts). Eski dosyayı kaldırıp içeriğini paketteki route şablonunun yedek değerine taşıyın.

İlgili Kılavuzlar

Bu adımları kendi sitenizde uygulayın

Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.

Tüm rehberler