شرح add_action, do_action في وورد بريس

الدالة add_action تستخدم لإضافة إجراء معين لحدث ما ، و الصيغة العامة لهذه الدالة هي 

add_action( $hook, $function_to_add, $priority, $accepted_args );

حيث:

• hook$ : هو الحدث الذي تريد أن تربط به الدالة الخاصة بك، أي الحدث التي تريد أن تنفذ دالتك عند حدوثه.
• function_to_add$ : اسم الدالة (الإجراء) التي تريد إضافتها للحدث أعلاه. أي التي ستنفذ عند حصول الحدث hook$ .
• priority$ : هذه هي أولوية تنفيذ الدالة عند هذا الحدث، بمعنى أنه إذا كان هنالك أكثر من دالة تم إضافتها باستخدام الدالة add_action إلى نفس الحدث فإن قيمة هذا المعامل ستحدد أي الدوال ستنفذ أولا وأيها ثانيا وهكذا. قيمة هذا المعامل يجب أن تكون من النوع int ، وقيمته الافتراضية 10 والحدث ذو القيمة الأقل سينفذ أولا ، بمعنى أن الدالة التي لديها قيمة 5 ستنفذ قبل الدالة التي لديها 20 وهكذا.
• accepted_args$ : عدد المعاملات التي تقبلها الدالة المطلوب تنفيذها function_to_add$.

ومن الأمثلة على هذا , حيث يمكنك لإرسال بريد إلكتروني إلى بعض الأصدقاء كلما تم نشر إدخال في مدونتك:

function wpdocs_email_friends( $post_id ) {
    $friends = 'bob@example.org, susie@example.org';
    wp_mail( $friends, "Hsoub", 'هنا النص' );
 
    return $post_id;
}
add_action( 'publish_post', 'wpdocs_email_friends' );

 الدالة do_action ، يستخدم ووردبريس الدالة do_action لتحديد المكان الذي سينفذ فيه الإجراء، وبالتالي في هذا المكان الذي تتواجد فيه الدالة يقوم بتنفيذ كل الدوال التي تم إضافتها لهذا الحدث المعين، وتأخذ الصيغة العامة

 do_action( $tag, $arg );

حيث:

• tag$ : اسم الإجراء الذي تود تنفيذه. وكما أسلفنا فإن هذه الدالة عند مناداتها ستنفذ كل الدوال التي تم إضافتها لهذا الحدث tag$.
• arg$ : المعامل الذي يتم تمريره للدوال المرتبطة بالحدث tag$.

الدالة add_filter ، تستخدم دالة add_filter لإضافة مرشح جديد لأحد المتغيرات وتأخذ الصيغة العامة:

add_filter( $tag, $function_to_add, $priority, $accepted_args );

ومن الأمثلة على add_filter هو التحكم بطول النص المقتطف للتدوينة مثل 

if( ! function_exists( 'prefix_custom_excerpt_length' ) )
{
    function prefix_custom_excerpt_length( $length )
    {
        return 40;
    }
}
add_filter( 'excerpt_length', 'prefix_custom_excerpt_length', 999 );

يمكنك مراجعة الدرس التالي على أكاديمية حسوب