Site Kodu Görevleri: Geliştirici Kartları, Hız, Şablon, Güvenlik
Hazırlayan Ersin DorlakSon güncelleme:
Bu Sayfa Ne Yapar
Site kodu görevleri, düzeltme kanallarınızın siteye yazamadığı işleri altyapınıza göre hazırlanmış kopyala-yapıştır kod ve adımlarla tek ekranda toplar. Bir kanal başlık etiketini değiştirebilir ama temanın her sayfaya bastığı aynı H1'i, sunucunun güvenlik başlıklarını ya da ağır bir görselin yükleme sırasını değiştiremez; bu işler sitenin kodunda yapılmalıdır.
Ekranda beş sekme vardır: Geliştirici kartları, Hız (LCP, CLS), Şablon, Güvenlik başlıkları ve Yayın betikleri. Geliştirici kartları sekmesi takılan düzeltmeleri, şablon görevlerini ve eksik güvenlik başlıklarını tek listede birleştirir; her kartta türü (Takılan düzeltme, Şablon görevi, Güvenlik başlıkları, Sayfa hızı), nedeni, etkilenen sayfa sayısı, örnek sayfalar ve altyapı sekmeleri bulunur. Sitenizin altyapısı WordPress, PHP, Next.js, OpenCart ya da Genel HTML olarak seçilir; tespit edilen altyapı "tespit edilen" notuyla önce gelir.
Kartların kaynağı farklıdır. Takılan düzeltmeler, kanalın uygulayamadığı, tekrar denemesi durdurulmuş ya da sitede görünmeyen düzeltmelerden gelir ve en fazla 60 kart gösterilir. Şablon görevleri son taramadan çıkar: aynı bulgu en az 3 sayfada ya da en az 2 sayfada ve HTML sayfaların beşte birinde görülmelidir. Hız sekmesi PageSpeed mobil ölçümünü kullanır; gerçek Chrome kullanıcılarından saha verisi varsa onu, yoksa laboratuvar ölçümünü gösterir. Güvenlik başlıkları ana sayfanın yanıt başlıklarından okunur ve 100 üzerinden puanlanıp harf notuna çevrilir.
Kodu kendiniz ya da geliştiricinizle uygulayabilirsiniz. Geliştiriciniz yoksa kartlardaki Bizim yapmamızı ister misiniz? bölümünden hizmet talebi açarsınız; hizmetin fiyatı tanımlıysa bedel yazar, değilse Fiyat teklifi iste düğmesi çıkar ve talep Taleplerim ekranında açılır. Yayın betikleri sekmesi ise GitHub ve Cloudflare Worker kanallarıyla yapılan yayınları sürüm sürüm listeler ve bir sürümü geri almanızı sağlar.
Sık karıştırılan nokta, buradaki kartların kendiliğinden kapanmasıdır: kart siz kodu yükleyince değil, düzeltme bir sonraki doğrulamada ya da taramada sitede görüldüğünde listeden düşer. Güvenlik başlıkları sıralamayı doğrudan değiştirmez; siteyi çerçeveleme ve karışık içerik risklerine karşı korur.
Anlatılan sayfayı panelde aç(giriş yapınca açılır)
Ön Koşullar
- Projede tamamlanmış en az bir tarama olmalı; şablon görevleri ve hız ölçümleri son taramadan, geliştirici kartları takılan düzeltmelerden üretilir.
- Hız sekmesinin dolması için sayfa hızı ölçümünün (PageSpeed) bu kurulumda çalışıyor ve planınızda yer alıyor olması gerekir; değilse sekme nedenini yazar.
- Yayın betikleri sekmesi yalnız GitHub ya da Cloudflare Worker kanalı bağlı projelerde dolar; diğer kanallarda kanal önerisine yönlendiren bir not görünür.
- Kodu uygulayacak kişinin sitenin tema dosyalarına, sunucu yapılandırmasına ya da yönetim paneline erişimi olmalı; hizmet talebi için KVKK aydınlatma metnini onaylamanız gerekir.
Adım Adım Kullanım
- Üst menüden Kanallar → Takılanlar ve site kodu grubundaki Geliştirici kartları, Hız (LCP, CLS), Şablon (H1, şema, yazar) ya da Güvenlik başlıkları maddesini açın. Sekmeler arasında üstteki şeritten geçersiniz; telefonda şerit yana kaydırılır.
- Geliştirici kartları sekmesinde kartları yukarıdan aşağı okuyun. Kartın türü, nedeni ve "12 sayfa" gibi etkilenen sayfa sayısı işin büyüklüğünü gösterir; Örnek sayfalar listesi değişikliği nerede kontrol edeceğinizi söyler.
- Kartın altındaki Altyapı sekmelerinden sitenize uyanı seçin. Tespit edilen altyapı önce gelir; sitenizi farklı bir yapıyla çalıştırıyorsanız (ör. WordPress değil özel PHP) doğru sekmeyi elle seçin, çünkü dosya adları ve kod buna göre değişir.
- Adımlar listesini sırayla izleyin ve kod bloklarını Kopyala düğmesiyle alın. Blok başlığı kodun gideceği dosyayı yazar (functions.php, header.php, next.config.js, .htaccess gibi). Kopyalama başarısız olursa metni seçip elle kopyalayın.
- Kodu uyguladıktan sonra örnek sayfalardan birini açıp kaynağında değişikliği kontrol edin. Kart, düzeltme bir sonraki doğrulamada sitede görülünce kendiliğinden listeden düşer; listede 60'tan fazla iş varsa kalanlar siz ilerledikçe görünür.
- Hız (LCP, CLS) sekmesinde son ölçüm tarihini ve ölçülen sayfa sayısını okuyun. Listede yalnız LCP, CLS ya da INP değerlerinden en az biri iyi aralıkta olmayan sayfalar çıkar; her sayfanın Performans puanı ve Ne yapmalı? önerileri o sayfanın tarama bulgularından gelir.
- Hız sekmesinin üstündeki Tüm siteyi etkileyen hız bulguları bölümünü önce ele alın; ortak bir görsel ya da betik sorunu çözüldüğünde birçok sayfa birden iyileşir.
- Şablon sekmesinde "Son taramada 240 HTML sayfadan 4 şablon görevi çıktı." gibi özeti okuyun. Aynı H1, eksik şema, yazar ve tarih bilgisi gibi görevler temada bir kez düzeltildiğinde o şablonu kullanan bütün sayfaları düzeltir.
- Güvenlik başlıkları sekmesinde notu, puanı ve altı başlığın durumunu (Var, Zayıf, Yok, Gerekmez) okuyun. Düzeltme kodu bölümünde sunucunuza uyan sekmeyi (nginx, Apache (.htaccess), Cloudflare, Next.js) seçip kodu uygulayın, ardından Yeniden kontrol et düğmesine basın.
- WordPress eklentisi kullanıyorsanız güvenlik başlıklarını kod yazmadan ekleyebilirsiniz: WordPress kanalını aç bağlantısıyla Kanal & Kurulum ekranındaki güvenlik başlıkları ayarını açın.
- Yayın betikleri sekmesinde her yayını Sürüm 3 gibi numarasıyla, içerdiği düzeltme sayısı ve durumuyla görün. GitHub sürümlerinde Pull request'i aç ile değişikliği inceleyin; sorunlu bir sürüm için Bu sürümü geri al deyip onaylayın.
- İşi bize yaptırmak için kartta Bizim yapmamızı ister misiniz? bölümündeki düğmeye basın. Açılan Site kodu hizmeti talebi penceresine isteğe bağlı not ve telefon yazın, KVKK kutusunu işaretleyip Talebi gönder deyin; talep Taleplerim ekranında izlenir.
Hangi kod nereye gider?
- WordPress: alt temanın functions.php dosyası ya da bir kod parçacığı eklentisi. Ana temaya yazılan kod tema güncellemesinde silinir.
- PHP: ortak şablon dosyası (çoğunlukla header.php); yönlendirme ve başlıklar .htaccess ya da nginx yapılandırmasına.
- Next.js: sayfanın page.tsx dosyasında metadata ve JSON-LD; yönlendirme ve güvenlik başlıkları next.config.js içinde.
- OpenCart: başlık ve açıklama yönetim panelindeki SEO sekmesinden; diğer etiketler header.twig ya da sayfa denetleyicisinden.
- Genel HTML: her sayfanın head bölümü; birden çok sayfa ortak bir şablondan üretiliyorsa değişikliği o şablonda yapın.
Ekrandaki öğeler
- Geliştirici kartları — Kanalın uygulayamadığı düzeltmeler, şablon görevleri ve eksik güvenlik başlıkları için hazır kod kartları.
- Hız (LCP, CLS) — Core Web Vitals değerlerinden en az biri iyi olmayan sayfaları ve önerileri gösteren sekme.
- Şablon — Aynı kök nedenden gelen, birden çok sayfayı etkileyen bulguları tek görevde toplayan sekme.
- Güvenlik başlıkları — Ana sayfanın yanıt başlıklarından çıkan güvenlik karnesi ve sunucuya göre düzeltme kodu.
- Yayın betikleri — GitHub ve Cloudflare Worker yayınlarının sürüm listesi ve geri alma.
- Takılan düzeltme, Şablon görevi, Güvenlik başlıkları, Sayfa hızı — Kartın türünü belirten etiketler.
- Altyapı sekmeleri (WordPress, PHP, Next.js, OpenCart, Genel HTML) — Kodu ve adımları sitenizin yapısına göre değiştirir; "tespit edilen" notu otomatik algılanan altyapıyı gösterir.
- Adımlar — Kodu uygulamak için izlenecek sıralı talimatlar.
- Kopyala — Kod bloğunu panoya alır; başarılı olunca Kopyalandı yazar.
- Örnek sayfalar — Görevden etkilenen sayfalardan örnekler; düzeltmeyi kontrol etmek için kullanılır.
- Aç — Kartın işi kod yazmadan bir ayarla da yapılabiliyorsa vurgulu kutuda görünen bağlantı; sizi o ayarın bulunduğu ekrana götürür.
- Bizim yapmamızı ister misiniz? — Hizmet talebi bölümü; fiyat tanımlıysa "Hizmet bedeli:" ve tutar, değilse Fiyat teklifi iste düğmesi görünür.
- Site kodu hizmeti talebi — Not, Telefon (isteğe bağlı), KVKK onayı, Talebi gönder ve Vazgeç içeren talep penceresi.
- Talebi aç — Aynı görev için açık talebiniz varsa o talebe götüren bağlantı.
- İyi, İyileştirilmeli, Zayıf — Hız sekmesinde LCP, CLS ve INP değerlerinin sınıfı.
- saha / laboratuvar — Hız değerinin gerçek Chrome kullanıcılarından mı yoksa test ölçümünden mi geldiğini gösterir.
- Performans puanı — PageSpeed mobil performans puanı.
- Tüm siteyi etkileyen hız bulguları ve Ne yapmalı? — Site genelindeki hız bulguları ve sayfaya özel öneriler.
- Not ve puan (ör. B, 78 / 100) — Güvenlik başlıklarının harf notu ve 100 üzerinden puanı.
- Var, Zayıf, Yok, Gerekmez — Her güvenlik başlığının durumu; Önerilen sütunu eklenmesi gereken değeri yazar.
- Düzeltme kodu ve sunucu sekmeleri (nginx, Apache (.htaccess), Cloudflare, Next.js) — Eksik başlıklar için sunucunuza uygun kod.
- Yeniden kontrol et — Güvenlik başlıklarını ana sayfadan yeniden okur; çalışırken Kontrol ediliyor… yazar.
- WordPress kanalını aç — WordPress eklentisi bağlıysa güvenlik başlıklarını eklentiyle açmanız için kurulum ekranına götürür.
- Açık PR, Birleştirildi, Kapatıldı, Yayında, Yerini yenisi aldı — Yayın betiklerindeki sürüm durumları.
- Pull request'i aç ve Bu sürümü geri al — GitHub sürümünü inceleme ve sürümdeki geri alınabilir düzeltmeleri geri alma düğmeleri.
- Önerilen kanalı aç — Yayın betikleri için uygun kanal bağlı değilse Kanallar ekranındaki öneri sekmesine götürür.
Sonuçları nasıl yorumlarsınız
Kartları etkilenen sayfa sayısına göre önceliklendirin: şablon görevleri tek dosya değişikliğiyle onlarca sayfayı düzelttiği için çoğu zaman en verimli iştir. Hız ve güvenlik değerlerinde ekrandaki eşikleri kullanın; eşik dışında bir "iyi" tanımı yoktur.
- Hız eşikleri: LCP ≤ 2,5 sn iyi, 4 sn üstü zayıf; CLS ≤ 0,1 iyi, 0,25 üstü zayıf; INP ≤ 200 ms iyi, 500 ms üstü zayıf. Arada kalan değerler İyileştirilmeli olarak gösterilir.
- Saha verisi gerçek ziyaretçilerin deneyimidir ve laboratuvar ölçümünden daha ağırlıklıdır; laboratuvar değeri yalnız saha verisi olmayan sayfalarda gösterilir.
- Güvenlik notu puana göre verilir: 90 ve üstü A, 75 ve üstü B, 55 ve üstü C, 35 ve üstü D, altı F. HSTS en yüksek ağırlığa sahiptir, ardından Content-Security-Policy ve çerçeve koruması gelir.
- Yayın betiklerinde "Bu kanallar üzerinden şu an sitede 14 düzeltme var." satırı, sunucu tarafında yayında olan düzeltme sayısını verir; bir sürümü geri almak yalnız o sürümdeki düzeltmeleri etkiler.
Örnek senaryo
örnek.com özel bir PHP sitesi; düzeltmeler Pixel ile gidiyor. Son taramadan sonra Şablon sekmesinde "Son taramada 180 HTML sayfadan 3 şablon görevi çıktı." yazıyor: bunlardan biri 120 sayfada aynı H1 metninin kullanılması. Geliştirici kartında PHP altyapı sekmesini seçiyor, Adımlar listesine göre header.php dosyasındaki sabit H1'i sayfa başlığını basan değişkenle değiştiriyor ve Örnek sayfalar listesindeki iki sayfanın kaynağında farklı H1'leri görüyor.
Aynı gün Güvenlik başlıkları sekmesinde not D, Strict-Transport-Security ve X-Content-Type-Options satırları Yok. Site nginx üzerinde çalıştığı için nginx sekmesindeki kodu sunucu yapılandırmasına ekleyip Yeniden kontrol et düğmesine basıyor; not hemen yükseliyor.
H1 görevi ise bir sonraki taramada sayfalar yeniden okunduğunda listeden düşüyor. Hız sekmesindeki iki zayıf sayfa için geliştiricisi olmadığından karttaki Bizim yapmamızı ister misiniz? bölümünden talep açıyor ve talebi Taleplerim ekranından izliyor.
İpuçları
- WordPress'te kodu ana temaya değil alt temaya ya da bir kod parçacığı eklentisine ekleyin; tema güncellemesi ana temadaki değişikliği siler.
- Şablon görevlerini tekil sayfa düzeltmelerinden önce bitirin; aynı kök neden çözülünce SEO Onarım'daki birçok sayfa düzeltmesi de gereksizleşir.
- Güvenlik başlıklarını eklemeden önce siteyi bir iframe içinde gösteren başka bir sisteminiz varsa çerçeve korumasının o kullanımı engelleyeceğini hesaba katın.
- Hız sekmesinde önce saha verisi olan sayfalara odaklanın; bu sayfalar gerçek trafik alır ve iyileştirme ziyaretçiye doğrudan yansır.
- Hizmet talebine barındırma paneli bilgisini ve erişim için uygun saatleri not olarak ekleyin; şifre gibi gizli bilgileri talep notuna yazmayın.
- GitHub kanalında bir sürümü geri almak yerine sorunlu tek düzeltmeyi SEO Onarım ekranından geri alabilirsiniz; sürüm geri alma içindeki tüm geri alınabilir düzeltmeleri kaldırır.
Sık yapılan hatalar
- Tespit edilen altyapıyı kontrol etmeden kodu kopyalamak; özel PHP sitesine WordPress kodu eklemek hata verir.
- Kodu ekledikten sonra kartın hemen kaybolmasını beklemek; kart bir sonraki doğrulamada ya da taramada değişiklik görülünce düşer.
- Önbellek eklentisi ya da CDN önbelleğini temizlemeden sonucu kontrol etmek; eski sayfa sunulduğu için değişiklik görünmez.
- Güvenlik başlıklarını hem sunucuda hem eklentide eklemek; aynı başlığın iki kez gönderilmesi tarayıcıda beklenmedik davranışa yol açabilir.
Sık Karşılaşılan Sorunlar
- Site kodu gerektiren bekleyen iş yok. Kanallarınız hazırlanan düzeltmeleri uygulayabiliyor.: Geliştirici kartları sekmesi boş çünkü kanallarınız hazırlanan düzeltmelerin hepsini siteye yazabiliyor ve şablon ya da güvenlik başlığı görevi yok. Yeni tarama ya da takılan düzeltme olduğunda kartlar burada belirir.
- Sayfa hızı ölçümü (PageSpeed) bu kurulumda yapılandırılmamış; ölçüm olmadan hız görevi üretilmez.: Hız ölçümü bu kurulumda kapalı olduğu için Hız sekmesi dolmaz. Diğer sekmeler çalışmaya devam eder; hız değerlerini görmek için ölçüm açıldığında bir sonraki taramayı bekleyin.
- Ölçüm bütçesi bugün için doldu; bir sonraki taramada yeniden denenecek.: Günlük hız ölçümü bütçesi dolduğu için yeni sayfa ölçülmedi. Bir şey yapmanız gerekmez; ölçüm bir sonraki taramada yeniden denenir. Aynı durum PageSpeed kotası dolduğunda da görülür.
- Son taramada şablon düzeyinde (birden çok sayfayı etkileyen) bulgu yok. Tekil sayfa sorunları SEO Onarım ekranında.: Şablon görevi için aynı bulgunun en az 3 sayfada ya da en az 2 sayfada ve HTML sayfaların beşte birinde görülmesi gerekir. Tek sayfadaki sorunlar SEO Onarım ekranında düzeltme olarak hazırlanır.
- "Ana sayfa okunamadı (…). Site erişilebilir mi, güvenlik duvarı panel isteğini engelliyor mu kontrol edin.": Güvenlik başlıklarını okumak için ana sayfaya yapılan istek yanıt almadı ya da engellendi. Site açıksa güvenlik duvarında ya da Cloudflare kurallarında panel isteğine izin verin, ardından Yeniden kontrol et düğmesine basın.
- Bu görev için açık bir talebiniz zaten var.: Aynı görev için son 7 gün içinde açtığınız ve hâlâ açık olan bir hizmet talebi var; ikinci talep açılmaz. Talebi aç bağlantısıyla mevcut talebe gidip yazışmaya oradan devam edin.
- Bu projede GitHub ya da Cloudflare Worker kanalı bağlı değil.: Yayın betikleri yalnız sayfayı sunucu tarafında değiştiren bu iki kanalla oluşur. Başka kanal kullanıyorsanız sekme boş kalır; Önerilen kanalı aç bağlantısıyla bu kanalların uygun olup olmadığını görebilirsiniz.
- Bu altyapı için hazır kod üretilemedi; adımları izleyin ya da hizmet talep edin.: Seçtiğiniz altyapı sekmesi için bu görevde otomatik kod şablonu yok. Adımlar listesindeki talimatlarla işi elle yapın ya da başka bir altyapı sekmesini deneyin; gerekirse hizmet talebi açı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.