oldalsáv wordpress. WordPress oldalsávok, WordPress oldalsávok létrehozása. Alapértelmezett WordPress widgetek

Megjeleníti az első aktív widget panelt (az oldalsáv olyan panel, amely legalább egy widgetet tartalmaz). Megadhatja a panel azonosítóját vagy számát, hogy melyiket jelenítse meg, ha a webhely egynél több widget panellel rendelkezik.

A dynamic_sidebar() igaz vagy hamis értéket ad vissza, és a visszatérési eredmény a widgetsávot is megjeleníti. A visszatérési érték felhasználható például annak meghatározására, hogy fel kell-e dolgozni a widgeteket helyettesítő kódot, ha nincsenek widgetek a panelen (lásd az 1. példát).

visszatér

igaz, ha a widget panelt megtalálták. false, ha a panel nem létezik, vagy nem tartalmaz widgetet.

Használat

Példák

#1 Jelenítse meg az oldalsávot, ha létezik.

Ez a példa bemutatja, hogyan jeleníthető meg az első nem üres oldalsáv (az oldalsáv azonosítója nem lett megadva a regisztráció során), vagy ha nem található, dolgozza fel a megadott kódot:

#2 Jelenítse meg a kívánt oldalsávot.

#3 Ellenőrizze a panel jelenlétét, és jelenítse meg

A 2. példában nem ellenőriztük, hogy van-e benne panel és widgetek. Ebben a példában ellenőrizni fogjuk a panel jelenlétét, hogy ne jelenjen meg felesleges HTML címkék (

), ha az oldalsáv üres:

Több oldalsáv

Ha egynél több widget panelt regisztrál a register_sidebar() paraméterrel, kényelmesebb minden panelhez megadni egy azonosítót.

Az azonosítót nem tudjuk megadni, akkor a panel sorszámot kap. De ebben az esetben a téma szerkesztésekor nehéz lesz megérteni, melyik panel melyik, mert az 1, 2, 3 számok nem jelentenek semmit. De ha beállítja a nevet, sokkal világosabb lesz:

// --- számok// regisztráció register_sidebar(); // kimenet dynamic_sidebar(1); // --- Húrok// regisztráció register_sidebar(array("id" => "top_menu")); // kimenet dynamic_sidebar("top_menu");

A példából jól látható, hogy a karakterláncokkal kényelmesebb: ha belenézünk a témába, és látjuk a dynamic_sidebar("top_menu") parancsot, azonnal látható, hogy a főmenü paneljét hívják meg.

Az id argumentum nem tartalmazhat szóközt, nagybetűt és cirill betűket. Használhat benne gondolatjelet - és aláhúzásjelet _. Egyedinek is kell lennie. Az azonosító megadásával megadhatjuk a nevét, leírását és fordítását is:

Register_sidebar(array("id" => "top-menu", "name" => __("Top Menu", $text_domain), "description" => __("Ez az oldalsáv az életkor logója felett található.", $szöveg_domain))))

Megjegyzések

• Globális. Sor. $wp_registered_sidebars Regisztrált oldalsávok.
• Globális. Sor. $wp_registered_widgets

Változások listája

A 2.2.0 verzió óta

Bemutatott.

Kód dinamikus oldalsáv: wp-includes/widgets.php WP 5.3.2

$érték) (if (megtisztítás_cím($érték["név"]) == $index) ( $index = $kulcs; break; ) ) ) $sidebars_widgets = wp_get_sidebars_widgets(); if (empty($wp_registered_sidebars[ $index ]) || empty($sidebars_widgets[ $index ]) || !is_array($sidebars_widgets[ $index ])) ( /** Ez a művelet a wp-includes/widgetben van dokumentálva. php */ do_action("dynamic_sidebar_before", $index, false); /** Ezt a műveletet a wp-includes/widget.php dokumentálja */ do_action("dynamic_sidebar_after", $index, false); /** Ez a szűrő dokumentálva: wp-includes/widget.php */ return apply_filters("dynamic_sidebar_has_widgets", false, $index); ) /** * A widgetek dinamikus oldalsávban való megjelenítése előtt aktiválódik. * * Megjegyzés: A művelet az üres oldalsávok esetén is aktiválódik, valamint az előlapon * és a hátoldalon is, beleértve az Inaktív widgetek oldalsávot a Widgetek képernyőn. * * @3.9.0 óta * * @param int|string $index A dinamikus oldalsáv indexe, neve vagy azonosítója. * @param bool $has_widgets Hogy az oldalsáv tele van-e widgetekkel. * alapértelmezett igaz. */ do_action("dynamic_sidebar_before", $index, true); $oldalsáv = $wp_regisztrált_oldalsávok[ $index ]; $did_one = hamis; foreach ((tömb) $sidebars_widgets[ $index ] mint $id) ( if (! isset($wp_registered_widgets[ $id ])) ( folytassa; ) $params = array_merge(array(array_merge($sidebar, array("widget_id") => $id, "widget_name" => $wp_registered_widgets[ $id ]["name"],)),), (tömb) $wp_registered_widgets[ $id ]["params"]); // HTML azonosító és osztály helyettesítése attribútumok a before_widgetbe $classname_ = ""; foreach ((tömb) $wp_registered_widgets[ $id ]["osztálynév"] mint $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_); /** * Szűri a widget kijelző-visszahívásának átadott paramétereket. * * Megjegyzés: A szűrő az elő- és a hátoldalon is kiértékelésre kerül, * beleértve a az Inaktív widgetek oldalsávja a Widgetek képernyőn.* * @2.5.0 óta * * @lásd register_sidebar() * * @param tömb $params ( * @typ e tömb $args ( * Widget megjelenítési argumentumok tömbje. * * @type string $name Annak az oldalsávnak a neve, amelyhez a widget hozzá van rendelve. * @type string $id Annak az oldalsávnak az azonosítója, amelyhez a widget hozzá van rendelve. * @type string $description Az oldalsáv leírása. * @type string $class CSS osztály alkalmazva az oldalsáv tárolójára. * @type string $before_widget HTML-jelölés az oldalsáv minden widgetjéhez. * @type string $after_widget HTML jelölés az oldalsáv minden widgetjéhez hozzáfűzni. * @type string $before_title HTML-jelölés a widget cím elé, amikor megjelenik. * @type string $after_title HTML-jelölés, amely a widget címéhez fűződik, amikor megjelenik. * @type string $widget_id A widget azonosítója. * @type string $widget_name A widget neve. * ) * @type array $widget_args ( * Több widget argumentumok tömbje. * * @type int $number Számnövekedés ugyanazon widget többszöröseihez. * ) * ) */ $params = apply_filters("dynamic_sidebar_params", $params); $callback = $wp_registered_widgets[ $id ]["visszahívás"]; /** * A widget kijelzőjének visszahívása előtt aktiválódik. * * Megjegyzés: A művelet az elő- és a hátoldalon is aktiválódik, beleértve a * elemet a widgetek képernyő Inaktív widgetek oldalsávjában. * * A művelet a következő nincs aktiválva üres oldalsávokra * * @3.0.0 óta * * @param array $widget_id ( * Widget argumentumok asszociatív tömbje. * * @type string $name A widget neve. * @type string $id Widget ID. * @type array|hívható $callback Amikor a hook az előlapon van elindítva, a $callback egy tömb *, amely a widget objektumot tartalmazza. A háttérben aktiválva a $callback * "wp_widget_control", lásd: $_callback.* @type tömb $params Több widget argumentumok asszociatív tömbje.* @type string $classname CSS osztály alkalmazva a widget tárolóra.* @type string $description A widget leírása.* @type tömb $_callback Amikor a horog hátul kilőve végén, a $_callback * egy widget objektumot tartalmazó tömbbel van feltöltve, lásd $callback. * ) */ do_action("d ynamic_sidebar", $wp_registered_widgets[ $id ]); if (is_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * A widgetek dinamikus oldalsávban történő megjelenítése után aktiválódik. * * Megjegyzés: A művelet az üres oldalsávok esetén is aktiválódik, valamint az előlapon * és a hátoldalon is, beleértve az Inaktív widgetek oldalsávot a Widgetek képernyőn. * * @3.9.0 óta * * @param int|string $index A dinamikus oldalsáv indexe, neve vagy azonosítója. * @param bool $has_widgets Hogy az oldalsáv tele van-e widgetekkel. * alapértelmezett igaz. */ do_action("dynamic_sidebar_after", $index, true); /** * Szűri, hogy az oldalsáv tartalmaz-e widgeteket. * * Megjegyzés: A szűrőt az üres oldalsávokra is kiértékeli a rendszer, mind az előlapon *, mind a hátulján, beleértve az Inaktív widgetek oldalsávot is a Widgetek képernyőn. * * @3.9.0 óta * * @param bool $did_one Megjelenik-e legalább egy widget az oldalsávban. * alapértelmezett false. * @param int|string $index A dinamikus oldalsáv indexe, neve vagy azonosítója. */ return apply_filters("dynamic_sidebar_has_widgets", $did_one, $index); )

Hello barátok! Ahogy ígértem, készítettem egy témát erről WordPress oldalsávok. Ez egy kis útmutató az oldalsávok használatához és testreszabásához a WordPress webhelyeken.

Ebben a témakörben szeretnék egy kis titkot felfedni minden sablonfejlesztő előtt: az oldalsávok mindig is fontos részét képezték a WordPress rendszernek, és az elmúlt néhány évben sokat fejlődtek.

Figyelembe véve a legújabb fejleményeket, lépésről lépésre mutatom meg az oldalsávok létrehozásának és használatának folyamatát a WordPress témákhoz.

Mi az a WordPress oldalsáv?

Valójában az „oldalsáv (oldalsáv)” két teljesen független fogalmat jelenthet a WordPress rendszerben:

1. Dinamikus oldalsáv: egy tároló a widgetek készletéhez, amelyeket a felhasználó az adminisztrációs panelen keresztül telepíthet -> Widgetek szakasz.
2. Oldalsáv sablon: Ez a webhelysablon által megjelenített oldalsáv.

A legtöbb esetben az egyszerű sablonoknak van egy dinamikus oldalsávja, amely betölti az összes elhelyezett widgetet az adminisztrációs panelről. Ez a folyamat egy másik algoritmus szerint is végbemehet, de leggyakrabban ennek a séma szerint. Ennek ellenére fontos megérteni, hogy a dinamikus oldalsáv és az oldalsávsablon két különböző dolog. Minden prémium, főleg az Oldalsáv sablonnal dolgozom.

Általában az „oldalsáv” kifejezést a dinamikus oldalsávval kapcsolatban használják, amelyről ebben a cikkben lesz szó. Kitérek azonban az oldalsáv sablonjára is.

A legtöbb téma böngészése során az okozott csalódást, hogy a fejlesztők nem használják ki teljes mértékben a WordPress rendszer legerősebb funkcióit. A legtöbb témának csak egy oldalsávja van, a legjobb esetben kettő. De végül is ezek a témák hatalmas oldalakat hoznak létre egy sor lehetőséggel, amelyek widgetek segítségével könnyen feldolgozhatók, és tartalmuk közvetlenül a sablonba helyezhető. Inkább sok oldalsávot használok egy témában egy rugalmas, funkciókban gazdag webhely létrehozásához.

WordPress oldalsáv regisztrációja, hozzáadása és létrehozása

Sok téma gyakran nem felel meg a minőségi szabványoknak, ezért ha Ön sablonfejlesztő, akkor ügyeljen arra, hogy komolyan vegye ezt a problémát. Megfelelő dinamika kialakítása WordPress oldalsáv a folyamat legfontosabb része, mert amit beállítasz, az az oldalsáv összes többi funkciójához kapcsolódik.

Egy vagy több oldalsáv létrehozásához regisztrálnia kell azokat egy fájlon keresztül funkciókat. php A témának, minden témának saját fájlja van, amely tartalmazza az összes sablonbeállítást. Fájlhoz funkciókat. php Hozzáadhat vagy eltávolíthat témabeállításokat.

Az alábbi kód bemutatja, hogyan hozhat létre oldalsávot a WordPressben a funkció használatával register_sidebar(). Ebben az esetben létrehozunk egy „elsődleges” oldalsávot, amely példaként szolgál majd a munkához.

"primary", "name" => __("Elsődleges"), "description" => __("Az oldalsáv leírása (látható az adminisztrációs panelen)."), "before_widget" => "

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

", "after_title" => "

")); /* A register_sidebar() függvényt megismételheti más widgeteknél is, az id mezőnek egyedinek kell lennie (elsődleges, másodlagos, moiwidget stb. */ ) ?>

add_action("widgets_init" , "registriruem_sidebari" ) ; függvény register_sidebari() ( /* Regisztrálja az "elsődleges" oldalsávot. */ register_sidebar( sor( "id" => "primary" , "name" => __("Elsődleges") , "leírás" => __( "Az oldalsáv leírása (az adminisztrációs panelen látható).") , "before_widget" => " " , "after_widget" => " " , "before_title" => " " , "after_title" => " " /* Megismételheti a register_sidebar() függvényt más widgeteknél, az id mezőnek egyedinek kell lennie (elsődleges, másodlagos, moiwidget stb. */

Amint látja, az oldalsáv regisztrálása nagyon egyszerű feladat, ha rendelkezik információval a végrehajtás módjáról.

Érvek a dinamikus oldalsáv létrehozásához dynamic_sidebar()

Funkció register_sidebar() csak egy paramétert fogad el, ezt hívják $argsés argumentumkészletet tartalmaz, amelyek meghatározzák, hogy az oldalsáv a widgetekkel hogyan jelenjen meg. Ezután tekintsen meg példákat az argumentumok kézi használatára.

ID

Érv id, valószínűleg az egyik legfontosabb érv az íráshoz (nézze meg alább a rosszul megírt kód példáját, és nézze meg, miért kell feltétlenül megírnia). A WordPress fogja használni id hogy widgeteket rendeljen egy adott oldalsávhoz, és szüksége lesz rá id az oldalsáv további kitöltéséhez - oldalsáv.

Minden id egyedinek kell lennie. A WordPress alapértelmezés szerint ezt írja elő oldalsáv-$i(Ahol $i

//widget azonosítónk, amely csak egyszer van hozzárendelve "id" => "primary",

Név

Bármilyen nevet írhat, amelyről úgy gondolja, hogy a legjobban tükrözi az Ön nevét WordPress oldalsáv. Az oldalsávok leggyakrabban olyan neveket kapnak, amelyek alapján a felhasználó meghatározhatja, hogy a téma mely aspektusait érinti (például bal vagy jobb oldalsáv). Ez az érv nemzetköziesíthető (azaz más nyelvekre lokalizálható). Ezért ügyeljen arra, hogy a megfelelő szövegtartományt írja be, amikor előkészíti a témát a fordításra. Az argumentum alapértelmezés szerint Oldalsávként van írva $i(Ahol $i a létrehozott oldalsáv sorszáma).

//widget neve, a példában az Elsődlegeset használom a widget azonosítójának neveként "name" => "Elsődleges",

leírás

Érv leírás először a WordPress 2.9-ben jelent meg. Ez az argumentum lehetővé teszi a widget leírását, a leírás az adminisztrációs panelen, a Widgetek részben jelenik meg. Ez az argumentum alapértelmezés szerint egy üres karakterláncba van írva. Nemzetközivé is lehet tenni (azaz cirill betűvel vagy más nyelven írható).

//a leírás látható lesz a widgetek részben "description" => __("A webhely bal oldali oszlopának modulja"),

előtt_widget

Érv előtt_widget ez az oldalsávhoz rendelt widget nyitó eleme. Ennek is blokk szintű elemnek kell lennie HTML jelölés (pl. tag < li > , < p > , < div > stb.). Ennek az argumentumnak van néhány jellemzője, amelyeket például beírhat id="" vagy class="": attribútumok id=""így írják: (%1$s)és attribútumok class=""Így: (%2$s).

Alapértelmezés szerint a WordPress listaelemként fogja felsorolni őket: < li id = "%1$s" > . Nem rajongok az oldalsáv widget listaelemeinek létrehozásáért. mindig használom < div > . Nem rajongok az oldalsáv widget listaelemeinek létrehozásáért. Utoljára használtam, mert widget hiányában az oldalon nem fog látni extra HTML címkéket, de továbbgondoljuk, hogyan lehet megszabadulni tőlük.

after_widget

Érv after_widget elég könnyű létrehozni. Ez az oldalsávhoz rendelt widget záró eleme. Csak be kell zárnia az argumentumhoz megadott elemet előtt_widget. Alapértelmezés szerint a WordPress a következőként írja ki < li > .

"after_widget" => "