sivupalkki wordpress. WordPress-sivupalkit, WordPress-sivupalkin luominen. WordPressin oletuswidgetit

Näyttää ensimmäisen aktiivisen widget-paneelin (sivupalkki on paneeli, joka sisältää vähintään yhden widgetin). Voit määrittää paneelin tunnuksen tai numeron, kumpi näytetään, jos sivustolla on useampi kuin yksi widget-paneeli.

dynamic_sidebar() palauttaa tosi tai epätosi, ja palautustulos näyttää myös widget-palkin. Palautusarvoa voidaan käyttää esimerkiksi määrittämään, tuleeko widgetejä korvaava koodi käsitellä, kun paneelissa ei ole widgetejä (katso esimerkki #1).

palaa

tosi, jos widget-paneeli löytyi. false, jos paneelia ei ole olemassa tai se ei sisällä widgetejä.

Käyttö

Esimerkkejä

#1 Näytä sivupalkki, jos se on olemassa.

Tämä esimerkki näyttää, kuinka ensimmäinen ei-tyhjä sivupalkki näytetään (sivupalkin tunnusta ei määritetty rekisteröinnin aikana) tai jos sitä ei löydy, käsittele määritetty koodi:

#2 Näytä haluamasi sivupalkki.

#3 Tarkista paneelin olemassaolo ja näytä se

Esimerkissä 2 emme tarkistaneet, onko siinä paneelia ja widgetejä. Tässä esimerkissä tarkistamme paneelin olemassaolon, jotta emme näytä tarpeettomia HTML-tunnisteet (

) jos sivupalkki on tyhjä:

Useita sivupalkkeja

Kun rekisteröit useamman kuin yhden widget-paneelin register_sidebar() -sovelluksella, on helpompi määrittää tunnus jokaiselle paneelille.

Emme voi määrittää tunnusta, jolloin paneeli saa sarjanumeron. Mutta tässä tapauksessa, kun muokkaat teemaa, on vaikea ymmärtää, mikä paneeli on mikä, koska numerot 1, 2, 3 eivät tarkoita mitään. Mutta jos asetat nimen, se tulee paljon selkeämmäksi:

// --- numerot// rekisteröinti register_sidebar(); // tulos dynaaminen_sivupalkki(1); // --- Jouset// rekisteröinti register_sidebar(array("id" => "top_menu")); // tulos dynamic_sidebar("top_menu");

Esimerkistä käy selvästi ilmi, että se on kätevämpää merkkijonojen kanssa: tutkimalla aihetta ja näkemällä dynamic_sidebar("top_menu"), on heti selvää, että päävalikon paneelia kutsutaan.

Id-argumentti ei saa sisältää välilyöntejä, isoja kirjaimia tai kyrillisiä kirjaimia. Voit käyttää siinä väliviivaa ja alaviivaa _. Sen on myös oltava ainutlaatuinen. Määrittämällä tunnuksen voimme määrittää niille myös nimen, kuvauksen ja käännökset:

Register_sidebar(array("id" => "top-menu", "name" => __("Top Menu", $text_domain), "description" => __("Tämä sivupalkki sijaitsee ikälogon yläpuolella.", $teksti_verkkotunnus))))

Huomautuksia

• Maailmanlaajuinen. Array. $wp_registered_sidebars Rekisteröidyt sivupalkit.
• Maailmanlaajuinen. Array. $wp_registered_widgets

Luettelo muutoksista

Versiosta 2.2.0 lähtien

Otettu käyttöön.

Koodi dynaaminen sivupalkki: wp-includes/widgets.php WP 5.3.2

$arvo) (if (puhdista_nimi($arvo["nimi"]) == $indeksi) ( $indeksi = $avain; break; ) ) ) $sivupalkit_widgetit = wp_get_sidebars_widgets(); if (empty($wp_registered_sidebars[ $index ]) || empty($sidebars_widgets[ $index ]) || !is_array($sidebars_widgets[ $index ])) ( /** Tämä toiminto on dokumentoitu tiedostossa wp-includes/widget. php */ do_action("dynamic_sidebar_before", $index, false); /** Tämä toiminto on dokumentoitu tiedostossa wp-includes/widget.php */ do_action("dynamic_sidebar_after", $index, false); /** Tämä suodatin on dokumentoitu tiedostossa wp-includes/widget.php */ return apply_filters("dynamic_sidebar_has_widgets", false, $index); ) /** * Käynnistyy ennen kuin widgetit hahmonnetaan dynaamisessa sivupalkissa. * * Huomautus: Toiminto käynnistyy myös tyhjille sivupalkeille ja sekä etu- että takapuolelle, mukaan lukien Widgets-näytön Ei-aktiiviset widgetit -sivupalkki. * * @alkaen 3.9.0 * * @param int|string $index Dynaamisen sivupalkin indeksi, nimi tai tunnus. * @param bool $has_widgets Onko sivupalkki täynnä widgetejä. * oletuksena tosi. */ do_action("dynaaminen_sivupalkki_ennen", $indeksi, tosi); $sivupalkki = $wp_registered_sidebars[ $index ]; $ teki_yksi = epätosi; foreach ((array) $sidebars_widgets[ $index ] as $id) ( if (! isset($wp_registered_widgets[ $id ])) ( jatka; ) $params = array_merge(array(array_merge($sidebar, array("widgetin_id") => $id, "widgetin_nimi" => $wp_registered_widgets[ $id ]["name"],)),), (joukko) $wp_registered_widgets[ $id ]["params"]); // Korvaa HTML-tunnus ja luokka attribuutit ennen_widgetiin $classname_ = ""; foreach ((taulukko) $wp_registered_widgets[ $id ]["luokannimi"] muodossa $cn) ( if (is_string($cn)) ( $classname_ .= "_" . $cn; ) elseif (on_objekti($cn)) ( $classname_ .= "_" . get_class($cn); ) ) $classname_ = ltrim($classname_, "_"); $params["ennen_widgetiä"] = sprintf($ params["before_widget"], $id, $classname_); /** * Suodattaa widgetin näyttökutsuun välitetyt parametrit. * * Huomautus: Suodatin arvioidaan sekä etu- että takapäässä, * mukaan lukien widgetit-näytön Ei-aktiiviset widgetit -sivupalkki.* * @alkaen 2.5.0 * * @katso register_sidebar() * * @param array $params ( * @typ e array $args ( * Joukko widgetin näyttöargumentteja. * * @type string $name Sen sivupalkin nimi, johon widget on liitetty. * @type string $id Sen sivupalkin tunnus, johon widget on määritetty. * @type string $description Sivupalkin kuvaus. * @type string $class CSS-luokka käytetty sivupalkin säilössä. * @type string $before_widget HTML-merkintä liittääksesi jokaisen sivupalkin widgetin edelle. * @type string $after_widget HTML-merkintä liittääksesi jokaiseen sivupalkin widgetiin. * @type string $before_title HTML-merkintä, joka liitetään widgetin otsikkoon, kun se näytetään. * @type string $after_title HTML-merkintä lisättäväksi widgetin otsikkoon, kun se näytetään. * @type string $widget_id widgetin tunnus. * @type string $widget_name Widgetin nimi. * ) * @type array $widget_args ( * Monen widgetin argumenttien joukko. * * @type int $number Numeron lisäys, jota käytetään saman widgetin kerrannaisiin. * ) * ) */ $params = apply_filters("dynamic_sidebar_params", $params); $callback = $wp_registered_widgets[ $id ]["takaisinsoitto"]; /** * Käynnistyy ennen kuin widgetin näyttökutsu kutsutaan. * * Huomautus: Toiminto käynnistyy sekä etu- että takapäässä, mukaan lukien * widgetit Widget-näytön Ei-aktiiviset widgetit -sivupalkissa. * * Toiminto on ei käynnisty tyhjille sivupalkeille * * @alkaen 3.0.0 * * @param array $widget_id ( * Widget-argumenttien assosiatiivinen joukko. * * @type string $name Widgetin nimi. * @type string $id Widgetin tunnus. * @type array|kutsuttava $callback Kun koukku laukaistaan ​​etupäässä, $callback on matriisi *, joka sisältää widget-objektin.Takapäässä käynnistynyt $callback * on "wp_widget_control", katso $_callback.* @type array $params Usean widgetin argumenttien assosiatiivinen joukko.* @type string $classname widget-säilössä käytetty CSS-luokka.* @type string $description Widgetin kuvaus.* @type array $_callback Kun koukku laukaistaan ​​takana lopussa $_callback täytetään * taulukolla, joka sisältää widget-objektin, katso $callback. * ) */ do_action("d ynamic_sidebar", $wp_registered_widgets[ $id ]); if (on_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * Käynnistyy, kun widgetit on renderöity dynaamiseen sivupalkkiin. * * Huomautus: Toiminto käynnistyy myös tyhjille sivupalkeille ja sekä etu- että takapäälle, mukaan lukien Widgets-näytön Ei-aktiiviset widgetit -sivupalkki. * * @alkaen 3.9.0 * * @param int|string $index Dynaamisen sivupalkin indeksi, nimi tai tunnus. * @param bool $has_widgets Onko sivupalkki täynnä widgetejä. * oletuksena tosi. */ do_action("dynaaminen_sivupalkki_jälkeen", $indeksi, tosi); /** * Suodattaa, onko sivupalkissa widgetejä. * * Huomautus: Suodatin arvioidaan myös tyhjille sivupalkeille ja sekä etu- että takaosalle, mukaan lukien Widgetit-näytön Ei-aktiiviset widgetit -sivupalkki. * * @alkaen 3.9.0 * * @param bool $did_one Onko ainakin yksi widget renderöity sivupalkissa. * oletuksena false. * @param int|string $index Dynaamisen sivupalkin indeksi, nimi tai tunnus. */ return apply_filters("dynaaminen_sivupalkki_has_widgets", $did_one, $index); )

Hei ystävät! Kuten lupasin, tein aiheen WordPressin sivupalkit. Tämä on pieni opas sivupalkkien käyttöön ja mukauttamiseen WordPress-sivustoilla.

Tässä ketjussa haluan paljastaa pienen salaisuuden kaikille mallien kehittäjille: sivupalkit ovat aina olleet tärkeä osa WordPress-järjestelmää, ja niitä on parannettu huomattavasti viime vuosien aikana.

Ottaen huomioon viimeaikainen kehitys, aion näyttää sinulle vaiheittaisen prosessin WordPress-teemojen sivupalkkien luomiseen ja käyttämiseen.

Mikä on WordPressin sivupalkki?

Itse asiassa termi "sivupalkki (sivupalkki)" voi tarkoittaa kahta täysin toisiinsa liittymätöntä käsitettä WordPress-järjestelmässä:

1. Dynaaminen sivupalkki: säilö widget-sarjalle, jonka käyttäjä voi asentaa hallintapaneelin -> Widgetit-osion kautta.
2. Sivupalkin malli: Tämä on sivupalkki, jonka sivustomalli näyttää.

Useimmissa tapauksissa yksinkertaisissa malleissa on dynaaminen sivupalkki, joka lataa kaikki asetetut widgetit hallintapaneelista. Tämä prosessi voi tapahtua myös toisen algoritmin mukaan, mutta useimmiten tämän kaavion mukaan. On kuitenkin tärkeää ymmärtää, että dynaaminen sivupalkki ja sivupalkin malli ovat kaksi eri asiaa. Kaikki on ensiluokkaista, työskentelen pääasiassa sivupalkkimallin kanssa.

Yleensä termiä "sivupalkki" käytetään suhteessa dynaamiseen sivupalkkiin, jota käsitellään tässä artikkelissa. Kosketan kuitenkin myös sivupalkin mallia.

Eniten minua on pettynyt monien teemojen selailussa se, että kehittäjät eivät hyödynnä WordPress-järjestelmän tehokkaimpia ominaisuuksia. Useimmilla teemoilla on vain yksi sivupalkki, parhaimmillaan kaksi. Mutta loppujen lopuksi nämä teemat luovat valtavia sivuja, joissa on vaihtoehtoja, joita voidaan helposti käsitellä widgetien avulla ja joiden sisältö voidaan sijoittaa suoraan malliin. Käytän mieluummin monia sivupalkkeja teemassa luodakseni joustavan ja monipuolisen sivuston.

WordPress-sivupalkin rekisteröinti, lisääminen ja luominen

Monet teemat eivät usein täytä laatustandardeja, joten jos olet mallien kehittäjä, varmista, että otat tämän ongelman vakavasti. Sopivan dynamiikan luominen WordPressin sivupalkki on prosessin tärkein osa, koska siinä määrittämäsi liittyy kaikkiin muihin sivupalkin ominaisuuksiin.

Jos haluat luoda yhden tai useamman sivupalkin, sinun on rekisteröitävä ne tiedoston kautta toimintoja. php Teemasi, jokaisella teemalla on oma tiedostonsa, joka sisältää kaikki mallin asetukset. Arkistoida toimintoja. php Voit lisätä tai poistaa teemaasetuksia.

Alla oleva koodi näyttää, kuinka voit luoda sivupalkin WordPressiin toiminnon avulla register_sidebar(). Tässä tapauksessa luomme sivupalkin nimeltä "ensisijainen", joka toimii esimerkkinä.

"primary", "name" => __("Ensisijainen"), "description" => __("Sivupalkin kuvaus (näkyy hallintapaneelissa)."), "before_widget" => "

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

", "after_title" => "

")); /* Voit toistaa register_sidebar()-funktion muille widgeteille, id-kentän on oltava yksilöllinen (ensisijainen, toissijainen, moiwidget jne. */ ) ?>

add_action("widgets_init" , "registriruem_sidebari" ) ; funktio register_sidebari() ( /* Rekisteröi "ensisijainen" sivupalkki. */ register_sidebar( array( "id" => "ensisijainen" , "nimi" => __("Ensisijainen") , "kuvaus" => __( "Sivupalkin kuvaus (näkyy hallintapaneelissa).") , "ennen_widget" => " " , "after_widget" => " " , "ennen_titteliä" => " " , "after_title" => " " /* Voit toistaa register_sidebar()-funktion muille widgeteille, id-kentän on oltava yksilöllinen (ensisijainen, toissijainen, moiwidget jne. */

Kuten näet, sivupalkin rekisteröinti on hyvin yksinkertainen tehtävä, jos sinulla on tietoa sen tekemisestä.

Argumentteja dynaamisen sivupalkin luomiseksi dynaaminen_sivupalkki()

Toiminto register_sidebar() hyväksyy vain yhden parametrin, sitä kutsutaan $args ja sisältää joukon argumentteja, jotka määrittelevät kuinka sivupalkki ja sen widgetit tulee hahmontaa. Harkitse seuraavaksi esimerkkejä argumenttien manuaalisesta käytöstä.

ID

Perustelu id, on luultavasti yksi tärkeimmistä argumenteista kirjoittaa (katso alla esimerkki huonosti kirjoitetusta koodista ja katso, miksi sinun pitäisi ehdottomasti kirjoittaa se). WordPress tulee käyttämään id määrittääksesi widgetejä tiettyyn sivupalkkiin, ja tarvitset id täyttääksesi sivupalkin edelleen - sivupalkki.

Joka id täytyy olla yksilöllinen. WordPress määrää sen oletuksena sivupalkki-$i(Missä $i

//widget-tunnuksemme, joka annetaan vain kerran "id" => "ensisijainen",

Nimi

Voit kirjoittaa minkä tahansa nimen, joka mielestäsi parhaiten edustaa sinua WordPressin sivupalkki. Useimmiten sivupalkeille annetaan nimiä, joiden avulla käyttäjä voi määrittää, mitä aiheen puolia hän koskettaa (esimerkiksi vasen tai oikea sivupalkki). Tämä argumentti voidaan kansainvälistää (eli lokalisoida muille kielille). Varmista siis, että kirjoitat oikean tekstialueen, kun valmistelet aihettasi käännöstä varten. Argumentti kirjoitetaan oletuksena sivupalkkina $i(Missä $i on luodun sivupalkin järjestysnumero).

//widgetin nimi, esimerkissä käytän Ensisijaista widgetin id:n nimenä "nimi" => "Ensisijainen",

kuvaus

Perustelu kuvaus otettiin ensimmäisen kerran käyttöön WordPress 2.9:ssä. Tämän argumentin avulla voit kuvailla widgettiäsi. Kuvaus näkyy hallintapaneelin Widgetit-osiossa. Tämä argumentti kirjoitetaan oletuksena tyhjään merkkijonoon. Se voidaan myös kansainvälistää (eli kirjoitettu kyrillisellä tai muilla kielillä).

//description näkyy widget-osiossa "description" => __("Widget sivuston vasemmalle sarakkeelle"),

ennen_widgetiä

Perustelu ennen_widgetiä tämä on sivupalkkiin määritetyn widgetin avauselementti. Sen on oltava myös lohkotason elementti HTML merkintä (esim < li > , < p > , < div > jne.). Tässä argumentissa on pari ominaisuutta, joihin voit kirjoittaa esimerkiksi id="" tai class="": attribuutit id="" on kirjoitettu näin: (%1$s) ja attribuutit class="" Niin: (%2$s).

Oletusarvoisesti WordPress listaa ne luettelokohteena: < li id = "%1$s" > . En pidä sivupalkin widget-luettelokohteiden luomisesta. käytän aina < div > . En pidä sivupalkin widget-luettelokohteiden luomisesta. Viimeisen kerran, kun käytän sitä, koska jos sivustolla ei ole widgetiä, et näe ylimääräistä HTML tunnisteita, mutta pohdimme edelleen, kuinka päästä eroon niistä.

after_widget

Perustelu after_widget aika helppo luoda. Tämä on sivupalkkiin määritetyn widgetin sulkeva elementti. Sinun tarvitsee vain sulkea argumentille määritetty elementti ennen_widgetiä. Oletuksena WordPress kirjoittaa sen nimellä < li > .

"after_widget" => "