bočný panel wordpress. Postranné panely WordPress, vytváranie bočných panelov WordPress. Predvolené widgety WordPress

Zobrazí prvý aktívny panel miniaplikácií (bočný panel je panel, ktorý obsahuje aspoň jednu miniaplikáciu). Môžete zadať ID alebo číslo panelu, ktorý sa má zobraziť, ak má lokalita viac ako jeden panel miniaplikácií.

dynamic_sidebar() vráti hodnotu true alebo false, pričom výsledok návratu zobrazí aj panel miniaplikácií. Návratovú hodnotu možno použiť napríklad na určenie, či sa má spracovať kód, ktorý nahrádza miniaplikácie, keď na paneli nie sú žiadne miniaplikácie (pozri príklad č. 1).

sa vracia

true, ak bol nájdený panel miniaplikácií. false, ak panel neexistuje alebo neobsahuje žiadne widgety.

Použitie

Príklady

#1 Zobrazte bočný panel, ak existuje.

Tento príklad ukazuje, ako zobraziť prvý neprázdny bočný panel (identifikátor bočného panela nebol zadaný počas registrácie) alebo ak sa nenájde, spracovať zadaný kód:

#2 Zobrazte požadovaný bočný panel.

#3 Skontrolujte prítomnosť panela a zobrazte ho

V príklade 2 sme nekontrolovali prítomnosť panela a miniaplikácií v ňom. V tomto príklade skontrolujeme prítomnosť panela, aby sa nezobrazoval zbytočný HTML tagy (

), ak je bočný panel prázdny:

Viacero bočných panelov

Pri registrácii viac ako jedného panelu miniaplikácií pomocou register_sidebar() je pohodlnejšie zadať id pre každý panel.

Nemôžeme špecifikovať ID, potom panel dostane sériové číslo. Ale v tomto prípade pri úprave témy bude ťažké pochopiť, ktorý panel je ktorý, pretože čísla 1, 2, 3 nič neznamenajú. Ale ak nastavíte názov, bude to oveľa jasnejšie:

// --- čísla// registrácia register_sidebar(); // výstup dynamic_sidebar(1); // --- Struny// registrácia register_sidebar(array("id" => "top_menu")); // výstup dynamic_sidebar("top_menu");

Z príkladu je zrejmé, že s reťazcami je to pohodlnejšie: keď sa pozriete do témy a uvidíte dynamic_sidebar("top_menu"), je hneď jasné, že sa volá panel pre hlavné menu.

Argument id nesmie obsahovať medzery, veľké písmená ani cyriliku. Môžete použiť pomlčku - a podčiarkovník _ v nej. Musí byť tiež jedinečný. Zadaním id môžeme pre ne určiť aj názov, popis a preklady:

Register_sidebar(array("id" => "hlavné menu", "meno" => __("Hlavné menu", $text_domain), "popis" => __("Tento bočný panel sa nachádza nad logom veku.", $text_domain))))

Poznámky

• globálne. Pole. $wp_registered_sidebars Registrované bočné panely.
• globálne. Pole. $wp_registered_widgets

Zoznam zmien

Od verzie 2.2.0

Predstavený.

kód dynamický bočný panel: wp-includes/widgets.php WP 5.3.2

$hodnota) ( if (sanitize_title($value["meno"]) == $index) ( $index = $kľúč; zlom; ) ) ) $sidebars_widgets = wp_get_sidebars_widgets(); if (empty($wp_registered_sidebars[ $index ]) || empty($sidebars_widgets[ $index ]) || !is_array($sidebars_widgets[ $index ])) ( /** Táto akcia je zdokumentovaná v wp-includes/widget. php */ do_action("dynamic_sidebar_before", $index, false); /** Táto akcia je zdokumentovaná v wp-includes/widget.php */ do_action("dynamic_sidebar_after", $index, false); /** Tento filter je zdokumentované v wp-includes/widget.php */ return apply_filters("dynamic_sidebar_has_widgets", false, $index); ) /** * Spustí sa pred vykreslením miniaplikácií v dynamickom bočnom paneli. * * Poznámka: Akcia sa spustí aj pre prázdne bočné panely a na prednej * aj zadnej strane, vrátane bočného panela Neaktívne miniaplikácie na obrazovke Widgety. * * @od 3.9.0 * * @param int|string $index Index, názov alebo ID dynamického bočného panela. * @param bool $has_widgets Či je bočný panel vyplnený miniaplikáciami. * predvolená hodnota true. */ do_action("dynamic_sidebar_before", $index, true); $sidebar = $wp_registered_sidebars[ $index ]; $did_one = false; foreach ((pole) $sidebars_widgets[ $index ] ako $id) ( if (! isset($wp_registered_widgets[ $id ])) (pokračovať; ) $params = array_merge(array(array_merge($sidebar, array("widget_id"" => $id, "widget_name" => $wp_registered_widgets[ $id ]["name"],)),), (pole) $wp_registered_widgets[ $id ]["params"]); // Nahradenie ID a triedy HTML atribúty do before_widget $classname_ = ""; foreach ((pole) $wp_registered_widgets[ $id ]["classname"] ako $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_); /** * Filtruje parametre odovzdané spätnému volaniu obrazovky miniaplikácie. * * Poznámka: Filter sa vyhodnocuje na frontende aj backende, * vrátane bočný panel Neaktívne miniaplikácie na obrazovke Widgety.* * @od 2.5.0 * * @pozri register_sidebar() * * @param pole $params ( * pole @type $args ( * Pole argumentov zobrazenia miniaplikácie. * * @type string $name Názov bočného panela, ku ktorému je priradený widget. * @type string $id ID bočného panela, ku ktorému je priradený widget. * @type string $description Popis bočného panela. * @type string $class Trieda CSS použitá na kontajner bočného panela. * @zadajte reťazec $before_widget HTML označenie, ktoré sa pridá pred každú miniaplikáciu na bočnom paneli. * @zadajte reťazec $after_widget HTML označenie, ktoré sa pridá ku každej miniaplikácii na bočnom paneli. * @type string $before_title Označenie HTML, ktoré sa pri zobrazení pridá pred názov miniaplikácie. * @zadajte reťazec $after_title HTML označenie, ktoré sa pri zobrazení pridá k názvu miniaplikácie. * @type string $widget_id ID miniaplikácie. * @type string $widget_name Názov widgetu. * ) * @type pole $widget_args ( * Pole argumentov viacerých miniaplikácií. * * @type int $number Prírastok čísla použitý pre násobky tej istej miniaplikácie. * ) * ) */ $params = apply_filters("dynamic_sidebar_params", $params); $callback = $wp_registered_widgets[ $id ]["callback"]; /** * Spustí sa pred zavolaním spätného volania displeja miniaplikácie. * * Poznámka: Akcia sa spustí na prednej aj zadnej strane, vrátane * pre miniaplikácie na bočnom paneli Neaktívne miniaplikácie na obrazovke Widgety. * * Akcia je nespustí sa pre prázdne bočné panely. * * @od 3.0.0 * * pole @param $widget_id ( * Asociatívne pole argumentov widgetu. * * @type string $name Názov widgetu. * @type string $id ID miniaplikácie. * @type array|callable $callback Keď sa spustí háčik na frontende, $callback je pole * obsahujúce objekt widgetu. $callback * je spúšťaný na zadnej strane, $callback * je "wp_widget_control", pozri $_callback.* @type pole $params Asociatívne pole argumentov viacerých miniaplikácií.* @type string $classname Trieda CSS použitá na kontajner widgetu.* @type string $description Popis widgetu.* @type pole $_callback Keď sa spustí hák na zadnej strane end, $_callback je vyplnený * poľom obsahujúcim objekt widgetu, pozri $callback.* ) */ do_action("dynamic_sidebar", $wp_registered_widgets[ $id ]); if (is_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * Spustí sa po vykreslení miniaplikácií v dynamickom bočnom paneli. * * Poznámka: Akcia sa spustí aj pre prázdne bočné panely a na prednej * aj zadnej strane, vrátane bočného panela Neaktívne miniaplikácie na obrazovke Widgety. * * @od 3.9.0 * * @param int|string $index Index, názov alebo ID dynamického bočného panela. * @param bool $has_widgets Či je bočný panel vyplnený miniaplikáciami. * predvolená hodnota true. */ do_action("dynamic_sidebar_after", $index, true); /** * Filtruje, či má bočný panel widgety. * * Poznámka: Filter sa vyhodnocuje aj pre prázdne bočné panely a na prednej * aj zadnej strane, vrátane bočného panela Neaktívne miniaplikácie na obrazovke Widgety. * * @od 3.9.0 * * @param bool $did_one Či sa na bočnom paneli vykreslil aspoň jeden widget. * predvolená hodnota false. * @param int|string $index Index, názov alebo ID dynamického bočného panela. */ return apply_filters("dynamic_sidebar_has_widgets", $did_one, $index); )

Dobrý deň, priatelia! Ako som sľúbil, vytvoril som tému o Postranné panely WordPress. Toto je malý sprievodca používaním a prispôsobením bočných panelov na stránkach WordPress.

V tomto vlákne chcem všetkým vývojárom šablón odhaliť malé tajomstvo: postranné panely boli vždy dôležitou súčasťou systému WordPress a za posledných pár rokov sa výrazne zlepšili.

Berúc do úvahy najnovší vývoj, ukážem vám krok za krokom proces vytvárania a používania bočných panelov pre témy WordPress.

Čo je bočný panel WordPress?

V skutočnosti môže výraz „bočný panel (bočný panel)“ znamenať dva úplne nesúvisiace koncepty v systéme WordPress:

1. Dynamický bočný panel: kontajner pre súpravu miniaplikácií, ktoré si používateľ môže nainštalovať cez admin panel -> sekcia Widgety.
2. Šablóna bočného panela: Toto je bočný panel, ktorý sa zobrazuje podľa šablóny lokality.

Vo väčšine prípadov majú jednoduché šablóny dynamický bočný panel, ktorý načíta všetky umiestnené miniaplikácie z panela správcu. Tento proces môže prebiehať aj podľa iného algoritmu, najčastejšie však podľa tejto schémy. Napriek tomu je dôležité pochopiť, že dynamický bočný panel a šablóna bočného panela sú dve rôzne veci. Všetko je prémiové, pracujem hlavne so šablónou Sidebar.

Pojem „bočný panel“ sa zvyčajne používa v súvislosti s dynamickým bočným panelom, o ktorom sa bude diskutovať v tomto článku. Dotknem sa však aj šablóny bočného panela.

Najviac ma pri prehliadaní mnohých tém sklamalo, že vývojári nevyužívajú naplno tie najvýkonnejšie funkcie systému WordPress. Väčšina tém má iba jeden bočný panel, najlepšie dva. Ale koniec koncov, tieto témy vytvoria obrovské stránky so sadou možností, ktoré sa dajú jednoducho spracovať pomocou widgetov a ich obsah je možné umiestniť priamo do šablóny. Uprednostňujem použitie veľkého množstva bočných panelov v téme na vytvorenie flexibilnej stránky s množstvom funkcií.

Registrácia, pridanie a vytvorenie bočného panela WordPress

Mnohé témy často nespĺňajú štandardy kvality, takže ak ste vývojár šablón, uistite sa, že tento problém beriete vážne. Vytvorenie vhodnej dynamiky Bočný panel WordPress je najdôležitejšou súčasťou procesu, pretože to, čo v ňom nastavíte, bude súvisieť so všetkými ostatnými funkciami bočného panela.

Ak chcete vytvoriť jeden alebo viac bočných panelov, budete ich musieť zaregistrovať prostredníctvom súboru funkcie. php Vaša téma, každá téma má svoj vlastný súbor, ktorý obsahuje všetky nastavenia šablóny. Vyplniť funkcie. php Môžete pridať alebo odstrániť nastavenia témy.

Nižšie uvedený kód ukazuje, ako môžete pomocou funkcie vytvoriť bočný panel vo WordPress register_sidebar(). V tomto prípade vytvoríme bočný panel s názvom 'primárny', ktorý bude slúžiť ako príklad na prácu.

"primárny", "názov" => __("Primárny"), "popis" => __("Popis bočného panela (viditeľný na paneli správcu)."), "pred miniaplikáciou" => "

", "after_widget" => "
", "before_title" => "

", "after_title" => "

")); /* Funkciu register_sidebar() môžete zopakovať pre iné widgety, pole id musí byť jedinečné (primárne, sekundárne, moiwidget atď. */ ) ?>

add_action("widgets_init" , "registriruem_sidebari" ); funkcia register_sidebari() ( /* Zaregistrujte "primárny" bočný panel. */ register_sidebar( pole( "id" => "primárne" , "name" => __("Primárne") , "popis" => __( "Popis bočného panela (viditeľný na paneli správcu).") , "before_widget" => " " , "after_widget" => " " , "before_title" => " " , "after_title" => " " /* Funkciu register_sidebar() môžete zopakovať pre iné widgety, pole id musí byť jedinečné (primárne, sekundárne, moiwidget atď. */

Ako vidíte, registrácia bočného panela je veľmi jednoduchá úloha, ak máte informácie o tom, ako to urobiť.

Argumenty na vytvorenie dynamického bočného panela dynamic_sidebar()

Funkcia register_sidebar() akceptuje iba jeden parameter, je to tzv $args a obsahuje sadu argumentov určujúcich, ako sa má vykresliť bočný panel s jeho widgetmi. Ďalej zvážte príklady manuálneho použitia argumentov.

ID

Argumentovať id, je pravdepodobne jedným z najdôležitejších argumentov na napísanie (pozrite si príklad zle napísaného kódu nižšie a zistite, prečo by ste ho určite mali napísať). WordPress použije id na priradenie miniaplikácií ku konkrétnemu bočnému panelu a budete potrebovať id na ďalšie vyplnenie bočného panela - bočného panela.

Každý id musí byť jedinečný. WordPress to štandardne predpíše pre bočný panel-$i(Kde $i

//naše ID widgetu, ktoré je priradené iba raz "id" => "primárne",

názov

Môžete napísať akékoľvek meno, o ktorom si myslíte, že najlepšie vystihuje vaše meno Bočný panel WordPress. Bočné panely sú najčastejšie pomenované, podľa ktorých môže používateľ určiť, ktorých aspektov témy sa dotýka (napríklad ľavý alebo pravý bočný panel). Tento argument môže byť internacionalizovaný (t. j. lokalizovaný pre iné jazyky). Pri príprave témy na preklad sa teda uistite, že napíšete správnu textovú doménu. Argument je štandardne napísaný ako bočný panel $i(Kde $i je poradové číslo vytvoreného bočného panela).

//názov miniaplikácie, v príklade používam Primary ako názov ID miniaplikácie "name" => "Primary",

popis

Argumentovať popis bol prvýkrát predstavený vo WordPress 2.9. Tento argument vám umožňuje popísať váš widget, popis sa zobrazuje v administračnom paneli v sekcii Widgety. Tento argument sa štandardne zapisuje na prázdny reťazec. Môže byť aj internacionalizovaný (t. j. napísaný v azbuke alebo iných jazykoch).

//popis bude viditeľný v časti widgetov "popis" => __("Widget pre ľavý stĺpec na stránke"),

before_widget

Argumentovať before_widget toto je úvodný prvok miniaplikácie priradenej k bočnému panelu. Musí to byť aj prvok na úrovni bloku HTML označenie (napr. tag < li > , < p > , < div > atď.). Tento argument má niekoľko funkcií, do ktorých môžete napísať napr id="" alebo class="": atribúty id="" sú napísané takto: (%1$s) a atribútov class="" Takže: (%2$s).

V predvolenom nastavení ich WordPress uvedie ako položku zoznamu: < li id = "%1$s" > . Nie som fanúšikom vytvárania položiek zoznamu miniaplikácií na bočnom paneli. Vždy používam < div > . Nie som fanúšikom vytvárania položiek zoznamu miniaplikácií na bočnom paneli. Naposledy to používam, pretože pri absencii widgetu na stránke neuvidíte navyše HTML tagy, ďalej však zvážime, ako sa ich zbaviť.

after_widget

Argumentovať after_widget celkom ľahké vytvoriť. Toto je uzatvárací prvok pre miniaplikáciu priradenú k bočnému panelu. Stačí zatvoriť prvok určený pre argument before_widget. V predvolenom nastavení to WordPress zapíše ako < li > .

"after_widget" => "