إنتقل إلى المحتوى الرئيسي

إنشاء قائمة

تتيح قدرة إنشاء قائمة إنشاء قوائم تنقل (navigation menus) لمنصة WordPress، مع دعم تسميات تنقل مميزة ومختلفة عن عناوين الصفحات.

نظرة عامة​

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

المعاملات (Parameters)​

المعامل (Parameter)النوع (Type)مطلوب (Required)الوصف (Description)
namestringYesاسم القائمة، مثال: Primary Navigation
locationstringNoموقع القالب (Theme location) الذي سيتم تعيين هذه القائمة إليه، مثال: primary
navigation_labelstringNoالتسمية التي ستظهر في شريط التنقل (مختلفة عن عنوان الصفحة)

قيمة الإرجاع (Return Value)​

{
  "success": true,
  "menu_id": 7,
  "name": "Primary Navigation",
  "navigation_label": "Main Menu"
}

تسمية التنقل مقابل عنوان الصفحة​

يتيح لك مُعامل navigation_label فصل اسم القائمة الداخلي عن التسمية المعروضة للمستخدمين:

  • name — المعرّف الداخلي للقائمة الذي تستخدمه WordPress (مثال: "Primary Navigation")
  • navigation_label — التسمية المعروضة لزوار الموقع في شريط التنقل (مثال: "Main Menu")

يكون هذا مفيدًا عندما:

  • يختلف نظام التسمية الداخلي الخاص بك عن التسميات الظاهرة للمستخدمين
  • تريد تسميات أقصر في شريط التنقل مما هي عليه في لوحة التحكم (admin panel)
  • تحتاج إلى دعم لغات متعددة بتفاوت في أطوال التسميات
  • تقوم بإنشاء قوائم لمناطق أو مجموعات مستخدمين محددة

أمثلة الاستخدام​

المثال 1: قائمة بسيطة بتسمية تنقل​

المُدخل (Prompt):

Create a primary navigation menu called "Main Navigation" with the navigation label "Menu".

النتيجة:

{
  "success": true,
  "menu_id": 7,
  "name": "Main Navigation",
  "navigation_label": "Menu"
}

المثال 2: قائمة لموقع قالب محدد​

المُدخل (Prompt):

Create a footer menu called "Footer Links" with navigation label "Quick Links" and assign it to the footer location.

النتيجة:

{
  "success": true,
  "menu_id": 8,
  "name": "Footer Links",
  "navigation_label": "Quick Links",
  "location": "footer"
}

التكامل مع مُنشئ القوالب (Theme Builder)​

عند استخدام مُنشئ القوالب (Theme Builder)، تقوم قدرة إنشاء القائمة بما يلي:

  1. الكشف التلقائي عن مواقع القوائم المتاحة في القالب
  2. إنشاء قوائم بتسميات تنقل مناسبة لتصميمك
  3. تعيين القوائم لمواقع القوالب الصحيحة
  4. دعم إضافة عناصر القائمة بعد الإنشاء
  • add_menu_item — إضافة عناصر إلى قائمة موجودة
  • update_menu — إعادة تسمية قائمة أو إعادة تعيينها لموقع قالب
  • delete_menu — إزالة قائمة من موقعك

أفضل الممارسات​

  • استخدم تسميات تنقل واضحة — حافظ على التسميات موجزة ووصفية للمستخدمين
  • مطابقة مواقع القوالب — قم بتعيين القوائم لموقع القالب الصحيح لعرضها بشكل سليم
  • تخطيط هيكل القائمة — قرر التسلسل الهرمي لقائمتك قبل إنشاء العناصر
  • اختبار الاستجابة (Responsiveness) — تحقق من عرض القوائم بشكل صحيح على الأجهزة المحمولة
  • توطين التسميات (Localize labels) — استخدم تسميات تنقل مختلفة لإصدارات اللغات المختلفة

القيود​

  • تسميات التنقل هي للعرض فقط؛ ولا يزال اسم name الداخلي يُستخدم لتحديد WordPress
  • دعم القوالب يختلف؛ ليست كل القوالب تدعم جميع مواقع القوائم
  • يجب إضافة عناصر القائمة بشكل منفصل بعد إنشاء القائمة
  • يتطلب تغيير تسمية التنقل تحديث القائمة