bara laterală wordpress. Bare laterale WordPress, crearea barelor laterale WordPress. Widgeturi WordPress implicite

Afișează primul panou widget activ (o bară laterală este un panou care conține cel puțin un widget). Puteți specifica ID-ul sau numărul panoului, care să fie afișat, dacă site-ul are mai multe panouri widget.

dynamic_sidebar() returnează adevărat sau fals, rezultatul returnat afișând și bara de widget-uri. Valoarea returnată poate fi utilizată, de exemplu, pentru a determina dacă codul care înlocuiește widget-urile trebuie procesat atunci când nu există widget-uri în panou (vezi exemplul #1).

se intoarce

adevărat dacă panoul widget a fost găsit. false dacă panoul nu există sau nu conține widget-uri.

Utilizare

Exemple

#1 Afișează bara laterală dacă există.

Acest exemplu arată cum să afișați prima bară laterală negoală (ID-ul barei laterale nu a fost specificat în timpul înregistrării) sau, dacă nu este găsit, procesați codul specificat:

#2 Afișează bara laterală dorită.

# 3 Verificați prezența panoului și afișați-l

În exemplul 2, nu am verificat prezența unui panou și a widget-urilor în el. În acest exemplu, vom verifica prezența unui panou pentru a nu afișa inutil Etichete HTML (

) dacă bara laterală este goală:

Bare laterale multiple

Când înregistrați mai mult de un panou widget cu register_sidebar() , este mai convenabil să specificați un ID pentru fiecare panou.

Nu putem specifica id, atunci panoul va primi un număr de serie. Dar în acest caz, la editarea temei, va fi greu de înțeles care panou este care, deoarece numerele 1, 2, 3 nu înseamnă nimic. Dar dacă setați numele, devine mult mai clar:

// --- numere// înregistrare register_sidebar(); // ieșire dynamic_sidebar(1); // --- Siruri de caractere// înregistrare register_sidebar(array("id" => "top_meniu")); // ieșire bară_laterală_dinamică("meniu_de sus");

Din exemplu, este clar că este mai convenabil cu șiruri de caractere: privind în subiect și văzând dynamic_sidebar("top_menu"), este imediat clar că panoul pentru meniul principal este apelat.

Argumentul id nu trebuie să conțină spații, majuscule, litere chirilice. Puteți folosi o liniuță - și o liniuță de subliniere _ în ea. Trebuie să fie și unic. Specificând id-ul, putem specifica și numele, descrierea și traducerile pentru acestea:

Register_sidebar(array("id" => "meniu de sus", "nume" => __("Meniu de sus", $text_domain), "description" => __("Această bară laterală este situată deasupra siglei vârstei.", $text_domain))))

Note

• Global. Matrice. $wp_registered_sidebars Bare laterale înregistrate.
• Global. Matrice. $wp_registered_widgets

Lista modificărilor

Din versiunea 2.2.0

Introdus.

Cod bara laterală dinamică: wp-includes/widgets.php WP 5.3.2

$value) ( ​​​​dacă (sanitize_title($value["nume"]) == $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 ]))) ( /** Această acțiune este documentată în wp-includes/widget. php */ do_action("dynamic_sidebar_before", $index, false); /** Această acțiune este documentată în wp-includes/widget.php */ do_action("dynamic_sidebar_after", $index, false); /** Acest filtru este documentat în wp-includes/widget.php */ return apply_filters("dynamic_sidebar_has_widgets", false, $index); ) /** * Se declanșează înainte ca widgeturile să fie redate într-o bară laterală dinamică. * * Notă: acțiunea se declanșează și pentru barele laterale goale și atât pe partea frontală *, cât și pe cea din spate, inclusiv în bara laterală Widgeturi inactive de pe ecranul Widgeturi. * * @since 3.9.0 * * @param int|string $index Indexul, numele sau ID-ul barei laterale dinamice. * @param bool $has_widgets Dacă bara laterală este populată cu widget-uri. * implicit adevărat. */ do_action("dynamic_sidebar_before", $index, true); $sidebar = $wp_registered_sidebars[ $index ]; $did_one = false; foreach ((matrice) $sidebars_widgets[ $index ] ca $id) ( if (! isset($wp_registered_widgets[ $id ])) ( continua; ) $params = array_merge(array(array_merge($sidebar, array("widget_id") => $id, "widget_name" => $wp_registered_widgets[ $id ]["nume"],)),), (matrice) $wp_registered_widgets[ $id ]["params"]); // Înlocuiește id-ul și clasa HTML atribute în before_widget $classname_ = ""; foreach ((matrice) $wp_registered_widgets[ $id ]["classname"] ca $cn) ( if (is_string($cn)) ( $classname_ .= "_" . $cn; ) elseif (este_obiect($cn)) ( $classname_ .= "_" . get_class($cn); ) ) $classname_ = ltrim($classname_, "_"); $params["before_widget"] = sprintf($ params["before_widget"], $id, $classname_); /** * Filtrează parametrii trecuți la apel invers de afișare a unui widget. * * Notă: Filtrul este evaluat atât pe front-end, cât și pe back-end, * inclusiv pentru bara laterală Widgeturi inactive de pe ecranul Widgeturi.* * @din 2.5.0 * * @see register_sidebar() * * @param array $params ( * @typ e array $args ( * O matrice de argumente de afișare widget. * * @type șir $nume Numele barei laterale căreia îi este atribuit widget-ul. * @type șir $id ID-ul barei laterale căreia îi este atribuit widget-ul. * @type string $description Descrierea barei laterale. * @type șir $class clasă CSS aplicată containerului barei laterale. * @type șir $before_widget Markup HTML pentru a adăuga fiecare widget din bara laterală. * @type șir $after_widget Markup HTML de atașat fiecărui widget din bara laterală. * @type șir $before_title Markup HTML pentru a adăuga titlului widgetului atunci când este afișat. * @type șir $after_title Markup HTML pentru a adăuga titlului widget-ului când este afișat. * @type șir $widget_id ID-ul widget-ului. * @type șir $widget_name Numele widget-ului. * ) * @type array $widget_args ( * O matrice de argumente cu mai multe widgeturi. * * @type int $number Increment de număr folosit pentru multiplii aceluiași widget. * ) * ) */ $params = apply_filters("dynamic_sidebar_params", $params); $callback = $wp_registered_widgets[ $id ]["callback"]; /** * Se declanșează înainte de apelarea unui apel invers de afișare a unui widget. * * Notă: Acțiunea se declanșează atât pe front-end, cât și pe back-end, inclusiv * pentru widget-uri din bara laterală Widgeturi inactive de pe ecranul Widgeturi. * * Acțiunea este nu se declanșează pentru barele laterale goale. * * @din 3.0.0 * * @param array $widget_id ( * O matrice asociativă de argumente widget. * * @type șir $nume Numele widget-ului. * @type șir $id ID widget. * @type array|callback $callback Când hook-ul este declanșat pe front-end, $callback este o matrice * care conține obiectul widget. Lansat pe back-end, $callback * este „wp_widget_control”, vezi $_callback.* @type array $params O matrice asociativă de argumente multi-widget.* @type șir $classname clasă CSS aplicată containerului widget.* @type șir $descriere Descrierea widgetului.* @type array $_callback Când cârligul este declanșat pe spate final, $_callback este populat * cu o matrice care conține obiectul widget, vezi $callback. * ) */ do_action("d ynamic_sidebar", $wp_registered_widgets[ $id ]); if (is_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * Se declanșează după ce widget-urile sunt redate într-o bară laterală dinamică. * * Notă: acțiunea se declanșează și pentru barele laterale goale și atât pe partea frontală *, cât și pe cea din spate, inclusiv în bara laterală Widgeturi inactive de pe ecranul Widgeturi. * * @since 3.9.0 * * @param int|string $index Indexul, numele sau ID-ul barei laterale dinamice. * @param bool $has_widgets Dacă bara laterală este populată cu widget-uri. * implicit adevărat. */ do_action("dynamic_sidebar_after", $index, true); /** * Filtrează dacă o bară laterală are widget-uri. * * Notă: filtrul este evaluat și pentru barele laterale goale și atât pe partea frontală * cât și pe cea din spate, inclusiv în bara laterală Widgeturi inactive de pe ecranul Widgeturi. * * @since 3.9.0 * * @param bool $did_one Dacă cel puțin un widget a fost redat în bara laterală. * implicit fals. * @param int|string $index Indexul, numele sau ID-ul barei laterale dinamice. */ returneaza apply_filters("dynamic_sidebar_has_widgets", $did_one, $index); )

Bună prieteni! După cum am promis, am făcut un subiect despre Bare laterale WordPress. Acesta este un mic ghid pentru utilizarea și personalizarea barelor laterale pe site-urile WordPress.

În acest thread, vreau să dezvălui un mic secret tuturor dezvoltatorilor de șabloane: barele laterale au fost întotdeauna o parte importantă a sistemului WordPress și au fost mult îmbunătățite în ultimii ani.

Ținând cont de evoluțiile recente, vă voi arăta procesul pas cu pas de creare și utilizare a barelor laterale pentru temele WordPress.

Ce este o bară laterală WordPress?

De fapt, termenul „bară laterală (bară laterală)” poate însemna două concepte complet nelegate în sistemul WordPress:

1. Bara laterală dinamică: un container pentru un set de widget-uri pe care utilizatorul le poate instala prin panoul de administrare -> secțiunea Widgeturi.
2. Șablon de bară laterală: Aceasta este bara laterală care este afișată de șablonul site-ului.

În cele mai multe cazuri, șabloanele simple au o bară laterală dinamică care încarcă toate widget-urile plasate din panoul de administrare. Acest proces poate avea loc și după un alt algoritm, dar cel mai adesea după această schemă. Totuși, este important să înțelegeți că o bară laterală dinamică și un șablon de bară laterală sunt două lucruri diferite. Totul este premium, lucrez în principal cu șablonul Sidebar.

De obicei, termenul „bară laterală” este folosit în legătură cu bara laterală dinamică, care va fi discutată în acest articol. Cu toate acestea, voi atinge și șablonul barei laterale.

Ceea ce m-a dezamăgit cel mai mult în răsfoirea multor teme este că dezvoltatorii nu profită din plin de cele mai puternice caracteristici ale sistemului WordPress. Majoritatea temelor au doar o bară laterală, în cel mai bun caz două. Dar, până la urmă, aceste teme vor crea pagini uriașe cu un set de opțiuni care pot fi procesate cu ușurință folosind widget-uri, iar conținutul lor poate fi plasat direct în șablon. Prefer să folosesc o mulțime de bare laterale într-o temă pentru a crea un site flexibil, bogat în funcții.

Înregistrarea, adăugarea și crearea unei bare laterale WordPress

Multe teme nu respectă standardele de calitate, așa că, dacă sunteți un dezvoltator de șabloane, să ne asigurăm că luați această problemă în serios. Crearea unei dinamici adecvate Bara laterală WordPress este cea mai importantă parte a procesului, deoarece ceea ce setați în el va fi legat de toate celelalte caracteristici ale barei laterale.

Pentru a crea una sau mai multe bare laterale, va trebui să le înregistrați printr-un fișier funcții. php Tema dvs., fiecare temă are propriul fișier care conține toate setările șablonului. La dosar funcții. php Puteți adăuga sau elimina setările temei.

Codul de mai jos demonstrează cum puteți crea o bară laterală în WordPress folosind funcția register_sidebar(). În acest caz, vom crea o bară laterală numită „primar” care va servi drept exemplu pentru a lucra.

„primar”, „nume” => __(„Primar”), „descriere” => __(„Descrierea barei laterale (vizibilă în panoul de administrare).”), „before_widget” => „

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

", "after_title" => "

")); /* Puteți repeta funcția register_sidebar() pentru alte widget-uri, câmpul id trebuie să fie unic (primar, secundar, moiwidget etc. */ ) ?>

add_action("widgets_init" , "registriruem_sidebari" ); funcția register_sidebari() ( /* Înregistrați bara laterală „primară”. */ register_sidebar( matrice( "id" => "principal" , "nume" => __("Primar") , "descriere" => __( „Descrierea barei laterale (vizibilă în panoul de administrare).”) , „before_widget” => " " , "after_widget" => " " , „before_title” => " " , "after_title" => " " /* Puteți repeta funcția register_sidebar() pentru alte widget-uri, câmpul id trebuie să fie unic (primar, secundar, moiwidget etc. */

După cum puteți vedea, înregistrarea unei bare laterale este o sarcină foarte simplă dacă aveți informații despre cum să o faceți.

Argumente pentru crearea unei bare laterale dinamice dynamic_sidebar()

Funcţie register_sidebar() acceptă un singur parametru, este numit $argsși conține un set de argumente care specifică cum ar trebui redată bara laterală cu widget-urile sale. În continuare, luați în considerare exemple de utilizare manuală a argumentelor.

ID

Argument id, este probabil unul dintre cele mai importante argumente de scris (consultați exemplul de cod scris prost de mai jos și vedeți de ce ar trebui neapărat să îl scrieți). WordPress va folosi id pentru a atribui widget-uri unei anumite bare laterale și veți avea nevoie id pentru a umple în continuare bara laterală - bara laterală.

Fiecare id trebuie să fie unic. WordPress, implicit, îl va prescrie pentru sidebar-$i(Unde $i

//id-ul nostru widget, care este atribuit o singură dată „id” => „primar”,

Nume

Puteți scrie orice nume care credeți că vă reprezintă cel mai bine Bara laterală WordPress. Cel mai adesea, barelor laterale li se dau nume prin care utilizatorul poate determina ce aspecte ale subiectului ating (de exemplu, bara laterală din stânga sau din dreapta). Acest argument poate fi internaționalizat (adică localizat pentru alte limbi). Prin urmare, asigurați-vă că scrieți domeniul textului corect atunci când vă pregătiți subiectul pentru traducere. Argumentul, implicit, este scris ca Sidebar $i(Unde $i este numărul ordinal al barei laterale create).

//nume widget, în exemplu folosesc Primary ca nume al widget-ului id-ul „name” => „Primar”,

Descriere

Argument Descriere a fost introdus pentru prima dată în WordPress 2.9. Acest argument vă permite să vă descrieți widgetul, descrierea este afișată în panoul de administrare din secțiunea Widgeturi. Acest argument, implicit, este scris pe un șir gol. Poate fi, de asemenea, internaționalizat (adică scris în chirilic sau în alte limbi).

//descrierea va fi vizibilă în secțiunea de widget-uri „descriere” => __(„Widget pentru coloana din stânga a site-ului”),

înainte de_widget

Argument înainte de_widget acesta este elementul de deschidere al widget-ului atribuit barei laterale. De asemenea, trebuie să fie un element la nivel de bloc HTML marcare (de exemplu, etichetă < li > , < p > , < div > etc.). Acest argument are câteva caracteristici în care puteți scrie, de exemplu id="" sau clasa="": atribute id="" sunt scrise astfel: (%1$s) si atribute clasa="" Asa de: (%2$s).

În mod implicit, WordPress le va lista ca element de listă: < li id = "%1$s" > . Nu sunt un fan al creării de elemente din lista de widget-uri din bara laterală. Folosesc mereu < div > . Nu sunt un fan al creării de elemente din lista de widget-uri din bara laterală. Ultima dată l-am folosit, pentru că în lipsa unui widget pe site, nu vei vedea în plus HTML etichetele, totuși, vom analiza în continuare cum să scăpăm de ele.

după_widget

Argument după_widget destul de ușor de creat. Acesta este elementul de închidere pentru widget-ul atribuit barei laterale. Trebuie doar să închideți elementul specificat pentru argument înainte de_widget. În mod implicit, WordPress îl va scrie ca < li > .

"after_widget" => "