Kenar çubuğu wordpress. WordPress kenar çubukları, WordPress kenar çubuğu oluşturma. Varsayılan WordPress Widget'ları

İlk aktif widget panelini görüntüler (kenar çubuğu, en az bir widget içeren bir paneldir). Sitede birden fazla pencere öğesi paneli varsa, hangi panelin gösterileceğini ID veya numarasını belirleyebilirsiniz.

Dynamic_sidebar(), widget çubuğunu da görüntüleyen dönüş sonucuyla birlikte true veya false döndürür. Dönen değer, örneğin, panelde pencere öğesi yokken pencere öğelerinin yerini alan kodun işlenip işlenmeyeceğini belirlemek için kullanılabilir (bkz. örnek #1).

İadeler

widget paneli bulunduysa true . panel yoksa veya pencere öğesi içermiyorsa false.

kullanım

örnekler

#1 Varsa, kenar çubuğunu görüntüleyin.

Bu örnek, boş olmayan ilk kenar çubuğunun nasıl görüntüleneceğini (kayıt sırasında kenar çubuğu kimliği belirtilmedi) veya bulunmazsa, belirtilen kodun nasıl işleneceğini gösterir:

#2 İstediğiniz kenar çubuğunu görüntüleyin.

#3 Panelin varlığını kontrol edin ve görüntüleyin

Örnek 2'de, içinde bir panel ve widget'ların olup olmadığını kontrol etmedik. Bu örnekte, gereksiz görüntüleme yapmamak için bir panel olup olmadığını kontrol edeceğiz. HTML etiketleri (

) kenar çubuğu boşsa:

Birden fazla kenar çubuğu

register_sidebar() ile birden fazla pencere öğesi paneli kaydederken, her panel için bir kimlik belirlemek daha uygundur.

Kimlik belirtemiyoruz, o zaman panel bir seri numarası alacak. Fakat bu durumda temayı düzenlerken hangi panelin hangisi olduğunu anlamak zor olacaktır çünkü 1, 2, 3 rakamları bir anlam ifade etmemektedir. Ancak adı ayarlarsanız, çok daha net hale gelir:

// --- sayılar// kayıt register_sidebar(); // çıktı dinamik_kenar çubuğu(1); // --- Teller// kayıt register_sidebar(array("id" => "top_menu")); // output dynamic_sidebar("top_menu");

Örnekten, dizelerle daha uygun olduğu açıktır: konuya bakıldığında ve dynamic_sidebar("top_menu") görüldüğünde, ana menü panelinin çağrıldığı hemen anlaşılır.

id bağımsız değişkeni boşluk, büyük harf, Kiril harfleri içermemelidir. Kısa çizgi - ve içinde alt çizgi _ kullanabilirsiniz. Aynı zamanda benzersiz olmalıdır. Kimlik belirterek, onlar için isim, açıklama ve çevirileri de belirtebiliriz:

Register_sidebar(array("id" => "top-menu", "name" => __("Üst Menü", $text_domain), "description" => __("Bu kenar çubuğu yaş logosunun üzerindedir.", $metin_etki alanı))))

notlar

• Küresel. Sıralamak. $wp_registered_sidebars Kayıtlı kenar çubukları.
• Küresel. Sıralamak. $wp_registered_widgets

Değişiklik listesi

2.2.0 sürümünden beri

tanıtıldı.

kod dinamik kenar çubuğu: 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 ])) ( /** Bu eylem wp-includes/widget'ta belgelenmiştir. php */ do_action("dynamic_sidebar_before", $index, false); /** Bu eylem wp-includes/widget.php içinde belgelenmiştir */ do_action("dynamic_sidebar_after", $index, false); /** Bu filtre şu şekildedir: wp-includes/widget.php */'de belgelenmiştir. * * Not: Eylem, Widget'lar ekranındaki Etkin Olmayan Widget'lar kenar çubuğu da dahil olmak üzere boş kenar çubukları için ve hem ön uçta * hem de arka uçta tetiklenir. * * @since 3.9.0 * * @param int|string $index Dinamik kenar çubuğunun dizini, adı veya kimliği. * @param bool $has_widgets Kenar çubuğunun widget'larla doldurulup doldurulmadığı. * varsayılan doğrudur. */ do_action("dynamic_sidebar_before", $index, true); $kenar çubuğu = $wp_registered_sidebars[$dizin ]; $did_one = yanlış; foreach ((dizi) $sidebars_widgets[ $index ] as $id) ( if (! isset($wp_registered_widgets[ $id ])) ( devam et; ) $params = array_merge(dizi(dizi_merge($kenar çubuğu, dizi("widget_id") => $id, "widget_name" => $wp_registered_widgets[ $id ]["name"],)),), (dizi) $wp_registered_widgets[ $id ]["params"]); // HTML kimliğini ve sınıfını değiştirin foreach ((array) $wp_registered_widgets[ $id ]["classname"] as $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_); /** * Widget'ın display callback'ine iletilen parametreleri filtreler. * * Not: Filtre hem ön uçta hem de arka uçta değerlendirilir, * şunlar dahil Widget'lar ekranında Etkin Olmayan Widget'lar kenar çubuğu.* * @since 2.5.0 * * @see register_sidebar() * * @param dizisi $params ( * @typ e dizi $args ( * Widget görüntüleme bağımsız değişkenleri dizisi. * * @type string $name Widget'ın atandığı kenar çubuğunun adı. * Widget'ın atandığı kenar çubuğunun @type string $id kimliği. * @type string $description Kenar çubuğu açıklaması. * Kenar çubuğu kapsayıcısına uygulanan @type string $class CSS sınıfı. * Kenar çubuğundaki her parçacığın başına eklenecek @type string $before_widget HTML işaretlemesi. * Kenar çubuğundaki her widget'a eklenecek @type string $after_widget HTML işaretlemesi. * Görüntülendiğinde widget başlığının başına eklenecek @type string $before_title HTML işaretlemesi. * Görüntülendiğinde widget başlığına eklenecek @type string $after_title HTML işaretlemesi. * Widget'ın @type string $widget_id kimliği. * @type string $widget_name Widget'ın adı. * ) * @type array $widget_args ( * Çoklu-widget argümanları dizisi. * * @type int $number Aynı widget'ın katları için kullanılan sayı artışı. * ) * ) */ $params = Apply_filters("dynamic_sidebar_params", $paramlar); $geri arama = $wp_registered_widgets[ $id ]["geri arama"]; /** * Bir widget'ın ekranı geri çağrılmadan önce tetiklenir. * * Not: Eylem, Widget'lar ekranındaki Etkin Olmayan Widget'lar kenar çubuğundaki widget'lar için * dahil olmak üzere hem ön uçta hem de arka uçta tetiklenir. * * Eylem boş kenar çubukları için tetiklenmez. * * @since 3.0.0 * * @param dizisi $widget_id ( * Widget argümanlarının ilişkilendirilebilir dizisi. * * @type string $name Widget'ın adı. * @type string $id Widget Kimliği. * @type array|callable $callback Kanca ön uçta tetiklendiğinde, $callback widget nesnesini içeren * bir dizidir. Arka uçta tetiklenir, $callback * "wp_widget_control"dür, bkz. $_callback.* @type array $params Çoklu widget bağımsız değişkenlerinin ilişkilendirilebilir dizisi.* @type string $classname Widget kabına uygulanan CSS sınıfı.* @type string $description Widget açıklaması.* @type array $_callback Kanca arkadan ateşlendiğinde sonunda, $_callback * widget nesnesini içeren bir dizi ile doldurulur, bkz. $callback. * ) */ do_action("d ynamic_sidebar", $wp_registered_widgets[ $id ]); if (is_callable($callback)) ( call_user_func_array($callback, $params); $did_one = true; ) ) /** * Widget'lar dinamik bir kenar çubuğunda işlendikten sonra tetiklenir. * * Not: Eylem, Widget'lar ekranındaki Etkin Olmayan Widget'lar kenar çubuğu da dahil olmak üzere boş kenar çubukları için ve hem ön uçta * hem de arka uçta tetiklenir. * * @since 3.9.0 * * @param int|string $index Dinamik kenar çubuğunun dizini, adı veya kimliği. * @param bool $has_widgets Kenar çubuğunun widget'larla doldurulup doldurulmadığı. * varsayılan doğrudur. */ do_action("dynamic_sidebar_after", $index, true); /** * Bir kenar çubuğunda widget olup olmadığını filtreler. * * Not: Filtre, Widget'lar ekranındaki Etkin Olmayan Widget'lar kenar çubuğu da dahil olmak üzere boş kenar çubukları için ve hem ön uçta * hem de arka uçta değerlendirilir. * * @since 3.9.0 * * @param bool $did_one Kenar çubuğunda en az bir parçacığın oluşturulup oluşturulmadığı. * varsayılan yanlış. * @param int|string $index Dinamik kenar çubuğunun dizini, adı veya kimliği. */ return Apply_filters("dynamic_sidebar_has_widgets", $did_one, $index); )

Merhaba arkadaşlar! söz verdiğim gibi konu açtım WordPress kenar çubukları. Bu, WordPress sitelerinde kenar çubuklarını kullanmak ve özelleştirmek için küçük bir kılavuzdur.

Bu başlıkta, tüm şablon geliştiricilerine küçük bir sır vermek istiyorum: kenar çubukları her zaman WordPress sisteminin önemli bir parçası olmuştur ve son birkaç yılda büyük ölçüde geliştirilmiştir.

Son gelişmeleri dikkate alarak, size WordPress temaları için kenar çubukları oluşturma ve kullanma sürecini adım adım göstereceğim.

WordPress kenar çubuğu nedir?

Aslında, "kenar çubuğu (kenar çubuğu)" terimi, WordPress sisteminde tamamen ilgisiz iki kavram anlamına gelebilir:

1. Dinamik kenar çubuğu: kullanıcının yönetici paneli -> Widget'lar bölümünden yükleyebileceği bir dizi widget için bir kapsayıcı.
2. Kenar çubuğu şablonu: Bu, site şablonu tarafından görüntülenen kenar çubuğudur.

Çoğu durumda, basit şablonlar, yönetici panelinden yerleştirilen tüm widget'ları yükleyen dinamik bir kenar çubuğuna sahiptir. Bu işlem başka bir algoritmaya göre de gerçekleşebilir, ancak çoğu zaman bu şemaya göre. Yine de, dinamik kenar çubuğu ve kenar çubuğu şablonunun iki farklı şey olduğunu anlamak önemlidir. Her şey premium, ben esas olarak Kenar Çubuğu şablonuyla çalışıyorum.

Genellikle 'kenar çubuğu' terimi, bu makalede ele alınacak olan dinamik kenar çubuğuyla ilgili olarak kullanılır. Ancak kenar çubuğu şablonuna da değineceğim.

Pek çok temaya göz atarken beni en çok hayal kırıklığına uğratan şey, geliştiricilerin WordPress sisteminin en güçlü özelliklerinden tam olarak yararlanmamasıdır. Çoğu temanın yalnızca bir kenar çubuğu vardır, en iyi ihtimalle iki tanedir. Ancak sonuçta bu temalar, widget'lar kullanılarak kolayca işlenebilen ve içerikleri doğrudan şablona yerleştirilebilen bir dizi seçeneğe sahip devasa sayfalar oluşturacaktır. Esnek, zengin özelliklere sahip bir site oluşturmak için bir temada çok sayıda kenar çubuğu kullanmayı tercih ederim.

WordPress Kenar Çubuğu Kaydetme, Ekleme ve Oluşturma

Çoğu tema genellikle kalite standartlarının gerisinde kalır, bu nedenle bir şablon geliştiricisiyseniz bu konuyu ciddiye aldığınızdan emin olalım. Uygun bir dinamik oluşturma WordPress kenar çubuğu sürecin en önemli parçasıdır, çünkü içinde ayarladığınız şey diğer tüm kenar çubuğu özellikleriyle ilişkili olacaktır.

Bir veya daha fazla kenar çubuğu oluşturmak için bunları bir dosya aracılığıyla kaydetmeniz gerekir. fonksiyonlar. php Temanız, her temanın tüm şablon ayarlarını içeren kendi dosyası vardır. Dosyalamak fonksiyonlar. php Tema ayarları ekleyebilir veya kaldırabilirsiniz.

Aşağıdaki kod, işlevi kullanarak WordPress'te nasıl bir kenar çubuğu oluşturabileceğinizi gösterir. register_sidebar(). Bu durumda, çalışmak için örnek teşkil edecek 'birincil' adlı bir kenar çubuğu oluşturacağız.

"birincil", "ad" => __("Birincil"), "açıklama" => __("Yön çubuğu açıklaması (yönetici panelinde görünür)."), "before_widget" => "

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

"," after_title" => "

")); /* Diğer widget'lar için register_sidebar() işlevini tekrarlayabilirsiniz, id alanı benzersiz olmalıdır (birincil, ikincil, moiwidget, vb. */ ) ?>

add_action("widgets_init", "registriruem_sidebari" ) ; register_sidebari() işlevi ( /* "Birincil" kenar çubuğunu kaydedin. */ kayıt_kenar çubuğu( sıralamak( "id" => "birincil", "isim" => __("Birincil") , "açıklama" => __( "Kenar çubuğunun açıklaması (yönetici panelinde görünür).") , "widget'tan önce" => " " , "after_widget" => " " , "başlıktan önce" => " " , "başlıktan sonra" => " " /* register_sidebar() işlevini diğer parçacıklar için tekrarlayabilirsiniz, id alanı benzersiz olmalıdır (birincil, ikincil, moiwidget, vb. */

Gördüğünüz gibi, nasıl yapılacağı hakkında bilginiz varsa, bir kenar çubuğunu kaydetmek çok basit bir iştir.

Dinamik Kenar Çubuğu Oluşturma Argümanları dinamik_kenar çubuğu()

İşlev register_sidebar() yalnızca bir parametre kabul eder, buna denir $arg ve widget'larıyla birlikte kenar çubuğunun nasıl oluşturulması gerektiğini belirten bir dizi argüman içerir. Ardından, bağımsız değişkenlerin manuel olarak nasıl kullanılacağına ilişkin örnekleri inceleyin.

İD

Argüman İD, muhtemelen yazılacak en önemli argümanlardan biridir (aşağıdaki kötü yazılmış kod örneğine bakın ve neden kesinlikle yazmanız gerektiğini görün). WordPress'in kullanacağı İD belirli bir kenar çubuğuna widget atamak için ihtiyacınız olacak İD kenar çubuğunu daha fazla doldurmak için - kenar çubuğu.

Her İD eşsiz olmalı. WordPress, varsayılan olarak şunun için yazacaktır: kenar çubuğu-$i(Nerede $ ben

//sadece bir kez atanan widget kimliğimiz "id" => "birincil",

İsim

Kendinizi en iyi temsil ettiğini düşündüğünüz herhangi bir ismi yazabilirsiniz. WordPress kenar çubuğu. Çoğu zaman, kenar çubuklarına, kullanıcının konunun hangi yönlerine değindiğini belirleyebileceği adlar verilir (örneğin, sol veya sağ kenar çubuğu). Bu argüman uluslararasılaştırılabilir (yani diğer diller için yerelleştirilebilir). Bu nedenle konunuzu çeviriye hazırlarken doğru metin alanını yazdığınızdan emin olun. Bağımsız değişken, varsayılan olarak Kenar Çubuğu olarak yazılır $ ben(Nerede $ ben oluşturulan kenar çubuğunun sıra numarasıdır).

//widget adı, örnekte widget id'sinin adı olarak Primary'i kullanıyorum "name" => "Primary",

Tanım

Argüman Tanım ilk olarak WordPress 2.9'da tanıtıldı. Bu bağımsız değişken widget'ınızı tanımlamanıza izin verir, açıklama yönetici panelinde Widget'lar bölümünde görüntülenir. Bu bağımsız değişken, varsayılan olarak boş bir dizeye yazılır. Aynı zamanda uluslararası hale getirilebilir (yani Kiril veya diğer dillerde yazılabilir).

//açıklama widget bölümünde görünür olacak "description" => __("Sitedeki sol sütun için widget"),

önce_widget

Argüman önce_widget bu, pencere öğesinin kenar çubuğuna atanan açılış öğesidir. Aynı zamanda blok düzeyinde bir öğe olmalıdır. HTML işaretleme (ör. etiket < li > , < p > , < div > vesaire.). Bu argüman, örneğin içine yazabileceğiniz birkaç özelliğe sahiptir. kimlik="" veya sınıf="": Öznitellikler kimlik=""şöyle yazılır: (%1$s) ve nitelikler sınıf="" Bu yüzden: (%2$s).

Varsayılan olarak, WordPress bunları bir liste öğesi olarak listeler: < li id = "%1$s" > . Kenar çubuğu widget listesi öğeleri oluşturmanın hayranı değilim. her zaman kullanırım < div > . Kenar çubuğu widget listesi öğeleri oluşturmanın hayranı değilim. En son kullandığımda sitede bir widget olmadığı için ekstra bir şey görmeyeceksiniz. HTML Ancak etiketlerden nasıl kurtulacağımızı daha ayrıntılı olarak ele alacağız.

after_widget

Argüman after_widget oluşturmak oldukça kolay. Bu, kenar çubuğuna atanan widget'ın kapanış öğesidir. Argüman için belirtilen öğeyi kapatmanız yeterlidir. önce_widget. Varsayılan olarak, WordPress bunu şu şekilde yazacaktır: < li > .

"after_widget" => "