Template:Extension/ar

{{Documentation|content= {{intricate template}} {{lua|Module:Extension|Module:ExtensionJson|Module:String}} {{Uses TemplateStyles|Template:Extension/styles.css}} يجب إضافة هذا القالب إلى كافة صفحات الامتداد على موقع الويكي هذا (فقط في الصفحة الرئيسية). سوف يضيف صناديق معلومات مفيدة (طالع التالي) وسوف يضيف الامتداد تلقائيا إلى {{ll|Category:All extensions}}، بالإضافة إلى تصنيفات {{ll|Category:Extensions by status|الحالة}} و{{ll|Category:Extensions by implementation type|نوع التنفيذ}} الملائمين.

متغيرات المحتوى
يقدم هذا القسم وصفا للمتغيرات التي تنظم محتوى صناديق المعلومات. للمساعدة في templatemode ومتغيرات الضبط الأخرى، يرجى مطالعة متغيرات الضبط.
 *  - ترميز قالب يستعين بمتغيرات مخصصة، مثال
 *  - ترميز وسوم إكس إم إل مخصص، مثال
 *  - ترميز قالب لا يحتوي على متغيرات مخصص، مثال
 *  - امتدادات تضيف إعراب ويكي غير قياسي (أي وسوم not ، وكذا دوال المحلل اللغوي أو متغيرات).
 * - متغير عام لأغراض وهي الامتدادات التي تستحدث أو تتحقق من أو تمنح تصاريح أو تسحبها أو تراقب نشاط المستخدمين. لو كتبت امتداد وصول، يرجى استخدام واحد مما يلي من الأنواع المحددة:
 * - امتدادات تراقب نشاط المستخدم (حالات تسجيل الدخول والخروج وإنشاء مستخدم جديد وخلافه)
 * - امتدادات تنشئ مستخدمين وتمحو المستخدمين و/أو تتحقق من هوية أي مستخدم
 * - امتدادات لنظام إدارة الحقوق أي التغييرات التي تطرأ على سبيل تخصيص الحقوق وواجهات برمجة التطبيقات وأدوات الصيانة (لا تشمل الامتدادات التي تذكر فقط الحقوق المطلوبة لاستخدام ميزات هذا الامتداد؛ استخدم لهذا الغرض متغير الحقوق)
 * - متغير عام لكافة امتدادات واجهة المستخدم غير المصنفة.
 *  - امتدادات تسمح بتضمين محتوى وسائط متعددة على صفحات الويكي عن طريق تسجيل امتداد ملف مستخدما.
 *  - امتدادات تقدم بنية تحتية يمكن للمستخدمين منها تخصيص خبرة ميدياويكي الخاصة بهم و/أو المساعدة في إدارة تلك البنية
 * - امتدادات ترسل رسائل بريد إلكتروني إلى المستخدمين وكذا رسائل نشرات وكذا تقديم أنواع أخرى من الإشعار للمجتمع
 *  - امتدادات تحسن من s أو تعدله. يشمل هذا أي شيء ينفذ تصرف يقرأ صفحة أو يكتبها أو يبحث عنها أو يستحدثها أو يغير اسمها أو يمحوها أو يعيد التوجيه إليها أو يناقشها. لا يشمل ذلك حقوق (استخدم user rights) أو سجلات (استخدم user activity).
 * - امتدادات تبحث في صفحات وتختارها نيابة عن المستخدمين.
 * - امتدادات تضيف css أو جافا سكريبت أو تنفذ وظائف وصل تغير هيئة ميدياويكي وطريقة استخدامه باستخدام هيكل السمات.
 * - امتدادات تستخدم أساليب برمجة أجاكس.
 * - امتدادات تقع في فئة فرعية من فئة ، أو تستخدم واحد من وصلاتها أو تربط وظيفة واحدة أو أكثر في . طالع لمزيد من المعلومات.
 * other
 * - امتدادات تضيف وحدة واجهة برمجة تطبيقات جديدة أو توسع من نموذج أساسي لواجهة برمجة التطبيقات قائم.
 * - امتداد للوصلات - يحدد وصلة جديدة - طالع hook1 وخلافه تاليا لو كنت ترغب في تحديد الوصلات التي يستخدمها بالفعل امتدادك.
 * - يضيف جداول و/أو حقول إلى قاعدة البيانات التي تساند تنصيب ميدياويكي
 * - استخلاص البيانات
 * - امتداد يضيف مستودع أنواع ملفات جديد إلى النهاية الخلفية للملفات
 * - ليس امتدادا فعليا، بل مثال على كيفية كتابة كود امتداد
 * - ليس امتدادا فعليا، بل مثال على كيفية كتابة كود امتداد

أي قيمة أخرى لمتغير 'type' ستكون غير صالحة وينتج عنها وضع الامتداد في تصنيف Category:Extensions with invalid or missing type.

ملحوظة: تشتمل عدة امتدادات أكثر من نوع واحد، لو كان ذلك ينطبق على امتداداك، ضع محل  قيمة. يمكنك تحديد عدد يصل إلى ستة أنواع لامتداد واحد. hook1 hook2 hook3 hook4 ...  اسم كل رابط يستخدمه الامتداد إن إدخال القيم في هذا الحقل هو سبيل جيد للفت النظر إلى امتدادك ومساعدة المطورين الآخرين. سوف يضيف كل رابط موثق تلقائيا الامتداد إلى تصنيف يذكر الامتدادات التي تسعين بهذا الرابط. يربط هذا التصنيف تلقائيا بكل صفحة رابط حتى يتسنى للمبرمجين الوصول إلى أمثلة على امتدادات تستخدم رابط محدد.

لأغراض الروابط المدمجة:
 * استخدم اسم الرابط فقط. يرجى الرجوع إلى لتطلع على القيم (إلا أنه عليك إزالة محرف / الأول).

لأغراض الروابط المخصصة التي تحددها الامتدادات:
 * استخدم extensionName/hookName. لتطلع على قائمة جزئية بالروابط المخصصة، طالع Extension hook registry.

لأغراض الروابط المتعددة، حدد الرابط الأول في hook1 والرابط الثاني في hook2 وهكذا دواليك. newhook1 newhook2 newhook3 newhook4 ... newhook90 اسم كل رابط يقدمه الامتداد

ربما قد ترغب أيضا في إضافة روابط إلى Extension hook registry. username  اسم مستخدم المؤلف على موقع MediaWiki.org (لو كان للمستخدم حساب). يمكن محوه، إلا أنه في حالة وجوده سوف يستخدم في الوصل إلى صفحة مستخدم المؤلف وصفحة نقاشه. يجب أن يكون ذلك دون نطاق الاسم ودون. اسم مؤلف الامتداد لو كان مختلفا عن اسم المستخدم الموجود على MediaWiki.org. نص حر. لو محي ستستخدم خانة 'username' (لو كانت له قيمة مقدمة). description  بيان مختصر لقطة من الشاشة أو شعار الامتداد. يجب أن يكون ذلك دون نطاق الاسم ودون. اختياري، حجم الصورة (الحجم الافتراضي هو 220 بيكسل) آخر إصدار تاريخ آخر تحديث compatibility policy   (القيم المقبولة هي master و rel و ltsrel). الإصدار المطلوب من ميدياويكي الإصدار المطلوب من PHP تشير إلى أن الامتداد يتطلب تغيير مخطط جدول قاعدة بيانات أو تصرف مشابه لذلك، قبل تشغيل ميدياويكي. هذا الأمر يعد شرك شائع: سوف تتعرض برمجيات ميدياويكي لديك لعطل لو نسيت تشغيل update.php – لو كان الامتداد يتطلب تشغيل ذلك. يجب أن تحدد  قيمة منذ أن هذا يضمن أن الامتداد لا يتطلب تشغيل update.php وبالتالي تلافي الشك

تصمم الامتدادات التي تتماشى ومعايير امتدادات ميدياويكي القياسية مع نص برمجي لتغيير المخطط الذي يتعين عليك أن تبدأ تشغيله يدويا (مرة واحدة) قبل تشغيل ميدياويكي والوصول إليها مستخدما متصفحك، وكذا بعد نسخك لكافة ملفات الامتداد إلى  وإدراج   في «LocalSettings.php»، شغل التالي من سطر الأوامر:

cd path/to/wiki_install_directory cd maintenance php update.php

composer  لو تطلب الأمر ذلك، يتعين إدراج اسم «vendor» وكذا «package» بصيغة  ، على سبيل المثال   كي توجه الأفراد مباشرة إلى packagist.org، الذي يعمل بصفة أرشيف للحزمة. table1 table2 table3 table4 ... table30 اسم كل جدول غير أساسي يستخدمه الامتداد

وصلات شبكية إلى صفحة فرعية ملحقة بصفحة امتدادك. على سبيل المثال، إدراج "table1 = cu_changes" في خانة سوف يقدم وصلة شبكية إلى. لا تدرج الجداول الأساسية مثل أو  بل عليك أن تدرج فقط الجداول التي تضيفها الامتدادات. الترخيص المنظم لاستخدام هذا الامتداد، باستخدام أحد الأكواد المبينة في https://spdx.org/licenses/ على سبيل المثال  أو   أو   أو خلافه. download  وصلة شبكية للتنزيل : Git، WikimediaDownload. repo  اسم مستودع غيريت الذي يخزن فيه كود الامتداد البرمجي، لو كان مختلفا عن اسم الصفحة. ضبط هذه القيمة تلقائيا يضبط download ويسمح للقالب أن يحمل بيانات آليا من ملف  المناسب. وصلة شبكية خارجية إلى ملف readme مثل https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README وصلة شبكية خارجية إلى ملف سجل التغييرات مثل Extension:LDAP Authentication/Changelog المتغيرات المتاحة لملف LocalSettings.php أية وسوم يستعين بها امتدادك (مثل &lt;tag1&gt;, &lt;tag2&gt;) حقوق يسبغها الامتداد. '''لا تخلط بين هذا وترخيص الامتداد ذاته! '''هي حقوق مثل ' أو '، لا قيم مثل GFDL أو LGPL أو GPL – هذه هي أنواع تراخيص! نطاق الاسم الذي يستخدم فيه هذا الامتداد مثال أو موقع شبكي أو لقطة من الشاشة للامتداد أثناء تأدية عمله معلومات إضافية عن التوافق، على سبيل المثال مخططات التوافق (كانت تستخدم Template:Extension Testing في السابق). نحثك على إضافة أي معلومات توافق خاصة بالبرمجيات العميلة هنا أيضا، خاصة حينما تختلف عن ما هو متوقع من ناحية الدعم الكامل لمتصفح ما. متغيرات اختيارية للوصل الشبكي مع الصفحة المحددة حيث (معرف مجموعة الرسائل التي) سوف يكون الامتداد قابل للترجمة باستخدامها على translatewiki.net لو كانت الترجمة مسموحة. لو كانت الوصلة الشبكية غير صحيحة، يرجى ضبطها يدويا لتكون أي مما يلي: اسم مكون امتداد بغزيلا ميدياويكي اسم مشروع فابريكاتور تخطي اسم الصفحة المستخدم في الوصلة الشبكية لأغراض التحقق من الاستخدام.
 * ext-LOWERCASE(NOSPACES(الوسم حسب ما هو معرف في ))، aka
 * المتغير الذي تحصل عليه في محدد موقع الموارد الموحد بعد
 * إدخال اسم الامتداد في خانة البحث/الترشيح على translatewiki:Special:Translate أو
 * البحث عن اسمه في languagestats بعد النقر على «توسيع الكل – expand all».

متغيرات الضبط
لأنها ليست صفحة امتداد فعلية ولا نرغب في إضافة هذه الصفحة إلى أية تصنيفات بسبب ذلك.
 * nousage - يوقف وصلة 'check usage' الشبكية. توقف أيضا الوصلات الشبكية لو كانت الصفحة هي صفحة فرعية أي ليست في نطاق الاسم Extension: أو كانت موقوفة بسبب 'templatemode=nocats'

لو تركت القيمة فارغة، سوف يضيف القالب صفحة الاستضافة إلى Category:All extensions وإلى تصنيف إضافي واحد أو أكثر، استنادا إلى القيم المخصصة لمتغيرات المحتوى.

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

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

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

زر إنشاء امتداد
كي تحسن من سلوك زر إنشاء امتداد:


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

متغيرات صندوق المعلومات
بوجه عام:


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

إن أردت التغيير/التصويب/الإضافة إلى متغيرات نوع التطبيق:
 * تحقق من صفحة النقاش – ثمة نقاش كثير في هذا المجال.
 * الأنواع الصالحة وما الذي تصل إليه مبين في Module:Extension

كي تغير سلوك متغيرات الربط الشبكي:


 * Template:Extension/HookInUse: يضيف وصلات شبكية وتصنيفات لأي ربط شبكي مستخدم. تنفذ عدة روابط شبكية مستخدمة عن طريق استدعاء هذا القالب مستخدما Template:Foreach.
 * Template:Extension/HookInUseNoCats: يستخدم بدلا من Template:Extension/HookInUse حينما يكون هذا القالب مستخدما في . يمكن فقط للقوالب التي تستخدم مع Template:Foreach أن تأخذ متغير واحد لذا سنحتاج لتضمين الاستدعاء الخاص بحالة Template:Extension/HookInUse في قالب آخر يضبط الحالة.

حالة اختبار
تحقق كي ترى أن الصفحات التالية لا زالت صالحة، بعد تعديل هذا القالب.
 * Extension:Description2
 * Template:Extension

}} Maintenance: vulnerabilities, archived