تطوير ووردبريس للمبتدئين: برمجة إضافة – المعلقات، الأفعال والمرشحات

تُعد منصة ووردبريس واحدة من أشهر أنظمة إدارة المحتوى في العالم، وتستخدم لإنشاء المواقع الإلكترونية والمدونات بسهولة ومرونة. من أهم مزايا ووردبريس إمكانية تطوير إضافات (Plugins) تضيف وظائف جديدة للموقع، أو تعدل سلوكه بدون الحاجة لتغيير الكود الأساسي للنظام. ولتطوير إضافة ناجحة وفعالة، يجب فهم آلية عمل ووردبريس الداخلية خاصة فيما يتعلق بالمعلقات (Hooks) التي تشمل نوعين رئيسيين: الأفعال (Actions) والمرشحات (Filters).

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

1. مقدمة في برمجة إضافات ووردبريس

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

تُكتب الإضافات غالبًا بلغة PHP، وتستفيد من هيكلية ووردبريس البرمجية ومكتباتها. لفهم كيفية تطوير إضافة، من الضروري التعرف على نظام المعلقات الذي يُمكّن الإضافات من التفاعل مع النظام الأساسي.

2. المعلقات (Hooks) في ووردبريس

2.1 تعريف المعلقات

المعلقات هي نقاط اتصال داخل كود ووردبريس تسمح للمطورين “بالتعليق” أو إدخال وظائفهم الخاصة في مراحل معينة من تنفيذ النظام. تسمح هذه المعلقات بزيادة أو تعديل وظائف النظام بدون تعديل الكود الأصلي، ما يحافظ على استقرارية النظام وسهولة التحديث.

المعلقات تنقسم إلى نوعين رئيسيين:

• الأفعال (Actions): تسمح بتنفيذ وظائف إضافية في نقاط معينة من البرنامج.

• المرشحات (Filters): تسمح بتعديل البيانات قبل عرضها أو استخدامها.

2.2 أهمية المعلقات

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

3. الأفعال (Actions)

3.1 مفهوم الأفعال

الأفعال في ووردبريس هي وظائف تُنفذ عندما تحدث أحداث معينة في النظام. على سبيل المثال، عند تحميل الصفحة، حفظ منشور، أو تسجيل مستخدم جديد، يطلق ووردبريس أفعالًا يمكن للمطور الاشتراك بها.

3.2 كيفية استخدام الأفعال

لتفعيل كود معين عند حدوث فعل محدد، يتم استخدام دالة add_action() التي تربط بين اسم الفعل والوظيفة التي نريد تنفيذها.

الصيغة العامة:

php
CopyEdit
add_action( 'hook_name', 'function_name', $priority, $accepted_args );

• hook_name: اسم الفعل الذي تريد الاشتراك فيه.

• function_name: اسم الدالة التي تريد تنفيذها.

• $priority: ترتيب التنفيذ (افتراضي 10).

• $accepted_args: عدد المعطيات التي تستقبلها الدالة.

3.3 مثال عملي على استخدام الأفعال

مثلاً، إذا أردنا تنفيذ دالة تطبع رسالة في رأس الصفحة، نستخدم فعل wp_head:

php
CopyEdit
function custom_message_in_head() {
    echo '';
}
add_action( 'wp_head', 'custom_message_in_head' );

عند تحميل الصفحة، سيتم تنفيذ دالة custom_message_in_head في موقع رأس الصفحة.

4. المرشحات (Filters)

4.1 مفهوم المرشحات

المرشحات تسمح لنا بالتعامل مع بيانات معينة قبل عرضها أو حفظها. عبر المرشحات يمكننا تعديل نصوص، عناوين، محتوى، إعدادات، أو أي نوع من البيانات يتم تمريرها عبر ووردبريس.

4.2 كيفية استخدام المرشحات

تتم إضافة دالة تعالج بيانات معينة عبر add_filter()، التي تشبه في تركيبها add_action() لكنها تستخدم لتعديل البيانات.

الصيغة العامة:

php
CopyEdit
add_filter( 'hook_name', 'function_name', $priority, $accepted_args );

داخل الدالة المرتبطة، يتم استلام البيانات، تعديلها، ثم إرجاعها مرة أخرى.

4.3 مثال عملي على المرشحات

إذا أردنا تعديل عنوان كل مقال ليُضاف إليه نص معين، يمكننا استخدام مرشح the_title:

php
CopyEdit
function modify_post_title( $title ) {
    return $title . ' - من مدونتي';
}
add_filter( 'the_title', 'modify_post_title' );

هنا كل عنوان سيُضاف إليه النص “- من مدونتي”.

5. الفرق بين الأفعال والمرشحات

6. برمجة إضافة بسيطة باستخدام الأفعال والمرشحات

لنفترض أننا نريد إنشاء إضافة ووردبريس بسيطة تُعدل عنوان المقال وتُضيف رسالة في نهاية المحتوى.

6.1 إنشاء ملف الإضافة الأساسي

نبدأ بإنشاء ملف PHP داخل مجلد wp-content/plugins/ باسم my-custom-plugin.php يحتوي على رأس الإضافة:

php
CopyEdit

/*
Plugin Name: الإضافة المخصصة
Plugin URI: https://example.com
Description: إضافة لتعديل عنوان المقال وإضافة رسالة في نهاية المحتوى
Version: 1.0
Author: اسمك
Author URI: https://example.com
License: GPL2
*/

6.2 تعديل عنوان المقال باستخدام مرشح

نضيف الدالة التالية لتعديل العنوان:

php
CopyEdit
function my_custom_modify_title( $title ) {
    return $title . ' - إضافة مخصصة';
}
add_filter( 'the_title', 'my_custom_modify_title' );

6.3 إضافة رسالة في نهاية محتوى المقال باستخدام فعل

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

php
CopyEdit
function my_custom_add_message_to_content( $content ) {
    if ( is_single() ) {
        $content .= '
شكرًا لقراءة هذا المقال!
';
    }
    return $content;
}
add_filter( 'the_content', 'my_custom_add_message_to_content' );

6.4 تفعيل الإضافة

بمجرد رفع هذا الملف وتفعيله من لوحة تحكم ووردبريس، ستعمل التعديلات تلقائيًا.

7. تنظيم الكود والنصائح المهمة عند برمجة الإضافات

• تنظيف الكود: من الضروري كتابة أكواد نظيفة ومرتبة مع تعليق مناسب يشرح الوظائف.

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

• الأمان: التحقق من المدخلات وتهذيب المخرجات لتفادي الثغرات الأمنية.

• التحكم بالأولوية: استخدام أولوية التنفيذ لتنسيق عمل الأكواد عند اشتراك أكثر من دالة بنفس الفعل أو المرشح.

• اختبار الإضافة: فحص الإضافة في بيئة تطوير قبل استخدامها في المواقع الحية.

8. استخدام المعطيات في الأفعال والمرشحات

في بعض الحالات، تقوم المعلقات بتمرير معطيات متعددة إلى الدالة المرتبطة، مثل بيانات المنشور، معرف المستخدم، أو غيرها. يجب تحديد عدد المعطيات المقبولة في add_action أو add_filter لتلقيها بشكل صحيح.

مثال على استخدام المعطيات المتعددة:

php
CopyEdit
function custom_function( $arg1, $arg2 ) {
    // معالجة المعطيات
}
add_action( 'some_hook', 'custom_function', 10, 2 );

9. قائمة بأشهر الأفعال والمرشحات في ووردبريس

10. خلاصة وأهمية التعمق في المعلقات

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

المصادر والمراجع

• WordPress Developer Resources – Actions and Filters

• WordPress Plugin Handbook

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