Ayarlar API'sı ve Tema Özelleştirici

Ayarlar API'sını ne zaman kullanmak uygun olur ve tema özelleştiriciyi ne zaman kullanmak daha iyi olur?

Bütün sabah Googled yaptıktan sonra, bu konuda iyi düşünülmüş ve yakın zamanda bir rehber bulamadım. Söylemek için henüz erken olsa da, tema özelleştiricinin daha fazla Squarespace benzeri düzenleme özelliği getirmeye yönelik anlamlı bir ilk adım olduğunu hissediyorum . Herkes tema özelleştirici lehine ayarlar API günbatımı için herhangi bir plan biliyor mu? Hepimiz yavaşça ona doğru ilerlemeli miyiz, yoksa ayarlar API'sine bağlı kalsak daha iyi olur muyuz? Yan yana yaşayabilirler ve eğer öyleyse, sorumlulukların bölünmesi nerede olur?

settings-api theme-customizer

— Dre
kaynak

Yanıtlar:

Sorunun temeli kusurlu. Özelleştirici API bir değil seçenekleri API ziyade bir seçenek önizleme API. Özelleştirici API, iki API'den biri yoluyla eklenen mevcut ayarlar için kontrolleri kaydetmek için Ayarlar API'sına veya Tema Modları API'sine dayanır .

Özelleştirici değil - ve olamaz - kayıt / tanımlamak yeni zaten Ayarlar API veya Tema Değişiklikler API ya aracılığıyla tescil edilmemiş ayarları. Farklı bir yol söyledi: Özelleştirici API, ayarları doğrudan veritabanına eklemek veya doğrudan veritabanından almak için bir API değildir; Özelleştirici API'si , ayarları veritabanına kaydetmek veya veritabanından ayarları almak için Ayarlar API'sını veya Tema Modları API'sini kullanır.

Bu nedenle, Özelleştirici API, mevcut seçenek API'lerinden birine alternatif değildir ; bunun yerine, ayarlar sayfası için bir alternatiftir . Özelleştirici, bir ayarın Ayarlar API'sı veya Tema Modları API'sı aracılığıyla kaydedilip kaydedilmediğini umursamaz ve bu ayarlar Customzer'da karıştırılabilir ve eşleştirilebilir. Aslında, çoğu durumda, bu tür ayarları vardır özel başlık ve özel bir arka plan tema Değişiklikler vardır ve Site Başlık ve Açıklama Ayarlar API şunlardır: karma ve eşleşti.

Özelleştirici API'sı aracılığıyla ayarların ve denetimlerin nasıl kaydedildiğini tam olarak anlamak için Otto'nun mükemmel eğitimlerini okumanızı öneririz:

Dolayısıyla, soru belirtilen API'lerle ilgili değildir veya bu API'larla ilgili değildir. Uygun sorular / veya sorular:

Kullanım ya Settings API veya Tema Modlar API için mevcut ayarların kayıt yoluyla önizleme Özelleştirici API
Kullanım ya Özelleştirici API ya bir özel Tema'nın ayarları sayfası kullanıcıya izin vermek için yapılandırmak Tema seçenekleri .

— Chip Bennett
kaynak

Teşekkürler Chip. Hala % 100 seni takip etmiyorum , ama bana biraz daha konuya bakmam için yeterli verdin. Sanırım karışıklığım işlevsellikteki örtüşmeden ve isimlerdeki benzerlikten kaynaklanıyor. Farklı API'lerin kullanım durumlarını (daha soyut bir şekilde) açıkça belgeleyen sayfa var mı? Ben kodeks bakarak çok şansım olmadı; sadece API'yi uygulayan somun ve cıvatalara odaklanır.

— Dre

Biraz daha derinlemesine açıklamaya çalışmak için daha fazlasını ekledim. Ayrıca özellikle Otto'nun Özelleştirici eğiticilerine olan bağlantılara bakın; Sanırım bir şeyleri netleştirmeye yardımcı olacaklar.

— Chip Bennett

Siz baysınız.

— Dre

Bazen işler olabildiğince basit: Ayarlar API'sı Tema Özelleştirici değil . Her ikisi de farklı görevler için farklı şeylerdir.

Ayarlar API'sı

Ya bir eklenti yazıyorsunuz veya görsel geri bildirime ihtiyaç duymayan seçeneklere sahip olmayan bir temanız mı var? Bu seçenekle devam edin.

Tema Özelleştirici

Kullanıcının görebileceği görsel bir etkiye sahip seçeneklere mi ihtiyacınız var? Bu seçenekle devam edin.

— Kayser
kaynak

Bu benim ilk sonucumdu. Bununla birlikte, ikisi arasında, orijinal sorulara yol açan çok sayıda işlevsel çakışma vardır. Ayrıca, tema seçeneklerinin görsel olup olmadıklarına bağlı olarak iki konuma bölünmesi fikri, bir UX bakış açısından bana sorunlu geldiğini gösteriyor. Bu sana katılmıyorum demek değil; Ben sadece bu aşamada fikir istiyorum. Tüm konunun kendisi biraz bulanık. Belki de 'yükseklerden' iyi tanımlanmış bazı rehberler faydalı olabilir. Giriş için teşekkürler!

— Dre

@Dre Biraz yanlış anladığınızı tahmin edin: Görsel geri bildirime ihtiyaç duyan tek bir seçeneğiniz bile varsa, ThemeCustomizer ile gidin. Temel kural: Tema -> Tema Özelleştirici | Eklenti -> Ayarlar API'sı.

— kaiser

Genel bir kural olarak, tüm Tema tanımlı seçeneklerin sunum etkisi olmalıdır . :) Yani: Özelleştirme API gerektiriyor ya Ayarlar API veya Tema Modlar API var olmak için. Özelleştirme API'sı bu iki API'den biri için değil, özel bir Tema ayarları sayfası için bir alternatiftir .

— Chip Bennett

Özelleştiriciyle ilgili sorumluluklarınız var mı? Hem 3.5.1'de hem de 3.6'da (gövde) benim için oldukça mizaçlı görünüyor. Başlığı ve kapat / kaydet düğmelerini sık sık tıklamalara düzgün yanıt vermiyor ve bazen birkaç kez tıklatmak zorunda kalıyorum (ve daha çok bagajda). Bu hem FF'de hem de Chrome'da.

— t31os

@ t31os Bu sorunu daha önce de vardı, ama tutarlılık yoktu. Ama bir süredir denemedim. console.log()Tüm eylemlerinize öneriyorum, böylece neyin tetiklendiğini ve neyin kesintiye uğradığını görüyorsunuz. JavaScript hata ayıklaması kolay değil ...

— kaiser