Özel taksonomiler

Bir taksonomi, içeriği gruplamanın bir yoludur. WordPress'te iki yerleşik taksonomi vardır: Categories ve Tags. Özel bir taksonomi, Kitaplar için Türler ya da Etkinlikler için Şehirler gibi kendi gruplamanızı ekler. Bir taksonomideki her girdi bir terimdir (örneğin "Fantezi").

Taksonomiler her planda kullanılabilir. Özel yazı türleri dahil her yazı türünde çalışır.

İki biçim vardır:

Nerede bulunur

WPM Fields › Taxonomies ekranını açın. Listede şu sütunlar bulunur: Key, Plural label, Post types, Status ve REST API. Düzenlemek için bir satıra tıklayın; yeni oluşturmak için Add taxonomy düğmesini kullanın.

Taksonomi oluşturma

1. Add taxonomy düğmesine tıklayın.
2. Plural label ("Genres") ve Singular label ("Genre") alanlarını doldurun.
3. Taxonomy key değerini kontrol edin (siz düzenleyene kadar tekil etiketten otomatik doldurulur).
4. Post types altında taksonominin ait olduğu her türü işaretleyin. Varsayılan Post türüdür.
5. Kategori tarzı için Hierarchical seçeneğini işaretleyin; etiket tarzı için kapalı bırakın.
6. Create taxonomy düğmesine tıklayın. "Taxonomy created." mesajını görürsünüz.

Yeni taksonomi, seçilen her yazı türünün menüsü altında (veya Posts menüsünde) ek bir ekran olarak görünür.

Basics bölümü

Anahtar kuralları

Bir sorun olduğunda şu mesajları görürsünüz:

• "Taxonomy key is required."
• "Taxonomy key must be 1–20 characters: lowercase letters, numbers, hyphens, underscores only."
• "A taxonomy with this key already exists in Mass Custom Fields."
• "This taxonomy key is reserved by WordPress." Çekirdek taksonomiler (category, post_tag, post_format, nav_menu, link_category ve diğerleri) ile ayrılmış sorgu sözcükleri (type, name, year, term, tag, search ve benzerleri) reddedilir.
• "This taxonomy is already registered by WordPress or another plugin."
• Post type "key" does not exist. İşaretlediğiniz bir yazı türü etkin değil veya kayıtlı değil.

Advanced sekmeleri

General

Varsayılan terim, taksonomiyi kaydettikten sonraki ilk kayıt işleminde oluşturulur.

Labels

Yazı türlerindekiyle aynı davranış: 24 etiket alanı oluşturulan varsayılanı gri yer tutucu olarak gösterir, boş bir alan varsayılanı kullanır, Regenerate from labels hepsini varsayılanlarla doldurur (ve geçersiz kılma değeri olarak saklar), Clear overrides ise boşaltır. Bkz. General and Labels.

Anahtarlar: name, singular_name, menu_name, all_items, edit_item, view_item, update_item, add_new_item, new_item_name, parent_item, parent_item_colon, search_items, popular_items, separate_items_with_commas, add_or_remove_items, choose_from_most_used, not_found, no_terms, items_list_navigation, items_list, most_used, back_to_items, item_link, item_link_description.

Visibility

Meta box seçenekleri:

Özel bir geri çağrı, bir WordPress meta kutusu işlevi (post_categories_meta_box, post_tags_meta_box) olmalı veya wpmcf/taxonomies/allowed_callbacks filtresiyle izin verilmelidir. Aksi halde kaydetme "Meta box callback must be a WordPress meta box function or one allowed by the wpmcf/taxonomies/allowed_callbacks filter." hatasıyla başarısız olur. Meta box sanitization callback (optional) alanı da aynı kurala tabidir.

add_filter( 'wpmcf/taxonomies/allowed_callbacks', function ( array $allowed, string $arg ) {
	if ( 'meta_box_cb' === $arg ) {
		$allowed[] = 'my_genre_meta_box';
	}
	return $allowed;
}, 10, 2 );

URLs

URL'leri değiştirmek, bir sonraki sayfa yüklemesinde çalışacak bir yeniden yazma temizliği (rewrite flush) planlar. Settings › Permalinks ekranını yeniden kaydetmeniz gerekmez. Bkz. Custom post types.

REST API

Yazı türleriyle aynı dört alan: Show in the REST API (On), REST base, REST namespace (wp/v2) ve REST controller class (optional). Blok düzenleyicinin taksonomi panelini göstermesi için Show in the REST API açık olmalıdır. Bkz. Permissions and REST API.

Permissions

Yetki adları küçük harflere, rakamlara, tirelere ve alt çizgilere göre temizlenir. Bir işlem için WordPress'in varsayılanını korumak istiyorsanız alanı boş bırakın.

Taksonomiyi bir yazı türüne bağlama

Eşdeğer iki yol vardır:

• Taksonomide: Post types altındaki yazı türlerini işaretleyin.
• Yazı türünde: General sekmesindeki Taxonomies altında taksonomiyi işaretleyin (General and Labels). Yerleşik Categories veya Tags taksonomilerini özel bir türe eklemenin yolu da budur.

Taksonomiler her istekte yazı türlerinden önce kaydedilir; bu nedenle ikisi de kaydedildikten sonra oluşturulma sırasının önemi yoktur. Ancak kaydetme anında ikisi de mevcut olmalıdır: etkin olmayan veya henüz var olmayan bir yazı türüne taksonomi bağlayamazsınız.

Düzenleme, devre dışı bırakma ve silme

• Düzenleme: anahtar dışındaki her şey. Save changes düğmesine tıklayın; "Taxonomy saved." mesajını görürsünüz.
• Active kapalı: taksonomi artık kaydedilmez. Terimler ve atamaları veritabanında kalır ancak kullanılamaz.
• Silme (çöp kutusu simgesi): "This removes the registration for «key». Terms and assignments may remain in the database." Mevcut terimler silinmez. Onları geri getirmek için aynı anahtarla bir taksonomi yeniden oluşturun.

Terimleri sitenizde kullanma

Taksonomiler WordPress'e kaydedilir, bu nedenle olağan işlevler çalışır:

$terms = get_terms( array( 'taxonomy' => 'genre', 'hide_empty' => false ) );

$books = new WP_Query( array(
	'post_type' => 'book',
	'tax_query' => array(
		array( 'taxonomy' => 'genre', 'field' => 'slug', 'terms' => 'fantasy' ),
	),
) );

Terimlerde ek veri saklamak için Taxonomy konum kuralıyla bir alan grubu oluşturun; bkz. Field groups.

Hook'lar

wpmcf/taxonomies/before_register, wpmcf/taxonomies/register_args, wpmcf/taxonomies/after_register ve wpmcf/taxonomies/allowed_callbacks yazı türlerindeki karşılıkları gibi çalışır. Bkz. Hooks.

Sorun giderme

Taksonomi düzenleyicide görünmüyor. Active, Show in admin ayarlarını, yazı türünün işaretli olduğunu ve Meta box değerinin "None" olmadığını kontrol edin. Blok düzenleyici için Show in the REST API açık olmalıdır.

"Post type … does not exist." Yazı türü etkin değil, silinmiş veya aynı anda oluşturuluyor. Önce yazı türünü kaydedin, sayfayı yenileyin, ardından bağlayın.

Terim sayfaları 404 döndürüyor. Kalıcı bağlantı yapısı Plain, slug bir sayfayla çakışıyor veya Publicly queryable kapalı. Bir değişiklikten sonra sonraki sayfa yüklemesini bekleyin.

Varsayılan terim görünmüyor. Kaydettikten sonra yönetim panelini bir kez yenileyin; terim sonraki kayıt işleminde oluşturulur.