Kancaları Özel İşlevlerde Kullanma Kılavuzu
Yayınlanan: 2013-03-29Kancaların karmaşık olduğunu düşünebilirsiniz, bu anlaşılabilir bir durumdur çünkü onlara ilk baktığımda ben de öyle düşündüm!
Gerçek şu ki, kancaları anlamak çok kolaydır.
Onları kullandığınız özel işlev biraz daha karmaşıktır.
Kancalarla ilgili bu başlangıç kılavuzunda, kancaların ne olduğuna ve ne yaptıklarına ilişkin temel bilgilere ve bunların temanızdaki farklı konumlardaki içeriği görüntülemek için nasıl kullanılacağına bakacağız.
Kanca Nedir?
Kancalar, tema şablon dosyalarınızdaki bir nokta veya konumdur.
Hangi temada kullanıldıklarına bağlı olarak onlara açıklayıcı isimler verilir:
- woo_post_after - Tüm tek gönderilerden sonra çalışan Woo temalarına özel kanca
- genesis_after_header - Tek gönderilerden sonra yürütülen Genesis'e özgü tema kancası
- wp_footer – Tüm temalarda alt bilgiden sonra çalışan WordPress kancası.
Genesis'te farklı kancaların nerede bulunduğunu anlamanın en kolay yolu, tüm kanca konumlarını içeren görsel bir kanca kılavuzu görüntülemektir.
Genesis_after_header , tüm sayfalarda başlıktan sonra çalışan Genesis alt temalarında (StudioPress) kullanılan bir kancadır.
İçeriğinizi, başlığınızı görüntülemek için kullanılan ana temalar header.php dosyasına eklemek yerine, içeriği alt tema dosyalarınıza özel bir işleve ekleyebilirsiniz.
woo_before_header , Woo temalarında çalışan ve ana temalar header.php'de bulunan bir kancadır.
Ana tema şablonları dosyalarını düzenlemek yerine, alt temalarınız function.php'ye kod ekleyerek o konumdaki içeriği görüntülemek için kancayı kullanabilirsiniz.
WordPress Kancaları
wp_footer , genesis_after_post ve woo_header gibi temaya özel kancaların aksine herhangi bir temada çalışan bir WordPress kancasıdır.
Çekirdek WordPress dosyalarındaki footer.php dosyasını düzenlemek yerine, wp_footer kancasının footer.php şablon dosyasında bulunduğu konumda içeriği bağlamak (görüntülemek) için özel bir işlevde wp_footer kancasını kullanabilirsiniz.
Görsel Kanca Haritaları
Her tema geliştiricisi, normalde, her bir kancanın tam olarak nerede yürütüldüğünün bir haritasını, kancaların listesi ve temanızda nerede çalıştıklarının bir açıklamasıyla birlikte sağlar.
- Woo Temaları Görsel Kanca Haritası
- Genesis Görsel Kanca Kılavuzu
- Tez Görsel Kanca Referansı
Ana tema şablon dosyaları ve WordPress şablon dosyaları, farklı tema geliştiricilerinin her bir şablon dosyasının farklı konumlarına eklediği kancaları içerir.
Ardından, temanızdaki o belirli kanca konumunda içeriği görüntülemek için özel bir işleve ekleyebileceğiniz bu kancaların bir listesini sağlarlar.
Şablon Dosyalarındaki Kancalar
Geleneksel olarak, içeriği web sitenizde belirli bir konumda görüntülemek istiyorsanız, içeriği HTML, Metin veya PHP kullanarak doğrudan ana tema şablon dosyalarınıza eklemeniz gerekir. (Ve bazı insanlar hala yapıyor!)
Kancalarla, içeriğinizi herhangi bir şablon dosyasına eklemeniz gerekmez.
Bunun nedeni, her şablon dosyasının, ana tema dosyalarını hacklemek yerine bir alt tema işlevleri dosyasında basitçe başvurabileceğiniz birkaç kanca içermesidir.
Bu işlev, içeriğinizi, kancanın çekirdek şablon dosyalarında bulunduğu konuma bağlayarak görüntüler.
Genesis Dosyalarındaki Kancalar
Not: Temel Genesis dosyalarını asla düzenlememelisiniz ve buna hiç gerek duymamalısınız.
Ana tema şablon dosyalarında eylem kancalarının nerede olduğuna bir göz atalım.
Aşağıda, ana ana tema dosyalarında bulunan Genesis header.php şablon dosyasının bir görüntüsü bulunmaktadır.
Kancaların sağında katmanlı görsel kanca görüntüsünde de görebileceğiniz başlık kancalarını içerir.
Ayrıca orada başka bazı oluşum kancaları ve ayrıca belirli eklentileri takmak için gereken bir WordPress kancası olduğunu fark edeceksiniz.
İsterseniz WordPress kancasını bir işlevde kullanabilirsiniz ve işlev, tümü WordPress kancaları içerdiğinden tüm temalarda çalışır.
Aksiyon Kancalı Fonksiyonlar #
Genesis alt temalarında herhangi bir kanca konumunda metin görüntüleyen çok temel bir özel işleve bakalım.
İçerikten önce metni görüntülemek için kullandığımız kanca, genesis_after_header kancası olarak adlandırılır.
Bunu, oluşturduğumuz işlevin ne yaptığını açıklayan ve bu durumda content_after_header olarak adlandırılan temel bir işlevle birlikte ekledik.
Ayrıca, gerekirse kanca konumundaki metni biçimlendirebilmemiz için benzersiz bir div sınıfı ekleriz. Bu durumda onu after-header olarak adlandırdık.
Ve alt temalar style.css dosyasında, bu kanca konumundaki içeriği şu şekilde biçimlendirmek için bu yeni sınıfı kullanabiliriz:
.after-header { background: grey; border: solid 3px #222; padding: 10px; }
Genesis Simple Hooks Eklentisi
Genesis Simple Hooks eklentisinde bulunan kanca alanları aracılığıyla başlık kancalarına bakmanın başka bir yolu.
Genesis'te kancaların nasıl kullanılacağını öğrenmek için çok iyi bir adım, Genesis Simple Hooks eklentisini kullanmaya başlamaktır.
Bu eklenti, belirli bir kanca konumunda yürütülecek HTML, metin, kısa kodlar veya PHP kodunu kolayca yapıştırmanıza olanak tanır.
Bu, Genesis'te her bir kancanın nerede bulunduğu ve bu konumlarda farklı içerik türlerinin nasıl görüntüleneceği hakkında daha fazla bilgi edinmenin mükemmel bir yoludur.
PHP kodunu PHP etiketlerine sardığınız sürece, basit kancalar kullanarak herhangi bir kanca konumunda PHP kodunu çalıştırabilirsiniz:
Yukarıdaki kod, Simple Hooks eklentisi kullanılarak bir genesis_hook alanına yapıştırıldığında, yalnızca ana sayfada bir görüntü kaydırıcısı çıkaracaktır.
Özel İşlevler ve Koşullu Etiketlerle Kancaları Kullanma
Tüm kanca adlarını ve yürüttükleri konumları öğrendikten sonra, kancaları özel işlevlerde kullanmaya geçebilir ve yalnızca ana sayfa gibi belirli koşullara dayalı olarak içeriğinizi bir kanca konumunda yürütmek için bunları koşullu etiketlerle birleştirebilirsiniz. veya yalnızca tek gönderiler.
Bu kod, metninizi yalnızca tek gönderilerdeki tüm gönderi başlıklarından önce görüntüler.
Blogunuz, eviniz veya kategori arşivleriniz gibi arşiv sayfalarındaki metni görüntülemez ve metni statik sayfalarda görüntülemez.
Kancalarla Daha Fazla Özel İşlev
- Ana Tema Geliştirme için Eylem Kancaları
- Yeni Başlayanlar için Kancalar ve Filtreler Kılavuzu