stranska vrstica wordpress. Stranske vrstice WordPress, ustvarjanje stranske vrstice WordPress. Privzeti gradniki WordPress
Prikaže prvo aktivno ploščo gradnikov (stranska vrstica je plošča, ki vsebuje vsaj en gradnik). Določite lahko ID ali številko plošče, katero želite prikazati, če ima spletno mesto več kot eno ploščo gradnikov.
dynamic_sidebar() vrne true ali false, pri čemer vrnjeni rezultat prikaže tudi vrstico pripomočkov. Povratno vrednost je mogoče uporabiti na primer za določitev, ali naj se koda, ki nadomešča gradnike, obdela, ko na plošči ni gradnikov (glejte primer št. 1).
vrača
true, če je bila najdena plošča pripomočkov. false, če plošča ne obstaja ali ne vsebuje pripomočkov.
Uporaba
$index (niz/število) ID plošče, podan v parametru id funkcije register_sidebar(), ko je bila plošča registrirana. Če je navedena številka, bo preiskana plošča z ID-jem sidebar-$index.Privzeto: 1 (sidebar-1)
Primeri
#1 Pokaži stransko vrstico, če obstaja.
Ta primer prikazuje, kako prikazati prvo neprazno stransko vrstico (ID stranske vrstice ni bil naveden med registracijo) ali, če je ni mogoče najti, obdelati navedeno kodo:
#2 Prikažite želeno stransko vrstico.
#3 Preverite prisotnost plošče in jo prikažite
V primeru 2 nismo preverili prisotnosti plošče in pripomočkov v njej. V tem primeru bomo preverili prisotnost plošče, da ne bi prikazali nepotrebnega oznake HTML (
- ), če je stranska vrstica prazna:
- Globalno. Array. $wp_registered_sidebars Registrirane stranske vrstice.
- Globalno. Array. $wp_registered_widgets
- Dinamična stranska vrstica: vsebnik za nabor pripomočkov, ki jih lahko uporabnik namesti prek skrbniške plošče -> razdelek Gradniki.
- Predloga stranske vrstice: To je stranska vrstica, ki jo prikaže predloga spletnega mesta.
Več stranskih vrstic
Pri registraciji več kot ene plošče gradnikov z register_sidebar() je bolj priročno določiti ID za vsako ploščo.
ID-ja ne moremo določiti, potem bo plošča prejela serijsko številko. Toda v tem primeru bo pri urejanju teme težko razumeti, katera plošča je katera, saj številke 1, 2, 3 ne pomenijo ničesar. Če pa nastavite ime, postane veliko bolj jasno:
// --- številke// registracija register_sidebar(); // izpis dynamic_sidebar(1); // --- Strune// registracija register_sidebar(array("id" => "top_menu")); // izpis dynamic_sidebar("top_menu");
Iz primera je razvidno, da je bolj priročno z nizi: ko pogledate temo in vidite dynamic_sidebar("top_menu"), je takoj jasno, da se kliče plošča za glavni meni.
Argument id ne sme vsebovati presledkov, velikih črk, črk cirilice. Uporabite lahko pomišljaj - in podčrtaj _ v njem. Biti mora tudi unikaten. Z navedbo ID-ja lahko določimo tudi ime, opis in prevode zanje:
Register_sidebar(array("id" => "top-menu", "name" => __("Top Menu", $text_domain), "description" => __("Ta stranska vrstica se nahaja nad logotipom starosti.", $text_domain))))
Opombe
Seznam sprememb
| Od različice 2.2.0 | Predstavljen. |
Koda dinamična stranska vrstica: wp-includes/widgets.php WP 5.3.2
$value) ( if (sanitize_title($value["name"]) == $index) ( $index = $key; break; ) ) ) $sidebars_widgets = wp_get_sidebars_widgets(); if (empty($wp_registered_sidebars[ $index ]) || empty($sidebars_widgets[ $index ]) || !is_array($sidebars_widgets[ $index ])) ( /** To dejanje je dokumentirano v wp-includes/widget. php */ do_action("dynamic_sidebar_before", $index, false); /** To dejanje je dokumentirano v wp-includes/widget.php */ do_action("dynamic_sidebar_after", $index, false); /** Ta filter je dokumentirano v wp-includes/widget.php */ return apply_filters("dynamic_sidebar_has_widgets", false, $index); ) /** * Sproži se, preden so pripomočki upodobljeni v dinamični stranski vrstici. * * Opomba: dejanje se sproži tudi za prazne stranske vrstice in tako na sprednji * kot zadnji strani, vključno s stransko vrstico Neaktivni pripomočki na zaslonu pripomočkov. * * @od 3.9.0 * * @param int|string $index Indeks, ime ali ID dinamične stranske vrstice. * @param bool $has_widgets Ali je stranska vrstica poseljena s pripomočki. * privzeto res. */ do_action("dynamic_sidebar_before", $index, true); $sidebar = $wp_registered_sidebars[ $index]; $did_one = false; foreach ((matrika) $sidebars_widgets[ $index ] kot $id) ( if (! isset($wp_registered_widgets[ $id ])) (nadaljuj; ) $params = array_merge(array(array_merge($sidebar, array("widget_id" => $id, "widget_name" => $wp_registered_widgets[ $id ]["name"],)), (matrika) $wp_registered_widgets[ $id ]["params"]); // Nadomestni HTML ID in razred atributi v before_widget $classname_ = ""; foreach ((matrika) $wp_registered_widgets[ $id ]["classname"] kot $cn) ( if (is_string($cn)) ( $classname_ .= "_" . $cn; ) elseif (is_object($cn)) ( $classname_ .= "_" . get_class($cn); ) ) $classname_ = ltrim($classname_, "_"); $params["before_widget"] = sprintf($ params["before_widget"], $id, $classname_); /** * Filtrira parametre, posredovane povratnemu klicu prikaza pripomočka. * * Opomba: Filter je ovrednoten tako na sprednji kot zadnji strani, * vključno z stransko vrstico Inactive Widgets na zaslonu Widgets.* * @od 2.5.0 * * @see register_sidebar() * * @param array $params ( * @type array $args ( * Matrika argumentov za prikaz gradnikov. * * @type string $name Ime stranske vrstice, ki ji je pripomoček dodeljen. * @type string $id ID stranske vrstice, ki ji je pripomoček dodeljen. * @type string $description Opis stranske vrstice. * @type string $class Razred CSS, uporabljen za vsebnik stranske vrstice. * @type string $before_widget Oznaka HTML, ki se doda vsakemu pripomočku v stranski vrstici. * @type string $after_widget Oznaka HTML, ki se doda vsakemu pripomočku v stranski vrstici. * @type string $before_title Oznaka HTML, ki se doda pred naslov gradnika, ko je prikazan. * @type string $after_title Oznaka HTML, ki se doda naslovu pripomočka, ko je prikazan. * @type string $widget_id ID pripomočka. * @type string $widget_name Ime gradnika. * ) * @type array $widget_args ( * Niz argumentov za več gradnikov. * * @type int $number Povečanje števila, ki se uporablja za večkratnike istega gradnika. * ) * ) */ $params = apply_filters("dynamic_sidebar_params", $params); $callback = $wp_registered_widgets[ $id ]["callback"]; /** * Sproži se, preden se kliče povratni klic prikaza gradnika. * * Opomba: Dejanje se sproži na sprednjem in zadnjem koncu, vključno z * za gradnike v stranski vrstici Neaktivni gradniki na zaslonu Gradnikov. * * Dejanje je se ne sproži za prazne stranske vrstice. * @type array|callable $callback Ko je kavelj sprožen na sprednji strani, je $callback matrika *, ki vsebuje objekt pripomočka. $callback *, ki se sproži na zadnji strani, je "wp_widget_control", glejte $_callback.* @type array $params Asociativna matrika argumentov več gradnikov.* @type string $classname Razred CSS, ki se uporablja za vsebnik gradnikov.* @type string $description Opis gradnika.* @type array $_callback Ko se kavelj sproži na zadnji strani konec, $_callback je poseljen * z matriko, ki vsebuje objekt pripomočka, glejte $callback.* ) */ do_action("dynamic_sidebar", $wp_registered_widgets[ $id ]); if (is_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * Sproži se potem, ko so gradniki upodobljeni v dinamični stranski vrstici. * * Opomba: dejanje se sproži tudi za prazne stranske vrstice in tako na sprednji * kot zadnji strani, vključno s stransko vrstico Neaktivni pripomočki na zaslonu pripomočkov. * * @od 3.9.0 * * @param int|string $index Indeks, ime ali ID dinamične stranske vrstice. * @param bool $has_widgets Ali je stranska vrstica poseljena s pripomočki. * privzeto res. */ do_action("dynamic_sidebar_after", $index, true); /** * Filtrira, ali ima stranska vrstica pripomočke. * * Opomba: Filter je ovrednoten tudi za prazne stranske vrstice in tako na sprednji * kot zadnji strani, vključno s stransko vrstico Neaktivni pripomočki na zaslonu pripomočkov. * * @od 3.9.0 * * @param bool $did_one Ali je bil v stranski vrstici upodobljen vsaj en pripomoček. * privzeto napačno. * @param int|string $index Indeks, ime ali ID dinamične stranske vrstice. */ return apply_filters("dynamic_sidebar_has_widgets", $did_one, $index); )Pozdravljeni prijatelji! Kot sem obljubil, sem naredil temo o WordPress stranske vrstice. To je majhen vodnik za uporabo in prilagajanje stranskih vrstic na spletnih mestih WordPress.
V tej temi želim vsem razvijalcem predlog razkriti majhno skrivnost: stranske vrstice so bile vedno pomemben del sistema WordPress in so bile v zadnjih nekaj letih močno izboljšane.
Ob upoštevanju nedavnih dogodkov vam bom korak za korakom pokazal postopek ustvarjanja in uporabe stranskih vrstic za teme WordPress.
Kaj je stranska vrstica WordPress?
Dejansko lahko izraz 'stranska vrstica (sidebar)' pomeni dva popolnoma nepovezana pojma v sistemu WordPress:
V večini primerov imajo preproste predloge dinamično stransko vrstico, ki naloži vse nameščene gradnike iz skrbniške plošče. Ta postopek lahko poteka tudi po drugem algoritmu, vendar najpogosteje po tej shemi. Kljub temu je pomembno razumeti, da sta dinamična stranska vrstica in predloga stranske vrstice dve različni stvari. Vse je premium, delam predvsem s predlogo Sidebar.
Običajno se izraz 'stranska vrstica' uporablja v povezavi z dinamično stransko vrstico, o kateri bomo razpravljali v tem članku. Vendar se bom dotaknil tudi predloge stranske vrstice.
Pri brskanju po številnih temah me je najbolj razočaralo to, da razvijalci ne izkoriščajo v celoti najmočnejših funkcij sistema WordPress. Večina tem ima samo eno stransko vrstico, v najboljšem primeru dve. Toda navsezadnje bodo te teme ustvarile ogromne strani z naborom možnosti, ki jih je mogoče preprosto obdelati s pripomočki, njihovo vsebino pa je mogoče postaviti neposredno v predlogo. Raje uporabljam veliko stranskih vrstic v temi, da ustvarim prilagodljivo spletno mesto, bogato s funkcijami.
Registracija, dodajanje in ustvarjanje stranske vrstice WordPress
Številne teme pogosto ne dosegajo standardov kakovosti, zato, če ste razvijalec predlog, poskrbimo, da boste to težavo vzeli resno. Ustvarjanje ustrezne dinamike Stranska vrstica WordPress je najpomembnejši del postopka, saj bo tisto, kar nastavite v njem, povezano z vsemi drugimi funkcijami stranske vrstice.
Če želite ustvariti eno ali več stranskih vrstic, jih boste morali registrirati prek datoteke funkcije. php Vaša tema, vsaka tema ima svojo datoteko, ki vsebuje vse nastavitve predloge. Vložiti funkcije. php Nastavitve teme lahko dodate ali odstranite.
Spodnja koda prikazuje, kako lahko s funkcijo ustvarite stransko vrstico v WordPressu register_sidebar(). V tem primeru bomo ustvarili stransko vrstico, imenovano "primarna", ki bo služila kot primer za delo.
"primary", "name" => __("Primary"), "description" => __("Opis stranske vrstice (viden v skrbniški plošči)."), "before_widget" => "
", "before_title" => "", "after_title" => "
")); /* Funkcijo register_sidebar() lahko ponovite za druge pripomočke, polje id-ja mora biti edinstveno (primarno, sekundarno, moiwidget itd. */ ) ?>add_action("widgets_init" , "registriruem_sidebari" ) ; funkcija register_sidebari() ( /* Registriraj "primarno" stransko vrstico. */ register_sidebar( niz( "id" => "primarni" , "ime" => __("Primarni"), "opis" => __( "Opis stranske vrstice (viden v skrbniški plošči).") , "before_widget" => "" , "before_title" => " "after_title" => "" /* Funkcijo register_sidebar() lahko ponovite za druge pripomočke, polje ID mora biti edinstveno (primarni, sekundarni, moiwidget itd. */ |
Kot lahko vidite, je registracija stranske vrstice zelo preprosta naloga, če imate informacije o tem, kako to storiti.
Argumenti za ustvarjanje dinamične stranske vrstice dinamična_stranska vrstica()
funkcija register_sidebar() sprejme samo en parameter, se imenuje $args in vsebuje nabor argumentov, ki določajo, kako naj bo stranska vrstica s svojimi gradniki upodobljena. Nato razmislite o primerih ročne uporabe argumentov.
ID
Prepir id, je verjetno eden najpomembnejših argumentov za pisanje (oglejte si spodnji primer slabo napisane kode in ugotovite, zakaj bi jo vsekakor morali napisati). WordPress bo uporabil id da dodelite pripomočke določeni stranski vrstici in boste potrebovali id za nadaljnje polnjenje stranske vrstice - sidebar.
vsak id mora biti edinstven. WordPress ga bo privzeto predpisal za stranska vrstica-$i(Kje $ i
//naš widget id, ki je dodeljen samo enkrat "id" => "primary",
Ime
Napišete lahko katero koli ime, za katerega menite, da najbolje predstavlja vaše Stranska vrstica WordPress. Najpogosteje stranske vrstice dobijo imena, po katerih lahko uporabnik določi, katerih vidikov teme se dotika (na primer leva ali desna stranska vrstica). Ta argument je mogoče internacionalizirati (tj. lokalizirati za druge jezike). Zato se prepričajte, da ste napisali pravilno besedilno domeno, ko pripravljate temo za prevod. Argument je privzeto zapisan kot stranska vrstica $ i(Kje $ i je zaporedna številka ustvarjene stranske vrstice).
//ime gradnika, v primeru uporabljam Primarni kot ime id gradnika "name" => "Primarni",
opis
Prepir opis je bil prvič predstavljen v WordPressu 2.9. Ta argument vam omogoča, da opišete svoj gradnik, opis je prikazan na skrbniški plošči v razdelku Gradniki. Ta argument je privzeto zapisan v prazen niz. Lahko je tudi internacionaliziran (tj. napisan v cirilici ali drugih jezikih).
//opis bo viden v razdelku gradnikov "description" => __("Widget za levi stolpec na spletnem mestu"),
pred_pripomočkom
Prepir pred_pripomočkom to je začetni element gradnika, ki je dodeljen stranski vrstici. Prav tako mora biti element na ravni bloka HTML oznaka (npr. oznaka < li > , < p > , < div > itd.). Ta argument ima nekaj funkcij, v katere lahko na primer pišete id="" oz razred="": lastnosti id="" so zapisane takole: (%1$s) in atributi razred="" Torej: (%2$s).
WordPress jih bo privzeto navedel kot element seznama: < li id = "%1$s" > . Nisem ljubitelj ustvarjanja elementov seznama pripomočkov v stranski vrstici. Vedno uporabljam < div > . Nisem ljubitelj ustvarjanja elementov seznama pripomočkov v stranski vrstici. Zadnjič ga uporabljam, ker v odsotnosti pripomočka na spletnem mestu ne boste videli dodatnega HTML oznak, pa bomo v nadaljevanju razmislili, kako se jih znebiti.
after_widget
Prepir after_widget precej enostavno ustvariti. To je zaključni element za gradnik, dodeljen stranski vrstici. Samo zapreti morate element, določen za argument pred_pripomočkom. WordPress ga bo privzeto zapisal kot < li > .
"after_widget" => "
[ barvica - 5e1ff7d787fb8042608178 inline = "true" ] "after_widget" => "" , |
pred_naslovom
Večina pripomočkov prikaže naslov, če ga uporabnik vnese. Prepir pred_naslovom to je začetni element naslova pripomočka. WordPress ga privzeto zapiše kot < h2 > . Za uporabo oznak < h2 > ni vredno, v tem primeru bodo oznake dovolj < h3 > in < h4 > . Za intuitivnost in berljivost kode ne ustvarjajte imen razredov brez vezajev, da bi bilo bolj priročno, da sami preberete ime, je zelo pomembno, če že nekaj časa niste delali s spletnim mestom.
po_naslovu
Prepir po_naslovu to je zaključni element, določen v argumentu pred_naslovom. WordPress ga privzeto zapiše kot <
/
h2
>
.
Zagotoviti morate, da se njegova vrednost ujema z vrednostjo, navedeno v argumentu pred_naslovom.
"after_title" => ""
"after_title" => "" |
Prikaz dinamične stranske vrstice dynamic_sidebar()
Ko je ustvarjanje stranske vrstice končano, jo lahko začnete prikazovati znotraj teme. WordPress je za to ustvaril funkcijo, imenovano < a title = "Funkcija Codex Wordpress dynamic_sidebar()" href= "http://codex.wordpress.org/Function_Reference/dynamic_sidebar" target="_blank" > dynamic_sidebar()< / a > . Ta funkcija vedno zahteva parameter $index, ki se lahko hkrati nahajata v argumentu id, in v argumentu ime(določeno med ustvarjanjem stranske vrstice). Čeprav je tehnično možno uporabiti oba, je veliko bolj varno uporabiti tistega, ki ste ga predpisali. id.
S spodnjo kodo v eni od vaših predlog lahko postavite stransko vrstico primarni opisano tik zgoraj. Upoštevajte to div z razred in id Lahko spremenite po lastni presoji in privijete različne css slogi.
< div id = "id-vidgeta-primary" class = "moi-saidbar" > // pokličite funkcijo prikaza vrstice spletnega mesta
< / div > |
Običajno se ta koda nahaja v datoteki stranska vrstica - primarni . php, o katerem boste izvedeli v trenutku, ko bomo govorili o predlogah stranske vrstice. Vendar dinamična_stranska vrstica() lahko pokličete kjer koli v vaši temi.
- Delamo in
Privzeti prikaz vsebine
Nekateri razvijalci tem prikažejo lastno vsebino, če uporabnik ni pripel nobenega gradnika na določeno stransko vrstico. Če želite v stranski vrstici preveriti pripomočke, uporabite pogojno oznako is_active_sidebar() .
Tako kot funkcija dinamična_stranska vrstica(), ki se uporablja za zapolnitev stranske vrstice, funkcije is_active_sidebar() vedno zahteva parameter $index, ki naj bi bila ID stransko vrstico, ki jo preverjate.
S spodnjo kodo lahko preizkusimo stransko vrstico primarni za pripomočke. Če so widgeti, jih bomo prikazali, če ne, bomo prikazali vsebino, ki smo jo posebej pripravili.
< div id = "id-vidgeta-primary" class = "moi-saidbar" >
< / div > |
Ne prikazuje stranske vrstice brez pripomočkov
Prejšnji razdelek vam je pokazal, kako postaviti manjkajočo vsebino, ko določena stranska vrstica ni aktivna, vendar imate tudi možnost, da stransko vrstico popolnoma strnete (ničesar ne prikažete), ko stranska vrstica ni aktivna.
Ponovno bomo uporabili funkcijo is_active_sidebar() da preverite stransko vrstico primarni za pripomočke.
< div id = "id-vidgeta-primary" class = "moi-saidbar" >
< / div >
|
Mimogrede, tukaj si lahko omislite nekaj zanimivih stvari. Ustvarite lahko na primer dinamično širino stranske vrstice za svojo vsebino glede na to, katere stranske vrstice so aktivne in katere ne. Več o tem v naslednjih člankih.
Predloge stranske vrstice – stranska vrstica
Dotaknili smo se vseh vidikov ustvarjanja in dela z dinamično stransko vrstico, vendar je treba opozoriti, da obstajajo še druge zanimive funkcije. Oglejmo si torej predloge stranske vrstice.
Predloga stranske vrstice se uporablja za gostovanje kode dinamične stranske vrstice (glejte »Dinamični prikaz stranske vrstice« zgoraj). V povprečju imajo vse teme WordPress eno imenovano predlogo stranska vrstica. php. Če ima vaša tema eno stransko vrstico, ta predloga zadostuje.
Predloge stranske vrstice se izpolnijo znotraj teme s funkcijo get_sidebar().Spodnja koda je tisto, kar običajno uporabljam za polnjenje datoteke stranska vrstica. php.
[ barvica - 5e1ff7d788042260898923 inline = "true" ] |
get_sidebar() vedno zahteva tudi parameter $ ime, ki vam bo omogočil izpolnjevanje bolj specifičnih vzorcev. Na primer, spodnja koda zahteva datoteko predloge stranska vrstica - primarni . php.
[ barvica - 5e1ff7d788051693571425 inline = "true" ] |
Če želite ohraniti svojo temo v redu in ločiti kodo, morate ustvariti posebno predlogo za vsako dinamično stransko vrstico. Predlagam, da najprej ustvarite dve dinamični stranski vrstici z edinstvenim id: primarni in sekundarni. Za boljšo organizacijo ustvarite dve datoteki: stranska vrstica - primarni . php in sidebar-secondary. php.
Za ustvarjanje obeh predlog boste potrebovali spodnjo kodo.
[ barvica - 5e1ff7d788066428860015 inline = "true" ]
|
Zgoraj je tradicionalna koda, ki jo uporabljam za ustvarjanje predlog. Lahko ga nekoliko spremenite, da najbolje ustreza vašim osebnim zahtevam. Še vedno morate zagotoviti, da uporabljate funkcijo get_sidebar() pri izpolnjevanju predloge stranske vrstice.
Upoštevajte, da predloge stranske vrstice ne prikazujejo vedno dinamičnih stranskih vrstic. Tehnično lahko vsebujejo kodirano uporabniško vsebino, ki lahko odraža karkoli. Ne pozabite tudi, da lahko postavite dinamično stransko vrstico v skoraj vsako datoteko svoje predloge za prikaz na različnih straneh spletnega mesta.
Slaba koda stranske vrstice
Obstajajo številne napake, ki se ponavljajo iz kode v kodo, kar na dobrih spletnih mestih ni sprejemljivo. Vsi seveda niso tehnično nepravilni, lahko pa povzročijo okvare ali pa so preprosto dodatna obremenitev kode.
1. težava: odložena neurejena koda funkcije. php
Če razvijate teme, morate vedeti, da vgrajene kljuke WordPress delujejo s kavlji. Treba jih je ne samo dobro poznati, pomembno jih je tudi uporabljati. Največja težava, ki sem jo našel, je ta, da se koda preprosto vrže vanj funkcije. php. Ustvarite funkcijo registracije stranske vrstice in jo nato priložite widgets_init. Primer, kako to narediti, si lahko ogledate zgoraj v razdelku Registracija in ustvarjanje dinamične stranske vrstice.
Kot stransko opombo: Pozabite, da lahko kodo preprosto odložite funkcije. php. Vedno uporabljajte funkcijo hooks v WordPressu, to bo zagotovilo, da so vaše funkcije 100% popolne.
Problem 2: ni registriranih ID-jev
Pomembno je razumeti, da če ID ni jasno naveden, bo to zagotovo povzročilo določene posledice. Ko uporabljate register_sidebar() oz register_sidebars() brez predpisovanja posameznika id, WordPress samodejno ustvari indikatorje id, pri čemer šteje število že ustvarjenih stranskih vrstic. In zdi se, da je vse čudovito. Ampak to je velika napaka. Konec koncev, ko plugin oz otroška tema ustvari novo stransko vrstico, stranski vrstici se dodeli ID 1 (če je prva v toku), kar povzroči spremembo ID-ja vseh drugih stranskih vrstic. Ko uporabnik dostopi do stranske vrstice, bo videl, da so vsi njegovi pripomočki dodeljeni drugi stranski vrstici.
Pripomočki so pritrjeni na dinamično stransko vrstico glede na njeno id. če id spremembe, se premikajo tudi pripomočki. Zato je tako pomembno pravilno predpisovanje id med ustvarjanjem stranske vrstice. Zgoraj, v razdelku »Registracija in ustvarjanje dinamične stranske vrstice«, si lahko ogledate, kako to narediti pravilno.
Še ena prednost jasnega pisanja id je, da točno veš, kaj id namenjen za uporabo v drugih funkcijah, kot je npr dinamična_stranska vrstica() in is_active_sidebar function_exists() ni potrebe. Kot smo že omenili v tem članku, dinamične stranske vrstice obstajajo od leta 2007. To vrsto preverjanja lahko uporabite samo za združljivost s prejšnjimi različicami. Vendar pa večina tem ni združljivih za nazaj in od prejšnje različice ne priporočam uporabe.
Ena od običajnih vrst preverjanja obstoja funkcije register_sidebar() predstavljeno spodaj. Pozabite na to vrsto preverjanja in samo ustvarite stransko vrstico.
if (function_exists("register_sidebar")) dynamic_sidebar include (TEMPLATEPATH . "/sidebar.php" ) ;
To ni najboljši način za prikaz stranske vrstice v temi. Sistem WordPress ima funkcijo get_sidebar(), s katerim lahko to preprosto storite. Vedno ga uporabite, kot je prikazano v zgornjem primeru v razdelku »Predloge stranske vrstice«. To funkcijo bi morali uporabiti, ker kavelj
Včasih obstajajo teme, kjer je samo 1 stranska vrstica in se uporabljajo za potrebe same teme in tja ne morete postaviti novih pripomočkov. Morda morate spremeniti obstoječo predlogo teme in dodati dodatno stransko vrstico, recimo, da ima tema eno na levi, vendar morate dodati še eno na desni.
Reševanje tega problema sploh ni težko. Dovolj je, da naredite majhne spremembe v datotekah teme functions.php in datoteki predloge strani, kamor želite postaviti stransko vrstico. Kako ugotoviti, katera datoteka je odgovorna za prikaz strani
Najprej morate registrirati novo stransko vrstico. To se naredi v datoteki functions.php v mapi predloge. register_sidebar(array("name" =>"Nova stranska vrstica", "id" => "secondary-widget-area", "before_widget" => "", "after_title" => "
",));
Končano, na nadzorni plošči pripomočkov se je pojavila nova stranska vrstica. Ostaja le še nekoliko prilagoditi njegov videz v datoteki style.css (videz lahko kopirate iz obstoječega)
Kaj je kaj v kodi
Ime– ime stranske vrstice (sidebar), prikazano bo v skrbniški plošči Widgets.
id- enolični identifikator. Potreben pri dodajanju na stran.
pred_pripomočkom- kodo ali besedilo, ki se vstavi pred vsak gradnik.
after_widget- koda ali besedilo, ki se vstavi za vsakim pripomočkom.
pred_naslovom– koda ali besedilo, ki se vstavi pred naslov gradnika.
po_naslovu– koda ali besedilo, ki se vstavi za naslovom gradnika.
Bodite pozorni na ID, ime stranske vrstice, v tem primeru je to "sekundarno-območje-gradnikov". Biti mora popolnoma enako imenu, podanemu med registracijo v datoteki functions.php.
Stranska vrstica je posebno polje na spletnem mestu, kjer so vdelani pripomočki. Z drugimi besedami, to je stolpec z dinamično vsebino. Skoraj vse predloge imajo takšne stolpce in njihovo število je lahko različno. Pogosto se uporablja od 1 do 4 stolpcev.
Da bi bila vsaka predloga čim bolj unikatna ali da bi preprosto izboljšali videz ali izstopali, lahko spremenite položaj stolpcev glede na glavno besedilno polje v standardnih, brezplačnih in plačljivih predlogah za WordPress, kar bomo tudi storili. v tem članku.
Spreminjanje lokacije stranske vrstice in telesa besedila
Recimo, da ima predloga, ki jo uporabljamo, en stolpec za pripomočke, to je eno stransko vrstico, in en glavni stolpec, kjer je besedilo naših člankov in strani:
Naj se stolpec s pripomočki nahaja na desni in ga moramo premakniti na levo do samega roba. V skladu s tem se stolpec z glavno besedilno vsebino premakne v desno do samega roba.
Če želite narediti vse to, morate nekoliko spremeniti sloge. Besedilna vsebina ima pogosto slog #content, medtem ko ima vsebina pripomočkov pogosto slog #sidebar. Vse, kar je potrebno, je spremeniti lastnosti prvega iz float: levo; na plovcu: desno; in v drugem zaporedju za drugo.
Spremenite lokacijo stranske vrstice v temi Twenty Twelwe
Razmislite o vsem zgoraj navedenem na primeru standardne odzivne teme za WordPress.
Stranska vrstica - del skoraj katerega koli spletnega mesta, običajno postavljena levo, desno od področja vsebine ali pred nogo (nogo). Stranske vrstice WordPress niso izjema. Edina razlika je v tem, da je v WordPressu stranska vrstica območje, kjer se pripomočki samodejno prikažejo. V WordPressu lahko ustvarite neomejeno število stranskih vrstic, vendar bom na primer ustvaril dve stranski vrstici, levo in desno od območja glavne vsebine.
Registracija stranskih vrstic WordPress
Da bi bile stranske vrstice najprej prikazane v skrbniški plošči, jih moramo registrirati. Z drugimi besedami, dodajte kodo v datoteko functions.php:
/** * Registriraj stranske vrstice. */ funkcija fwbs_widgets_init() ( register_sidebar(array("name" => __("Desni stolpec", "fwbs"), "id" => "sidebar-1", "description" => __("Desna stranska vrstica " , "fwbs"), "before_widget" => " ", "before_title" => "
", "after_title" => "
",)); register_sidebar(array("name" => __("Levi stolpec", "fwbs"), "id" => "sidebar-2", "description" => __("Levi stolpec v nogi mesta ", "fwbs"), "before_widget" => " ", "before_title" => "", "after_title" => "
",)); ) add_action("widgets_init", "fwbs_widgets_init");Razčlenitev zgornje kode za ustvarjanje stranskih vrstic WordPress
Ni tako zapleteno, kot se zdi na prvi pogled.
- "name" => __("Right column", "fwbs") - ime območja pripomočkov, lahko napišete poljubno ime, le previdno med oklepaji, poglejte na zaslon in vidite, kje je prikazano;
- "id" => "sidebar-1" - ID je edinstven identifikator, dodeljen stranski vrstici, vse stranske vrstice morajo imeti svoje, drugačne od drugih ID-jev;
- "description" => __("Right side column", "fwbs") - opis, podoben imenu območja pripomočkov;
- "before_widget" => "
- "after_widget" => "" - oznaka HTML, ki zapre območje stranske vrstice. Kot vemo, morajo biti vse oznake HTML, z nekaterimi izjemami, seznanjene (odpiranje in zapiranje);
- "before_title" => "
" - naslov pripomočka bo zavit v oznako H4 z razredom
, lahko spremenite pomen glave H1, H2, H3, H4, H5, H6 in dodelite svoje razrede;
- "after_title" => ""- zapiranjeparna oznaka za naslov pripomočka.
Zdaj gremo na skrbniško ploščo, v razdelek "pripomočki" in si oglejte rezultat. Tukaj je slika tega, kar sem dobil:
S to kodo sem registriral dve coni gradnikov WordPress, zdaj ju moram prikazati na zaslonu.
Prikaz stranskih vrstic WordPress
Če želite prikazati stranske vrstice kjer koli v predlogi, je logično, da na pravo mesto napišete naslednjo kodo:
Nekaj pojasnil o kodi:
- - PHP koda, ki daje ukaz, če so v stranski vrstici pod id=sidebar-1 gradniki, naj bo prikazana na zaslonu, če gradnikov ni, stranska vrstica ni prikazana;
- - Koda PHP, ki prikliče stransko vrstico pod id=sidebar-1 na mestu, kjer ste jo zapisali v kodi predloge.
Toda kot lahko vidite, je v predlogah WordPress izhodna koda stranske vrstice postavljena v ločene datoteke sidebar.php, nato pa je vsebina izpisana iz datoteke sidebar.php na pravo mesto v predlogi. Ker vemo, da WordPress vsebino upodablja dinamično in je predloga spletnega mesta sestavljena iz več delov, je eden od njenih delov datoteka sidebar.php Let me do that.
Ustvarjanje datoteke sidebar.php
Ustvarite datoteko, kot je sidebar-right.php, ji dajte naslov in vanjo prilepite zgornjo kodo. Vse skupaj bo izgledalo takole:
Kot lahko vidite iz primera, sem kodo dopolnil z dodatnimi oznakami HTML. Zdaj, da prikažete območje pripomočkov, ostane še, da napišete naslednje na pravo mesto:
Za levi stranski stolpec je datoteka sidebar-left.php ustrezno ustvarjena in izpisana na desnem mestu predloge, kot je ta:
Kot pravijo, poiščite eno razliko v kodi.
To je to, stranske vrstice so ustvarjene, zdaj je ostalo le še, da v predlogi ustvarimo oznako zanje in napišemo sloge CSS.
