قالب:وصلة شبكية لامتداد

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Template:ExtensionHook and the translation is 100% complete.
Other languages:
English • ‎dansk • ‎polski • ‎العربية • ‎中文 • ‎日本語
Template documentation

نسخ القالب ولصقه

MyHook
متوفر بدءا من الإصدار ???

تعريف الوظيفة:
public static function onMyHook( $x, $y ) { ... }
وصلة الربط الشبكية:
$wgHooks['MyHook'][] = 'MyExtensionHooks::onMyHook';
تستدعى من:ملف/ملفات:

لمزيد من المعلومات المتعلقة بإضافة وصلة شبكية، طالع Manual:Hooks.
كي تطلع على أمثلة على امتدادات أخرى تستخدم هذه الوصلة الشبكية، طالع Category:MyHook extensions/ar.

{{ExtensionHook
|name = MyHook
|version =
|gerrit =
|removed =
|summary =
|args = $x, $y
|extension =
|source =
|sourcefunction =
|sourceclass =
|newvarname =
|newvarlink =
}}

ملاحظات على الاستخدام

name
اسم الوصلة الشبكية. عادة ما يكون هو نفس اسم الصفحة الفرعية.
version
إصدار برمجيات ميدياويكي الذي أضيف إليه هذه الوصلة الشبكي للمرة الأولى.
rev
إصدار مخزن SVN الذي أضيف إليه هذه الوصلة الشبكية للمرة الأولى. لو كان هذا المعطى مضافا، سوف يقدم رابط إلى صفحة مراجعة الكود البرمجي المناسبة لذلك الغرض (مثال r115794).
gerrit
رقم تغيير غيريت (Gerrit) الذي أضيف إليه هذه الوصلة الشبكية للمرة الأولى. لو كان هذا المعطى مضافا، سوف يقدم رابط إلى صفحة مجموعة تغيير غيريت (Gerrit) المناسبة لذلك الغرض (مثال تغيير غيريت رقم 5).
removed
لو كانت الوصلة قد حذفت، سيكون الرقم هو إصدار برمجيات ميدياويكي الذي حذفت منه.
deprecated
لو كانت الوصلة متقادمة (إلا أنها لم تحذف)، سيكون ذلك إصدار برمجيات ميدياويكي الذي تقادمت فيه.
summary
بيان قصير عن غرض الوصلة.
يحبذ إضافة بيان مفصل، ويجب أن يضاف إلى محتوى الصفحة الرئيسية.
لو حدثت البيان المختصر، يرجى أيضا تحديث الجدولين الموجودين على صفحة Manual:Hooks .
args
المعاملات كما تستخدم في الجزء الأعلى من الوظيفة.
extension
Extension name where hook is called; for when the source is not in the Mediawiki core code repository.
source
الموقع (اسم الملف) الذي يستدعي هذه الوصلة في الكود البرمجي. يمكن إضافة مواقع إضافية مستخدما source2...source10.
sourcefunction
اسم الوظيفة التي تستدعي هذه الوصلة. يمكن إضافة غيرها مستخدما sourcefunction2.
sourceclass
اسم التصنيف الذي يستدعي هذه الوصلة.
newvarname
يستخدمه {{Removed}} أو {{Deprecated}} حينما يضبط أي من removed أو deprecated.
newvarlink
يستخدمه {{Removed}} أو {{Deprecated}} حينما يضبط أي من removed أو deprecated.
templatemode
يضبط إلى القيمة nocats لو كان توثيق الوصلة لا يجب أن يظهر في تصنيفات برمجيات ميدياويكي المعتادة.
إن استخدام هذا القالب يضيف تلقائيا صفحة التوثيق إلى التصنيفات التالية:
  • وصلات ميدياويكي
  • وصلات أضيفت إلى ميدياويكي...
توجد حالات لا يستحب فيها تصنيف صفحات توثيق الوصلات آليا. قد تشمل أمثلة ذلك حينما توثق وصلة في امتداد أو حينما توثق القالب ذاته.

See also