Alanları Kullanım Dışı Bırakma
Bir GraphQL şemasını sürümlendirmek, alanları kullanım dışı bırakmayı, yani kullanıcıya bu alanın artık kullanılmaması gerektiğini ve hangi alanla değiştirilmesi gerektiğini söylemeyi içerir.
Alanları kod aracılığıyla kullanım dışı bırakmaya ek olarak, Gato GraphQL hangi alanların kullanım dışı bırakılacağını ve nasıl yapılacağını yapılandırmak için bir kullanıcı arayüzü sağlar.
Yapılandırma, bir alan kullanım dışı bırakma listesi aracılığıyla oluşturulur ve şema yapılandırması üzerinden özel endpoint'lere ve persisted queries'e iletilir.
Tüm alan kullanım dışı bırakma listelerine erişim
Eklentinin menüsünde "Field Deprecation Lists" seçeneğine tıklandığında, oluşturulan tüm alan kullanım dışı bırakma listelerinin listesi görüntülenir:
Yeni bir alan kullanım dışı bırakma listesi oluşturma
WordPress editörünü açmak için "Add New Field Deprecation List" düğmesine tıklayın:
Alan kullanım dışı bırakma listesine bir başlık verin, alanlarla birlikte girişler ekleyin ve kullanım dışı bırakma mesajını yapılandırın. Hazır olduğunuzda Publish düğmesine tıklayın. Ardından, yeni alan kullanım dışı bırakma listesi şema yapılandırması için kullanılabilir hale gelir.
Alan, şemada kullanım dışı olarak işaretlenecek ve ayrıca kullanım dışı bırakılmış bir alan sorgulandığında yanıtta kullanım dışı bırakma mesajı görüntülenecektir (Deprecation Notifier modülü etkinse).
Alan Kullanım Dışı Bırakma Girişleri
Her Field Deprecation List, aşağıdaki öğelere sahip bir veya daha fazla giriş içerir:
- Kullanım dışı bırakılacak alanlar
- Kullanım dışı bırakma mesajı
Arayüzlerden alan seçme
Türlerden gelen alanlara ek olarak, arayüzlerden de alan seçebiliriz. Bu durumda, kullanım dışı bırakma işlemi arayüzü uygulayan tüm türlerdeki bu alanlara uygulanır.
Alan kullanım dışı bırakma listesini açıklama
Alan kullanım dışı bırakma listesine bir açıklama eklemek için Document settings panelindeki "Excerpt" alanını kullanın.
Daha fazla bilgi için API'ye açıklama ekleme kılavuzuna bakın.
Alan kullanım dışı bırakma listesini kullanma
Alan kullanım dışı bırakma listesini oluşturduktan sonra, Custom Endpoint veya Persisted Query'nin bunu kullanmasını sağlamak için ilgili Şema Yapılandırmasını düzenleyin ve "Field Deprecation Lists" bloğunun altındaki listeden ACL'yi seçin.
Yapılandırma özelleştirilmezse, Ayarlar sayfasında "Field Deprecation" sekmesi altında tanımlanan varsayılan Field Deprecation Lists kullanılacaktır:
