Help:Extension:Parser Hooks

```wiki

Help:Extension:Parser Hooks

Parser Hooks هي امتدادات قوية في نظام MediaWiki تسمح للمطورين بتوسيع وظائف محرر النصوص المرئي (Visual Editor) والتحكم في كيفية عرض المحتوى. تتيح هذه الامتدادات إمكانية إضافة علامات (tags) مخصصة إلى النص، ثم معالجتها بواسطة PHP لتحويلها إلى HTML أو محتوى آخر. هذا المقال يهدف إلى تقديم شرح تفصيلي للمبتدئين حول Parser Hooks، وكيفية استخدامها لإنشاء وظائف مخصصة في ويكي الخاص بك.

ما هي Parser Hooks؟

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

لماذا نستخدم Parser Hooks؟

هناك العديد من الأسباب لاستخدام Parser Hooks:

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

المفاهيم الأساسية

• العلامة (Tag): النص الذي يحدد Parser Hook، على سبيل المثال `<myTag>some content</myTag>`.
• وظيفة Parser Hook: وظيفة PHP التي يتم استدعاؤها عند العثور على العلامة.
• المدخلات (Parameters): البيانات التي يتم تمريرها إلى وظيفة Parser Hook.
• الناتج (Output): المحتوى الذي يتم إرجاعه بواسطة وظيفة Parser Hook ليتم عرضه في الصفحة.
• Parser::fetchParserHookContext()‎: دالة أساسية تستخدم للوصول إلى سياق التحليل، بما في ذلك النص المحيط بالعلامة.

كيفية إنشاء Parser Hook

1. إنشاء ملف امتداد: قم بإنشاء ملف PHP في مجلد `extensions/` في تثبيت MediaWiki الخاص بك. اسم الملف يجب أن يكون وصفيًا، على سبيل المثال `MyCustomParserHooks.php`.

2. تسجيل Parser Hook: استخدم الدالة `wfRegisterExtension()` لتسجيل الامتداد الخاص بك.

3. تعريف وظيفة Parser Hook: قم بتعريف وظيفة PHP التي ستعالج العلامة الخاصة بك. يجب أن تكون الوظيفة مسجلة باستخدام `Parser::registerHook()‎`.

4. تنفيذ الوظيفة: اكتب الكود الذي يعالج المدخلات ويعيد الناتج المطلوب.

مثال بسيط

لنبدأ بمثال بسيط يقوم بعرض التاريخ الحالي:

```php <?php

class MyCustomParserHooks {

   public static function onParserHook() {
       global $parser;
       $parser->addFunction( 'currentdate', array( 'MyCustomParserHooks', 'currentDateFunction' ) );
       return true;
   }

   public static function currentDateFunction( $parser, $text ) {
       return date( 'Y-m-d' );
   }

}

wfRegisterExtension( 'MyCustomParserHooks' ); ```

في هذا المثال:

• `onParserHook()` هي دالة معالجة الأحداث التي يتم استدعاؤها عند تهيئة المحلل اللغوي.
• `$parser->addFunction()` تسجل وظيفة `currentDateFunction` باسم العلامة `currentdate`.
• `currentDateFunction()` هي وظيفة Parser Hook التي تعرض التاريخ الحالي بتنسيق `YYYY-MM-DD`.

لاستخدام هذه العلامة في صفحة ويكي، اكتب: `{{#currentdate}}`.

مثال أكثر تعقيداً: جدول أسعار الخيارات الثنائية

هذا المثال يوضح كيف يمكن استخدام Parser Hooks لإنشاء جدول يعرض أسعار الخيارات الثنائية. لنفترض أن لدينا دالة خارجية (`getOptionPrices()`) تقوم بإرجاع مصفوفة من أسعار الخيارات الثنائية.

```php <?php

class BinaryOptionParserHooks {

   public static function onParserHook() {
       global $parser;
       $parser->addFunction( 'binaryoptions', array( 'BinaryOptionParserHooks', 'binaryOptionsFunction' ) );
       return true;
   }

   public static function binaryOptionsFunction( $parser, $text ) {
       $options = getOptionPrices(); // دالة افتراضية للحصول على الأسعار
       if (empty($options)) {
           return "لا توجد أسعار متاحة.";
       }

       $output = "|---|---|---|\n";
       $output .= "| الأصل | سعر الشراء | سعر البيع |\n";
       $output .= "|---|---|---|\n";

       foreach ($options as $option) {
           $output .= "| " . $option['asset'] . " | " . $option['buy'] . " | " . $option['sell'] . " |\n";
       }

       return $output;
   }

}

// دالة وهمية للحصول على أسعار الخيارات الثنائية function getOptionPrices() {

   return array(
       array('asset' => 'EUR/USD', 'buy' => 1.1000, 'sell' => 1.0990),
       array('asset' => 'GBP/USD', 'buy' => 1.2500, 'sell' => 1.2490),
       array('asset' => 'USD/JPY', 'buy' => 110.00, 'sell' => 109.90),
   );

}

wfRegisterExtension( 'BinaryOptionParserHooks' ); ```

لاستخدام هذه العلامة في صفحة ويكي، اكتب: `{{#binaryoptions}}`. سيقوم هذا بإنشاء جدول يعرض أسعار الخيارات الثنائية.

التعامل مع المدخلات

يمكن لوظائف Parser Hook استقبال مدخلات. يتم تمرير المدخلات إلى الوظيفة كجزء من الوسيط `$text`. يمكنك استخدام التعبيرات العادية (Regular Expressions) أو دوال PHP الأخرى لتحليل هذه المدخلات.

مثال:

```php public static function myHookFunction( $parser, $text ) {

   // تقسيم النص بناءً على الفاصلة
   $parts = explode( ',', $text );
   $name = trim( $parts[0] );
   $age = (int) trim( $parts[1] );

   return "الاسم: " . $name . ", العمر: " . $age;

} ```

لاستخدام هذه العلامة، اكتب: `{{#myHookFunction|John Doe,30}}`.

أفضل الممارسات

• التحقق من الصحة: تحقق من صحة المدخلات للتأكد من أنها بالتنسيق الصحيح.
• التعامل مع الأخطاء: تعامل مع الأخطاء بشكل صحيح وأظهر رسائل خطأ مفيدة للمستخدمين.
• الأداء: حاول تحسين أداء Parser Hooks الخاصة بك لتجنب التأثير على سرعة ويكي الخاص بك.
• الأمان: كن حذرًا بشأن الأمان، خاصةً إذا كنت تتعامل مع مدخلات المستخدم. تجنب استخدام `eval()` أو وظائف PHP الأخرى التي يمكن أن تكون خطيرة.
• الوثائق: قم بتوثيق Parser Hooks الخاصة بك بشكل جيد حتى يتمكن المستخدمون الآخرون من فهمها واستخدامها.

موارد إضافية

• Manual:Parser hooks
• Extension:ParserFunctions
• Manual:Configuration settings
• Help:Categories

استراتيجيات الخيارات الثنائية ذات الصلة (للإشارة فقط)

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

التحليل الفني المستخدم في الخيارات الثنائية

• مستويات الدعم والمقاومة: تحديد المستويات التي يميل السعر إلى الارتداد منها.
• خطوط الاتجاه: تحديد اتجاه حركة السعر.
• أنماط الشموع اليابانية: تحليل أنماط الشموع اليابانية للتنبؤ بحركة السعر.
• المؤشرات الفنية: استخدام المؤشرات الفنية مثل المتوسطات المتحركة و RSI و MACD.
• التحليل الموجي: تحديد الأنماط المتكررة في حركة السعر.

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

• حجم التداول كدليل على الاتجاه: زيادة حجم التداول تؤكد الاتجاه.
• التباعد بين السعر وحجم التداول: يشير إلى انعكاس محتمل للاتجاه.
• مستويات السيولة: تحديد مستويات السيولة في السوق.

مؤشرات الخيارات الثنائية

• مؤشر القوة النسبية (RSI): يقيس قوة الاتجاه.
• مؤشر الماكد (MACD): يحدد التغيرات في قوة الاتجاه.
• مؤشر ستوكاستيك: يقيس الزخم.
• نطاقات بولينجر: تقيس التقلبات.
• مؤشر فيبوناتشي: يحدد مستويات الدعم والمقاومة المحتملة.

الاتجاهات في الخيارات الثنائية

• الاتجاه الصاعد: سلسلة من القمم والقيعان الأعلى.
• الاتجاه الهابط: سلسلة من القمم والقيعان الأدنى.
• الاتجاه الجانبي: حركة السعر في نطاق ضيق.

أسماء استراتيجيات الخيارات الثنائية (أمثلة)

• استراتيجية الاختراق: تعتمد على اختراق مستويات الدعم والمقاومة.
• استراتيجية التداول مع الاتجاه: تداول في اتجاه الاتجاه السائد.
• استراتيجية التداول العكسي: تداول ضد الاتجاه السائد.
• استراتيجية التداول على الأخبار: تداول بناءً على إصدارات الأخبار الاقتصادية.

تحذير

تداول الخيارات الثنائية ينطوي على مخاطر عالية. يرجى التأكد من فهمك الكامل للمخاطر قبل التداول. هذا المقال هو للأغراض التعليمية فقط ولا ينبغي اعتباره نصيحة مالية. ```

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

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

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

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