Útvíkkun ketilsplata WordPress þema

  1. 1. Kynning á WordPress þema sérsniðna
  2. 2. Samskipti við WordPress þema sérsniðna
  3. 3. Boilerplate fyrir sérsniðið WordPress þema
  4. 4. Lestur sem stendur: Útvíkkun ketilsplata WordPress þema
  5. 5. Þema sérsniðið ketilplata – Skilyrt valmöguleikar, barnaþemu og viðbætur

Hluti 3 af seríunni Theme Customizer kynnti þér Tem Customizer Boilerplate sem gerir þér kleift að einfalda kóða sem sér um þemavalkosti þína. Allt sem þú þarft að gera er að fara yfir fjölda valmyndareina og ketilplötuna mun sjá um að skrá þema sérsniðna hluta, stillingar og stýringar fyrir þig á bak við tjöldin.


Fram til þessa leyfði ketilplata þér að nota textareit, gátreit, útvarpshnappa og velja reiti í Theme Customizer, þessar greinar sýna þér hvernig þú getur framlengt það.

Athugið: Áður en lengra er haldið, vinsamlegast hlaðið niður nýjustu útgáfunni af WordPress Theme Customizer Boilerplate úr Github geymslu þess. Ég hef gert nokkrar endurbætur á því síðan síðast námskeið og það er mikilvægt að kóðinn þinn sé uppfærður. Skoðaðu fyrri færslu til að fá fleiri athugasemdir um breytingar, en í hnotskurn, þegar þú hefur afritað ketilplötuna í þemamöppuna þína þarftu alls ekki að breyta skrám hennar – öll klippingin er gerð með síu og aðgerðakrókum.

Krókar í þema sérsniðna ketilplötu

Það eru nokkrir aðgerða- og síukrókar í ketilplötunni WordPress Theme Customizer. Þú getur krókað þig inn í hvaða þeirra sem er frá function.php skrá þemans með því að nota add_action og bæta við_filter aðgerðir:

  • ‘Thsp_cbp_directory_uri’ – Síukrókur skilgreindur í helpers.php, gerir þér kleift að breyta staðsetningu Customizer Boilerplate í þemamöppunni þinni. Sjálfgefið er að ketillarstígurinn lítur svona út – get_template_directory_uri (). „/ Sérsniðin ketilsplata“ – en ef þú vilt frekar flytja það á sérsniðinn stað, þá er þetta krókurinn sem getur hjálpað þér.
  • ‘Thsp_cbp_menu_link_text’ – Síukrókur skilgreindur í helpers.php, gerir þér kleift að breyta valmyndartexta. Ketilplata bætir við hlekk undir Útliti í mælaborði WordPress, sem gerir notendum kleift að fá aðgang að Theme Customizer. Sjálfgefið er að þessi hlekkur segir „Þema sérsniðið“ og þú getur breytt textanum með „thsp_cbp_menu_link_text“ síukróknum.
  • „Thsp_cbp_capability“ – Síukrókur skilgreindur í helpers.php. Gerir þér kleift að breyta nauðsynlegri getu sem notuð er í $ wp_customize-> add_setting aðferð.
  • „Thsp_cbp_option“ – Síukrókur skilgreindur í helpers.php. Ef þú notar „valkost“ í stillingarrökum þínum skaltu nota þennan krók til að breyta heiti færslunnar sem þemastillingargildin verða geymd undir í wp_options töflu. Sjálfgefið gildi er „thsp_cbp_theme_options“, vertu viss um að krækja þig í þennan og breyta því í eitthvað sem hefur þemanafn þitt í því.
  • „Thsp_cbp_options_array“ – Síukrókur skilgreindur í options.php, VERÐUR að krækja í hann og skipta um sjálfgefna valmyndaröðina (sem inniheldur sýnishornavalkosti) fyrir valkosti sem eru notaðir í þemað. Ég skal endurtaka það, feitletra það og undirstrika það: You VERÐUR að krækja í hann og skipta um sjálfgefna valmyndaröðina fyrir valkosti sem eru notaðir í þemað þitt.
  • „Thsp_cbp_custom_controls“ – Aðgerðarkrókur skilgreindur í sérsniðnum controls.php, með því að krækja í hann geturðu búið til þín eigin sérsniðna stjórntæki, haltu áfram að lesa til að sjá dæmi um hvernig á að gera það.
  • „Tshp_cbp_remove_sections“„Tshp_cbp_remove_controls“ og „Tshp_cbp_remove_settings“ – Síukrókar skilgreindir í customizer.php. Þú getur framhjá þeim fylki af innbyggðum ID-köflum (eða stýringar-ID eða stillingar-ID) til að fjarlægja hluti af innbyggðu hlutunum, stjórntækjum eða stillingum.

Athugasemd: Þó við séum með stækkun og búum til þína eigin króka svo aðrir verktaki geti notað þá til að lengja kóðann þinn, þá er ómögulegt að gera of mikið úr því hversu mikilvægt þetta er. Þegar öllu er á botninn hvolft er það hvernig WordPress (kjarna) virkar. Og ég gat ekki þakkað Pippin og hans greinar nóg til að koma þessari hugmynd inn í hausinn á mér.

Sérsniðin stjórntæki

Uppfærða útgáfan af Theme Customizer (sem þú hefur bara kíkt á, ekki satt?) Hefur nokkur stjórntæki í viðbót sem þú getur notað – textarea reit, HTML5 númerareit og myndareit, sem er í grundvallaratriðum fín útgáfa af hnappum.

Þessi sérsniðna stjórntæki eru skilgreind í custom-controls.php, ég mun ekki fara í gegnum þau öll hér, en við skulum kíkja á einn (HTML5 númerareit) til að sjá hvernig þetta virkar:

/ **
* Býr til sérsniðna stjórnun fyrir inntak [type = number] reit
*
* @since Theme_Customizer_Boilerplate 1.0
* /
bekk CBP_Customizer_Number_Control nær WP_Customize_Control {

public $ type = 'number';

opinber aðgerð render_content () {
echo '';
}

}

Eins og þú sérð, það eina sem þú þarft að gera er að skilgreina nýja stjórnun $ gerð og render_content aðgerðina sem gefur frá sér stjórnunina á skjánum Customizer.

Notkun innbyggðra sérsniðinna stjórntækja fyrir ketilplötu

Það er það sama og einfaldir reitir sem fjallað er um í fyrri námskeiðinu, það eina sem þú þarft að vera meðvitaðir um eru „gerðir“ sem þú þarft að nota fyrir hvern og einn:

  • Fjöldi reit – „Tala“
  • Textarea sviði – „Textarea“
  • Myndir sem virka sem útvarpshnappar – ‘Images_radio’, hér er dæmi um þessa stjórn í komandi ókeypis Cazuela þema:

Þema sérsniðið ketilplata

Það er auðvelt að þekkja nöfn á þessum nýju stjórntegundum og bæta við einni. Svona geturðu bætt númerareit við stjórn sem fylgir öllum valkostum þínum:

/ *
* ============
* ============
* Fjöldi reit
* ============
* ============
* /
'new_number_field' => fylki (
'setting_args' => fylki (
'default' => '',
'type' => 'valkostur',
'capability' => $ thsp_cbp_capability,
'flutningur' => 'hressa',
),
'control_args' => fylki (
'label' => __ ('Fjöldi', 'my_theme_textdomain'),
'type' => 'tala', // Textarea stjórnun
'forgang' => 8
)
)

Athugasemd: Ef þú ert ekki viss um hvar þú vilt bæta þessu við skaltu haka við „Nota valmöguleika fyrir að bæta við sérsniðnum hlutum, stillingum og stýringum“ í 3. hluta þessarar seríu. Einnig er sýnishorn fyrir hvert og eitt af sérsniðnum stýringum í option.php skránni.

Bætir við þínum eigin sérsniðnum stjórntækjum

Við skulum snúa aftur að „thsp_cbp_custom_controls“ aðgerðarkróknum sem ég nefndi áðan:

/ **
* Aðgerðarkrókur sem gerir þér kleift að búa til þínar eigin stjórntæki
* /
do_action ('thsp_cbp_custom_controls');

Það er einfaldur WordPress aðgerðarkrókur sem gerir þér kleift að bæta við eigin sérsniðnum stjórntækjum án þess að breyta Theme Customizer Boilerplate skránum. Af hverju myndirðu vilja forðast að breyta þeim? Vegna þess að ef þú krækir í ketilplötuna í staðinn, hvenær sem einhver uppfærir það, geturðu bara grípt í nýjustu útgáfuna, sleppt henni í þemað þitt og ekki tapað breytingunum sem þú gerðir. Hugsaðu að breyta WordPress kjarna skrám á móti því að skrifa viðbætur, breyta þema vs. að búa til barn þema osfrv.

Ef þú þarft einhvern tíma að bæta við sérsniðnum stjórntækjum þínum er þetta hvernig þú getur gert það:

virka my_theme_add_customizer_boilerplate_control () {
/ **
* Býr til sérsniðna stjórn til að nota með Theme Customizer Boilerplate
* Notaðu einstakt flokks forskeyti!
*
* @since Theme_Customizer_Boilerplate 1.0
* /
bekk CBP_Customizer_My_Control nær WP_Customize_Control {

public $ type = 'my_type'; // Breyta þessu

opinber aðgerð render_content () {
// Control framleiðsla fer hér
}

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

Gakktu úr skugga um að forskeyti sérsniðna stjórnunarflokk þinn með einhverju sérstöku, svo að nafn hans skellur ekki á annan flokk. Ég notaði „CBP_“ (Customizer Boilerplate) – þar sem þú ert að nota ketilplötu í þema er nafn þemans þíns mikið skynsamlegt og ætti að virka vel fyrir þig.

Sérsniðin þema: Hvað er næst?

Nú þegar WordPress Theme Customizer Boilerplate er teygjanlegt í gegnum krókana munum við kíkja á til að bæta við „skilyrðum þemavalkostum“ – þá sem munu aðeins birtast ef ákveðin viðbætur eru virkar og hjálpa þér við að halda skjánum fyrir Theme Customizer af ringulreið..

Hverjar eru hugsanir þínar um Customizer Boilerplate hingað til? Ætlarðu að nota það í þemunum þínum? Einhverjar hugmyndir um hvernig hægt væri að bæta það? Athugasemdir þínar eru alltaf vel þegnar.

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