İşte blok eklentilerinin WordPress kancalarını, özellikle de WordPress 6.4'te sunulan yeni Blok Kancaları özelliğini nasıl kullanabileceğinin bir özeti:
1. Blok Kanca Prensipleri:
- Otomatik Yerleştirme: İçeriğe başka bir blok eklendiğinde bloklar otomatik olarak kendilerini konumlandırarak manuel ekleme ihtiyacını ortadan kaldırır.
- Görünürlük ve Kontrol: Eklenen blok düzenleyicide görünür ve kullanıcılar, özelleştirilmiş bir düzenleme deneyimine olanak tanıyacak şekilde otomatik ekleme üzerindeki kontrolü elinde tutar.
2. Sınırlamalar ve Hususlar:
- Blok Kancaları yalnızca değiştirilmemiş şablonlarda, şablon parçalarında ve temalar tarafından sağlanan desenlerde çalışır. Gönderi içeriğinde, değiştirilmiş şablonlarda/parçalarda veya kullanıcı tarafından oluşturulan kalıplarda çalışmazlar.
- WordPress 6.4'ten itibaren otomatik ekleme, özel kaydetme işlevine sahip bloklarla çalışmaz çünkü blok doğrulama hatalarına neden olabilir. Geliştiriciler uyumluluk için Dinamik blokları kullanmalıdır.
3. Blokları Kancalamanın İki Yolu:
A. 'block.json'u kullanarak:
- Üçüncü taraf bloğunu bağlamanın basit bir yolunu sunar, ancak esnekliği sınırlıdır.
- "block.json"daki "blockHooks" özelliği, bağlanan bloğun konumunun belirtilmesine olanak tanır (öncesi, sonrası, ilk çocuk, son çocuk).
B. 'hooked_block_types' filtresini kullanma:
- 'block.json'a kıyasla daha fazla esneklik sunarak şablona, şablon parçasına veya desene dayalı olarak koşullu bağlantıya izin verir.
- 'hooked_block_types' için geri çağırma işlevi, kancalı bloklar, konum, bağlantı bloğu ve bağlam gibi parametreleri alır.
4. Geliştiriciler için Dikkat Edilmesi Gerekenler:
- Kancalı bloklar Site Düzenleyicisinde görünecek ve kullanıcılara yerleşimleri üzerinde kontrol sağlayacak. Kullanıcı bir bloğu taşımak isterse geliştiriciler bloğun konumunu zorlayamaz.
- Statik blokların (özel kaydetme işlevleriyle) kancalanması, blok doğrulama hatalarına neden olabileceğinden önerilmez. Dinamik bloklar Blok Kancaları için tercih edilen seçimdir.
- Geliştiriciler, kancalı bloklarının mevcut WordPress sürümü ve onun Block Hooks API'si ile uyumlu olduğundan emin olmalıdır.
Özetle, WordPress 6.4 ve sonraki sürümlerdeki yeni Blok Kancaları özelliği, blok eklentilerinin bloklarını belirli konumlara otomatik olarak eklemeleri için güçlü bir yol sağlarken, kullanıcıların bu blokların Site Düzenleyicisi içindeki yerleşimini kontrol etmesine de olanak tanır.
Alıntılar:[1] https://github.com/WordPress/gutenberg/issues/54904
[2] https://kinsta.com/blog/wordpress-hooks/
[3] https://essential-blocks.com/block-hooks-everything-you-need-to-know/
[4] https://www.youtube.com/watch?v=ezPHiyhhaoQ
[5] https://developer.wordpress.org/block-editor/reference-guides/packages/packages-hooks/