قالب:وصلة شبكية لامتداد
Jump to navigation
Jump to search
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 لو كان توثيق الوصلة لا يجب أن يظهر في تصنيفات برمجيات ميدياويكي المعتادة.
- إن استخدام هذا القالب يضيف تلقائيا صفحة التوثيق إلى التصنيفات التالية:
- وصلات ميدياويكي
- وصلات أضيفت إلى ميدياويكي...
- توجد حالات لا يستحب فيها تصنيف صفحات توثيق الوصلات آليا. قد تشمل أمثلة ذلك حينما توثق وصلة في امتداد أو حينما توثق القالب ذاته.