قالب:تثبيت امتداد
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
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 على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
هذا القالب يستخدم لوا: |
الاستخدام
Installation instructions.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Extension name | 1 | Set the extension name manually.
| 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.
| URL | optional |
LocalSettings early | localsettingsearly | Pass custom php code that the user should include in [[LocalSettings.php]] before the extension is loaded.
| Unknown | optional |
LocalSettings | localsettings | Pass custom PHP code that the user should include in [[LocalSettings.php]].
| Unknown | optional |
Database update | db-update | If the extension has one or more database tables that need to be created through [[update.php]], set this parameter to any value.
| Boolean | optional |
Composer | composer | If the extension uses [[Composer]] to manage dependencies, set this parameter to any value.
| 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
| Unknown | optional |
أمثلة
التالي هي بضعة أمثلة عن كيفية استخدام هذا القالب:
بسيط
{{ExtensionInstall}}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/MyExtension/MyExtension.php";- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
الاسم
{{ExtensionInstall|CategoryTree}}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
CategoryTree
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/CategoryTree/CategoryTree.php";- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
وصلة التنزيل
{{ExtensionInstall |download-link=[http://bits.wikimedia.org/example.zip Download] }}
- Download وضع الملف/الملفات في دليل يحمل اسم
MyExtension
في مجلد extensions/
لديك.- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/MyExtension/MyExtension.php";- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
LocalSettings
{{ExtensionInstall |localsettings= $wgUseAjax = true; }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/MyExtension/MyExtension.php"; $wgUseAjax = true;- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
LocalSettings مبكر
{{ExtensionInstall |localsettingsearly= $wgUseAjax = true; // يتعين ضم هذا قبل تحميل الامتداد }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
$wgUseAjax = true; // يتعين ضم هذا قبل تحميل الامتداد require_once "$IP/extensions/MyExtension/MyExtension.php";- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
تحديث قاعدة البيانات
{{ExtensionInstall |db-update=Yes }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/MyExtension/MyExtension.php";- شغل نص التحديث البرمجي الذي سوف ينشئ تلقائيا جداول قاعدة البيانات الضرورية التي يحتاج إليها الامتداد.
- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
Composer
{{ExtensionInstall |composer=Yes }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- حينما تثبته مستخدما غت شغّل Composer كي تثبت اعتمادات بي إتش بي، وذلك عن طريق إصدار
composer install --no-dev
في مجلد الامتداد. (طالع مهمة T173141 لتطلع على التعقيدات المحتملة.)- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/MyExtension/MyExtension.php";- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
خطوات مخصصة
{{ExtensionInstall |custom-steps= * Lorem ipsum dolor sit amet * Foo bar baz quux [[sandbox]] }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
require_once "$IP/extensions/MyExtension/MyExtension.php";- Lorem ipsum dolor sit amet
- Foo bar baz quux sandbox
- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
التسجيل لأغراض الدعم
{{ExtensionInstall |registration=1 }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
wfLoadExtension( 'MyExtension' );- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
التسجيل لأغراض الدعم باستخدام الإصدار الأدنى
{{ExtensionInstall |registration=1 |no-registration-version=1.39 }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
wfLoadExtension( 'MyExtension' );- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
للمستخدمين الذي يستخدمون إصدار ميدياويكي 1.39 أو ما قبله:
تبين التعليمات السالفة سبيل جديد لتثبيت الامتداد مستخدما
wfLoadExtension()
. لو كنت تحتاج لتثبيت الامتداد على هذه الإصدارات السابقة (ميدياويكي 1.39 أو ما قبله)، استخدم ما يلي بدلا منwfLoadExtension( 'MyExtension' );
:require_once "$IP/extensions/MyExtension/MyExtension.php";
يعمل هذا فقط لو كان الإصدار المحدد هو 1.35 أو ما بعده، خلاف ذلك سيفترض القالب أن لا أحد يعبأ بإصدارات قديمة وسيرجع إلى #يتطلب التسجيل.
يتطلب التسجيل
{{ExtensionInstall |registration=required }}
- نزّل الملف/الملفات وضعها في دليل يحمل اسم
MyExtension
داخل مجلد extensions/
لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MyExtension- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
wfLoadExtension( 'MyExtension' );- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
كل شيء
{{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 }}
- Download وضع الملف/الملفات في دليل يحمل اسم
Example
في مجلد extensions/
لديك.- حينما تثبته مستخدما غت شغّل Composer كي تثبت اعتمادات بي إتش بي، وذلك عن طريق إصدار
composer install --no-dev
في مجلد الامتداد. (طالع مهمة T173141 لتطلع على التعقيدات المحتملة.)- أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
wfLoadExtension( 'Example' ); $wgUseAjax = true;- شغل نص التحديث البرمجي الذي سوف ينشئ تلقائيا جداول قاعدة البيانات الضرورية التي يحتاج إليها الامتداد.
- Lorem ipsum dolor sit amet
- Foo bar baz quux sandbox
- تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
للمستخدمين الذي يستخدمون إصدار ميدياويكي 1.39 أو ما قبله:
تبين التعليمات السالفة سبيل جديد لتثبيت الامتداد مستخدما
wfLoadExtension()
. لو كنت تحتاج لتثبيت الامتداد على هذه الإصدارات السابقة (ميدياويكي 1.39 أو ما قبله)، استخدم ما يلي بدلا منwfLoadExtension( 'Example' );
:require_once "$IP/extensions/Example/Example.php";
تنصيب Vagrant:
- لو كنت تستخدم Vagrant ، ثبته مستخدما
vagrant roles enable example --provision