WordPress'te WP_Query Sınıfı Nasıl Kullanılır?

WP_Query'yi nasıl kullanabilirsiniz?

Artık WP_Query'nin ne olduğunu ve tam olarak ne işe yaradığını biliyorsunuz. Bu güçlü aracı kullanabileceğiniz farklı durum senaryolarına göz atalım.

1. WP_Query'de Döngü Oluşturun

Öncelikle Loop'un ne olduğunu anlamalısınız. Verilerden gönderi verilerini almak ve web sitenizde görüntülemek için oldukça duyarlı olan WordPress'in bir parçasıdır. Temel olarak temanızın şablonlarına göre içeriğinizin nasıl görüneceğine karar vermeye odaklanır.

Döngü Web Sitesinde Neleri Gösterebilir?

Seçtiğiniz ayarlara bağlı olarak Döngü şunları görüntüleyebilir:

• Özel gönderi türleri ve özel alanlar
• Ana sayfanızda başlıklar ve kısa açıklamalar yayınlayın
• Tek bir gönderinin içeriği ve yorumları
• Şablon etiketlerini kullanan tek tek sayfaların içeriği

Daha iyi anlamanız için aşağıda basit bir Döngü yapısı verilmiştir.

Temel Döngü Örneği

<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// Display post content
endwhile;
endif;
?>

• Burada have_posts() işlevi mevcut herhangi bir gönderinin olup olmadığını kontrol eder.
• while ( have_posts() ) : the_post(); : Gönderiler varsa bu döngü her gönderi için çalışacak ve içeriğini gösterecektir.

Döngüyü WP_Query ile Özelleştirme

Bazen tüm gönderilerinizi görüntülemek istemezsiniz. Neyin gösterileceğini özelleştirmek için WP_Query'yi kullanabilirsiniz:

<?php
// The Query
$the_query = new WP_Query( $args );

// The Loop
if ( $the_query->have_posts() ) {
echo '<ul>';
while ( $the_query->have_posts() ) {
$the_query->the_post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// No posts found
}
/* Restore original Post Data */
wp_reset_postdata();
?>


Bu Özel Döngü Nasıl Çalışır?

• Sorguyu Ayarlamak : $the_query = new WP_Query( $args ); ayarladığınız parametrelere (yazı türü, kategori vb.) göre özel bir sorgu oluşturur.
• Döngüyü Çalıştırmak : if ( $the_query->have_posts() ) { ... } sorgunuzla eşleşen gönderilerin olup olmadığını kontrol eder. Varsa, her gönderinin başlığını bir listede görüntüler.
• Gönderi Verilerini Sıfırlama : wp_reset_postdata(); özel döngü çalıştırıldıktan sonra orijinal gönderi verilerinin geri yüklenmesini sağlar.

Özelleştirme Seçenekleri

WP_Query ile şunları yapabilirsiniz:

• Belirli bir kategori, yazar veya tarih aralığındaki yayınları göster
• Gönderileri belirli etiketlere veya özel alanlara sahip olarak görüntüleyin

2. WP_Query Argümanları

WordPress sitenizden belirli gönderiler almak istediğinizde WP_Query oluşturmanız ve bunun için dört temel bölümü eklemeniz gerekir:

• Sorgu Bağımsız Değişkeni : WordPress'e hangi verilerin alınacağını söyler.
• Sorgu : Veriyi getirmek için argümanı kullanır.
• Döngü : Her gönderiyi işler ve görüntüler.
• Veri Sıfırlama Sonrası : Döngü çalıştıktan sonra verileri sıfırlar.

Ancak WP_Query'nin en önemli bileşenlerinden biri, veritabanından almak istediğiniz belirli gönderinin çıkarılmasından sorumlu olan argümandır (genellikle WP_Query argümanları olarak adlandırılır).

Bu o kadar önemlidir ki, argüman tüm gönderileri göstermek yerine yalnızca belirli gönderileri gösterecek koşulları belirler.

Bir Argüman Örneği

• $args Satırı : Sorgu argümanınızı ekleyeceğiniz yer burasıdır.
• Yapı : Belirli parametreleri bir diziye koyarsınız. İşte temel bir örnek,

$args = array(
'parameter1' => 'value',
'parameter2' => 'value',
'parameter3' => 'value'
);

Spesifik Örnek

'WordPress Hataları' etiketli gönderileri görüntülemek istiyorsanız sorgu argümanınızı şu şekilde ayarlamanız gerekir:

$query = new WP_Query( array( 'tag' => 'WordPress Errors' ) );

Argüman Neden Önemlidir?

• Bağımsız Değişken Yok, İçerik Yok : Bir WP_Query bağımsız değişkeni eklemezseniz, WordPress hangi gönderilerin görüntüleneceğini bilemez. Sorgunuz veritabanından herhangi bir içerik getirmeyecektir.

3. WP_query parametrelerini ayarlayın

Parametreler WP_Query'yi kullanışlı ve güçlü kılan şeylerdir. Bunların çeşitliliği sayesinde herkesin veritabanı aramalarını filtrelemesi kolay hale geldi.

Örneğin, WordPress sitenizde belirli gönderileri göstermek istediğinizde WP_Query kullanırsınız ve doğru gönderiyi aldığınızdan emin olmak için parametreleri ayarlayabilirsiniz. Aklınızda başka bir soru olabilir. Parametreler Nelerdir?

Parametreler tıpkı WordPress'e veritabanından ne tür gönderiler alınacağını söyleyen talimatlar gibidir.

Ortak Parametre Örnekleri

Kullanabileceğiniz bazı genel parametreler şunlardır:

• kedi : Belirli kategorilerdeki gönderileri görüntüler.
• yazar : Bir veya daha fazla belirli yazarın gönderilerini gösterir.
• post_status : Devam eden, planlanmış, yayınlanmış veya silinmiş gönderileri gösterir.
• orderby : Gönderileri yazara, gönderi türüne, tarihe vb. göre sıralar.
• posts_per_page : Görüntülenecek gönderi sayısını ayarlar.
• tag : Belirli etiketlere sahip gönderileri gösterir.
• order : Gönderileri artan veya azalan düzende sıralar.
• post_type : Gönderilerin, sayfaların veya özel gönderi türlerinin gösterilip gösterilmeyeceğini tanımlar.

Parametreler Nasıl Kullanılır

Belirli bir kategorideki gönderileri göstermek istiyorsanız category_name parametresini kullanabilirsiniz. İşte bir örnek:

$query = new WP_Query( array( 'category_name' => 'WordPress' ) );

Bu, “personel” kategorisindeki ve alt kategorilerdeki tüm gönderileri gösterecektir.

Daha Karmaşık Örnek

Bu örnekte, tam olarak istediğiniz gönderileri almak amacıyla karmaşık ve özelleştirilmiş bir sorgu oluşturmak için farklı argümanlardaki birden çok değeri nasıl kullanabileceğinizi gösteriyoruz.

Belirli kategorilerdeki, belirli etiketlere sahip, belirli yazarlar tarafından yazılan ve tarihe göre azalan düzende sıralanan gönderileri alacağız.

$args = array(
'category__in' => array(5, 10), // Categories with IDs 5 and 10
'tag__in' => array('featured', 'popular'), // Posts tagged with 'featured' or 'popular'
'author__in' => array(1, 2), // Authors with IDs 1 and 2
'orderby' => 'date', // Order by date
'order' => 'DESC', // In descending order
'posts_per_page' => 10 // Limit to 10 posts
);

$query = new WP_Query($args);

// The Loop
if ($query->have_posts()) {
while ($query->have_posts()) {
$query->the_post();
// Display post content
the_title('<h2>', '</h2>');
the_excerpt();
}
} else {
// No posts found
echo 'No posts found';
}

// Restore original Post Data
wp_reset_postdata();


• categor__in : Kimlikleri 5 ve 10 olan kategorilerden gönderiler istediğimizi belirtmeye yardımcı olur.
• tag__in : Gönderilerin 'öne çıkan' veya 'popüler' ile etiketlenmesini istediğimizi belirtir.
• Author__in : Kimlikleri 1 ve 2 olan yazarların gönderilerini istediğimizi belirtir.
• orderby : Gönderileri yayınlandıkları tarihe göre sıralamak istediğimizi belirtir.
• order : Gönderilerin azalan sırada (en yenisi önce) olmasını istediğimizi belirtir.
• posts_per_page : Alınan gönderi sayısını 10 ile sınırlar.

4. Nesneleri Yöntemler ve Sınıf Özellikleriyle Değiştirin

WordPress'te WP_Query , veritabanından gönderileri almak için kullanılan özel bir PHP sınıfıdır. Bunu, web sitenizde göstermek istediğiniz gönderileri tam olarak almanıza yardımcı olan bir araç olarak düşünün.

Sınıf Özellikleri ve Yöntemleri Nelerdir?

PHP'de bir sınıfın özellikleri (değişkenler gibi) ve yöntemleri (fonksiyonlar gibi) olabilir. İşte bunları anlamanın basit bir yolu:

• Özellikler : Bunlar bilgi içeren kaplar gibidir. WP_Query bağlamında özellikler, gönderi listesi veya bulunan gönderi sayısı gibi şeyleri içerebilir.
• Yöntemler : Bunlar gerçekleştirebileceğiniz araçlara veya eylemlere benzer. WP_Query yöntemler, gönderi olup olmadığını kontrol etmenize, gönderinin başlığını almanıza veya sorguyu sıfırlamanıza yardımcı olabilir.

Özellikleri Doğrudan Değiştirebilir misiniz?

Hayır, özellikleri Doğrudan değiştiremezsiniz, Geliştiriciler bile bunu kesinlikle önermiyor, Ancak alternatif olarak Yöntemleri kullanabilirsiniz.

Yöntemler tıpkı doğru yolu izlemenize yardımcı olan resmi araçlar veya komutlar gibidir. Bunlar tam olarak işlevler gibi çalışır; WP_Query yöntemlerinde belirli değişiklikler yaptığınızda, getirilen verileri de özelleştirebilirsiniz.

WP_Query'de Yöntem Kullanma Örneği

Bu örnekte, reset_postdata() işlevi WP_Query'nizi yazmada kritik bir adım olabilir. Bu yöntem $current_post ve $post'un özelliklerini sıfırlayacaktır.

<?php
// Create a new query with specific arguments
$the_query = new WP_Query(array(
'post_type' => 'post',
'posts_per_page' => 5,
'category_name' => 'news',
));
?>

<?php if ($the_query->have_posts()) : ?>
<!-- Display the posts -->
<?php while ($the_query->have_posts()) : $the_query->the_post(); ?>
<h2><?php the_title(); ?></h2>
<p><?php the_excerpt(); ?></p>
<?php endwhile; ?>
<!-- Reset the post data to avoid conflicts -->
<?php wp_reset_postdata(); ?>
<?php else : ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>


Bozulma:

• Sorgu Oluşturma :
  • $the_query = new WP_Query($args); : Sağladığınız argümanlarla yeni bir WP_Query nesnesi oluşturur.
• Gönderiler kontrol ediliyor :
  • if ($the_query->have_posts()) : Sorgunuza göre gösterilecek gönderi olup olmadığını kontrol eder.
• Gönderiler Arasında Döngü :
  • while ($the_query->have_posts()) : $the_query->the_post(); : Gönderi verilerini görüntüleyebilmeniz için ayarlar.
• Gönderiler Görüntüleniyor :
  • the_title(); ve the_excerpt(); : Geçerli gönderinin başlığını ve alıntısını görüntüler.
• Gönderi Verilerini Sıfırlama :
  • wp_reset_postdata(); : Genel gönderi verilerini ana sorgunun gönderisine sıfırlar. Bu, sayfanızın diğer bölümlerini karıştırmamak için önemlidir.

Kullanabileceğiniz Genel Yöntemler

WP_Query sorgunuzla çalışmak için kullanabileceğiniz bazı yaygın yöntemler şunlardır:

• get_posts :
  • Ne İşe Yarar : Gönderilerin listesini alır.
  • Örnek :phpCopy code $posts = get_posts(array('category' => 'news'));
• have_posts :
  • Ne İşe Yarar : Görüntülenecek gönderi olup olmadığını kontrol eder.
  • Örnek :phpCopy code if ($the_query->have_posts()) { // There are posts to show }
• the_post :
  • Ne İşe Yarar : Geçerli gönderi verilerini ayarlar.
  • Örnek :phpCopy code $the_query->the_post();
• fill_query_vars :
  • Ne İşe Yarar : Eksik sorgu ayrıntılarını tamamlar.
  • Örnek :phpCopy code $the_query->fill_query_vars($args);

WP_Query'ye doğru bilgileri sağlayarak onu farklı görevleri gerçekleştirecek şekilde özelleştirebilirsiniz. Bu yöntem, sınıf özelliklerini ayarlamanın esnek ve güvenli bir yoludur.

WP_Query Vs query_posts(): Hangisi tercih edilir?

Aşağıda, WordPress'te WP_Query ve query_posts() karşılaştırmasının ayrıntılı bir karşılaştırma tablosu bulunmaktadır; bu tablo, WP_Query neden genellikle query_posts() yerine tercih edildiğini anlamanıza yardımcı olabilecek bazı ana noktaları içerir:

WP_Query Kullanımına Bazı Örnekler

WP_Query'yi ve pratik kullanımını daha iyi anlamak için aşağıda verilen Örneklerden bazılarına göz atın:

1. Bu Hafta Yayınlanan Son Gönderileri Göster

İyi bir kullanıcı tabanınız veya makul miktarda web trafiğiniz varsa, bu, ziyaretçilerinizin içeriğinizi beğendiği ve sitenizde yayınlanan en son makaleleri okumak isteyeceği anlamına gelir.

Web sitenizi tasarlarken, son gönderileri web sayfasının özel bir bölümünde öne çıkarabilirsiniz. Neyse ki WP_Query ile tarih parametrelerine dayalı gönderileri kolayca bulabilirsiniz. Nasıl olduğunu görelim.

<?php
$arguments = array(
"date_query" => array(
array(
"year" => date( "Y" ),
"week" => date( "W" ),
)
)
);
$posts = new WP_Query($arguments);
?>


Bu örnekte, içinde bulunduğumuz haftada yayınlanan gönderileri bulmak için bir WP_Query oluşturuyoruz. Arama kriterlerimizi belirtmek için WP_Query'nin date_query adlı özel bir bölümünü kullanıyoruz.

Sorgunun asıl amacı mevcut hafta boyunca yayınlanan gönderileri bulmaktı. Bunun için, gönderileri tarihlere göre aramak için date_query parametresini kullandık. Tarihle ilgili bir dizi argüman alır.

Yani date_query parametresini özelleştirdiğinizde yakın zamanda yayınlanan gönderileri getirebilir ve görüntüleyebilirsiniz. Ancak sorguyu daha etkili hale getirmek ve geçen hafta yazılan en son makaleleri vurgulamak için özel değerler de belirtebilirsiniz.

2. Belirli Kategorideki En Son Gönderiyi Göster

Web sitenizin ziyaretçileri sıklıkla en yeni bilgileri arayabilir ve etkileşimi ve sayfa görüntülemelerini artırmak için, beğenebilecekleri daha fazla ilgili yayın önermek iyi bir uygulamadır.

Her ne kadar WordPress'te ilgili gönderileri bağlamanın birçok yolu olsa da, WP_Query bunu yapmanın etkili yollarından biridir. Özellikle her zaman güncel içerik yayınlayan web sitesi için harika bir yol.

Örneğin, birisi WordPress Hataları ile ilgili bir makale okursa, WP_Query diğer benzer ve yeni makalelerin gösterilmesine yardımcı olabilir.

Dolayısıyla, belirli bir kategorideki en son gönderileri getirmek istiyorsanız bu WP_query'yi kullanın ve site bilgilerinizi içeren küçük düzenlemeler yapın:

<?php

// Get the current post id.
$current_post_id = get_the_ID();

// Get the current post's category (first one if there's more than one).
$current_post_cats = get_the_category();
$current_post_first_cat_id = $current_post_cats[ 0 ]->term_id;

// Setup arguments.
$args = array(
// Get category's posts.
'cat' => $current_post_first_cat_id,
// Exclude current post.
'post__not_in' => array( $current_post_id )
);

// Instantiate new query instance.
$my_query = new WP_Query( $args );

?>

3. Aynı Yazarın ve aynı Kategorideki gönderilerini gösterin

Ziyaretçi içeriğinizi beğeniyorsa yazarın görüşlerini, yazım tarzını, algısını da beğenmesi kuvvetle muhtemeldir.

Bunun için okuyucularınıza aynı yazarın yazdığı benzer yazıları önermek için WP_Query'yi kullanabilirsiniz. Sorgu, geçerli gönderiyle aynı kategori için aynı yazar tarafından yazılan gönderileri arayacaktır.

Bunun için benzer yazarlara ve aynı kategoriye sahip gönderileri arayacak belirli bir WP_Query dizesi oluşturmamız gerekiyor.

İşte kod:

<?php
$arguments = array(
"author_name" => "Rahul",
"category_name" => "WordPress",
"posts_per_page" => 3,
);
$posts = new WP_Query($arguments);
?>


Yukarıdaki kodda “Rahul”u yazarın adıyla, “WordPress”i ise kategori adıyla değiştirmeniz gerekir.

4. En popüler Gönderilerinizi gösterin

Tıpkı okuyucularınız için görüntülediğiniz En Son veya En Son gönderiler gibi. Okuyucularınızın çok beğendiği ve ilgi duyduğu konulardaki gönderileri de göstermek isteyebilirsiniz. Bunu başarmak için orderby parametresini kullanabilir ve bunu comment_count argümanına iletebilirsiniz.

<?php
$arguments = array(
"category_name" => "WordPress Errors",
"orderby" => "comment_count",
"posts_per_page" => 5,
);
$posts = new WP_Query($arguments);
?>

Yukarıdaki WP_Query, "WordPress Hataları" kategorisindeki gönderileri arayacak ve sonuçları, her gönderinin sahip olduğu yorum sayısına göre filtreleyecektir.

Çıktı, en çok yorum alan beş gönderiyi, en yüksek etkileşime sahip gönderiden başlayarak en düşük gönderiyle biten, soldan sağa doğru azalan sırada görüntüleyecektir.

Çözüm

Artık WP_Query'nin ne kadar güçlü olduğuna ve WordPress'te veritabanı isteklerini gerçekleştirmenizi nasıl kolaylaştırdığına tanık oldunuz. Ayrıca sitenizi özelleştirme esnekliği sağlar ve ziyaretçilerinize benzersiz bir deneyim sunar.

WP_Query'yi kullanmak için şunları yapabilirsiniz:

• Döngü Oluşturun: Gönderilerinizi görüntüleyin.
• Sorgu Bağımsız Değişkenlerini Kullan: Aramalarınızı özelleştirin.
• Belirli Parametreleri Ayarlayın: Sonuçlarınızı filtreleyin.
• Sınıf Özelliklerini Değiştirin: Sorgu sonuçlarını yöntemlerle ayarlayın.

Tüm bu tekniklerde uzmanlaştıysanız popülerlik ve tarih gibi çeşitli faktörlere dayalı olarak belirli gönderileri kolayca önerebileceksiniz.

Bu teknik, kullanıcının etkileşimini artırmaya, kullanıcı deneyimini geliştirmeye ve ayrıca sadık ziyaretçilerinizin daha alakalı içerik bulmasına yardımcı olur.

WP_Query ile ilgili hâlâ şüpheleriniz varsa veya gözden kaçırmış olabileceğimiz daha fazla içerik eklemek istiyorsanız. Lütfen aşağıdaki yorum bölümünde bize bildirin.

Rahul

Rahul Kumar, WordPress ve web barındırma konusunda uzmanlaşmış bir web tutkunu ve içerik stratejistidir. Yılların deneyimi ve sektör trendlerini takip etme kararlılığıyla trafiği yönlendiren, etkileşimi artıran ve dönüşümleri artıran etkili çevrimiçi stratejiler oluşturuyor. Rahul'ın ayrıntılara olan ilgisi ve ilgi çekici içerik oluşturma yeteneği, onu çevrimiçi varlığını geliştirmek isteyen her marka için değerli bir varlık haline getiriyor.