الدليل الكامل لتطوير إضافات ووردبريس: من المبتدئ إلى الاحتراف في بناء وظائف مخصصة

لماذا يتم اختيار تطوير إضافات (Plugins) لمنصة ووردبريس (WordPress)؟

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

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

إنشاء أول إضافة (plugin) خاصة بك

الخطوة الأولى لبدء تطوير الإضافات هي فهم البنية الأساسية لأية إضافة. جميع إضافات ووردبريس تُخزَّن في/wp-content/plugins/داخل الدليل، يمتلك كل مكون إضافي مجلده المستقل الخاص به.

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

إنشاء ملف رئيسي للإضافة (plugin main file)

جوهر الإضافة هو ملف PHP رئيسي واحد. تحتاج إلى إنشاء مجلد جديد، على سبيل المثالmy-first-pluginوأنشئ بداخله ملف PHP يحمل الاسم نفسه للمجلد:my-first-plugin.phpتعليق رأس هذا الملف بالغ الأهمية، فهو يزوّد ووردبريس بالبيانات الوصفية للإضافة.

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

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

صفحة الوصول

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

بعد حفظ هذا الملف، ستتمكن من رؤيته وتفعيله في صفحة “الإضافات” داخل لوحة تحكم ووردبريس. ورغم أنه لا يحتوي الآن على أي وظيفة، فقد نجحت بالفعل في إنشاء هيكل إضافي قانوني.

إضافة الميزات الأساسية للإضافة (Plugin)

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

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

// 在网站页脚输出自定义信息
function my_first_plugin_footer_text() {
    echo '<p style="text-align: center;">شكرًا لاستخدامك الميزات المقدمة بواسطة أول إضافة (plugin) من تطويري!</p>';
}
add_action( 'wp_footer', 'my_first_plugin_footer_text' );

هنا، نعرّف دالةmy_first_plugin_footer_text()ثم استخدمه.add_action()تقوم الدالة بتثبيته (أو تركيبه) هناك.wp_footerعلى الخطاف. عندما يصل WordPress إلى جزء تذييل الصفحة، فإنه سيستدعي دالتنا تلقائيًا ويُخرج محتوى HTML المحدد مسبقًا. وهذا يوضح الاستخدام الأساسي لآلية “الخطافات والاستدعاءات الراجعة” في WordPress.

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

في الصميم: الخطافات والفلاتر.

تقوم الفلسفة الأساسية لتطوير إضافات ووردبريس على “الخطافات” (Hooks). وتنقسم الخطافات إلى نوعين: خطافات الإجراءات (Action Hooks) وخطافات المرشحات (Filter Hooks). وفهمها هو المفتاح لانتقالك من مرحلة المبتدئ إلى مرحلة الإتقان.

فهم خطافات الإجراءات

تسمح لك خطافات الإجراءات بإدراج تعليماتك البرمجية الخاصة في نقاط زمنية محددة أثناء تنفيذ ووردبريس. كما في المثال أعلاهwp_footer، يتم تشغيله عند إنشاء HTML التذييل. وخطاف إجراء شائع آخر هوinitيتم تنفيذه بعد أن يُكمل WordPress التحميل الأساسي وقبل معالجة الطلب، ويُستخدم غالبًا لتهيئة إعدادات الإضافات، وتسجيل أنواع المقالات المخصصة، وغير ذلك.

// 在初始化时执行一些操作
function my_plugin_init_action() {
    // 例如，在这里可以注册一个自定义文章类型
    // if ( ! post_type_exists( 'book' ) ) { ... }
}
add_action( 'init', '_plugin_init_action' );

إتقان خطافات التصفية

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

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

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

صفحة الوصول

// 在文章内容末尾自动添加一段提示文字
function my_plugin_content_filter( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">تم إنشاء محتوى هذا المقال باستخدام أداة إضافية (plugin) خاصة بي.</div>';
        $content .= $extra_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_plugin_content_filter' );

في هذا المثال، الدالةmy_plugin_content_filter()تلقي النسخة الأصلية$contentتحقق مما إذا كانت الصفحة صفحة مقالة مفردة، ثم أضف بعدها مقطعًا من HTML، وأخيرًا أعد المحتوى بعد التعديل. سيستخدم WordPress هذه القيمة المعادة لاستبدال المحتوى الأصلي عند الإخراج.

إنشاء مكونات إضافية قابلة للتكوين

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

إنشاء قوائم وصفحات الإدارة

الاستفادة منadd_menu_page()أوadd_options_page()يمكن للدالة إضافة عنصر قائمة وصفحة إعدادات لإضافتك في الواجهة الخلفية. هذا عادةً فيadmin_menuيتم ذلك في خطاف الإجراء.

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

// 添加插件管理菜单
function my_plugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 所需权限
        'my-plugin-settings',   // 菜单slug
        'my_plugin_settings_page' // 显示页面的回调函数
    );
}
add_action( 'admin_menu', 'my_plugin_add_admin_menu' );

// 设置页面的HTML内容
function my_plugin_settings_page() {
    ?>
    <div class="wrap">
        <h1>إعدادات الإضافة الخاصة بي</h1>
        <form method="post" action="/ar/options.php/" data-trp-original-action="options.php">
            
        <input type="hidden" name="trp-form-language" value="ar"/></form>
    </div>
    أنا لا أعرف ماذا أقول.

إعدادات التسجيل والحقول والمعالجة الأمنية

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

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个新的设置项到“my_plugin_settings_group”
    register_setting( 'my_plugin_settings_group', 'my_plugin_options' );

// 在设置页面添加一个区域
    add_settings_section(
        'my_plugin_section_id',
        '基础配置',
        null,
        'my-plugin-settings'
    );

// 向该区域添加一个字段
    add_settings_field(
        'my_plugin_text_field',
        '提示文本',
        'my_plugin_text_field_render',
        'my-plugin-settings',
        'my_plugin_section_id'
    );
}
add_action( 'admin_init', 'my_plugin_settings_init' );

// 渲染文本框字段
function my_plugin_text_field_render() {
    $options = get_option( 'my_plugin_options' );
    ?>
    <input type='text' name='my_plugin_options[text_field]' value='<?php echo esc_attr( $options['text_field'] ?? '' ); ?>'>
    <p class="description">النص المدخل هنا سيتم عرضه في واجهة الموقع الإلكتروني.</p>
    أنا لا أعرف ماذا أقول.

بهذه الطريقة، ستخضع البيانات التي يُدخلها المستخدم في الواجهة الأمامية لمعالجات الأمان المدمجة في ووردبريس مثل nonce وescape والتحقق، ثم تُحفَظ على شكل مصفوفة إلىwp_optionsفي الجدول. يمكن لشفرة المكوّن الإضافي الخاص بك أن تتم من خلالget_option( ‘my_plugin_options’ )احصل على هذه القيم بأمان.

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

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

صفحة الوصول

اتبع أفضل الممارسات واستعد للإصدار

يتطلب تطوير مكوّن إضافي عالي الجودة وقابل للصيانة وآمن اتباع سلسلة من أفضل الممارسات.

تنظيم الكود والأمان

لا تثق أبداً بإدخال المستخدم. بالنسبة لكل ما يأتي من$_GET、$_POSTيجب إخضاع البيانات التي تم الحصول عليها، أو البيانات التي تمت قراءتها من قاعدة البيانات والمعدة للإخراج، للإفلات أو التحقق باستخدام الدوال التي يوفرها WordPress، مثلesc_html()、esc_attr()、sanitize_text_field()、wp_kses()إلخ. استخدمها.wp_enqueue_script()وwp_enqueue_style()لتحميل البرامج النصية والأنماط بشكل صحيح، ومعالجة التبعيات والتحكم في الإصدارات. بالنسبة للإضافات المعقدة، فكّر في استخدام البرمجة كائنية التوجه (OOP) لتنظيم الشيفرة، وتغليف الوظائف داخل فئات، لتحسين وحدوية الشيفرة وإمكانية إعادة استخدامها.

التدويل والتوطين

لكي يتمكن المستخدمون في جميع أنحاء العالم من استخدام المكون الإضافي الخاص بك، فإن التدويل (i18n) أمر لا غنى عنه. وهذا يعني أنك بحاجة إلى استخدام__()أو_e()استخدم دوال مثل هذه وغيرها لتغليف جميع السلاسل النصية الموجّهة للمستخدم. المُعرَّفة في تعليقات رأس الإضافة.Text Domain(على سبيل المثال،my-first-plugin）يجب أن يتطابق مع حقل النص المستخدم هنا.

// 错误示例
echo “Settings Saved”;

// 正确示例
echo esc_html__( 'Settings Saved', 'my-first-plugin' );

ثم يمكنك استخدام أدوات مثل Poedit لاستخراج هذه السلاسل وإنشائها.potملف قالب يمكن للمترجمين استخدامه لإنشاء لغات مختلفة مثلzh_CN.poملفات الترجمة الخاصة بـ). ضع هذه.moضع الملفات المترجمة في مجلد الإضافة/languages/ضمن المجلد، سيقوم WordPress بتحميل الترجمة المقابلة تلقائيًا وفقًا للغة الموقع.

التحضير للنشر في الدليل الرسمي

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

الملخصات

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

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

ما المعارف المسبقة المطلوبة لتطوير الإضافات

تحتاج إلى امتلاك معرفة أساسية ببرمجة PHP، وفهم HTML وCSS، وأن تكون لديك معرفة معينة بالعمليات والمفاهيم الأساسية في WordPress (مثل المقالات، والصفحات، والودجات). كما أن الإلمام بالمفاهيم الأساسية لقاعدة بيانات MySQL مفيد أيضًا، لكنه ليس ضروريًا، لأن WordPress يوفر دوال مريحة للتعامل مع قاعدة البيانات (مثلWP_Query、wpdbفئة).

ما الفرق بين ملفات functions.php في الإضافات (plugins) والقوالب (themes)؟

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

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

يوفر WordPress مجموعة متنوعة من أدوات تصحيح الأخطاء. أولاً، يمكنك أن تقوم بـwp-config.phpتم تفعيل الملف.WP_DEBUGالوضع، سيتمdefine( 'WP_DEBUG', true );سيؤدي هذا إلى عرض جميع أخطاء PHP والتحذيرات والإشعارات على الشاشة. والطريقة الأكثر أمانًا هي أيضًا تعيينWP_DEBUG_LOGلأجلtrueتسجيل الأخطاء إلى/wp-content/debug.logفي الملف. بالإضافة إلى ذلك، استخدامerror_log()يمكن استخدام الدوال أو تثبيت إضافات تصحيح احترافية مثل Query Monitor لتتبع المتغيرات واستعلامات قاعدة البيانات بكفاءة أكبر.

كيف أجعل الإضافة متوافقة مع إصدارات PHP الأحدث

لضمان أن تعمل الإضافة بشكل طبيعي أيضًا في الإصدارات المستقبلية من PHP، ينبغي عليك تجنب استخدام الدوال وبنى الصياغة التي تم إهمالها أو إزالتها. في بيئة التطوير المحلية، استخدم بيئة اختبار تتطابق مع الإصدار المستهدف المستقبلي، مثل PHP 8.x. تابع باستمرار إعلانات التحديث الرسمية لكل من WordPress وPHP، واذكر في سجل تحديثات الإضافة نطاق إصدارات PHP المتوافقة، حتى يتم تذكير المستخدمين باتخاذ اختيار مناسب للبيئة.