شكل البداية/المتعلقة بالمعرفة/ووردبريس/تفاصيل المحتوى

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

2 دقيقة للقراءة
2026-03-17
2026-06-03
2,548
أنا أحصل على عمولة عند التسوق عبر الروابط أدناه، ولا يُضاف أي تكلفة عليك.

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

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

إعداد بيئة التطوير المحلية

يُنصح باستخدام بيئة الخادم المحلي، مثل Local by Flywheel أو XAMPP أو Laragon. فهي تسمح بإنشاء بيئة تشغيل لـ WordPress تحتوي على Apache/Nginx وMySQL وPHP بسرعة على الكمبيوتر الخاص بك. الميزة في ذلك أنك تستطيع اختبار وتصحيح الأخطاء في بيئة مستقلة وآمنة، دون القلق من التأثير على الموقع الإلكتروني الحقيقي.

الأدوات الأساسية الضرورية لتطوير الإضافات (Plugins):

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

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

فهم البنية الأساسية للإضافات.

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

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

تركيب الملف الرئيسي للإضافة.

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

/**
 * Plugin Name:       我的强大插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示插件开发指南的强大定制插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

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

تنظيم الكود والتعامل معه على شكل وحدات مستقلة (المودولات)

من أجل تحقيق قابلية صيانة الكود، يجب اتباع مبادئ التعديدية (التقسيم إلى وحدات منفصلة). بالإضافة إلى الملف الرئيسي، قد يتضمن دليل الإضافات (plugins directory) المحتويات التالية:
* includes/ الدليل: يُستخدم لتخزين ملفات الكلاسات أو الدوال الأساسية.
* admin/ المحتويات: مخصص لتخزين الكود المتعلق بواجهة الإدارة الخلفية.
* public/ المحتويات: يحتوي على الكود المسؤول عن معالجة المنطق الأمامي (الواجهة البرمجية) للموقع الإلكتروني.
* assets/ المجلد: يُستخدم لوضع الموارد الثابتة مثل JavaScript وCSS والصور.
* languages/ المجلد: يحتوي على ملفات الترجمة الدولية (بصيغة .po و .mo).
تجعل هذه البنية الكود منظمًا وسهل الصيانة على المدى الطويل ويسهل أيضًا توسيع وظائفه.

التطوير الأساسي: الخطافات (Hooks) وواجهات برمجة التطبيقات (APIs)

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

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

استخدام خطافات الإجراءات.

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

function myplugin_send_notification_on_publish( $post_id ) {
    // 获取文章信息
    $post = get_post( $post_id );
    // 模拟发送邮件通知
    wp_mail( '[email protected]', '新文章已发布！', '文章标题：' . $post->post_title );
}
// 将函数挂载到 `publish_post` 这个动作钩子
add_action( 'publish_post', 'myplugin_send_notification_on_publish' );

استخدام مُعلقات الفلتر.

تُستخدم “خطافات المرشحات” (Filter Hooks) لتعديل البيانات. قبل استخدام البيانات (مثل تخزينها في قاعدة البيانات أو عرضها للمستخدمين)، يمكنك تغيير قيمها باستخدام هذه الخطافات. ويتم ذلك عن طريق… add_filter() تم تنفيذ الدالة بواسطة… (The function was implemented by…)

function myplugin_modify_excerpt_length( $length ) {
    // 将文章摘要的默认字数从55改为30
    return 30;
}
add_filter( 'excerpt_length', 'myplugin_modify_excerpt_length' );

الدوال الهامة لواجهة برمجة التطبيقات العامة (Global API Functions)

بالإضافة إلى الأدوات المتاحة، يوفر ووردبريس مجموعة كبيرة من دوال واجهة برمجة التطبيقات (API) المفيدة، مثل تلك المخصصة للتعامل مع قواعد البيانات. wpdb الفئات، خيارات المعالجة… get_option() و update_option()إنشاء جداول بيانات مخصصة dbDelta() الدوال وما إلى ذلك… إتقان استخدام هذه الواجهات البرمجية (APIs) هو مفتاح التطوير الفعال.

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

تنفيذ وظيفة إضافة (plugin) كاملة

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

إنشاء إطار عمل للإضافات (plugins) والملف الرئيسي (main file)

أولاً، في… /wp-content/plugins/ قم بإنشاء مجلد جديد داخل المجلد الحالي، وأطلق عليه الاسم التالي: post-reading-timeداخل هذا المجلد، قم بإنشاء الملف الرئيسي. post-reading-time.phpوقم بملء معلومات رأس الإضافة القياسية.

الدالة الأساسية لحساب وعرض وقت القراءة

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

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

function prt_calculate_reading_time( $content ) {
    // 1. 只有在单篇文章页面才生效
    if ( ! is_single() ) {
        return $content;
    }

// 2. 获取文章内容，去除短代码和HTML标签，计算字数
    $text_content = strip_shortcodes( wp_strip_all_tags( $content ) );
    $word_count   = str_word_count( $text_content );

// 3. 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );

// 4. 生成显示HTML
    $reading_time_html = sprintf(
        '<div class="post-reading-time"><p><strong>الوقت المتوقع للقراءة:</strong>حوالي 1 ثانية و30 مللي ثانية</p></div>',
        $reading_time
    );

// 5. 将阅读时间信息放在文章内容之前
    return $reading_time_html . $content;
}
add_filter( 'the_content', 'prt_calculate_reading_time' );

إضافة أنماط بسيطة للإضافة (plugins)

لجعل العرض أكثر جمالاً، يمكننا إضافة بعض أكواد CSS. من الممارسات الجيدة تنظيم ترتيب تحميل أكواد الأنماط (enqueue the loading of styles). wp_enqueue_style() هذه الدالة تضمن تحميل ملفات الأنماط (style sheets) بشكل صحيح وتمنع حدوث تعارض مع أي إضافات (plugins) أخرى.

function prt_enqueue_styles() {
    wp_enqueue_style(
        'prt-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/prt-style.css', // 假设CSS文件路径
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'prt_enqueue_styles' );

ثم… assets/css/prt-style.css إضافة أنماط بسيطة إلى الملف:

الاستضافة المشتركة InterServer
استضافة مشتركة $2.50 دولار أمريكي في الشهر، الشهر الأول $0.1 دولار أمريكي الرمز الترويجي tryinterserver، 461 نص برمجي للتطبيقات السحابية، تثبيت بنقرة واحدة.
انتر سيرفر LOGO صفحة الوصول 
.post-reading-time {
    background-color: #f0f8ff;
    border-left: 4px solid #3498db;
    padding: 10px 15px;
    margin-bottom: 20px;
    font-size: 0.95em;
}

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

الملخصات

تطوير إضافات ووردبريس (WordPress plugins) هو عملية تحويل الأفكار إلى وظائف قوية ومفيدة. من خلال إنشاء بيئة عمل متخصصة، وفهم الهيكل القياسي للإضافات، وإتقان آليات الروابط (Hooks) وواجهات برمجة التطبيقات الأساسية (Core APIs)، ستكتسب القدرة الأساسية على بناء إضافات مخصصة من مختلف الأنواع. يقدم هذا المقال لك مسارًا واضحًا للتعلم، بدءًا من التحضيرات اللازمة وصولاً إلى هيكل الكود، ومن المبادئ النظرية إلى حالات عملية. المفتاح هو الممارسة العملية؛ ابدأ بتطوير وظيفة بسيطة مثل “وقت القراءة”، ثم زد تدريجياً من درجة تعقيد الإضافة، حتى تتمكن في النهاية من تطوير إضافات ووردبريس قوية تلبي احتياجات محددة بثقة.

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

هل يلزم الإلمام التام بلغة PHP لتطوير الإضافات (plugins)؟

نعم، إن امتلاك أساسيات قوية في لغة PHP أمر ضروري لتطوير إضافات (plugins) لمنصة WordPress. وذلك لأن جزءًا كبيرًا من كود منصة WordPress الأساسي، بالإضافة إلى إضافاتها وقوالبها (themes)، مكتوب بلغة PHP. يجب أن تفهم المفاهيم الأساسية في لغة PHP مثل المتغيرات (variables)، الدوال (functions)، الكلاسات (classes)، المصفوفات (arrays)، الحلقات (loops)، والتحكمات الشرطية (conditional statements)، بالإضافة إلى المفاهيم الأساسية للبرمجة الكائنية (Object-Oriented Programming – OOP)، حتى تتمكن من كتابة كود إضافات آمن وفعال.

كيف يمكنني التأكد من أن الإضافة (البرنامج الإضافي) التي أطورها آمنة؟

لضمان أمان الإضافات (plugins)، من الضروري بذل جهود متعددة. أولاً، يجب إجراء تحقق صارم (Validation) وتنقية (Purification) وتهريب (Escaping) لجميع البيانات المدخلة من قبل المستخدمين. يمكن استخدام الدوال المتاحة في ووردبريس (WordPress) لتحقيق ذلك. sanitize_text_field(), esc_html(), wp_kses_post() ثانيًا، عند تنفيذ عمليات على قاعدة البيانات، يجب استخدام… (The text seems incomplete here; please provide the full sentence for a proper translation.) $wpdb طرق الفئة (Class methods) prepare() استخدم عبارات برمجية لمنع هجمات الاستغلال الضار (SQL injection). وأخيرًا، اتبع مبدأ الحد الأدنى من الصلاحيات، ومنح البرامج الإضافية (plugins) فقط القدرات الضرورية لتنفيذ وظائفها.

هل يمكن تحميل الإضافة (البرنامج الإضافي) التي طورتها إلى الدليل الرسمي لووردبريس (WordPress)?

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

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

عادةً ما يتطلب إضافة صفحة إعدادات للإضافة (plugin) استخدام “واجهة برمجة التطبيقات الخاصة بصفحات القوائم” (Menu Page API) في ووردبريس (WordPress). يمكنك استخدامها لإنشاء صفحة الإعدادات هذه بسهولة. add_menu_page() هناك دالة متاحة لإنشاء عنصر قائمة رئيسي (top-level menu item)، أو يمكنك استخدام طرق أخرى حسب احتياجاتك. add_submenu_page() قم بإنشاء صفحة فرعية تحت القائمة الحالية (مثل “الإعدادات”). في دالة الاستدعاء الخاصة بصفحة الإعدادات، يجب عليك عرض نموذج HTML واستخدامه لجمع البيانات المطلوبة. settings API(بما في ذلك) register_setting, add_settings_section, add_settings_field تُستخدم دوال مثل (…) لمعالجة عمليات تسجيل الخيارات وحفظها وعرضها بطريقة آمنة وسهلة.

ما التالي، ما التالي؟

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

القراءة الموسعة والمعرفة العملية

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

الوسوم