Template:ApiParam/ar

توثيق القالب

يرجى التفكير جديا في رفع استدعاءات هذا القالب ووضع مكانها حالات ضم Special:ApiHelp (T89318) منذ أن ملء متغيرات هذا القالب يكرر بلا داعي توثيق متغيرات واجهة برمجة التطبيقات في النص المصدر.

الاستخدام

يمكن استخدام هذا القالب في توثيق متغيرات واجهة برمجة التطبيقات. الغرض منه هو توحيد هيئة قوالب المتغيرات على كافة صفحات واجهة برمجة التطبيقات.

{{ApiParam
|name=
|description=
|required=
|maxallowed=
|maxallowedbot=
|type=
|values=
|default=
|version=
|deprecated=
|removed=
}}

متغيرات ApiParam
اسم المتغير	بيان	Required?
name (أو أول متغير غير مسمى)	اسم المتغير (إلزامي):	Required
description (أو ثاني متغير غير مسمى	بيان المتغير.	Optional
required	حدد قيمة لو كان المتغير مطلوبا. اسم المتغير المطلوب سوف يكون بخط أسود عريض.	Optional
maxallowed	لأغراض القيم المقسمة باستخدام شريط رأسي أو الكميات المكونة من أرقام، ما هو الحد الأقصى.	Optional
maxallowedbot	كما سلف، للبوتات. لو استخدمت 50 أو 500 لأغراض maxallowed، سوف تصبح القيمة الافتراضية هي 500 أو 5000 على التوالي.	Optional
type	نوع بيانات المتغير.	Optional
values	قائمة بالقيم المحتملة للمتغير.	Optional
default	القيمة الافتراضية للمتغير.	Optional
version	الإصدار الذي أضيف له هذا المتغير. استخدم رقم إصدار برمجيات ميدياويكي الصرف لا غير.	Optional
deprecated	الإصدار الذي أصبح فيه المتغير متقادما. استخدم رقم إصدار برمجيات ميدياويكي الصرف لا غير.	Optional
removed	الإصدار الذي رفع منه هذا المتغير. استخدم رقم إصدار برمجيات ميدياويكي الصرف لا غير.	Optional

أمثلة

*{{ApiParam|rcid|معرّف أحدث تغييرات واحد أو أكثر الذي منه يمكن إضافة الوسم أو إزالته.|maxallowed=50}}

• rcid: معرّف أحدث تغييرات واحد أو أكثر الذي منه يمكن إضافة الوسم أو إزالته. لا يسمح بما يزيد عن 50 (500 للبوتات).

*{{ApiParam|siprop|أيّ الخصائص المطلوب الحصول عليها|default=general}}
**{{ApiParam|general|معلومات عامة عن الموقع}}
***{{ApiParam|articlepath|{{ll|Manual:$wgArticlePath|$wgArticlePath}}|version=1.15}}

• siprop: أيّ الخصائص المطلوب الحصول عليها (افتراضي: general)
  • general: معلومات عامة عن الموقع
    • articlepath: $wgArticlePath 1.15+

طالع أيضا

• {{Parameter }} – نسخة قديمة من ApiParam

يمكن للمحررين تجريب تعديلاتهم على القالب في صفحات ملعب (أنشئ | مرآة) و مختبر (أنشئ).
الصفحات الفرعية لـ قالب.