قالب:تثبيت امتداد

This page is a translated version of the page Template:ExtensionInstall and the translation is 100% complete.

نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎ExtensionInstall داخل مجلد ‎extensions/‎ لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionInstall
```
أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
```
require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
```
تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

توثيق القالب

هذا القالب يستخدم لوا:

Module:Extension

الاستخدام

Installation instructions.

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Extension name	`1`	Set the extension name manually. Default The current page name without namespace prefix. Auto value `{{ROOTPAGENAME}}`	String	optional
Git submodule	`git-submodule`	Add --recurse-submodules to the git clone command	Boolean	optional
Vagrant role name	`vagrant`	If given, shows how to install extension with the Vagrant's enable-role command	String	optional
Download link	`download-link`	Overwrite the download link. Default Link to Special:ExtensionDistributor with the extension name.	URL	optional
LocalSettings early	`localsettingsearly`	Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded. Example $wgUseAjax = true; // Must be included before the extension is loaded	Unknown	optional
LocalSettings	`localsettings`	Pass custom PHP code that the user should include in [[LocalSettings.php]]. Example $wgUseAjax = true;	Unknown	optional
Database update	`db-update`	If the extension requires the update script to be run, set this parameter to any value. (For example, if it has one or more database tables that need to be created.) Example 1	Boolean	optional
Composer	`composer`	If the extension uses Composer to manage dependencies, set this parameter to any value. Not that this does not indicate that the extension is able to be installed with Composer. Default false	Boolean	optional
Custom steps 0	`custom-steps0`	Additional steps before download, e.g. other required extensions (as an unordered "* list").	Content	optional
Custom steps	`custom-steps`	Additional steps (as an unordered "* list").	Content	optional
Supports registration	`registration`	Changes the template to use <code>wfLoadExtension()</code> if it supports registration. Set to any value if the extension supports registration, or to <code>required</code> if it <em>only</em> supports registration and doesn't support the old-style of loading.	String	optional
No registration version	`no-registration-version`	The MediaWiki version for which extension registration should not be used. Default 1.24	Unknown	optional

أمثلة

التالي هي بضعة أمثلة عن كيفية استخدام هذا القالب:

بسيط

{{ExtensionInstall}}

الاسم

{{ExtensionInstall|CategoryTree}}

وصلة التنزيل

{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}

LocalSettings

{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}

LocalSettings مبكر

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // يتعين ضم هذا قبل تحميل الامتداد
}}

تحديث قاعدة البيانات

{{ExtensionInstall
|db-update=Yes
}}

Composer

{{ExtensionInstall
|composer=Yes
}}

خطوات مخصصة

{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}

التسجيل لأغراض الدعم

{{ExtensionInstall
|registration=1
}}

التسجيل لأغراض الدعم باستخدام الإصدار الأدنى

{{ExtensionInstall
|registration=1
|no-registration-version=1.39
}}

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

يتطلب التسجيل

{{ExtensionInstall
|registration=required
}}

كل شيء

{{ExtensionInstall|Example
|download-link=[http://bits.wikimedia.org/example.zip Download]
|vagrant=example
|localsettings=
$wgUseAjax = true;

|db-update=Yes
|composer=Yes
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
|registration=yes
}}