Manual:Hooks

```wiki

Manual:Hooks

الخطافات هي آلية قوية في MediaWiki تسمح للمطورين بتعديل أو إضافة وظائف إلى نقاط معينة في عملية تنفيذ البرنامج. تعتبر الخطافات أساسية لتخصيص Wiki الخاص بك دون تعديل الكود الأساسي، مما يضمن سهولة الترقية والاستقرار. هذا الدليل موجه للمبتدئين ويهدف إلى تقديم فهم شامل لكيفية عمل الخطافات وكيفية استخدامها.

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

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

الخطافات هي في الأساس نقاط في الكود حيث يمكن للمطورين إدخال كودهم الخاص. هذا الكود يمكن أن يكون أي شيء من تعديل المحتوى المعروض إلى تسجيل الأحداث أو حتى تغيير سير العمل الأساسي لـ Wiki.

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

توجد أنواع مختلفة من الخطافات في MediaWiki، ويمكن تصنيفها بناءً على وقت تنفيذها والغرض منها. بعض الأنواع الشائعة تشمل:

• خطافات المحتوى (Content Hooks): تُستخدم هذه الخطافات لتعديل المحتوى المعروض للزوار. مثال على ذلك هو خطاف `OutputPageParser`, الذي يسمح لك بتعديل HTML الذي يتم إرساله إلى المتصفح.
• خطافات الأحداث (Event Hooks): تُستخدم هذه الخطافات للاستجابة لأحداث معينة، مثل حفظ صفحة، تسجيل دخول مستخدم، أو تغيير عنوان URL. مثال على ذلك هو خطاف `BeforeSave`, الذي يتم استدعاؤه قبل حفظ الصفحة.
• خطافات الواجهة (Interface Hooks): تستخدم هذه الخطافات لتعديل الواجهة الرسومية لـ Wiki، مثل إضافة عناصر جديدة إلى القائمة الرئيسية أو تغيير تصميم الصفحات. مثال على ذلك هو خطاف `PersonalUrls`.
• خطافات الامتدادات (Extension Hooks): توفرها الامتدادات (Extensions) المختلفة وتسمح بتخصيص سلوك الامتداد.

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

لاستخدام خطاف، تحتاج إلى:

1. تحديد الخطاف المناسب: ابحث عن الخطاف الذي يتوافق مع الحدث أو السلوك الذي تريد تعديله. Special:ListHooks هي صفحة خاصة تعرض قائمة بجميع الخطافات المتاحة في Wiki الخاص بك. 2. إنشاء وظيفة مخصصة: اكتب وظيفة PHP التي تحتوي على الكود الذي تريد تنفيذه عند استدعاء الخطاف. 3. تسجيل الوظيفة: أخبر MediaWiki عن وظيفتك المخصصة وأخبره بالخطاف الذي يجب استدعاؤه عند حدوث الحدث. يتم ذلك عادةً في ملف `LocalSettings.php`.

مثال عملي: تعديل تذييل الصفحة

لنفترض أنك تريد إضافة نص مخصص إلى تذييل كل صفحة في Wiki الخاص بك. يمكنك استخدام خطاف `OutputPageParser` لتحقيق ذلك.

1. تحديد الخطاف: `OutputPageParser` هو الخطاف المناسب لتعديل HTML الذي يتم إرساله إلى المتصفح. 2. إنشاء وظيفة مخصصة: أضف الكود التالي إلى ملف `LocalSettings.php` (أو إلى ملف امتداد مخصص):

```php function myCustomFooter( $parser, $text ) {

return $text . "

هذا النص المخصص يظهر في تذييل الصفحة.

";

}

$wgHooks['OutputPageParser'][] = 'myCustomFooter'; ```

3. شرح الكود:

   *   `myCustomFooter` هي وظيفة PHP التي تأخذ كائن `Parser` والنص الحالي كمدخلات.
   *   تقوم الوظيفة بإلحاق النص المخصص بالنص الحالي.
   *   `$wgHooks['OutputPageParser'][] = 'myCustomFooter';` يقوم بتسجيل الوظيفة `myCustomFooter` لاستدعائها عند استدعاء خطاف `OutputPageParser`.

بعد حفظ التغييرات في `LocalSettings.php`، يجب أن يظهر النص المخصص في تذييل كل صفحة في Wiki الخاص بك.

الخطافات الشائعة وأمثلة عليها

| الخطاف | الوصف | مثال على الاستخدام | |---|---|---| | `BeforeSave` | يتم استدعاؤه قبل حفظ الصفحة. | إضافة قالب تلقائيًا إلى كل صفحة جديدة. | | `AfterSave` | يتم استدعاؤه بعد حفظ الصفحة. | تحديث ذاكرة التخزين المؤقت بعد حفظ الصفحة. | | `ArticleViewBeforeBody` | يتم استدعاؤه قبل عرض محتوى الصفحة الرئيسية. | إضافة إعلانات أو رسائل مخصصة. | | `PersonalUrls` | يتم استدعاؤه لتعديل قائمة الروابط الشخصية (مثل "My preferences"). | إضافة رابط مخصص إلى ملف تعريف المستخدم. | | `LoadExtensionSchemaUpdates` | يتم استدعاؤه لتحميل تحديثات مخطط الامتدادات. | إضافة جداول جديدة لقاعدة البيانات. | | `GetCategoryTree` | يسمح بتعديل شجرة الفئات. | تخصيص عرض شجرة الفئات. | | `SkinAfterContent` | يسمح بإضافة محتوى بعد محتوى الصفحة الرئيسي. | إضافة توقيعات أو معلومات حقوق النشر. | | `ParserBeforeTidy` | يسمح بتعديل المحتوى قبل عملية الترتيب. | معالجة علامات HTML مخصصة. | | `ParserAfterTidy` | يسمح بتعديل المحتوى بعد عملية الترتيب. | إضافة تنسيق إضافي. | | `OutputPageParser` | يسمح بتعديل HTML الناتج. | إضافة نص مخصص أو تعديل الأنماط. |

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

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

أدوات مفيدة

• Special:ListHooks: قائمة بجميع الخطافات المتاحة.
• Manual:Configuration settings/Variable:wgHooks: شرح لمتغير `$wgHooks` المستخدم لتسجيل الخطافات.
• MediaWiki API: واجهة برمجة التطبيقات (API) لـ MediaWiki، والتي يمكن استخدامها للاستجابة للأحداث وتعديل المحتوى.
• Extension:Hooks: (إذا كان موجوداً) امتداد يوفر أدوات إضافية للعمل مع الخطافات.

استراتيجيات الخيارات الثنائية والتحليل الفني (للمطورين المهتمين بالربط مع أنظمة خارجية)

يمكن استخدام الخطافات لربط Wiki ببيانات من منصات الخيارات الثنائية أو لتشغيل استراتيجيات تداول آلية. على سبيل المثال:

• تكامل مع منصات التداول: يمكن استخدام خطاف `AfterSave` لتحديث Wiki بمعلومات حول الصفقات المفتوحة أو المغلقة في منصة تداول.
• عرض بيانات السوق: يمكن استخدام خطاف `OutputPageParser` لعرض بيانات السوق الحية (مثل أسعار الأسهم أو مؤشرات الفوركس) في Wiki.
• تنفيذ استراتيجيات آلية: (يتطلب خبرة متقدمة في البرمجة) يمكن استخدام الخطافات لتشغيل استراتيجيات تداول آلية بناءً على بيانات السوق أو الأحداث التي تحدث في Wiki.

• • استراتيجيات الخيارات الثنائية ذات الصلة:**

• 60-Second Strategy: استراتيجية تداول تعتمد على توقعات قصيرة الأجل.
• Hedging Strategy: استراتيجية لتقليل المخاطر من خلال اتخاذ مراكز متعاكسة.
• Martingale Strategy: استراتيجية تداول خطيرة تعتمد على مضاعفة الرهانات بعد كل خسارة.
• Pin Bar Strategy: استراتيجية تعتمد على أنماط الشموع اليابانية.
• News Trading: استراتيجية تداول تعتمد على الأخبار الاقتصادية.

• • التحليل الفني والمؤشرات:**

• Moving Averages: المتوسطات المتحركة.
• Bollinger Bands: نطاقات بولينجر.
• Relative Strength Index (RSI): مؤشر القوة النسبية.
• MACD: مؤشر المذبذب التقاربي والمتباعد.
• Fibonacci Retracements: ارتدادات فيبوناتشي.
• Ichimoku Cloud: سحابة إيشيموكو.
• Volume Analysis: تحليل حجم التداول.
• Candlestick Patterns: أنماط الشموع اليابانية.
• Support and Resistance Levels: مستويات الدعم والمقاومة.
• Trend Lines: خطوط الاتجاه.

• • تحليل حجم التداول:**

• On Balance Volume (OBV): حجم التداول المتوازن.
• Accumulation/Distribution Line: خط التراكم/التوزيع.
• Chaikin Money Flow: تدفق أموال تشايكين.

• • اتجاهات السوق:**

• Uptrend: اتجاه صاعد.
• Downtrend: اتجاه هابط.
• Sideways Trend: اتجاه جانبي.

الخلاصة

الخطافات هي أداة قوية لتخصيص MediaWiki وتوسيع وظائفه. من خلال فهم كيفية عمل الخطافات وكيفية استخدامها، يمكنك إنشاء Wiki يلبي احتياجاتك الخاصة. تذكر أن تكون حذرًا عند استخدام الخطافات وأن تضع في اعتبارك الأداء والأمان والتوافق. استخدم Special:ListHooks كمرجع دائم للخطافات المتاحة. ``` ```

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

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

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

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