Memperluas Plating Kustomizer Tema WordPress

  1. 1. Pengantar Penyesuai Tema WordPress
  2. 2. Berinteraksi dengan WordPress Theme Customizer
  3. 3. Kustomizer Boilerplate Tema WordPress
  4. 4. Sedang membaca: Memperluas Plating Kustomizer Tema WordPress
  5. 5. Tema Customizer Boilerplate – Opsi Bersyarat, Tema dan Plugin Anak

Bagian 3 dari seri Theme Customizer memperkenalkan Anda ke Theme Customizer Boilerplate yang memungkinkan Anda menyederhanakan kode yang menangani opsi tema Anda. Yang perlu Anda lakukan adalah melewati array bidang opsi dan boilerplate akan mengurus pendaftaran bagian Customizer Tema, pengaturan dan kontrol untuk Anda di belakang layar.


Sampai sekarang, boilerplate memungkinkan Anda untuk menggunakan bidang teks, kotak centang, tombol radio dan pilih bidang di Theme Customizer, artikel ini menunjukkan kepada Anda bagaimana Anda dapat memperluasnya.

Catatan: Sebelum melanjutkan, silakan unduh versi terbaru WordPress Theme Customizer Boilerplate dari repositori Github-nya. Saya telah membuat beberapa perbaikan sejak tutorial terakhir, dan penting bahwa kode Anda terbaru. Lihatlah posting sebelumnya untuk lebih banyak catatan tentang perubahan, tetapi singkatnya, begitu Anda menyalin pelat ke folder tema Anda, Anda tidak perlu mengedit file sama sekali – semua pengeditan dilakukan menggunakan filter dan kait tindakan.

Menghubungkan ke Tema Customizer Boilerplate

Ada beberapa kait tindakan dan filter di WordPress Theme Customizer Boilerplate. Anda dapat menghubungkan salah satu dari mereka dari file functions.php tema Anda dengan menggunakan add_action dan add_filter fungsi:

  • ‘Thsp_cbp_directory_uri’ – Filter hook didefinisikan dalam helpers.php, memungkinkan Anda untuk mengubah lokasi Customizer Boilerplate di folder tema Anda. Secara default, jalur boilerplate terlihat seperti ini – get_template_directory_uri (). ‘/ Penyesuai-boilerplate’ – tetapi jika Anda lebih suka memindahkannya ke lokasi khusus, ini adalah pengait yang dapat membantu Anda.
  • ‘Thsp_cbp_menu_link_text’ – Filter hook didefinisikan dalam helpers.php, memungkinkan Anda mengubah tautan teks Menu. Boilerplate menambahkan tautan di bawah Appearance in WordPress dashboard, memungkinkan pengguna akses mudah ke Theme Customizer. Secara default, tautan itu akan mengatakan “Penyesuai Tema” dan Anda dapat mengubah teks menggunakan using thsp_cbp_menu_link_text ’hook kait.
  • ‘Thsp_cbp_capability’ – Filter hook didefinisikan dalam helpers.php. Memungkinkan Anda untuk mengubah kapabilitas yang diperlukan standar yang digunakan dalam metode $ wp_customize-> add_setting.
  • ‘Thsp_cbp_option’ – Filter hook didefinisikan dalam helpers.php. Jika Anda menggunakan ‘opsi’ dalam argumen pengaturan Anda, gunakan kait ini untuk mengubah nama entri, nilai pengaturan tema Anda akan disimpan di bawah dalam tabel wp_options. Nilai default adalah ‘thsp_cbp_theme_options’, pastikan Anda menghubungkan yang ini dan mengubahnya menjadi sesuatu yang memiliki nama tema Anda di dalamnya.
  • ‘Thsp_cbp_options_array’ – Filter hook didefinisikan dalam options.php, Anda HARUS menghubungkan ke dalamnya dan mengganti array opsi default (berisi opsi sampel) dengan opsi yang digunakan dalam tema Anda. Saya akan mengulanginya, cetak tebal dan garis bawahi: YAnda HARUS menghubungkan ke dalamnya dan mengganti array opsi default dengan opsi yang digunakan dalam tema Anda.
  • ‘Thsp_cbp_custom_controls’ – Kait tindakan didefinisikan dalam custom-controls.php, dengan menghubungkan ke dalamnya Anda dapat membuat kontrol kustom Anda sendiri, terus membaca untuk melihat contoh bagaimana melakukannya.
  • ‘Tshp_cbp_remove_sections’‘Tshp_cbp_remove_controls’ dan ‘Tshp_cbp_remove_settings’ – Filter hooks didefinisikan dalam customizer.php. Anda dapat memberikan mereka array ID bagian built-in (atau ID kontrol, atau ID pengaturan) untuk menghapus beberapa bagian built-in, kontrol atau pengaturan.

Catatan: Meskipun kami pada ekstensibilitas dan membuat kait Anda sendiri sehingga pengembang lain dapat menggunakannya untuk memperpanjang kode Anda, tidak mungkin untuk melebih-lebihkan betapa pentingnya hal ini. Bagaimanapun, begitulah cara WordPress (inti) bekerja. Dan saya tidak bisa berterima kasih Pippin dan -nya artikel cukup untuk memasukkan ide ini ke kepala saya.

Kontrol khusus

Versi terbaru dari Theme Customizer (yang baru saja Anda periksa, kan?) Memiliki beberapa kontrol lagi yang dapat Anda gunakan – bidang textarea, bidang angka HTML5 dan bidang gambar, yang pada dasarnya adalah versi mewah dari tombol radio.

Kontrol khusus ini didefinisikan dalam custom-controls.php, saya tidak akan membahas semuanya di sini, tetapi mari kita lihat satu (bidang angka HTML5) untuk melihat bagaimana semuanya bekerja:

/ **
* Membuat kontrol Customizer untuk bidang input [type = number]
*
* @since Theme_Customizer_Boilerplate 1.0
* /
kelas CBP_Customizer_Number_Control meluas WP_Customize_Control {

public $ type = 'number';

fungsi publik render_content () {
gaung';
}

}

Seperti yang Anda lihat, yang perlu Anda lakukan adalah menentukan $ tipe kontrol baru dan fungsinya render_content yang menghasilkan kontrol di layar Theme Customizer.

Menggunakan kontrol bawaan Customizer Boilerplate

Itu sama dengan bidang sederhana yang dibahas dalam tutorial sebelumnya, satu-satunya hal yang perlu Anda ketahui adalah ‘jenis’ yang perlu Anda gunakan untuk masing-masing:

  • Bidang angka – ‘jumlah’
  • Bidang Textarea – ‘Textarea’
  • Gambar yang bertindak sebagai tombol radio – ‘Images_radio’, inilah contoh kontrol ini dalam gratis mendatang Tema Cazuela:

Tema Customizer Boilerplate

Mengetahui nama tipe kontrol baru ini, menambahkannya mudah. Inilah cara Anda dapat menambahkan kontrol bidang angka ke array yang menyimpan semua opsi Anda:

/ *
* ============
* ============
* Bidang Angka
* ============
* ============
* /
'new_number_field' => array (
'setting_args' => array (
'default' => '',
'type' => 'option',
'kapabilitas' => $ thsp_cbp_capability,
'transport' => 'refresh',
),
'control_args' => array (
'label' => __ ('Number', 'my_theme_textdomain'),
'type' => 'number', // kontrol Textarea
'priority' => 8
)
)

Catatan: Jika Anda tidak yakin di mana menambahkan ini, centang “Menggunakan Pilihan Array untuk Menambahkan Bagian, Pengaturan dan Kontrol Penyesuai” pada Bagian 3 dari seri ini. Juga, ada sampel untuk masing-masing kontrol khusus dalam file options.php.

Menambahkan kontrol kustom Anda sendiri

Mari kembali ke kait tindakan ‘thsp_cbp_custom_controls yang saya sebutkan sebelumnya:

/ **
* Kait tindakan yang memungkinkan Anda untuk membuat kontrol Anda sendiri
* /
do_action ('thsp_cbp_custom_controls');

Ini adalah kait tindakan WordPress sederhana yang memungkinkan Anda untuk menambahkan kontrol kustom Anda sendiri tanpa memodifikasi file Theme Customizer Boilerplate. Mengapa Anda ingin menghindari mengeditnya? Karena jika Anda menghubungkan ke boilerplate, setiap kali seseorang memperbaruinya, Anda bisa mengambil versi terbaru, letakkan di tema Anda dan tidak kehilangan perubahan yang Anda buat. Pikirkan mengedit file inti WordPress vs. menulis plugin, mengedit tema vs. membuat tema anak, dll.

Jika Anda perlu menambahkan kontrol khusus Anda sendiri, ini adalah bagaimana Anda dapat melakukannya:

function my_theme_add_customizer_boilerplate_control () {
/ **
* Membuat kontrol khusus untuk digunakan dengan Theme Customizer Boilerplate
* Gunakan awalan kelas yang unik!
*
* @since Theme_Customizer_Boilerplate 1.0
* /
kelas CBP_Customizer_My_Control meluas WP_Customize_Control {

public $ type = 'my_type'; // Ubah ini

fungsi publik render_content () {
// Kontrol output ada di sini
}

}
}
add_action ('thsp_cbp_custom_controls', 'my_theme_add_customizer_boilerplate_control');

Pastikan Anda mengawali kelas kontrol khusus Anda dengan sesuatu yang unik, jadi namanya tidak bertentangan dengan kelas lain. Saya menggunakan ‘CBP_’ (Customizer Boilerplate) – karena Anda menggunakan boilerplate dalam suatu tema, nama tema Anda sangat masuk akal dan akan berfungsi dengan baik untuk Anda.

Penyesuai Tema: Apa Selanjutnya?

Sekarang karena WordPress Theme Customizer Boilerplate dapat dikembangkan melalui kait, kita akan melihat untuk menambahkan “opsi tema bersyarat” – opsi yang hanya akan muncul jika plugin tertentu aktif dan membantu Anda menjaga layar Tema Kustomis tetap berantakan..

Apa pendapat Anda tentang Customizer Boilerplate sejauh ini? Apakah Anda berencana untuk menggunakannya dalam tema Anda? Adakah gagasan tentang bagaimana hal itu dapat ditingkatkan? Umpan balik Anda diterima, selalu.

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map