Şablon fonksiyonları, veritabanından içerik çekmek için kullanılan tema fonksiyonlarıdır. Çekeceğiniz içerik, bloğunuzun başlığından, bir yazınızın başlığına, bir yorum formundan bir sayfa kenarının (sidebar) tamamına kadar her şey olabilir.

Bu fonksiyonlar:

• Değişkendirler, yönetim panelinizden yaptığınız her değişikliği yansıtırlar.
• Birden fazla tema dosyasında kullanılabilirler.
• Temanızın, daha anlaşılır ve daha küçük parçalardan oluşmasını sağlarlar.

Bir Şablon Fonksiyonu Nedir?

Basitçe, bir şablon fonksiyonu, WordPress’in geliştirdiği bir PHP fonskiyonudur. Bu fonksiyon, veritabanınızdan içerik çekmek için kullanılır ve parametreler alabilir.

Örneğin, get_header() fonksiyonu ile header.php dosyanızı sayfanıza dahil edebilirsiniz. Aynı şekilde get_footer() fonksiyonu ile de footer.php dosyanızı sayfanıza dahil edebilirsiniz.

Tabi ki, daha bir çok şablon fonksiyonu vardır:

• the_title() – Bir sayfanın ya da yazının başlığını getirir.
• bloginfo( 'name' ) – Bloğunuzun ya da sitenizin başlığını getirir.

Yukarıdaki belirttiğimiz, bloginfo() fonksiyonuna bakarsanız, fonksiyonun parantezleri içerisinde bir parametre göreceksiniz. Parametreler, iki şeyi yapmanızı sağlar:

1. Fonksiyonun, sadece parametrede belirttiğiniz kadar bilgi getirmesini sağlar.
2. Veritabanından çektiğiniz bilgiyi, belirli bir formatta/biçimde getirmesini sağlar.

Şablon Fonksiyonlarını Neden Kullanmalıyız?

Şablon fonkisyonlarının en büyük faydası, zamandan ve yerden tasarruf sağlamasıdır. İşimizi hızlandırırlar ve daha az kod yazmamızı sağlarlar. Bu, aynı zamanda, daha hızlı ve daha anlaşılır şablon dosyaları hazırlamamızı sağlar.

Örneğin, header.php dosyası, hemen hemen bütün şablon dosyalarınızda kullanmanız gereken bir şablon parçasıdır. Bu dosyayı, ihtiyaç duyduğunuzda sayfanıza dahil etmek, get_header() yazmak kadar kısa ve kolaydır. Bunun yanında, header.php dosyasında yaptığınız bütün değişiklikler de bu dosyanın dahil edildiği bütün şablon dosyalarına otomatik olarak yansıyacaktır.

Şablon fonksiyonlarını kullanmanın başka bir avantajı ise, size dinamik içerikler oluşturma fırsatı vermesidir. Mesela, sitenizin adını, yazdığınız bir yazının başlığını ya da içeriğini değiştirdiğinizde, bu değişiklikler şablon fonksiyonları yardımı ile bu içeriklerin kullanıldığı bütün sayfalarda otomatik olarak uygulanacaktır.

Şablon Fonksiyonları Nasıl Kullanılır?

Şablon fonksiyonlarını kullanmak çok basittir. Şablon dosyalarında, bu fonksiyonları, sadece bir satır PHP kodu yazarak kullanabilirsiniz. header.php sayfasını çağırmak aşağıdaki kadar basittir:

get_header();

Parametreler

Bazı şablon dosyaları size parametre girme şansı da tanır. Parametreler, veritabanından getireceğiniz içerik ile ilgili detaylardır.

Örneğin; bloginfo() şablon fonksiyonu size siteniz ile ilgili belli bilgileri getirmek için parametreler girme seçeneği sunar. Mesela; sitenizin adını çağırmak istediğinizde, bu fonksiyona name parametresini girmeniz yeterlidir:

bloginfo( 'name' );

Mesela; sitenizi çalıştıran WordPress versiyonunu öğrenmek için ise version parametresini kullanırsınız:

bloginfo( 'version' );

Tabi her şablon fonksiyonunun aldığı parametreler farklıdır.

Şablon Fonksiyonlarının Döngü İçinde Kullanımı

Bir çok şablon fonksiyonu, WordPress döngüsü içinde kullanılır. Yani, sitenizin bir çok sayfasını oluşturan içerikler, bu şablon fonksiyonlarını içeren WordPress döngüsü sayesinde oluşur.

Bir WordPress döngüsü şu şekilde başlar:

if ( have_posts() ) : // Eğer içerik varsa
 while ( have_posts() ) : // İçerikler bitene kadar
  the_post(); // İçerik

Şablon fonksiyonları, bu döngü bitmeden önce, yani başlangıcı ile sonu arasında kullanılmalıdır. Bir WordPress döngüsü şu şekilde biter:

endwhile; 
else :
   _e( 'Üzgünüm, aradığınız kriterlere uygun bir içerik bulunamadı.', 'textdomain' );
endif;

Döngü içinde kullanılması gereken şablon fonksiyonlarından bazıları şunlardır:

• the_content() : Yazınızın ana metnini getirir.
• the_excerpt(): Klasik editörlerde yazılmış yazıların ilk 55 kelimesini, Gutenberg editörü (blok editör) ile yazılmış yazıların özetini getirir ve “devamını oku” anlamına gelen (…) şeklinde bir link verir.
• next_post_link() – Görüntülenen sayfadaki yazıdan bir sonraki yazıya bir link verir.
• previous_post_link() – Sayfadaki yazıdan bir önceki yazıya link verir.
• the_category() – Yazının dahil edildiği kategorileri gösterir.
• the_author() – Yazının yazırını getirir.
• the_ID() – Sayfa ya da yazının id değerini getirir.
• the_meta() – Sayfa ya yazının özel alan bilgilerini getirir.
• the_shortlink() – Yazı ya da sayfalara ait, sitenin adını ve içeriğin id değerini içeren bir link oluşturur.
• the_tags() – İçeriğe ait etiketleri getirir.
• the_title() – İçeriğin başlığını getirir.
• the_time() – İçeriğin oluşturulma zamanını getirir ve getirdiği bu tarih, PHP diline ait, standart zaman fonksiyonları ile biçimlendirilebilir.

Yukarıdaki fonksiyonların çalışması için, global içerik nesnesinin (global $post) tanımlanmış olması gerekmektedir. Bu yüzden, bu fonksiyonlar, döngü içinde kullanılmalıdır.

Döngü İçinde Kullanılmak Zorunda Olmayan Şablon Fonksiyonları

Aşağıdaki gibi bazı şablon fonksiyonları da, döngü içinde kullanılmak zorunda değillerdir:

• wp_list_cats(): Kategorileri listeler.
• wp_list_pages(): Sayfaları listeler.
• bloginfo(): Bloğunuz ya da siteniz hakkında bilgiler getirir.
• get_header(): header.php dosyasını çağırır.
• get_footer(): footer.php dosyasını çağırır…

Bu fonksiyonları, sayfa kenarında, sayfa üstünde veya altında veya istediğiniz herhangi bir şablon dosyasında kullanabilirsiniz. Bu fonksiyonlar global içerik nesnesine ihtiyaç duymazlar.

WordPress’in kullandığı, bütün şablon fonksiyonlarının listesini şu adreste bulabilirsiniz.