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

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Template:ExtensionInstall and the translation is 100% complete.
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎ExtensionInstall داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/ExtensionInstall/ExtensionInstall.php";
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.
توثيق القالب

الاستخدام

Add instructions about installing an extension.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Extension name1

Set the extension name manually.

Default
The current page name without namespace prefix.
Auto value
{{ROOTPAGENAME}}, i.e. the page name without namespace nor subpages
Stringoptional
Vagrant role namevagrant

If given, shows how to install extension with the vagrant's enable-role command

Auto value
Stringoptional
Download linkdownload-link

Overwrite the download link.

Default
Link to ExtensionDistributor with the extension name.
URLoptional
LocalSettings earlylocalsettingsearly

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
Unknownoptional
LocalSettingslocalsettings

Pass custom php code that the user should include in [[LocalSettings.php]].

Example
$wgUseAjax = true;
Unknownoptional
Database updatedb-update

If the extension has one or more database tables that need to be created through [[update.php]], set this parameter to any value.

Default
false
Booleanoptional
Composercomposer

If the extension uses [[Composer]] to manage dependencies, set this parameter to any value.

Default
false
Booleanoptional
Custom steps 0custom-steps0

Additional steps before download, e.g. other required extensions (as an unordered "* list")

Contentoptional
Custom stepscustom-steps

Additional steps (as an unordered "* list")

Contentoptional
Supports registrationregistration

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.

Stringoptional
No registration versionno-registration-version

The MediaWiki version for which extension registration should not be used

Default
1.24
Unknownoptional

أمثلة

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

بسيط

{{ExtensionInstall}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

الاسم

{{ExtensionInstall|CategoryTree}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎CategoryTree داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/CategoryTree/CategoryTree.php";
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

وصلة التنزيل

{{ExtensionInstall
|download-link=[http://bits.wikimedia.org/example.zip Download]
}}
  • Download وضع الملف/الملفات في دليل يحمل اسم ‎MyExtension في مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

LocalSettings

{{ExtensionInstall
|localsettings=
$wgUseAjax = true;
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    $wgUseAjax = true;
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

LocalSettings مبكر

{{ExtensionInstall
|localsettingsearly=
$wgUseAjax = true; // this must be included before the extension is loaded
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    $wgUseAjax = true; // this must be included before the extension is loaded
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

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

{{ExtensionInstall
|db-update=Yes
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • شغل نص التحديث البرمجي الذي سوف ينشئ تلقائيا جداول قاعدة البيانات الضرورية التي يحتاج إليها الامتداد.
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

Composer

{{ExtensionInstall
|composer=Yes
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • حينما تثبته مستخدما غت شغّل Composer كي تثبت اعتمادات بي إتش بي، وذلك عن طريق إصدار composer install --no-dev في مجلد الامتداد. (طالع مهمة T173141 لتطلع على التعقيدات المحتملة.)
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

خطوات مخصصة

{{ExtensionInstall
|custom-steps=
* Lorem ipsum dolor sit amet
* Foo bar baz quux [[sandbox]]
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    require_once "$IP/extensions/MyExtension/MyExtension.php";
    
  • Lorem ipsum dolor sit amet
  • Foo bar baz quux sandbox
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

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

{{ExtensionInstall
|registration=1
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    wfLoadExtension( 'MyExtension' );
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

للمستخدمين الذي يستخدمون إصدار ميدياويكي 1.24 أو ما قبله:

تبين التعليمات السالفة سبيل جديد لتثبيت الامتداد مستخدما ‎wfLoadExtension()‎. لو كنت تحتاج لتثبيت الامتداد على هذه الإصدارات السابقة (ميدياويكي 1.24 أو ما قبله)، استخدم ما يلي بدلا من wfLoadExtension( 'MyExtension' );:

require_once "$IP/extensions/MyExtension/MyExtension.php";

ضبط إصدار ميدياويكي لأغراض التسجيل المحبذة

{{ExtensionInstall
|registration=1
|no-registration-version=1.25
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    wfLoadExtension( 'MyExtension' );
    
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

للمستخدمين الذي يستخدمون إصدار ميدياويكي 1.25 أو ما قبله:

تبين التعليمات السالفة سبيل جديد لتثبيت الامتداد مستخدما ‎wfLoadExtension()‎. لو كنت تحتاج لتثبيت الامتداد على هذه الإصدارات السابقة (ميدياويكي 1.25 أو ما قبله)، استخدم ما يلي بدلا من wfLoadExtension( 'MyExtension' );:

require_once "$IP/extensions/MyExtension/MyExtension.php";

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

{{ExtensionInstall
|registration=required
}}
  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎MyExtension داخل مجلد ‎extensions/‎ لديك.
  • أضف الكود التالي في الجزء الأسفل من LocalSettings.php:
    wfLoadExtension( 'MyExtension' );
    
  • Yes تم التنفيذ – اذهب إلى 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
}}
  • لو كنت تستخدم Vagrant ، ثبته مستخدما vagrant roles enable example --provision
تثبيت يدوي
  • 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
  • Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

للمستخدمين الذي يستخدمون إصدار ميدياويكي 1.24 أو ما قبله:

تبين التعليمات السالفة سبيل جديد لتثبيت الامتداد مستخدما ‎wfLoadExtension()‎. لو كنت تحتاج لتثبيت الامتداد على هذه الإصدارات السابقة (ميدياويكي 1.24 أو ما قبله)، استخدم ما يلي بدلا من wfLoadExtension( 'Example' );:

require_once "$IP/extensions/Example/Example.php";