Extension:Hooks: Difference between revisions

Revision as of 18:55, 23 April 2025

Extension:Hooks

Extension:Hooks هي إضافة قوية لموقع ميدياويكي تسمح للمطورين بتنفيذ كود PHP مخصص في نقاط محددة خلال عملية تنفيذ ميدياويكي. هذه النقاط تُعرف باسم "الخطافات" (Hooks)، وتمكن المطورين من تعديل أو إضافة وظائف جديدة دون الحاجة إلى تعديل الكود الأساسي لميدياويكي نفسه. هذه الميزة ضرورية لتخصيص ميدياويكي وتوسيع إمكانياته بطرق معقدة ومرنة.

ما هي الخطافات؟

الخطافات هي نقاط في الكود الأساسي لميدياويكي حيث يمكن للمطورين "ربط" وظائفهم الخاصة. عند حدوث حدث معين في ميدياويكي (مثل حفظ صفحة، أو عرض صفحة، أو تسجيل دخول مستخدم)، يتم استدعاء جميع الوظائف المرتبطة بهذا الحدث. هذا يسمح بتعديل السلوك الافتراضي لميدياويكي أو إضافة سلوك جديد تمامًا.

أنواع الخطافات

هناك أنواع مختلفة من الخطافات، ويمكن تصنيفها بناءً على وقت تنفيذها ومكانها في الكود:

خطافات التنفيذ (Action Hooks): تُنفذ *بعد* اكتمال حدث معين. مثال: خطاف `AfterParse` الذي يُنفذ بعد تحليل محتوى الصفحة.
خطافات الاستعلام (Query Hooks): تُنفذ *أثناء* معالجة استعلام قاعدة البيانات. مثال: خطاف `SMWQueryBefore` الذي يسمح بتعديل استعلام Semantic MediaWiki قبل تنفيذه.
خطافات الواجهة (Hook Interfaces): تسمح بتعديل عناصر الواجهة الرسومية. مثال: خطافات تعديل قائمة القوائم الجانبية.
خطافات أخرى (Other Hooks): تشمل مجموعة متنوعة من الخطافات لأغراض محددة.

كيفية استخدام الخطافات

لاستخدام الخطافات، يجب عليك:

1. تحديد الخطاف الذي تريد استخدامه. يمكنك العثور على قائمة كاملة بالخطافات المتاحة في MediaWiki API documentation. 2. إنشاء وظيفة PHP تقوم بالعمل الذي تريد تنفيذه. 3. ربط الوظيفة بالخطاف باستخدام الدالة `hook_register()`.

مثال بسيط:

```php <?php function myCustomFunction( $parser, $text ) {

 return 'This text was modified by a hook!';

}

hook_register( 'AfterParse', 'myCustomFunction' ); ?> ```

في هذا المثال، الوظيفة `myCustomFunction` ستُنفذ بعد تحليل محتوى الصفحة، وستستبدل النص الأصلي بالنص الجديد.

مزايا استخدام الخطافات

التخصيص (Customization): تسمح بتخصيص ميدياويكي لتلبية احتياجات محددة.
التوسع (Extensibility): تمكن من إضافة وظائف جديدة دون تعديل الكود الأساسي.
الصيانة (Maintainability): تسهل صيانة التعديلات، حيث يمكن تحديث ميدياويكي دون فقدان التخصيصات.
التوافق (Compatibility): تقلل من خطر حدوث تعارضات مع التحديثات المستقبلية لميدياويكي.

حالات استخدام الخطافات

تكامل مع الخدمات الخارجية: ربط ميدياويكي بقواعد بيانات أو خدمات ويب أخرى.
تعديل سلوك المحتوى: تغيير طريقة عرض أو معالجة المحتوى.
إضافة وظائف بحث متقدمة: توسيع قدرات البحث في ميدياويكي.
إنشاء أدوات إدارية مخصصة: تطوير أدوات لمساعدة المسؤولين على إدارة الموقع.
تحسين الأداء: تحسين سرعة وأداء ميدياويكي.

أمثلة متقدمة

إضافة أزرار تحرير مخصصة: باستخدام خطافات الواجهة.
تنفيذ نظام تسجيل دخول مخصص: باستخدام خطافات المصادقة.
إضافة دعم للغات جديدة: باستخدام خطافات الترجمة.
تعديل سلوك محرر النصوص المرئي: باستخدام خطافات تتعلق بالمحرر.

اعتبارات هامة

الأداء (Performance): يجب أن تكون الوظائف المرتبطة بالخطافات فعالة قدر الإمكان لتجنب التأثير على أداء الموقع.
الأمان (Security): يجب التأكد من أن الكود المضاف آمن ولا يحتوي على ثغرات أمنية.
التوثيق (Documentation): يجب توثيق جميع التعديلات بشكل جيد لتسهيل صيانتها في المستقبل.
التوافقية (Compatibility): يجب اختبار التعديلات مع إصدارات مختلفة من ميدياويكي للتأكد من توافقها.

الموارد الإضافية

استراتيجيات تداول ذات صلة

التحليل الفني وحجم التداول

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين

@@ Line 1: / Line 1: @@
-## Extension:Hooks - دليل شامل للمبتدئين
+=== Extension:Hooks ===
-'''Extension:Hooks''' هي إضافة قوية لموقع [[ميدياويكي]] تتيح للمطورين تنفيذ تعليمات برمجية مخصصة (Hooks) في نقاط محددة خلال عملية معالجة ميدياويكي. هذه الإضافة لا تعمل بشكل مباشر على تداول [[العقود الآجلة للعملات المشفرة]] أو [[الخيارات الثنائية]]، لكنها ضرورية لتطوير [[إضافات ميدياويكي]] متخصصة يمكنها التكامل مع بيانات السوق، وعرض الرسوم البيانية، وحتى تنفيذ استراتيجيات تداول آلية (مع التحذير من المخاطر المرتبطة).  هذا المقال يهدف إلى توفير مقدمة شاملة للمبتدئين حول كيفية عمل Hooks، وكيفية استخدامها، وأمثلة على التطبيقات المحتملة.
+'''Extension:Hooks''' هي إضافة قوية لموقع ميدياويكي تسمح للمطورين بتنفيذ كود PHP مخصص في نقاط محددة خلال عملية تنفيذ ميدياويكي. هذه النقاط تُعرف باسم "الخطافات" (Hooks)، وتمكن المطورين من تعديل أو إضافة وظائف جديدة دون الحاجة إلى تعديل الكود الأساسي لميدياويكي نفسه. هذه الميزة ضرورية لتخصيص ميدياويكي وتوسيع إمكانياته بطرق معقدة ومرنة.
-=== ما هي الـ Hooks؟ ===
+== ما هي الخطافات؟ ==
-الـ Hooks هي نقاط محددة في [[شفرة المصدر]] لميدياويكي حيث يمكن للمطورين "ربط" (Hook) تعليماتهم البرمجية الخاصة.  عندما يصل ميدياويكي إلى هذه النقطة في معالجته، فإنه يقوم بتشغيل جميع الـ Hooks المرتبطة بها.  هذا يسمح بتعديل سلوك ميدياويكي دون الحاجة إلى تعديل شفرة المصدر الأساسية، مما يجعل التحديثات أكثر أمانًا وأسهل.  فكر في الأمر كأنها نظام إشعارات يسمح لك بالاستجابة لأحداث معينة داخل ميدياويكي.
+الخطافات هي نقاط في الكود الأساسي لميدياويكي حيث يمكن للمطورين "ربط" وظائفهم الخاصة. عند حدوث حدث معين في ميدياويكي (مثل حفظ صفحة، أو عرض صفحة، أو تسجيل دخول مستخدم)، يتم استدعاء جميع الوظائف المرتبطة بهذا الحدث.  هذا يسمح بتعديل السلوك الافتراضي لميدياويكي أو إضافة سلوك جديد تمامًا.
-=== أنواع الـ Hooks ===
+== أنواع الخطافات ==
-هناك أنواع مختلفة من الـ Hooks، كل منها يتم تفعيله في مرحلة مختلفة من معالجة ميدياويكي. بعض الأنواع الشائعة تشمل:
+هناك أنواع مختلفة من الخطافات، ويمكن تصنيفها بناءً على وقت تنفيذها ومكانها في الكود:
-* '''Hooks الخاصة بالتحليل (Parser Hooks):''' يتم تفعيلها أثناء تحليل [[صفحة ويكي]] وتسمح بتعديل محتوى الصفحة أو إضافة محتوى جديد. مثال: إنشاء [[قوالب]] مخصصة لعرض أسعار العملات المشفرة في الوقت الفعلي.
+* '''خطافات التنفيذ''' (Action Hooks):  تُنفذ *بعد* اكتمال حدث معين. مثال: خطاف `AfterParse` الذي يُنفذ بعد تحليل محتوى الصفحة.
-* '''Hooks الخاصة بالأحداث (Event Hooks):''' يتم تفعيلها استجابة لأحداث معينة، مثل حفظ صفحة، أو تسجيل مستخدم جديد.  مثال: إرسال إشعار عبر [[البريد الإلكتروني]] عند إجراء تعديل كبير على صفحة تحتوي على بيانات تداول.
+* '''خطافات الاستعلام''' (Query Hooks): تُنفذ *أثناء* معالجة استعلام قاعدة البيانات. مثال: خطاف `SMWQueryBefore` الذي يسمح بتعديل استعلام Semantic MediaWiki قبل تنفيذه.
-* '''Hooks الخاصة بواجهة المستخدم (UI Hooks):''' تسمح بتعديل واجهة المستخدم لميدياويكي. مثال: إضافة أزرار مخصصة لتنفيذ أوامر تداول (مع التحذير من المخاطر).
+* '''خطافات الواجهة''' (Hook Interfaces):  تسمح بتعديل عناصر الواجهة الرسومية. مثال: خطافات تعديل قائمة القوائم الجانبية.
-* '''Hooks الخاصة بالبحث (Search Hooks):''' تسمح بتعديل نتائج [[البحث]] في ميدياويكي. مثال: إعطاء الأولوية للصفحات التي تحتوي على معلومات حول استراتيجيات تداول محددة.
+* '''خطافات أخرى''' (Other Hooks):  تشمل مجموعة متنوعة من الخطافات لأغراض محددة.
-=== كيفية استخدام الـ Hooks ===
+== كيفية استخدام الخطافات ==
-لاستخدام الـ Hooks، يجب عليك:
+لاستخدام الخطافات، يجب عليك:
-. '''تثبيت الإضافة:''' تأكد من أن إضافة Hooks مثبتة على موقع ميدياويكي الخاص بك.
+. '''تحديد الخطاف''' الذي تريد استخدامه.  يمكنك العثور على قائمة كاملة بالخطافات المتاحة في [[MediaWiki API documentation]].
-. '''تسجيل الـ Hook:''' باستخدام [[PHP]]، قم بتسجيل الـ Hook الخاص بك باستخدام وظيفة `hook_name`.  يجب أن تحدد اسم الـ Hook، والأولوية (لتحديد ترتيب التنفيذ)، والدالة التي سيتم استدعاؤها.
+. '''إنشاء وظيفة PHP''' تقوم بالعمل الذي تريد تنفيذه.
-. '''كتابة الدالة:''' اكتب الدالة التي ستقوم بتنفيذ التعليمات البرمجية المخصصة الخاصة بك.  ستتلقى هذه الدالة معلمات مختلفة اعتمادًا على نوع الـ Hook.
+. '''ربط الوظيفة بالخطاف''' باستخدام الدالة `hook_register()`.
-. '''الاختبار:''' اختبر الـ Hook الخاص بك للتأكد من أنه يعمل كما هو متوقع.
-=== مثال بسيط ===
+مثال بسيط:
-لنفترض أننا نريد إضافة رسالة بسيطة في أسفل كل صفحة. يمكننا استخدام Parser Hook للقيام بذلك:
 ```php
 <?php
-/**
+function myCustomFunction( $parser, $text ) {
- * ملف الإضافة: MyCustomHook.php
+  return 'This text was modified by a hook!';
- */
-class MyCustomHook {
-    public static function addBottomMessage( $parser, $text ) {
-        return $text . "\n\n<p>هذه رسالة مخصصة من خلال Hook!</p>";
-    }
 }
-$wgHooks['ParserAfterParse'][] = 'MyCustomHook::addBottomMessage';
+hook_register( 'AfterParse', 'myCustomFunction' );
+?>
 ```
-في هذا المثال:
+في هذا المثال، الوظيفة `myCustomFunction` ستُنفذ بعد تحليل محتوى الصفحة، وستستبدل النص الأصلي بالنص الجديد.
-* `ParserAfterParse` هو اسم الـ Hook.
+== مزايا استخدام الخطافات ==
-* `MyCustomHook::addBottomMessage` هي الدالة التي سيتم استدعاؤها.
-* الدالة تضيف رسالة HTML إلى نهاية محتوى الصفحة.
-=== تطبيقات محتملة في تداول العملات المشفرة والخيارات الثنائية ===
+* '''التخصيص''' (Customization):  تسمح بتخصيص ميدياويكي لتلبية احتياجات محددة.
+* '''التوسع''' (Extensibility): تمكن من إضافة وظائف جديدة دون تعديل الكود الأساسي.
+* '''الصيانة''' (Maintainability):  تسهل صيانة التعديلات، حيث يمكن تحديث ميدياويكي دون فقدان التخصيصات.
+* '''التوافق''' (Compatibility):  تقلل من خطر حدوث تعارضات مع التحديثات المستقبلية لميدياويكي.
-على الرغم من أن الـ Hooks لا تتعامل مباشرة مع التداول، إلا أنها يمكن أن تكون أساسًا لتطوير إضافات متقدمة:
+== حالات استخدام الخطافات ==
-* '''عرض بيانات السوق:'''  يمكن لـ Parser Hook جلب بيانات أسعار العملات المشفرة من [[واجهات برمجة التطبيقات]] (APIs) وعرضها في جداول أو رسوم بيانية داخل صفحات ويكي.
+* '''تكامل مع الخدمات الخارجية''':  ربط ميدياويكي بقواعد بيانات أو خدمات ويب أخرى.
-* '''إشعارات التداول:'''  يمكن لـ Event Hook إرسال إشعارات عبر البريد الإلكتروني أو [[برامج المراسلة]] عند تحقيق أهداف ربح أو خسارة محددة.
+* '''تعديل سلوك المحتوى''':  تغيير طريقة عرض أو معالجة المحتوى.
-* '''أدوات التحليل الفني:'''  يمكن لـ Parser Hook حساب مؤشرات فنية (مثل [[المتوسطات المتحركة]]، [[مؤشر القوة النسبية]]، [[MACD]]) وعرضها في صفحات ويكي.
+* '''إضافة وظائف بحث متقدمة''':  توسيع قدرات البحث في ميدياويكي.
-* '''تنفيذ أوامر تداول آلية (بحذر شديد):'''  يمكن لـ Event Hook، بالاشتراك مع واجهة برمجة تطبيقات لتبادل العملات المشفرة، تنفيذ أوامر تداول آلية بناءً على شروط محددة. **تحذير:** هذا يتطلب خبرة برمجية متقدمة وفهمًا عميقًا لمخاطر التداول الآلي.
+* '''إنشاء أدوات إدارية مخصصة''':  تطوير أدوات لمساعدة المسؤولين على إدارة الموقع.
+* '''تحسين الأداء''':  تحسين سرعة وأداء ميدياويكي.
-=== اعتبارات الأمان والأداء ===
+== أمثلة متقدمة ==
-* '''الأمان:'''  تأكد من أن التعليمات البرمجية الخاصة بك آمنة ولا تعرض موقع ميدياويكي الخاص بك للخطر.  تحقق من صحة جميع المدخلات وتجنب استخدام وظائف PHP غير آمنة.
+* '''إضافة أزرار تحرير مخصصة''':  باستخدام خطافات الواجهة.
-* '''الأداء:'''  يمكن أن تؤثر الـ Hooks على أداء موقع ميدياويكي الخاص بك.  تأكد من أن التعليمات البرمجية الخاصة بك فعالة ولا تستهلك الكثير من الموارد.  استخدم [[التخزين المؤقت]] (Caching) لتقليل عدد مرات تنفيذ الـ Hooks.
+* '''تنفيذ نظام تسجيل دخول مخصص''':  باستخدام خطافات المصادقة.
-* '''التوافق:'''  اختبر الـ Hooks الخاصة بك مع إصدارات مختلفة من ميدياويكي للتأكد من أنها متوافقة.
+* '''إضافة دعم للغات جديدة''':  باستخدام خطافات الترجمة.
+* '''تعديل سلوك محرر النصوص المرئي''': باستخدام خطافات تتعلق بالمحرر.
-=== موارد إضافية ===
+== اعتبارات هامة ==
-* [[مساعدة:Hooks]]
+* '''الأداء''' (Performance):  يجب أن تكون الوظائف المرتبطة بالخطافات فعالة قدر الإمكان لتجنب التأثير على أداء الموقع.
-* [[Extension:Hooks/Documentation]]
+* '''الأمان''' (Security):  يجب التأكد من أن الكود المضاف آمن ولا يحتوي على ثغرات أمنية.
-* [[PHP Manual]]
+* '''التوثيق''' (Documentation):  يجب توثيق جميع التعديلات بشكل جيد لتسهيل صيانتها في المستقبل.
-* [[ميدياويكي API]]
+* '''التوافقية''' (Compatibility): يجب اختبار التعديلات مع إصدارات مختلفة من ميدياويكي للتأكد من توافقها.
-* [[قوالب ميدياويكي]]
-=== استراتيجيات ذات صلة، التحليل الفني وتحليل حجم التداول ===
+== الموارد الإضافية ==
+* [[Manual:Hooks]]
+* [[Developing with MediaWiki]]
+* [[Extension:Semantic MediaWiki]]
+* [[MediaWiki API documentation]]
+== استراتيجيات تداول ذات صلة ==
 * [[استراتيجية الاختراق]]
+* [[استراتيجية المتوسطات المتحركة]]
+* [[استراتيجية الماكد]]
+* [[استراتيجية المضاربة]]
+* [[استراتيجية التداول اليومي]]
 * [[استراتيجية التداول المتأرجح]]
-* [[استراتيجية التداول اليومي]]
+* [[استراتيجية تداول النطاق]]
-* [[تحليل الشموع اليابانية]]
+* [[استراتيجية تتبع الاتجاه]]
-* [[نظرية الموجات الإيلوت]]
+* [[استراتيجية كسر النطاق]]
+* [[استراتيجية الارتداد]]
+* [[استراتيجية الاختراق الكاذب]]
+* [[استراتيجية التداول بناءً على الأخبار]]
+* [[استراتيجية تداول التحكيم]]
+* [[استراتيجية التداول الخوارزمي]]
+* [[استراتيجية مارتينجال]]
+== التحليل الفني وحجم التداول ==
+* [[الشموع اليابانية]]
+* [[مؤشر القوة النسبية (RSI)]]
 * [[مؤشر ستوكاستيك]]
-* [[خطوط فيبوناتشي]]
+* [[مؤشر بولينجر باند]]
-* [[مؤشر متوسط الحركة المتقاربة المتباعدة (MACD)]]
+* [[مؤشر MACD]]
-* [[حجم التداول (Volume)]]
+* [[مؤشر ADX]]
-* [[تقلبات السوق]]
+* [[حجم التداول]]
+* [[تحليل الموجات إليوت]]
+* [[تحليل فيبوناتشي]]
+* [[خطوط الاتجاه]]
+* [[مستويات الدعم والمقاومة]]
+* [[أنماط الشموع العكسية]]
+* [[تحليل الاختراق]]
 * [[تحليل التجميع والتوزيع]]
-* [[مؤشر القوة النسبية (RSI)]]
+* [[تحليل التقارب والتباعد]]
-* [[تحليل فجوة السعر]]
-* [[التحليل الأساسي]]
-* [[إدارة المخاطر في التداول]]
-[[Category:الفئة:إضافات_ميدياويكي]]
+[[Category:الفئة:إضافات ميدياويكي]]
 == ابدأ التداول الآن ==