Pengaturan API vs Penyesuai Tema

20

Kapan tepat menggunakan API pengaturan, dan kapan lebih baik menggunakan penyesuai tema?

Setelah Googled sepanjang pagi, saya belum dapat menemukan panduan yang dipertimbangkan dengan baik dan baru-baru ini tentang masalah ini. Meskipun masih terlalu dini untuk mengatakan, saya merasa bahwa penyesuai tema adalah langkah pertama yang sugestif untuk membawa lebih banyak fitur pengeditan seperti Squarespace . Apakah ada yang tahu tentang rencana untuk memundurkan API pengaturan demi penyesuai tema? Haruskah kita semua perlahan bergerak ke arah itu, atau lebih baik kita tetap berpegang pada pengaturan API? Bisakah mereka hidup berdampingan, dan jika demikian, di mana pembagian tanggung jawab berada?

settings-api theme-customizer Dre
sumber

Jawaban:

21

Premis pertanyaan itu cacat. The Customizer API bukanlah pilihan API, melainkan sebuah pilihan pratinjau API. API Customizer bergantung pada Pengaturan API atau API Mods Tema untuk mendaftarkan kontrol untuk pengaturan yang ada ditambahkan melalui salah satu dari dua API.

Customizer tidak - dan tidak bisa - menetapkan / mendaftarkan pengaturan baru yang belum didaftarkan melalui API Pengaturan atau API Mods Tema. Mengatakan dengan cara yang berbeda: API Customizer bukan API untuk menambahkan pengaturan langsung ke atau untuk mengambil pengaturan langsung dari database; melainkan, Customizer API menggunakan API Pengaturan atau API Mods Tema untuk menyimpan pengaturan ke, atau untuk mengambil pengaturan dari, basis data.

Dengan demikian, API Penyesuai bukan alternatif dari salah satu API opsi yang ada ; alih-alih, ini merupakan alternatif untuk halaman pengaturan . Penyesuai tidak peduli apakah suatu pengaturan didaftarkan melalui API Pengaturan atau API Mod Tema, dan pengaturan semacam itu dapat dicampur dan dicocokkan dalam Customzer. Bahkan, dalam kebanyakan kasus, pengaturan seperti itu dicampur dan dicocokkan: tajuk khusus dan latar belakang kustom adalah Mod Tema, dan Judul Situs dan Deskripsi adalah Pengaturan API.

Untuk memahami dengan tepat bagaimana pengaturan dan kontrol didaftarkan melalui API Customizer, saya sarankan membaca tutorial Otto yang sangat baik:

Jadi, pertanyaannya bukan / atau sehubungan dengan API yang ditentukan. Salah satu dari pertanyaan ini adalah:

  • Gunakan baik yang Settings API atau yang Tema Mods API untuk mendaftar pengaturan yang ada untuk pratinjau melalui API Customizer
  • Gunakan baik yang Customizer API atau sebuah halaman kustom Tema pengaturan untuk memungkinkan pengguna untuk mengkonfigurasi opsi tema .
Chip Bennett
sumber
Terima kasih Chip Saya masih belum 100% mengikuti Anda, tetapi Anda telah memberi saya cukup untuk pergi dan melihat ke masalah lagi. Saya pikir kebingungan saya berasal dari tumpang tindih dalam fungsionalitas dan kesamaan dalam nama. Apakah ada halaman yang secara jelas mendokumentasikan kasus penggunaan (dengan cara yang lebih abstrak) dari berbagai API? Saya belum beruntung melihat kode itu; itu hanya berfokus pada mur dan baut menerapkan API.
Dre
Saya telah menambahkan lebih banyak, untuk mencoba menjelaskan sedikit lebih mendalam. Lihat juga, khususnya, tautan ke tutorial Customizer Otto; Saya pikir mereka akan membantu memperjelas hal-hal.
Chip Bennett
Anda tuan adalah pria terhormat.
Dre
5

Sesederhana terkadang: API Pengaturan bukan Penyesuai Tema. Keduanya adalah hal yang berbeda untuk tugas yang berbeda.

Pengaturan API

Anda sedang menulis plugin atau memiliki tema yang tidak memiliki opsi yang tidak memerlukan umpan balik visual? Pergi dengan opsi ini.

Penyesuai Tema

Anda perlu memiliki opsi yang memiliki dampak visual yang harus dapat dilihat pengguna? Pergi dengan opsi ini.

kaisar
sumber
Ini adalah kesimpulan awal saya. Namun, ada banyak tumpang tindih fungsional antara keduanya, yang mengarah pada pertanyaan awal. Selain itu, gagasan untuk membagi opsi tema menjadi dua lokasi tergantung pada apakah mereka terlihat atau tidak menurut saya bermasalah dari sudut pandang UX. Bukan untuk mengatakan bahwa saya tidak setuju dengan Anda; Saya hanya meminta pendapat pada tahap ini. Seluruh topik itu sendiri agak suram. Mungkin beberapa panduan 'dari atas' yang didefinisikan dengan baik akan bermanfaat. Terima kasih atas masukan Anda!
Dre
@Apakah kira Anda salah membaca sedikit: Jika Anda bahkan punya satu opsi tunggal yang membutuhkan umpan balik visual, pergi dengan ThemeCustomizer. Jadi aturan praktisnya adalah: Theme -> Theme Customizer | Plugin -> Pengaturan API.
kaiser
Sebagai aturan umum, semua opsi yang ditentukan Tema harus memiliki dampak presentasi . :) Yang mengatakan: Kustomisasi API membutuhkan baik yang API Pengaturan atau yang Tema Mods API untuk eksis. API Kustomisasi bukan merupakan alternatif untuk salah satu dari dua API tersebut, tetapi merupakan alternatif untuk halaman pengaturan Tema khusus .
Chip Bennett
Apakah Anda memiliki masalah resposifitas dengan penyesuai? Tampaknya cukup temperamental bagi saya di kedua 3.5.1 dan bahkan lebih dalam 3.6 (trunk). Saya menemukan tombol tajuk dan tutup / simpan sering tidak merespons dengan benar terhadap klik dan terkadang harus mengkliknya beberapa kali (dan lebih banyak lagi di bagasi). Ini ada di FF dan Chrome.
t31os
@ t31os Punya masalah ini sebelumnya, tetapi tanpa konsistensi. Tetapi belum mencoba selama beberapa waktu. Saya sarankan untuk console.log()semua tindakan Anda sehingga Anda melihat apa yang dipicu dan apa yang mengganggu. Debugging JavaScript tidak mudah ...
kaiser