إتقان تطوير الإضافات في ووردبريس: دليل عملي كامل من الصفر إلى واحد.

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

أساسيات تطوير إضافات ووردبريس وإعداد البيئة المناسبة للتطوير

قبل كتابة أول سطر من الكود، نحتاج إلى فهم المفاهيم الأساسية لإضافات ووردبريس (WordPress plugins) وتهيئة بيئة التطوير الخاصة بنا. إضافة ووردبريس، في جوهرها، عبارة عن ملف أو ملفات بلغة PHP تتبع معايير الكود الخاصة بووردبريس، وتستخدم واجهات برمجة التطبيقات (APIs) المتاحة فيه لتوسيع الوظائف الأساسية للنظام.

المفاهيم الأساسية قبل عملية التطوير

يجب أن يحتوي أي إضافة (plugin) على ملف رئيسي، ويجب أن يحتوي هذا الملف في بدايته على معلومات تعليقية محددة تُستخدم لإعلام منصة ووردبريس (WordPress) بوجود الإضافة. عادةً ما يكون اسم هذا الملف الرئيسي فريدًا، على سبيل المثال my-first-plugin.phpيمكن للإضافات (البرامج الإضافية) أن تعمل بشكل مستقل، ولا ينبغي أن تعتمد على مواضيع (تصاميم) معينة، مما يضمن قابليتها للنقل (التكيف) على مواقع ووردبريس المختلفة.

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

بناء بيئة تنمية محلية

بيئة التطوير المحلي الفعالة أمر ضروري للغاية. ننصح باستخدام حلول الخوادم المحلية المتكاملة مثل Local by Flywheel أو XAMPP أو MAMP. هذه الأدوات تسمح بتثبيت ووردبريس بنقرة واحدة، وتقوم بتكوين PHP وMySQL وخادم الويب بشكل تلقائي. بالإضافة إلى ذلك، ستحتاج إلى محرر كود مثل Visual Studio Code أو PhpStorm، ويجب تثبيت الإضافات المتعلقة بووردبريس للحصول على تلميحات الكود وإمكانيات التصحيح.

خادم ووردبريس من شركة UltaHost

ضمان استرداد المال خلال 30 يومًا، عرض نطاق ترددي وقواعد بيانات غير محدودين، حماية مجانية ضد هجمات DDoS، خصم 50% عند الشراء لمدة 3 سنوات (السعة المتاحة: 501–4 تيرابايت).

صفحة الوصول

قم بإنشاء أول إضافة (plugin) لموقع ووردبريس (WordPress) الخاص بك.

دعونا نبدأ بإضافة بسيطة تسمى “Hello World”، فهي ستساعدك على فهم الهيكل الأساسي للإضافات وعملية تفعيلها.

هيكل الملف الرئيسي للإضافة (Plugin Main File)

يجب أن يبدأ كل إضافة (plugin) من ملف PHP رئيسي واحد. وذلك ضمن مجلد تثبيت WordPress الخاص بك. /wp-content/plugins/ داخل المجلد، قم بإنشاء مجلد جديد، على سبيل المثال… my-greeting-pluginداخل هذا المجلد، قم بإنشاء الملف الرئيسي. my-greeting-plugin.php。

يجب أن يتضمن بداية هذا الملف تعليقات رأس الإضافة (plugin header comments) القياسية، وهي ضرورية لكي يتعرف ووردبريس (WordPress) على الإضافة ويعرضها في واجهة الإدارة الخلفية.

<?php
/**
 * Plugin Name:       我的问候插件
 * Plugin URI:        https://example.com/my-greeting-plugin
 * Description:       这是一个简单的插件，用于在网站底部显示问候语。
 * Version:           1.0.0
 * Author:            Your Name
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-greeting-plugin
 */

تنفيذ وظيفة بسيطة

الآن، دعونا نضيف ميزة بسيطة لهذا الإضافة: عرض نص معين في قسم القائمة السفلية (الفوتر) لصفحة الواجهة الأمامية للموقع. سنستخدم إمكانيات ووردبريس (WordPress) لتحقيق ذلك. wp_footer Action Hook.

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

أضف الكود التالي أسفل تعليقات بداية الملف الرئيسي للإضافة:

// 在 wp_footer 钩子上挂载我们的函数
add_action( 'wp_footer', 'my_greeting_display' );

/**
 * 输出问候语的函数
 */
function my_greeting_display() {
    echo '<p style="text-align: center; color: #666;">مرحبًا بكم في موقعي الإلكتروني! تم توفير هذه الميزة بواسطة “إضافة التحيات الخاصة بي” (My Greetings Plugin).</p>';
}

بعد حفظ الملف، ادخل إلى صفحة “الإضافات” (Plugins) في واجهة خلفية ووردبريس (WordPress Dashboard)، ويجب أن ترى إضافة “My Greeting Plugin” موجودة في قائمة الإضافات. انقر على “تفعيل” (Activate)، ثم قم بزيارة الصفحة الأمامية لموقعك واسحب الشاشة للأسفل لرؤية الرسالة التحية التي أضفتها. هذه العملية تشمل إنشاء الإضافة وتفعيلها بالإضافة إلى تنفيذ وظيفتها الأساسية.

التعمق في الجوهر: الخطافات (Hooks) والمرشحات (Filters)

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

استضافة.كوم استضافة مشتركة

أداء عالٍ مع وحدات المعالجة المركزية AMD EPYC، ووحدات تخزين NVMe SSD وLiteSpeed، ودعم داخلي متخصص على مدار الساعة طوال أيام الأسبوع، وتدابير أمنية متقدمة بما في ذلك SSL، وقوة الغاشمة، والحماية من البرامج الضارة والحماية من DDoS، وتوفير ما يصل إلى 731 تيرابايت 4 تيرابايت

صفحة الوصول

فهم واستخدام خطافات الإجراءات (Action Hooks)

تُستخدم “خطافات الإجراءات” (Action Hooks) في ووردبريس لتنفيذ كود معين في لحظات محددة من عملية تشغيل الموقع، مثل أثناء التهيئة الأولية، أو عند حفظ المقالات، أو عند عرض قسم القائمة السفلية (Footer). يمكنك “تثبيت” دوالك الخاصة في هذه اللحظات لتنفيذ المهام المطلوبة. كما رأينا في الم add_action( 'wp_footer', ... ) يتم استخدام "خطافات الإجراءات" (Action Hooks) لهذا الغرض.

آخر خيار شائع لـ “أهداف الإجراءات” (Action Hooks) هو… admin_menuيُستخدم هذا الأمر لإضافة صفحات القوائم في واجهة الإدارة الخلفية. على سبيل المثال، لإضافة صفحة إعدادات بسيطة:

add_action( 'admin_menu', 'my_plugin_add_menu' );

function my_plugin_add_menu() {
    add_menu_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 权限要求
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}

function my_plugin_settings_page() {
    echo '<div class="wrap"><h1>إعدادات الإضافة الخاصة بي</h1><p>هذه هي صفحة الإعدادات.</p></div>';
}

فهم واستخدام خيوط (hooks) المرشحات (filter hooks)

تُستخدم “خطافات المرشحات” (filter hooks) لتعديل البيانات. تتم استدعاؤها قبل أن يتم استخدام البيانات (مثل تخزينها في قاعدة البيانات أو عرضها في المتصفح)، ويمكن لدالتك أن تستقبل البيانات، تعدلها، ثم ترجع البيانات المعدلة. على the_content يقوم الفلتر بإضافة فقرة نصية تلقائيًا في نهاية كل مقال.

القراءة الموصى بها دليل شامل لتطوير إضافات ووردبريس: من المبادئ الأساسية إلى التطبيقات العملية المتقدمة。

add_filter( 'the_content', 'my_content_filter' );

function my_content_filter( $content ) {
    // 只在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $append_text = '<hr><p><em>شكرًا لقراءتكم! نرحب بمتابعتنا للحصول على المزيد من التحديثات.</em></p>';
        $content .= $append_text;
    }
    return $content; // 必须返回修改后的内容
}

بناء إضافات قابلة للتكوين: صفحات الخيارات والإعدادات

عادةً ما يحتاج الإضافات (plugins) الناضجة إلى السماح للمستخدمين بإجراء التكوينات الخاصة بها. يوفر ووردبريس (WordPress) واجهة برمجة التطبيقات (API) المسماة “Settings API” لإنشاء صفحات الإعدادات وحفظ الخيارات بطريقة آمنة وسهلة.

إنشاء صفحة إعدادات ومجموعات خيارات

أولاً، نستخدم… admin_init قم بتسجيل الإعدادات والحقول والفصول عن طريق تنفيذ الإجراءات المناسبة.

الاستضافة المشتركة InterServer

استضافة مشتركة $2.50 دولار أمريكي في الشهر، الشهر الأول $0.1 دولار أمريكي الرمز الترويجي tryinterserver، 461 نص برمجي للتطبيقات السحابية، تثبيت بنقرة واحدة.

صفحة الوصول

add_action( 'admin_init', 'my_plugin_settings_init' );

function my_plugin_settings_init() {
    // 注册一个新的设置项到 “reading” 页面（或自定义页面）
    register_setting( 'reading', 'my_plugin_greeting_text' );

// 在现有设置页面添加一个区域
    add_settings_section(
        'my_plugin_section',                       // ID
        '我的插件设置',                            // 标题
        'my_plugin_section_callback',              // 回调函数（显示描述）
        'reading'                                  // 显示在哪个页面（reading, general等）
    );

// 向区域添加字段
    add_settings_field(
        'my_plugin_field',                         // ID
        '问候语文本',                              // 字段标题
        'my_plugin_field_callback',               // 渲染字段HTML的回调函数
        'reading',                                 // 页面
        'my_plugin_section'                        // 区域
    );
}

function my_plugin_section_callback() {
    echo '<p>قم بتكوين محتوى رسالة التحية الخاصة بالإضافة (البرنامج الإضافي) هنا.</p>';
}

function my_plugin_field_callback() {
    // 从数据库中获取已保存的选项值
    $value = get_option( 'my_plugin_greeting_text', '默认问候语' );
    printf(
        '<input type="text" name="my_plugin_greeting_text" value="%s" style="width: 300px;" />'php
esc_attr($value);

خيارات الحفظ والاستخدام بأمان

بعد التسجيل عبر واجهة برمجة التطبيقات (API) للإعدادات (Settings API)، سيقوم ووردبريس (WordPress) تلقائيًا بمعالجة التحقق من البيانات (validation)، وتنظيفها (cleaning)، وحفظها (saving) عند إرسال النماذج (form submission). يمكن تعديل الدوال الوظيفية (functionality) السابقة لدينا لاستخدام هذا الخيار القابل لل

function my_greeting_display() {
    $greeting = get_option( 'my_plugin_greeting_text', '欢迎来到我的网站！' );
    printf( '<p style="text-align: center; color: #666;">%s</p>', esc_html( $greeting ) );

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

الملخصات

من فهم الهيكل الأساسي للإضافات، إلى إنشاء أول إضافة بسيطة تعرض رسالة “Hello World”， مرورًا بإتقان آليات ووردبريس الأساسية مثل “الخطافات” (الأفعال والمرشحات)، وصولًا إلى بناء إضافة متقدمة تحتوي على واجهة تكوين للمستخدمين، هذا هو المسار الكامل لتعلم تطوير إضافات ووردبريس. المفتاح هو العمل العملي: ابدأ بميزات بسيطة، ثم أدخل تدريجيًا مفاهيم أكثر تعقيدًا مثل واجهة برمجة التطبيقات للإعدادات (Settings API)، وجداول قواعد البيانات المخصصة، والكود المختصر (Shortcodes)، وتكامل واجهات برمجة التطبيقات REST. اتبع دائمًا معايير ترميز ووردبريس وأفضل الممارسات الأمنية، مثل تهريب البيانات المخرجة، والتحقق من المدخلات، واستخدام أكواد “Nonces” لمنع التصييد الاحتيالي عبر المواقع (Cross-Site Request Forgery). من خلال التكرار والاختبار المستمر، ستتمكن من تطوير إضافات ووردبريس قوية وآمنة ومحبوبة من قبل المستخدمين.

الأسئلة الشائعة الأسئلة المتداولة

هل يجب أن أكون خبيرًا في PHP لتطوير مكونات WordPress الإضافية؟

نعم، PHP هي اللغة الأساسية المستخدمة في تطوير ووردبريس (WordPress) وإضافاته (plugins). من الضروري أن تكون على دراية جيدة بقواعد اللغة الأساسية لـ PHP، ومفاهيم البرمجة الكائنية، بالإضافة إلى معرفة الطرق الأساسية للتفاعل مع قاعدة البيانات MySQL. بالإضافة إلى ذلك، فإن امتلاك معرفة أساسية بـ HTML وCSS وJavaScript أمر بالغ الأهمية لإنشاء إضافات تحتوي على واجهات مستخدم تفاعلية.

كيف يمكنني تصحيح الأخطاء (الديباجات) في الإضافة (البرنامج الإضافي) التي قمت بتطويرها لـ WordPress؟

يوفر ووردبريس العديد من أدوات التصحيح والتحقيق في الأخطاء (debugging tools). أولاً، wp-config.php تم تفعيل وضع التصحيح في الملف. WP_DEBUG تم تعيين الثابت على قيمة trueسيتم عرض أخطاء PHP وتحذيراتها على الصفحة. في الوقت نفسه، يمكن استخدام… error_log() تقوم الدالة بتسجيل المعلومات في سجل الأخطاء الخاص بالخادم، أو باستخدام أدوات أكثر تقدمًا مثل إضافة Query Monitor، والتي يمكنها مراقبة استعلامات قواعد البيانات والبرامج النصية وغيرها، وهي مساعد قيم للمطورين.

كيف يمكن للإضافة (البرنامج الإضافي) التي طورتها أن تتوافق مع إصدارات مختلفة من ووردبريس (WordPress)؟

لضمان أقصى قدر من التوافق، يجب عليك تحديد أدنى إصدار من ووردبريس (WordPress) الذي يدعمه الإضافة (plugin) في بداية ملفات الإضافة (plugin files). Requires at least عند الترميز، تجنب استخدام الدوال القديمة أو المهجورة، ويمكنك الرجوع إلى وثائق الإصدارات الرسمية لـ WordPress للحصول على معلومات مفصلة. بالنسبة للدوال التي تم إضافتها في إصدارات جديدة، قم باستخدامها بعد التأكد من أنها متوافقة م function_exists() قم بإجراء الفحص وتوفير خطة احتياطية ملائمة، حتى يتمكن البرنامج المكمل (الإضافة) من العمل بشكل أساسي حتى على الإصدارات القديمة.

كيف يمكنني تقديم إضافتي إلى الدليل الرسمي للإضافات في ووردبريس (WordPress Plugin Directory)؟

تسمح عملية التقديم إلى الدليل الرسمي لـ WordPress بتمكين المستخدمين حول العالم من البحث عن إضافتك وتثبيتها مباشرةً. يجب عليك زيارة موقع WordPress.org وإنشاء حساب هناك، ثم تقديم ملف الإضافة المضغوط للمراجعة. ستتضمن عملية المراجعة فحص جودة الكود والأمان وتوافق الترخيص (يجب أن يكون متوافقًا مع GPL) بالإضافة إلى مدى توافق الإضافة مع إرشادات الدليل. يجب أن يحتوي الملف الرئيسي لإضافتك على معلومات الرأس القياسية، ومن الأفضل توفير الملفات الكاملة الخاصة بالإضافة readme.txt يجب أن يتوافق تنسيق الملف مع متطلبات ووردبريس.