ويكيبيديا:مقدم الطلبات

مُقدم الطلبات هي إضافة تساعد علي إنشاء زر ونموذج طلب أنيق لتسهيل الطلبات في ويكيبيديا العربية.

إنشاء نموذج

أولا: إنشاء ملف التهنئة بصيغة جسون

الجزء الأول: الجذر

{
    "widgets": [...],
    "text": "...",
    "summary": "..."
}

الجذر يحتوي على 3 مفاتيح رئيسية:

1. widgets: قائمة بالعناصر التفاعلية (مثل الحقول والنماذج) التي ستُعرض للمستخدم.

2. text: نص القالب النهائي الذي سيتم إنشاؤه بناءً على المدخلات.

3. summary: ملخص عن الطلب، يتم تكوينه بناءً على المدخلات.

الحقل "widgets"

"widgets": [
		{
			"name": "username",
			"class": "OO.ui.TextInputWidget",
			"config": {
				"label": "مستخدم",
				"value": "__USERNAME__",
				"required": true
			}
		},
		...
]

شرح:

widgets: قائمة من الكائنات، كل كائن يمثل عنصر إدخال (مثل النصوص أو القوائم) داخل النموذج.

داخل كل كائن:

name: اسم هذا الحقل (يستخدم لربط البيانات المدخلة مع الحقول الأخرى أو النصوص).

class: نوع الحقل المستخدم (مثل TextInputWidget لحقول النص، أو MultilineTextInputWidget للكتابة المتعددة).

config: إعدادات إضافية للحقل.

label: النص الذي يظهر بجانب الحقل لتوضيح وظيفته.

value: القيمة الافتراضية (إذا لم تُدخل قيمة).

required: ما إذا كان إدخال هذا الحقل إلزاميًا.

مثال لحقل محدد: "username"

{
	"name": "username",
	"class": "OO.ui.TextInputWidget",
	"config": {
		"label": "مستخدم",
		"value": "__USERNAME__",
		"required": true
	}
}

الحقل يحمل اسم username.

نوعه حقل نص بسيط TextInputWidget.

الإعدادات:

النص بجانبه سيكون "مستخدم".

القيمة الافتراضية هي __USERNAME__.

الحقل إلزامي (required: true).

الحقل "text"

شرح:

text: النص الذي سيتم إنشاؤه باستخدام المدخلات.

يُستخدم قيم widgets مثل ${permission}، و${username}، و${reason} لملء القيم التي أدخلها المستخدم.

النص الناتج يشير إلى قالب خاص (في هذه الحالة: طلب إزالة صلاحية) بوسائط تُملأ بالقيم المدخلة.

الناتج المتوقع (إذا أدخل المستخدم القيم التالية):

permission = "مراجع"

username = "Ahmed123"

reason = "غير نشط"

النص الناتج:

==== <sub>إزالة صلاحية</sub> مراجع: Ahmed123 ====
:{{عن مستخدم|Ahmed123}}
{{وضع طلب|انتظار}}
:'''السبب''': غير نشط --~~~~
:'''رد الإداري''':
<!-- من فضلك اكتب تعليقك أعلى هذا السطر -->
-

الحقل "summary"

"summary": "طلب إزالة صلاحية ${permission}: [[مستخدم:${username}|${username}]]"

شرح:

summary: ملخص الطلب الذي يظهر للمشرفين أو المراجعين.

يُستبدل ${permission} و${username} بالقيم المدخلة.

الناتج المتوقع:

إذا كان permission = "مراجع" وusername = "Ahmed123".

النص الناتج:

طلب إزالة صلاحية مراجع: [[مستخدم:Ahmed123|Ahmed123]]

لتعديل أو إنشاء ملف جديد:

1. استخدم هيكل الجذر نفسه. 2. أضف الحقول التي تحتاجها داخل widgets، وحدد الاسم والنوع والإعدادات. 3. عدل نص text بما يناسب القالب الذي تستخدمه. 4. عدل summary حسب الحاجة لتلخيص الطلب.

مثال جديد: طلب إضافة صلاحية:

{
	"widgets": [
		{
			"name": "username",
			"class": "OO.ui.TextInputWidget",
			"config": {
				"label": "اسم المستخدم",
				"required": true
			}
		},
		{
			"name": "permission",
			"class": "OO.ui.DropdownWidget",
			"config": {
				"label": "الصلاحية",
				"options": [
					{"data": "مراجع"},
					{"data": "إداري"}
				],
				"required": true
			}
		},
		{
			"name": "reason",
			"class": "OO.ui.MultilineTextInputWidget",
			"config": {
				"label": "سبب الطلب",
				"required": true
			}
		}
	],
	"text": "{{نسخ:طلب إضافة صلاحية|مستخدم=${username}|صلاحية=${permission}|سبب=${reason}}}",
	"summary": "طلب إضافة صلاحية ${permission} للمستخدم [[مستخدم:${username}|${username}]]"
}

إبلاغ عن مشاكل

يجب الإبلاغ عن أي مشاكل متعلقة بالإضافة في صفحة النقاش.