تعلم تطوير الإضافات في ووردبريس: ابني أول توسعة وظيفية لديك من الصفر.

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

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

إنشاء ملحقاتك الخاصة، مقارنةً بتعديل المظاهر مباشرةً. functions.php الملفات تتمتع بمزايا كبيرة؛ فالإضافات (plugins) هي وحدات وظيفية مستقلة عن التصميم العام للموقع (الـ theme)، وبالتالي لا تفقد وظائفها عند تغيير التصميم. هذا يجعل الكود أسهل في الصيانة والتحديث، ويسمح بمشاركته بين مشاريع مختلفة. فهم الآليات الأساسية لتطوير الإضافات ضروري لكي تصبح مطورًا متقدمًا في ووردبريس (WordPress).

إنشاء بيئة التطوير الخاصة بك

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

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

إعدادات بيئة الخادم المحلي

ننصح باستخدام حلول الخوادم المحلية المتكاملة، مثل Local by Flywheel أو XAMPP أو MAMP، حيث توفر إمكانية تثبيت Apache/Nginx وPHP وMySQL بنقرة واحدة. تأكد من أن إصدار PHP الذي تستخدمه متوافق مع إصدار WordPress الذي تريده؛ يُنصح عمومًا باستخدام إصدار PHP 7.4 أو أحدث. بالإضافة إلى ذلك، من الضروري تثبيت نسخة جديدة من WordPress على الخادم المحلي لاستخدامها كبيئة اختبار (“sandbox”) لاختبار الإضافات (plugins).

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

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

صفحة الوصول

محررات الكود وأدوات التصحيح

اختر محرر كود قوي ومتطور، مثل Visual Studio Code أو PHPStorm. توفر هذه المحررات تمييزًا للغة البرمجية، اقتراحات أثناء كتابة الكود، وتكاملاً مع أنظمة إدارة الإصدارات (Version Control). بالنسبة لعملية التصحيح (Debugging)، يجب تفعيل وضع التصحيح الخاص بـ WordPress؛ وهذا يتطلب تعديل ملفات في المجلد الرئيسي (الجذري) لموقع WordPress. wp-config.php الملف، سيتم… WP_DEBUG تم تعيين الثابت على قيمة true。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误日志保存到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

بعد تفعيل وضع التصحيح (Debugging Mode)، سيتم تسجيل أي أخطاء PHP، تحذيرات، أو إشعارات، مما يساعدك على تحديد المشكلة بسرعة.

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

يمكن أن يكون إضافة ووردبريس بسيطة للغاية، حيث تتكون فقط من ملف واحد، ولكن من المهم جدًا اتباع هيكل سليم ومنظم. سنبدأ بأبسط إضافة ممكنة، وهي إضافة “Hello World”.

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

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

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

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

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

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

إضافة الميزة الأولى: إدارة القوائم

في الخطوة التالية، دعونا نضيف ميزة بسيطة للإضافة: إضافة عنصر قائمة جديد إلى شريط الإدارة الجانبي في واجهة ووردبريس الخلفية.

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

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

صفحة الوصول

سنستخدم… add_action() دالة لتثبيت دالة تعديل (callback function) admin_menu هذا الإجراء مرتبط بذلك الخيط (الحبل) المعين.

// 在插件主文件中，插件头部注释块之后，添加以下代码

if ( ! defined( 'ABSPATH' ) ) {
    exit; // 禁止直接访问
}

// 钩子到 admin_menu 动作
add_action( 'admin_menu', 'mfp_add_admin_menu' );

/**
 * 注册一个自定义管理菜单
 */
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',          // 菜单标题
        'manage_options',    // 所需权限
        'my-first-plugin',   // 菜单别名 (slug)
        'mfp_display_admin_page', // 显示页面内容的回调函数
        'dashicons-smiley', // 菜单图标 (使用 Dashicon)
        6                    // 菜单位置
    );
}

/**
 * 管理页面的显示内容
 */
function mfp_display_admin_page() {
    ?>
    <div class="wrap">
        <h1></h1>
        <p>مرحبًا بالعالم! هذه هي صفحة إدارة الإضافات الخاصة بي الأولى في ووردبريس.</p>
    </div>
    أنا لا أعرف ماذا أقول.

بعد حفظ الملف وتحديث واجهة خلفية ووردبريس (WordPress)، سترى عنصر قائمة جديدًا يسمى “My Plugins” (أدواتي) في شريط القوائم على الجانب الأيسر. عند النقر عليه، ستدخل إلى صفحة بسيطة تعرض رسالة ترحيب.

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

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

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

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

تُستخدم “خطافات الإجراءات” (Action Hooks) في ووردبريس لتنفيذ كود معين في أوقات محددة، مثل عند حفظ المقالات، أو تحميل رأس الصفحة، أو عرض قاعدة الصفحة. يمكن للإضافات (Plugins) الخاصة بك أن “تستمع” إلى هذه الأحداث وتنفيذ الدوال الخاصة بها في تلك اللحظات. الأمثلة التي است admin_menu إنه مجرد خطاف لتنفيذ إجراء معين (action hook).

مثال شائع آخر هو إضافة فقرة نصية تلقائيًا في نهاية محتوى المقال.

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

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

صفحة الوصول

add_action( 'the_content', 'mfp_append_text_to_content' );

function mfp_append_text_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $append_text = '<p><em>تم إنشاء هذا المقال بواسطة أول إضافة (plugin) لي.</em></p>';
        $content .= $append_text;
    }
    return $content;
}

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

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

add_filter( 'the_title', 'mfp_modify_post_title' );

function mfp_modify_post_title( $title ) {
    // 只在非后台的主查询中修改
    if ( ! is_admin() && in_the_loop() ) {
        $title = '[重要] ' . $title;
    }
    return $title;
}

فهم واستخدام الـ “هوكس” (hooks) بشكل ماهر هو المفتاح لبناء إضافات (plugins) مرنة وقوية. يوفر نظام ووردبريس (WordPress) الأساسي آلاف الـ “هوكس”، والتي تنتشر عبر كامل دورة حياة الإضافة (من تطويرها إلى

أمان الإضافات وأفضل الممارسات

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

التحقق من صحة البيانات وتهيئتها للاستخدام (Data Validation and Escaping)

لا تثق أبدًا بالبيانات التي يدخلها المستخدمون أو التي تأتي من قواعد البيانات. يجب تنفيذ عمليات تهريب (escaping) لأي بيانات قبل عرضها في المتصفح (سواء كان ذلك عبر HTML، JavaScript، أو خصائص العناصر). يوفر WordPress مجموعة من الدوال المساعدة لتنفيذ هذه العمليات بسهولة.

// 输出到 HTML 内容中
echo esc_html( $untrusted_data );
// 输出到 HTML 属性中
echo esc_attr( $untrusted_data );
// 输出到 URL 中
echo esc_url( $untrusted_data );
// 在 JavaScript 变量中输出
$js_data = wp_json_encode( $untrusted_data );

قبل حفظ البيانات في قاعدة البيانات أو إجراء أي عمليات تحليل منطقي، من الضروري إجراء عمليات تحقق (Validation) للتأكد من أن البيانات تتوافق مع الصيغة المطلوبة (مثل ما إذا كانت عناوين بريد إلكتروني أو أرقام، و

استخدام المساحات الاسمية (Namespaces) والفئات (Classes)

بالنسبة للإضافات المعقدة، يُنصح باستخدام مساحات الأسماء (namespaces) في PHP والبرمجة الكائنية (Object-Oriented Programming – OOP) لتنظيم الكود. هذا يساعد على تجنب تعارض أسماء الدوال، ويحسن من تقسيم الكود إلى وحدات منطقية (modules) ويزيد من قابليته ل

<?php
namespace MyFirstPluginAdmin;

class Admin_Menu {
    public function __construct() {
        add_action( 'admin_menu', [ $this, 'add_menu_page' ] );
    }

public function add_menu_page() {
        add_menu_page( ... );
    }
}

// 初始化
new Admin_Menu();

بالإضافة إلى ذلك، من الضروري إضافة دعم للترجمة الدولية (internationalization support) إلى الإضافة (plugin). __() و _e() تعتبر الميزات مثل وجود واجهة سهلة الاستخدام للمستخدمين (مع وظائف واضحة)، وتوفير خيارات تنظيف مناسبة عند إلغاء التثبيت، والالتزام بمعايير ترميز ووردبريس (WordPress Coding Standards)، جزءًا مهمًا من ج

الملخصات

تطوير إضافات ووردبريس (WordPress plugins) هو رحلة تبدأ من الأساسيات وتتدرج تدريجياً نحو المستويات المتقدمة. تبدأ هذه الرحلة بإنشاء ملفات بسيطة يمكن لووردبريس التعرف عليها، ثم تتطور إلى استخدام أدوات قوية مثل الأفعال (actions) وخطافات المرشحات (filter hooks) لتوسيع وظائف الموقع. كل خطوة في هذه العملية تعتمد على فهم هيكل ووردبريس بشكل صحيح. بيئة التطوير المحلية (local development environment) تعتبر مختبرك، وأدوات التصحيح (debugging tools) هي أدواتك لفحص وتحليل كودك، بينما تعتبر معايير الأمان وأفضل الممارسات (security and best practices) الأساس الذي يضمن استقرار وموثوقية

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

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

ما هي الحد الأدنى لعدد الملفات المطلوبة لإضافة (plugin) في ووردبريس (WordPress)؟

يحتاج إضافة (plugin) في ووردبريس إلى ملف PHP واحد على الأقل. طالما أن هذا الملف يحتوي على التعليقات الخاصة برأس الإضافة (plugin header comments) بشكل صحيح، يمكن لووردبريس التعرف عليه وتفعيله في قائمة الإضافات الخاصة به في الخلفية. بالطبع، بالنسبة للإضافات ذات الميزات المتعددة، يتم عادةً تنظيم الكود في عدة ملفات ومجلدات لتسهيل عملية الصيانة.

كيف يمكن تجنب تعارض أسماء الدوال أثناء تطوير الإضافات (البرامج الإضافية)؟

هناك طريقتان رئيسيتان لتجنب تضارب أسماء الدوال. الأولى هي إضافة بادئة فريدة لجميع الدوال الخاصة بك، مثل استخدام اختصارات أو أسماء مختصرة للإضافات (plugins). mfp_ أو myplugin_الثاني هو استخدام الفئات (classes) ومساحات الأسماء (namespaces) في لغة PHP لتغليف دوالك داخل طرق (methods) الفئات. هذه هي الطريقة الأكثر حداثة والموصى بها، وتساعد في حل مشكلات التعارض في الأسماء بشكل جذري.

كيف يمكنني إضافة صفحة لإعدادات الخيارات للإضافة (plugin) الخاصة بي؟

عادةً ما يتضمن إضافة صفحة إعدادات للإضافة (plugin) استخدام… add_options_page() أو add_submenu_page() تُستخدم الدوال لتسجيل الصفحات، ثم يتم استخدام واجهة برمجة التطبيقات (API) الخاصة بـ WordPress لإنشاء الخيارات والتحقق من صحتها وحفظها بشكل آمن. تتضمن واجهة برمجة التطبيقات (Settings API) الميزات اللازمة لإدارة إعدادات الموقع بشكل register_setting()、add_settings_section() و add_settings_field() تُسهل هذه الدوال عملية إنشاء نماذج إعدادات موحدة، وتتعامل تلقائيًا مع الجوانب المتعلقة بالأمان وتخزين البيانات.

بعد الانتهاء من تطوير الإضافة، كيف يمكن نشرها في الدليل الرسمي لـ WordPress؟

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