الفرق بين تصفية والعمل هوكس؟

إذا نظرت إلى مصدر وظيفة add_action() الأساسية ، فهي مجرد غلاف لوظيفة add_filter() ...

وإذا نظرت إلى وظيفة do_action() ، فهي تشبه إلى حد كبير وظيفة apply_filters() ، بفارق رئيسي واحد: لا تُرجع قيمة.

فماذا يعني هذا؟ الإجراءات تشبه المرشحات ، باستثناء أن الإجراء لا يُرجع قيمة ، لذلك لا يمكنك تعديل البيانات. يُظهر أنه كان من السهل إنشاء آلية عمل WordPress من خلال نسخ آلية التصفية ببساطة ، وليس إرجاع قيمة. في الأساس ، كل ما يمكنك القيام به مع إجراء ما هو ببساطة تنفيذ وظيفة دون تعديل بعض القيمة.

في كلمة بسيطة.

الإجراءات هي تلك PHP الدوال التي تنفذ الإخراج.

المرشحات هي تلك PHP الدوال التي ترجع المخرجات.

محدث: يمكننا تمديد أي مكون إضافي يستخدم الإجراءات والمرشحات دون تعديل رمز هناك. عن طريق إضافة المرشحات والإجراءات في موضوعنا أو البرنامج المساعد.

كيف تستعمل؟

عمل:

راجع أدناه أمثلة بسيطة في ملف functions.php الخاص بالموضوع.

1. مثال واحد: (بسيط PHP مثال)

 اختبار الوظيفة () {
 يردد "الإخراج" ؛ 
} 
 
 اختبار () ؛ 

فوق البرنامج طباعة الإخراج:

انتاج

[ملاحظة: هنا test () ما عليك سوى استدعاء الوظيفة. وتنفيذ وظيفة رد الاتصال "اختبار".]

2. المثال الثاني: (الاستخدام البسيط للعمل)

 function test1 () {
 صدى "Output" ؛ 
} 
 add_action ('test' ، 'test1') ؛ 
 
 do_action ('test') ؛ 

فوق البرنامج طباعة الإخراج:

انتاج

[ملاحظة: هنا do_action('test') تعمل مثل وظيفة الاستدعاء. وتنفيذ وظيفة رد الاتصال 'test1'.]

3. المثال الثالث: (استخدام آخر للإجراءات)

 function test2 () {
 صدى "Test 2" ؛ 
} 
 add_action ('test' ، 'test2' ، 1) ؛ 
 
 function test1 () {
 صدى "Test 1" ؛ 
} 
 add_action ('test' ، 'test1' ، 2) ؛ 
 
 do_action ('اختبار') ؛ 

فوق البرنامج طباعة الإخراج:

 اختبار 2 اختبار 1 

[ملاحظة: هنا do_action('test') تعمل مثل وظيفة الاستدعاء. وتنفيذ وظائف رد الاتصال على أولوياتها.

وظيفة رد الاتصال 'test1' لها الأولوية 2 و 'test2' لها الأولوية 1.]

إذا تغيرت الأولويات مثل "test1" بالأولوية 1 و "test2" بالأولوية 2 ، فسيكون الناتج:

 اختبار 1 اختبار 2 

4. المثال الرابع: (دعم الطرف الثالث) أضف الكود أدناه في functions.php

 function test1 () {
 do_action ('test_before') ؛ 
 صدى "Test 1" ؛ 
 do_action ('test_after') ؛ 
 } 
 add_action ('test' ، 'test1') ؛ 
 
 do_action ('test') ؛ 

فوق البرنامج طباعة الإخراج:

 الاختبار 1 

الآن ، قم بإنشاء نموذج إضافي للتحقق من كيفية عمل مطور الطرف الثالث.

1. قم بإنشاء مجلد "بسيط" في دليل /wp-content/plugins/.
2. قم بإنشاء ملف باسم "simple.php" وأضف الكود أدناه.

/* 
 * اسم المكون الإضافي: البرنامج المساعد البسيط 
 */
 وظيفة test_callback_function () {
 صدى "من البرنامج المساعد" ؛ 
} 
 add_action ('test' ، 'test_callback_function') ؛ 

الآن ، قم بتنشيط البرنامج المساعد البسيط من لوحة تحكم مسؤول WordPress.

Goto plug-plugin وقم بتنشيطه.

بعد تفعيل البرنامج المساعد أعلاه البرنامج طباعة الإخراج:

 اختبار 1 من البرنامج المساعد [. _.]

[ملاحظة: إذا أضفنا الأولوية لعملنا الإضافي من 1 إلى 9 ، فسيطبع الناتج مثل:

 من pluginTest 1 

نظرًا لأن WordPress يفكر في 10 priority by default لجميع الإجراءات المضافة.]

مرشحات

تحقق من الأمثلة أدناه:

مثال بسيط PHP:

 $ data = array ('one' ، 'two') ؛ 
 print_r ($ data) ؛ 

فوق البرنامج طباعة الإخراج:

 صفيف ([0] => واحد [1] => اثنين) 

1. مثال واحد: (الاستخدام البسيط للمرشح)

 $ data = apply_filters ('my_filter_name' ، المصفوفة ('one' ، 'two')) ؛ 
 print_r ($ data) ؛ 
 
 add_filter (' my_filter_name '، function ($ old_data) {
 إرجاع صفيف (' ثلاثة '،' أربعة ') ؛ 
}) ؛ 

فوق البرنامج طباعة الإخراج:

 صفيف ([0] => ثلاثة [1] => أربعة) 

هنا ، لقد أضفنا عامل التصفية my_filter_name وقمنا بتغيير الإخراج الحالي array( 'one', 'two' ) مع array( 'three', 'four' ) دون تغيير ملفات السمات/البرنامج المساعد.