الشريط الجانبي وورد. الأشرطة الجانبية لـ WordPress ، إنشاء الشريط الجانبي لـ WordPress. أدوات WordPress الافتراضية

يعرض أول لوحة عناصر واجهة مستخدم نشطة (الشريط الجانبي هو لوحة تحتوي على عنصر واجهة مستخدم واحد على الأقل). يمكنك تحديد معرّف أو رقم اللوحة ، أيهما سيتم عرضه ، إذا كان الموقع يحتوي على أكثر من لوحة عناصر واجهة مستخدم.

يعرض dynamic_sidebar () صواب أو خطأ ، مع عرض نتيجة الإرجاع أيضًا شريط عناصر واجهة المستخدم. يمكن استخدام قيمة الإرجاع ، على سبيل المثال ، لتحديد ما إذا كان يجب معالجة التعليمات البرمجية التي تحل محل عناصر واجهة المستخدم في حالة عدم وجود عناصر واجهة مستخدم في اللوحة (راجع المثال رقم 1).

عائدات

صحيح إذا تم العثور على لوحة الأدوات. خطأ إذا كانت اللوحة غير موجودة أو لا تحتوي على أدوات.

إستعمال

أمثلة

# 1 اعرض الشريط الجانبي إذا كان موجودًا.

يوضح هذا المثال كيفية عرض أول شريط جانبي غير فارغ (لم يتم تحديد معرف الشريط الجانبي أثناء التسجيل) أو إذا لم يتم العثور عليه ، فقم بمعالجة الرمز المحدد:

# 2 اعرض الشريط الجانبي المطلوب.

# 3 تحقق من وجود اللوحة واعرضها

في المثال 2 ، لم نتحقق من وجود لوحة وعناصر واجهة مستخدم فيها. في هذا المثال ، سوف نتحقق من وجود لوحة حتى لا تظهر غير ضرورية علامات HTML (

) إذا كان الشريط الجانبي فارغًا:

أشرطة جانبية متعددة

عند تسجيل أكثر من لوحة عناصر واجهة مستخدم واحدة مع register_sidebar () ، يكون من الأنسب تحديد معرف لكل لوحة.

لا يمكننا تحديد الهوية ، ثم تتلقى اللوحة الرقم التسلسلي. لكن في هذه الحالة ، عند تحرير السمة ، سيكون من الصعب فهم أي لوحة هي ، لأن الأرقام 1 ، 2 ، 3 لا تعني شيئًا. ولكن إذا قمت بتعيين الاسم ، فسيصبح أكثر وضوحًا:

// --- أعداد// التسجيل register_sidebar () ؛ // إخراج dynamic_sidebar (1) ؛ // --- سلاسل// register_sidebar (المصفوفة ("id" => "top_menu")) ؛ // إخراج dynamic_sidebar ("top_menu") ؛

من المثال ، من الواضح أنه أكثر ملاءمة مع السلاسل: النظر في الموضوع ورؤية شريط الديناميكي ("top_menu") ، من الواضح على الفور أنه يتم استدعاء لوحة القائمة الرئيسية.

يجب ألا تحتوي وسيطة id على مسافات أو أحرف كبيرة أو أحرف سيريلية. يمكنك استخدام شرطة - وشرطة سفلية _ فيها. يجب أن تكون فريدة أيضًا. من خلال تحديد المعرّف ، يمكننا أيضًا تحديد الاسم والوصف والترجمات لها:

Register_sidebar (المصفوفة ("id" => "القائمة العلوية" ، "الاسم" => __ ("القائمة العلوية" ، $ text_domain) ، "الوصف" => __ ("يقع هذا الشريط الجانبي فوق شعار العمر."، $ text_domain))))

ملحوظات

• عالمي. مجموعة مصفوفة. الأشرطة الجانبية المسجلة $ wp_registered_sidebars.
• عالمي. مجموعة مصفوفة. $ wp_registered_widgets

قائمة التغييرات

منذ الإصدار 2.2.0

قدَّم.

شفرة الشريط الجانبي الديناميكي: wp-include / widgets.php WP 5.3.2

$ value) (if (sanitize_title ($ value ["name"]) == $ index) ($ index = $ key؛ break؛))) $ sidebars_widgets = wp_get_sidebars_widgets ()؛ if (فارغ ($ wp_registered_sidebars [$ index]) || فارغ ($ sidebars_widgets [$ index]) ||! is_array ($ sidebars_widgets [$ index])) (/ ** تم توثيق هذا الإجراء في wp-include / widget. php * / do_action ("dynamic_sidebar_before"، $ index، false)؛ / ** تم توثيق هذا الإجراء في wp-include / widget.php * / do_action ("dynamic_sidebar_after"، $ index، false)؛ / ** هذا المرشح هو موثق في wp-include / widget.php * / return apply_filters ("dynamic_sidebar_has_widgets"، false، $ index)؛) / ** * الحرائق قبل عرض الأدوات في شريط جانبي ديناميكي. * * ملاحظة: يتم تشغيل الإجراء أيضًا للأشرطة الجانبية الفارغة ، وعلى كل من الواجهة الأمامية * والنهاية الخلفية ، بما في ذلك الشريط الجانبي Inactive Widgets على شاشة Widgets. * *since 3.9.0 * *param int | string $ index Index أو الاسم أو المعرف للشريط الجانبي الديناميكي. *param bool $ has_widgets ما إذا كان الشريط الجانبي ممتلئًا بعناصر واجهة مستخدم أم لا. * الافتراضي صحيح. * / do_action ("dynamic_sidebar_before"، $ index، true)؛ $ sidebar = $ wp_registered_sidebars [$ index] ؛ did_one $ = خطأ ؛ foreach ((array) $ sidebars_widgets [$ index] كـ $ id) (if (! isset ($ wp_registered_widgets [$ id])) (continue؛) $ params = array_merge (array (array_merge ($ sidebar، array ("widget_id") => $ id، "widget_name" => $ wp_registered_widgets [$ id] ["name"]،))،)، (المصفوفة) $ wp_registered_widgets [$ id] ["params"])؛ // استبدل معرف HTML والفئة السمات إلى before_widget $ classname_ = "" ؛ foreach ((مجموعة) $ wp_registered_widgets [$ id] ["classname"] كـ $ 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_) ؛ / ** * ترشيح المعلمات التي تم تمريرها إلى رد اتصال عرض عنصر واجهة المستخدم. * * ملاحظة: يتم تقييم المرشح على كل من الواجهة الأمامية والخلفية ، * بما في ذلك الشريط الجانبي Inactive Widgets على شاشة Widgets. * *since 2.5.0 * * @ see register_sidebar () * *param array $ params (*typ e array $ args (* مجموعة من وسيطات عرض عنصر واجهة المستخدم. * *type string $ name اسم الشريط الجانبي الذي تم تخصيص عنصر واجهة المستخدم له. *type string $ id ID للشريط الجانبي الذي تم تعيين الأداة إليه. *type string $ description وصف الشريط الجانبي. *type string تم تطبيق فئة CSS $ class على حاوية الشريط الجانبي. *type string $ before_widget HTML ترميز قبل كل عنصر واجهة مستخدم في الشريط الجانبي. *type string $ after_widget HTML ترميز لإلحاق كل عنصر واجهة مستخدم في الشريط الجانبي. *type string $ before_title HTML علامة تكميلية قبل عنوان الأداة عند عرضها. *type string $ after_title HTML ترميز لإلحاق عنوان عنصر واجهة المستخدم عند عرضها. *type string $ widget_id ID الخاص بالقطعة. *type string $ widget_name اسم الأداة. *) *type array $ widget_args (* مصفوفة من الوسائط المتعددة الأدوات. * *type int $ number زيادة الرقم المستخدمة لمضاعفات نفس عنصر واجهة المستخدم. *) *) * / $ params = apply_filters ("dynamic_sidebar_params"، بارامس) ؛ رد الاتصال بالدولار = $ wp_registered_widgets [$ id] ["callback"] ؛ / ** * حرائق قبل استدعاء عرض عنصر واجهة المستخدم. * * ملاحظة: يتم تشغيل الإجراء على كل من الواجهة الأمامية والخلفية ، بما في ذلك * للأدوات في الشريط الجانبي Inactive Widgets على شاشة Widgets. * * الإجراء هو لم يتم تشغيله للأشرطة الجانبية الفارغة. * *since 3.0.0 * *param array $ widget_id (* مصفوفة ترابطية من وسيطات عنصر واجهة المستخدم. * *type string $ name اسم عنصر واجهة المستخدم. *type string $ id Widget ID. *type array | callback $ عند تشغيل الخطاف على الواجهة الأمامية ، رد النداء $ عبارة عن مصفوفة * تحتوي على عنصر عنصر واجهة المستخدم. تم إطلاقه في النهاية الخلفية ، رد استدعاء $ * هو "wp_widget_control" ، راجع $ _callback. *type array $ params مصفوفة ترابطية من الوسائط متعددة عناصر واجهة المستخدم. *type string $ classname يتم تطبيق فئة CSS على حاوية عناصر واجهة المستخدم. *type string $ description وصف عنصر واجهة المستخدم. *type array $ _callback عند تشغيل الخطاف في الخلف end ، يتم ملء $ _callback * بمصفوفة تحتوي على عنصر عنصر واجهة المستخدم ، راجع رد استدعاء $. *) * / do_action ("d ynamic_sidebar "، $ wp_registered_widgets [$ id]) ؛ if (is_callable ($ callback)) (call_user_func_array ($ callback، $ params)؛ $ did_one = true؛)) / ** * الحرائق بعد الأدوات تظهر في شريط جانبي ديناميكي. * * ملاحظة: يتم تشغيل الإجراء أيضًا للأشرطة الجانبية الفارغة ، وعلى كل من الواجهة الأمامية * والنهاية الخلفية ، بما في ذلك الشريط الجانبي Inactive Widgets على شاشة Widgets. * *since 3.9.0 * *param int | string $ index Index أو الاسم أو المعرف للشريط الجانبي الديناميكي. *param bool $ has_widgets ما إذا كان الشريط الجانبي ممتلئًا بعناصر واجهة مستخدم أم لا. * الافتراضي صحيح. * / do_action ("dynamic_sidebar_after"، $ index، true)؛ / ** * لتصفية ما إذا كان الشريط الجانبي يحتوي على عناصر واجهة أم لا. * * ملاحظة: يتم أيضًا تقييم المرشح للأشرطة الجانبية الفارغة ، وعلى كل من الواجهة الأمامية * والنهاية الخلفية ، بما في ذلك الشريط الجانبي Inactive Widgets على شاشة Widgets. * *since 3.9.0 * *param bool $ did_one ما إذا كان قد تم عرض عنصر واجهة مستخدم واحد على الأقل في الشريط الجانبي. * خطأ افتراضي. *param int | string $ index Index أو الاسم أو المعرف للشريط الجانبي الديناميكي. * / return application_filters ("dynamic_sidebar_has_widgets" ، $ did_one ، $ index) ؛ )

مرحبا اصدقاء! كما وعدت ، لقد قدمت موضوعًا حول الأشرطة الجانبية لـ WordPress. هذا دليل صغير لاستخدام وتخصيص الأشرطة الجانبية على مواقع WordPress.

في هذا الموضوع ، أرغب في الكشف عن سر صغير لجميع مطوري القوالب: كانت الأشرطة الجانبية دائمًا جزءًا مهمًا من نظام WordPress وتم تحسينها بشكل كبير خلال السنوات القليلة الماضية.

مع الأخذ في الاعتبار التطورات الأخيرة ، سأوضح لك العملية خطوة بخطوة لإنشاء واستخدام الأشرطة الجانبية لموضوعات WordPress.

ما هو الشريط الجانبي لـ WordPress؟

في الواقع ، يمكن أن يعني مصطلح "الشريط الجانبي (الشريط الجانبي)" مفهومين غير مرتبطين تمامًا في نظام WordPress:

1. الشريط الجانبي الديناميكي: حاوية لمجموعة من الأدوات التي يمكن للمستخدم تثبيتها من خلال لوحة الإدارة -> قسم الأدوات.
2. قالب الشريط الجانبي: هذا هو الشريط الجانبي الذي يتم عرضه بواسطة قالب الموقع.

في معظم الحالات ، تحتوي القوالب البسيطة على شريط جانبي ديناميكي يقوم بتحميل جميع عناصر واجهة المستخدم الموضوعة من لوحة الإدارة. يمكن أن تتم هذه العملية أيضًا وفقًا لخوارزمية أخرى ، ولكن في أغلب الأحيان وفقًا لهذا المخطط. ومع ذلك ، من المهم أن نفهم أن الشريط الجانبي الديناميكي ونموذج الشريط الجانبي هما شيئان مختلفان. كل شيء ممتاز ، وأنا أعمل بشكل أساسي مع قالب الشريط الجانبي.

عادةً ما يتم استخدام مصطلح "الشريط الجانبي" فيما يتعلق بالشريط الجانبي الديناميكي ، والذي سيتم مناقشته في هذه المقالة. ومع ذلك ، سوف أتطرق إلى قالب الشريط الجانبي أيضًا.

أكثر ما أصابني بخيبة أمل في تصفح العديد من السمات هو أن المطورين لا يستفيدون بشكل كامل من أقوى ميزات نظام WordPress. تحتوي معظم السمات على شريط جانبي واحد فقط ، اثنان في أحسن الأحوال. ولكن بعد كل شيء ، ستنشئ هذه السمات صفحات ضخمة بها مجموعة من الخيارات التي يمكن معالجتها بسهولة باستخدام الأدوات ، ويمكن وضع محتواها مباشرة في القالب. أفضل استخدام الكثير من الأشرطة الجانبية في قالب ما لإنشاء موقع مرن وغني بالميزات.

تسجيل وإضافة وإنشاء شريط جانبي لـ WordPress

غالبًا ما لا ترقى العديد من السمات إلى معايير الجودة ، لذلك إذا كنت مطور قوالب ، فلنتأكد من التعامل مع هذه المشكلة على محمل الجد. خلق ديناميكية مناسبة الشريط الجانبي لـ WordPressهو الجزء الأكثر أهمية في العملية ، لأن ما تحدده فيه سيكون مرتبطًا بجميع ميزات الشريط الجانبي الأخرى.

لإنشاء شريط جانبي واحد أو أكثر ، سيتعين عليك تسجيلهم عبر ملف المهام. بي أتش بيقالبك ، كل نسق له ملفه الخاص الذي يحتوي على جميع إعدادات القالب. إلى ملف المهام. بي أتش بييمكنك إضافة أو إزالة إعدادات الموضوع.

يوضح الكود أدناه كيف يمكنك إنشاء شريط جانبي في WordPress باستخدام الوظيفة register_sidebar (). في هذه الحالة ، سننشئ شريطًا جانبيًا يسمى "أساسي" والذي سيكون بمثابة مثال للعمل به.

"أساسي" ، "اسم" => __ ("أساسي") ، "وصف" => __ ("وصف الشريط الجانبي (مرئي في لوحة الإدارة).") ، "before_widget" => "

"،" after_widget "=>"
"،" before_title "=>"

"،" after_title "=>"

")) ؛ / * يمكنك تكرار وظيفة register_sidebar () لعناصر واجهة مستخدم أخرى ، يجب أن يكون حقل المعرف فريدًا (أساسي ، ثانوي ، moiwidget ، إلخ. * /)؟>

add_action ("widgets_init"، "registriruem_sidebari") ؛ وظيفة register_sidebari () ( / * تسجيل الشريط الجانبي "الأساسي". * / register_sidebar ( مجموعة مصفوفة( "id" => "أساسي" ، "الاسم" => __ ("أساسي") ، "الوصف" => __ ( "وصف الشريط الجانبي (مرئي في لوحة الإدارة).") , "before_widget" => " " , "after_widget" => " " , "before_title" => " " , "after_title" => " " / * يمكنك تكرار وظيفة register_sidebar () لعناصر واجهة المستخدم الأخرى ، ويجب أن يكون حقل المعرف فريدًا (أساسي ، ثانوي ، عنصر moiwidget ، إلخ. * /

كما ترى ، يعد تسجيل الشريط الجانبي مهمة بسيطة للغاية إذا كان لديك معلومات حول كيفية القيام بذلك.

الحجج الخاصة بإنشاء شريط جانبي ديناميكي الشريط الجانبي الديناميكي ()

وظيفة register_sidebar ()يقبل معلمة واحدة فقط ، يطلق عليه $ أرجسويحتوي على مجموعة من الوسائط التي تحدد كيفية عرض الشريط الجانبي مع عناصر واجهة المستخدم الخاصة به. بعد ذلك ، ضع في اعتبارك أمثلة حول كيفية استخدام الوسائط يدويًا.

بطاقة تعريف

دعوى بطاقة تعريف، ربما تكون واحدة من أهم الحجج التي يجب كتابتها (راجع مثال الشفرة المكتوبة بشكل سيئ أدناه واعرف لماذا يجب عليك بالتأكيد كتابتها). سيستخدم WordPress ملفات بطاقة تعريفلتعيين أدوات لشريط جانبي معين ، وستحتاج إلى بطاقة تعريفلتعبئة الشريط الجانبي - الشريط الجانبي.

كل بطاقة تعريفيجب أن يكون فريدًا. ووردبريس ، بشكل افتراضي ، سيصفها لـ الشريط الجانبي- $ i(أين أنا $

// معرف عنصر واجهة المستخدم الخاص بنا ، والذي تم تعيينه مرة واحدة فقط "id" => "أساسي" ،

اسم

يمكنك كتابة أي اسم تعتقد أنه يمثل أفضل اسم لك الشريط الجانبي لـ WordPress. في أغلب الأحيان ، يتم إعطاء الأشرطة الجانبية أسماء يمكن للمستخدم من خلالها تحديد جوانب الموضوع التي يتطرق إليها (على سبيل المثال ، الشريط الجانبي الأيسر أو الأيمن). يمكن تدويل هذه الحجة (أي المترجمة للغات أخرى). لذا تأكد من كتابة المجال النصي الصحيح عند تحضير موضوعك للترجمة. تتم كتابة الوسيطة ، افتراضيًا ، كشريط جانبي أنا $(أين أنا $هو الرقم الترتيبي للشريط الجانبي الذي تم إنشاؤه).

// اسم عنصر واجهة المستخدم ، في المثال الذي أستخدمه أساسي كاسم معرف الأداة "اسم" => "أساسي" ،

وصف

دعوى وصفتم تقديمه لأول مرة في WordPress 2.9. تتيح لك هذه الوسيطة وصف عنصر واجهة المستخدم الخاص بك ، ويتم عرض الوصف في لوحة الإدارة في قسم الأدوات. هذه الوسيطة ، بشكل افتراضي ، مكتوبة على سلسلة فارغة. يمكن أيضًا تدويلها (أي مكتوبة باللغة السيريلية أو لغات أخرى).

سيكون // الوصف مرئيًا في قسم الأدوات "الوصف" => __ ("عنصر واجهة المستخدم للعمود الأيسر على الموقع") ،

before_widget

دعوى before_widgetهذا هو العنصر الافتتاحي لعنصر واجهة المستخدم المخصص للشريط الجانبي. يجب أن يكون أيضًا عنصرًا على مستوى الكتلة لغة البرمجةالترميز (مثل العلامة < li > , < p > , < div > إلخ.). تحتوي هذه الحجة على ميزتين يمكنك الكتابة فيهما على سبيل المثال معرف = ""أو فئة = "": صفات معرف = ""مكتوبة مثل هذا: (٪ 1 $ s)والسمات فئة = ""لذا: (٪ 2 $ s).

بشكل افتراضي ، سيقوم WordPress بإدراجها كعنصر قائمة: < li id = "%1$s" > . لست من محبي إنشاء عناصر قائمة عناصر واجهة مستخدم الشريط الجانبي. أنا دائما استخدم < div > . لست من محبي إنشاء عناصر قائمة عناصر واجهة مستخدم الشريط الجانبي. آخر مرة استخدمتها ، لأنه في حالة عدم وجود عنصر واجهة مستخدم على الموقع ، فلن ترى المزيد لغة البرمجةالعلامات ، ومع ذلك ، سننظر في كيفية التخلص منها.

after_widget

دعوى after_widgetمن السهل جدًا إنشاءه. هذا هو عنصر الإغلاق لعنصر واجهة المستخدم المخصص للشريط الجانبي. تحتاج فقط إلى إغلاق العنصر المحدد للوسيطة before_widget. بشكل افتراضي ، سيكتبها WordPress كملف < li > .

"after_widget" => "