Pagpapalawak ng WordPress Theme Customizer Boilerplate

  1. 1. Panimula Sa Ang WordPress Tema Customizer
  2. 2. Pakikipag-ugnay Sa Customizer ng WordPress Tema
  3. 3. WordPress Tema Customizer Boilerplate
  4. 4. Kasalukuyang nagbabasa: Pagpapalawak ng WordPress Theme Customizer Boilerplate
  5. 5. Tema Customizer Boilerplate – Mga Pagpipilian sa Kondisyon, Mga Tema ng Bata at Plugin

Ang bahagi ng serye ng Tema Customizer ay nagpakilala sa iyo sa Tema Customizer Boilerplate na nagbibigay-daan sa iyo upang gawing simple ang code na humahawak sa iyong mga pagpipilian sa tema. Ang kailangan mo lang gawin ay pumasa sa isang hanay ng mga patlang na pagpipilian at ang boilerplate ay mag-aalaga ng pagrehistro ng mga seksyon ng Mga Tema, setting at kontrol para sa iyo sa likod ng mga eksena.


Hanggang ngayon, pinapayagan ka ng boilerplate na gumamit ng mga patlang ng teksto, mga checkbox, mga pindutan ng radyo at piliin ang mga patlang sa Tema Customizer, ipinapakita sa iyo ng mga artikulong ito kung paano mo ito mapalawak.

Tandaan: Bago magpatuloy, mangyaring i-download ang pinakabagong bersyon ng WordPress Tema Customizer Boilerplate mula sa Github na itatago nito. Gumawa ako ng ilang mga pagpapabuti mula pa noong huling tutorial, at mahalaga na napapanahon ang iyong code. Tingnan ang nakaraang post para sa higit pang mga tala sa mga pagbabago, ngunit sa madaling sabi, sa sandaling kopyahin mo ang boilerplate sa iyong folder ng tema, hindi mo na kailangang mai-edit ang lahat ng mga file nito – lahat ng pag-edit ay ginagawa gamit ang mga filter at pagkilos ng pagkilos..

Paggulong sa Boilerplate ng Customizer ng Tema

Mayroong maraming mga aksyon at filter hook sa WordPress Theme Customizer Boilerplate. Maaari kang mag-hook sa alinman sa mga ito mula sa file ng function.php ng ​​iyong tema sa pamamagitan ng paggamit add_action at magdagdag_filter function:

  • ‘Thsp_cbp_directory_uri’ – Tinukoy ng filter hook sa helpers.php, nagbibigay-daan sa iyo upang baguhin ang lokasyon ng Customizer Boilerplate sa iyong folder ng tema. Bilang default, ganito ang hitsura ng boilerplate path – get_template_directory_uri (). ‘/ Customizer-boilerplate’ – ngunit kung mas gusto mong ilipat ito sa isang pasadyang lokasyon, ito ang kawit na makakatulong sa iyo.
  • ‘Thsp_cbp_menu_link_text’ – Tinukoy ang kawit ng filter sa helpers.php, hinahayaan mong baguhin ang link ng teksto ng Menu. Ang Boilerplate ay nagdaragdag ng isang link sa ilalim ng Hitsura sa dashboard ng WordPress, na nagpapahintulot sa mga gumagamit ng madaling pag-access sa Tema Customizer. Bilang default, sasabihin ng link na iyon na “Tema Customizer” at mababago mo ang teksto gamit ang ‘thsp_cbp_menu_link_text’ filter hook.
  • ‘Thsp_cbp_capability’ – Tinukoy ang kawit ng filter sa helpers.php. Pinapayagan kang baguhin ang kinakailangang default na kakayahan na ginagamit sa $ wp_customize-> paraan ng add_setting.
  • ‘Thsp_cbp_option’ – Tinukoy ang kawit ng filter sa helpers.php. Kung gumagamit ka ng ‘pagpipilian’ sa iyong mga argumento ng mga setting, gamitin ang kawit na ito upang baguhin ang pangalan ng entry ang iyong mga halaga ng mga setting ng tema ay maiimbak sa ilalim ng talahanayan ng wp_options. Ang halaga ng default ay ‘thsp_cbp_theme_options’, siguraduhin na mag-hook ka sa isang ito at baguhin ito sa isang bagay na mayroong pangalan ng iyong tema.
  • ‘Thsp_cbp_options_array’ – Natukoy ang filter hook sa options.php, DAPAT kang mag-hook dito at papalitan ang default na pagpipilian ng mga pagpipilian (naglalaman ng mga pagpipilian ng sample) sa mga pagpipilian na ginagamit sa iyong tema. Uulitin ko iyon, i-bold ito at salungguhitan ito: Yo DAPAT mag-hook sa ito at palitan ang mga default na pagpipilian ng mga pagpipilian sa mga pagpipilian na ginagamit sa iyong tema.
  • ‘Thsp_cbp_custom_controls’ – Tinukoy ang pagkilos ng hook sa pasadyang-kontrol.php, sa pamamagitan ng pag-hook dito maaari kang lumikha ng iyong sariling mga pasadyang kontrol, panatilihin ang pagbabasa upang makita ang isang halimbawa ng kung paano gawin ito.
  • ‘Tshp_cbp_remove_sections’‘Tshp_cbp_remove_controls’ at ‘Tshp_cbp_remove_settings’ – Tinukoy ang mga kawit ng filter sa customizer.php. Maaari mong ipasa ang mga ito ng mga naka-built-in na seksyon na mga ID (o kinokontrol ang mga ID, o mga setting ng ID) upang alisin ang ilan sa mga built-in na seksyon, mga kontrol o setting.

Tandaan: Habang nasa extensibilidad kami at lumilikha ng iyong sariling mga kawit upang magamit ito ng iba pang mga developer upang mapalawak ang iyong code, imposibleng ma-overstate kung gaano kahalaga ito. Pagkatapos ng lahat, kung paano gumagana ang WordPress (core). At hindi ako magpasalamat Pippin at kanyang artikulo sapat para makuha ang ideyang ito sa aking ulo.

Pasadyang mga kontrol

Ang na-update na bersyon ng Tema Customizer (na iyong na-check out, di ba?) Ay may ilang higit pang mga kontrol na maaari mong gamitin – patlang ng textarea, patlang ng numero ng HTML5 at mga larang ng mga imahe, na talaga ay isang magarbong bersyon ng mga pindutan ng radyo.

Ang mga pasadyang kontrol na ito ay tinukoy sa mga pasadyang-control.php, hindi ko napadaan ang lahat ng ito dito, ngunit tingnan natin ang isa (patlang ng numero ng HTML5) upang makita kung paano gumagana ang lahat:

/ **
* Lumilikha ng control ng Customizer para sa larangan ng pag-input [type = number]
*
* @Since Tema_Customizer_Boilerplate 1.0
* /
ang klase ng CBP_Customizer_Number_Control ay nagpapalawak ng WP_Customize_Control {

pampublikong $ type = 'number';

pampublikong function render_content () {
sigaw';
}

}

Tulad ng nakikita mo, ang kailangan mo lang gawin ay tukuyin ang bagong uri ng control ng $ at ang render_content function na kung saan ang output sa screen ng Tema Customizer.

Gamit ang built-in na mga kontrol ng pasadyang Customizer Boilerplate

Ito ay katulad ng mga simpleng patlang na sakop sa nakaraang tutorial, ang tanging bagay na kailangan mong malaman ay ang mga ‘uri’ na kailangan mong gamitin para sa bawat isa:

  • Patlang ng numero – ‘Number’
  • Patlang ng Textarea – ‘Textarea’
  • Mga imahe na kumikilos bilang mga pindutan ng radyo – ‘Images_radio’, narito ang isang halimbawa ng kontrol na ito sa paparating na libre Tema ng Cazuela:

Boilerplate ng Tema ng Tema

Ang pag-alam ng mga pangalan ng mga bagong uri ng control, pagdaragdag ng isa ay madali. Narito kung paano ka maaaring magdagdag ng kontrol sa numero ng patlang sa hanay na may hawak ng lahat ng iyong mga pagpipilian:

/ *
* ============
* ============
* Patlang ng Bilang
* ============
* ============
* /
'new_number_field' => array (
'setting_args' => array (
'default' => '',
'type' => 'pagpipilian',
'kakayahan' => $ thsp_cbp_capability,
'transport' => 'i-refresh',
),
'control_args' => array (
'label' => __ ('Number', 'my_theme_textdomain'),
'type' => 'number', // Textarea control
'priority' => 8
)
)

Tandaan: Kung hindi ka sigurado kung saan idagdag ito, suriin ang “Paggamit ng Mga Pagpipilian Array upang Magdagdag ng Mga Seksyon ng Mga Customizer, Mga Setting at Mga Kontrol” ng Bahagi 3 ng seryeng ito. Gayundin, mayroong isang sample para sa bawat isa sa mga pasadyang mga kontrol sa mga pagpipilian sa.php file.

Pagdaragdag ng iyong sariling mga pasadyang kontrol

Balik tayo sa ‘thsp_cbp_custom_controls’ pagkilos na nabanggit ko kanina:

/ **
* Aksyon hook na nagbibigay-daan sa iyo upang lumikha ng iyong sariling mga kontrol
* /
do_action ('thsp_cbp_custom_controls');

Ito ay isang simpleng hook ng aksyon ng WordPress na nagbibigay-daan sa iyo upang magdagdag ng iyong sariling mga pasadyang kontrol nang hindi binabago ang mga file ng Customizer Boilerplate ng Tema. Bakit mo nais na maiwasan ang pag-edit ng mga ito? Dahil kung ikaw ay sumali sa boilerplate sa halip, kapag may nag-update nito, maaari mo lamang makuha ang pinakabagong bersyon, ihulog ito sa iyong tema at hindi mawawala ang mga pagbabagong nagawa mo. Isipin ang pag-edit ng mga pangunahing file ng WordPress kumpara sa pagsulat ng isang plugin, pag-edit ng isang tema kumpara sa paglikha ng isang tema ng bata atbp.

Kung kailangan mong magdagdag ng iyong sariling mga pasadyang mga kontrol, ito ay kung paano mo ito magagawa:

gumana ang aking_theme_add_customizer_boilerplate_control () {
/ **
* Lumilikha ng pasadyang kontrol upang magamit sa Tema Customizer Boilerplate
* Gumamit ng isang natatanging prefix ng klase!
*
* @Since Tema_Customizer_Boilerplate 1.0
* /
ang klase ng CBP_Customizer_My_Control ay nagpapalawak ng WP_Customize_Control {

pampublikong $ type = 'my_type'; // Baguhin ito

pampublikong function render_content () {
// Pumunta dito ang control output
}

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

Tiyaking nai-prefix mo ang iyong pasadyang klase ng control na may isang natatanging bagay, kaya ang pangalan nito ay hindi makipag-clash sa isa pang klase. Ginamit ko ang ‘CBP_’ (Customizer Boilerplate) – dahil gumagamit ka ng boilerplate sa isang tema, ang kahulugan ng pangalan ng iyong tema at dapat gumana para sa iyo.

Customizer ng Tema: Ano ang Susunod?

Ngayon na ang WordPress Tema Customizer Boilerplate ay mapapalawak sa pamamagitan ng mga kawit, titingnan namin upang magdagdag ng “mga pagpipilian sa kondisyon na kondisyon” – lilitaw lamang kung ang isang tiyak na plugin ay aktibo at tulungan kang mapanatili ang de-cluttered na Tema ng Screen Customizer..

Ano ang iyong mga saloobin sa Customizer Boilerplate hanggang ngayon? Plano mo bang gamitin ito sa iyong mga tema? Anumang mga ideya sa kung paano ito mapapabuti? Malugod ang iyong puna, palagi.

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