GitHub|Since 2007
WPTR

WordPress API Haberleşmesi İçin Neden En İyisi WPGraphQL?

Teknoloji
WPTR Team
2 Ocak 2025

Headless WordPress projelerinde veri çekme yöntemi, uygulamanızın performansını ve geliştirme sürecini doğrudan etkiler. REST API yıllardır standart olsa da, WPGraphQL modern web geliştirme dünyasında yeni standart haline geldi. Bu rehberde, WPGraphQL'in neden vazgeçilmez olduğunu ve protejelerinizde nasıl kullanacağınızı detaylıca inceliyoruz.

WPGraphQL Nedir?

WPGraphQL, WordPress siteniz için tamamen ücretsiz, açık kaynaklı ve genişletilebilir bir GraphQL şeması oluşturan bir eklentidir. Basitçe söylemek gerekirse, WordPress veritabanınızı bir GraphQL API'sine dönüştürür. Bu sayede, Next.js, Gatsby veya Vue gibi frontend teknolojileriyle WordPress verilerini çok daha verimli bir şekilde çekebilirsiniz.

REST API vs. WPGraphQL: Neden Değiştirmelisiniz?

Geleneksel REST API ile çalışırken karşılaşılan temel sorunları ve WPGraphQL'in bunlara getirdiği çözümleri inceleyelim:

1. Overfetching (Gereğinden Fazla Veri)

REST API'de bir endpoint'e (örn: /wp-json/wp/v2/posts) istek attığınızda, sunucu size o yazıyla ilgili tüm verileri gönderir. İhtiyacınız olan sadece "Başlık" ve "Özet" olsa bile, onlarca gereksiz alanı indirmek zorunda kalırsınız.

WPGraphQL Çözümü: Sadece istediğiniz veriyi sorarsınız ve sadece onu alırsınız.

query GetPosts {
  posts {
    nodes {
      title
      excerpt
    }
  }
}

2. Underfetching (Eksik Veri ve Çoklu İstekler)

Bir blog sayfası yaparken şunlara ihtiyacınız olur: Yazı içeriği, Yazarın adı ve avatarı, Kategori bilgisi, Öne çıkan görsel. REST API ile bunları almak için genellikle birden fazla endpoint'e istek atmanız veya karmaşık ?_embed parametreleri kullanmanız gerekir.

WPGraphQL Çözümü: İlişkisel verileri (yazar, görsel, kategori) tek bir iç içe sorgu ile tek seferde alırsınız.

query GetPostWithDetails {
  post(id: "blog-slug", idType: SLUG) {
    title
    author {
      node {
        name
        avatar {
          url
        }
      }
    }
    featuredImage {
      node {
        sourceUrl
      }
    }
    categories {
      nodes {
        name
      }
    }
  }
}

3. Tip Güvenliği (Type Safety) ve Dokümantasyon

WPGraphQL, verilerinizin şemasını (türlerini) otomatik olarak çıkarır. Bu, TypeScript kullanan projelerde (Next.js gibi) muazzam bir avantaj sağlar. Verinin ne formatta geleceğini kesin olarak bilirsiniz.

Kurulum ve Kullanım

WPGraphQL'i kurmak diğer herhangi bir WordPress eklentisi kurmak kadar basittir:

  1. WordPress yönetici panelinize gidin.
  2. Eklentiler > Yeni Ekle bölümüne gelin.
  3. "WPGraphQL" aramasını yapın ve eklentiyi yükleyip etkinleştirin.
  4. Sol menüde beliren GraphQL sekmesine tıklayarak ayarlara ulaşabilirsiniz.

GraphiQL IDE ile Sorgu Denemeleri

Eklentiyi kurduktan sonra üst bar'da "GraphiQL" simgesini göreceksiniz. Bu, tarayıcı içinde çalışan bir IDE'dir. Kodunuza tek satır yazmadan önce tüm sorgularınızı burada test edebilir, verilerin nasıl döndüğünü canlı olarak görebilirsiniz.

Next.js ile Basit Bir Örnek

Next.js projenizde verileri çekmek için fetch API'sini kullanabilirsiniz. Ekstra bir kütüphaneye (Apollo Client gibi) her zaman ihtiyacınız yoktur.

async function getPosts() {
  const query = `
    query GetPosts {
      posts {
        nodes {
          slug
          title
        }
      }
    }
  `;

  const res = await fetch('https://siteniz.com/graphql', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query }),
  });

  const json = await res.json();
  return json.data.posts.nodes;
}

Sonuç

Headless WordPress projelerinde WPGraphQL kullanmak, sadece bir tercih değil, projenin sürdürülebilirliği ve performansı için kritik bir karardır. Daha temiz kod, daha az ağ trafiği ve harika bir geliştirici deneyimi sunar.

graphqlwordpressapi
Blog'a Dön