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

البدء من الصفر: دليل شامل ودروس عملية لتطوير إضافات ووردبريس (WordPress Plugins)

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

الاستعدادات اللازمة قبل تطوير إضافات ووردبريس (WordPress Plugins)

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

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

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

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

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

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

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

كل شيء يبدأ بالصعوبة، لكن إنشاء ملف إضافة (plugin) بسيط للغاية لمنصة ووردبريس (WordPress) أمر سهل للغاية. سيقوم هذا القسم بتوجيهك خلال عملية إنشاء الهيكل الأساسي للإضافة، وكتابة بيان الأمان (security statement) الخاص

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

في أعلى هذا الملف الرئيسي، يجب عليك إضافة تعليق يحتوي على رأس الإضافة (plugin header) وفقًا لمعايير ووردبريس. فيما يلي مثال أساسي:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version:     1.0.0
 * Author:      你的名字
 * Author URI:  https://yourwebsite.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

الحقل “اسم الإضافة” (Plugin Name) ضروري في هذه التعليمات، بينما باقي المعلومات اختيارية. ننصح بشدة بملء جميع الحقول بشكل كامل. بعد الانتهاء، قم برفع مجلد الإضافة إلى مجلد تثبيت ووردبريس (WordPress Installation Directory)./wp-content/plugins/أنت الآن في المسار الصحيح. قم بالدخول إلى صفحة “الإضافات” (Plugins) في واجهة ووردبريس الخلفية، وستتمكن من رؤية إضافتك وتفعيلها. في هذه المرحلة، لا تمتلك الإضافة أي وظائف، ولكنك قد نجحت بالفعل في إنشاء إضافة يتعرف عليها ووردبريس.

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

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

دعونا نضيف أول وظيفة فعالة لهذا الإضافة الفارغة: إضافة إعلان حقوق النشر تلقائيًا في نهاية محتوى المقال. سيساعدك هذا على فهم آلية “الهاكات” (hooks) في ووردبريس (WordPress).

أولاً، نحتاج إلى إنشاء دالة لتنفيذ عملية إضافة نصوص حقوق النشر. سنسمي هذه الدالة…myplugin_add_footer_text。

function myplugin_add_footer_text($content) {
    // 确保只在网站前端的主文章循环中执行
    if (is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query()) {
        $footer_text = '<p><em>تم عرض هذا المقال بواسطة أول إضافة (plugin) من إضافاتي الخاصة لكم.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

بعد ذلك، نحتاج إلى “تثبيت” هذه الدالة في نقطة تنفيذ معينة داخل ووردبريس، وهذه العملية تُسمى “إضافة خطاف” (Adding a Hook). في هذه الحالة، سنستخدم…the_contentخطافات المرشحات (Filter Hooks): في ملف البرنامج المكون الرئيسي الخاص بك، أضف الكود التالي:

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

بعد حفظ الملف، قم بتحديث صفحة المقال على موقعك الإلكتروني، وستلاحظ ظهور نص حقوق النشر الذي قمت بتعريفه في نهاية المحتوى. من خلال هذا المثال البسيط، لقد أتقنت النمط الأساسي لتطوير الإضافات: إنشاء الدوال -> استخدامها.add_actionأوadd_filterتقوم هذه “الخطافات” (hooks) بربط الدوال بدورة حياة ووردبريس (WordPress lifecycle).

التعمق في الجوهر: مكونات ووردبريس الإضافية (Plugins) وواجهات برمجة التطبيقات (APIs)

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

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

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

قم بإنشاء دالة خاصة لخطاف الإجراء (action hook function):

function myplugin_log_post_published($ID, $post) {
    // 当文章发布时，在错误日志中记录一条信息（仅用于演示）
    error_log("文章 {$post->post_title} (ID: {$ID}) 已发布。");
}
// 将函数挂载到 `publish_post` 这个动作钩子上
add_action('publish_post', 'myplugin_log_post_published', 10, 2);

قم بإنشاء دالة خاصة بخيط التصفية (filter hook function):

الاستضافة المشتركة InterServer
استضافة مشتركة $2.50 دولار أمريكي في الشهر، الشهر الأول $0.1 دولار أمريكي الرمز الترويجي tryinterserver، 461 نص برمجي للتطبيقات السحابية، تثبيت بنقرة واحدة.
انتر سيرفر LOGO صفحة الوصول 
function myplugin_excerpt_length($length) {
    // 将默认的摘要长度从55个词修改为20个词
    return 20;
}
// 将函数挂载到 `excerpt_length` 这个过滤器钩子上
add_filter('excerpt_length', 'myplugin_excerpt_length');

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

استخدام واجهات برمجة التطبيقات (APIs) مع ووردبريس

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

إنشاء دالة لصفحة الخيارات:

function myplugin_settings_page() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}
add_action('admin_menu', 'myplugin_settings_page');

ثم تحتاج إلى تنفيذ ذلك.myplugin_render_settings_pageالدالة مستخدمة لعرض نموذج (form)، وتقوم أيضًا بـ…settings_fieldsوdo_settings_sectionsدالة لعرض حقول النموذج التي يتم معالجتها تلقائيًا بواسطة واجهة برمجة تطبيقات ووردبريس (WordPress API).get_optionيمكنك بسهولة الحصول على قيم الخيارات التي قام المستخدم بحفظها في أي مكان من كود الإضافة (البرنامج الإضافي).

ممارسات متقدمة في تطوير الإضافات ونشرها

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

للحفاظ على وضوح الكود، يُنصح بفصل الأكواد التي تؤدي وظائف مختلفة عن بعضها البعض ووضعها في ملفات منفصلة. على سبيل المثال، يمكن وضع عمليات تسجيل الاستجابات (hooks) والدوال الأساسية في الملف الرئيسي، بيadmin/الدليل الفرعي: يتم وضع كود وظائف الواجهة الأمامية (الفرينت إند) فيه.public/يتم إنشاء المجلدات الفرعية واستيراد المحتويات من خلال عمليات تحميل مشروطة. كما أن استخدام برمجة التوجه الكائني (Object-Oriented Programming – OOP) يعتبر ممارسة ممتازة لإدارة الإضافات المعقدة، حيث يساعد ذلك على تغ

الأمان هو شريان الحياة في تطوير الإضافات (البرامج الإضافية). جميع البيانات التي يتم الحصول عليها من المستخدمين (مثل…)$_GET， $_POST， $_COOKIEيجب أن تخضع جميع العناصر للتحقق والتطهير. يوفر ووردبريس عددًا كبيرًا من الدوال (functions) لتسهيل هذه العمليات.sanitize_text_field， wp_kses_post， intvalعند إرسال أي بيانات إلى المتصفح أو قاعدة البيانات، من الضروري أيضًا تنفيذ عملية التهريب (escaping)، وذلك باستخدام الطرق المناسبة.esc_html， esc_attrأوwp_ksesللعمليات على قواعد البيانات، يجب استخدام وظائف (functions) متوفرة في ووردبريس (WordPress).$wpdbالفئات وما يتعلق بهاprepareطرق لمنع تهديدات الاختراق عن طريق إدخال الكود البرمجي غير المرغوب فيه (SQL Injection).

إنجاز عملية تدويل المكوّنات الإضافية.

لكي يتمكن مستخدمو العالم أجمع من استخدام إضافتك، فإن التدويل (Internationalization) خطوة ضرورية للغاية. يتضمن ذلك خطوتين رئيسيتين:__()أو_e()تقوم الدوال مثل `wait` بتغليف جميع النصوص التي يجب ترجمتها، بالإضافة إلى تحميل حقول النصوص بشكل صحيح.

لقد قمنا بتعريف نطاق النصوص (Text Domain) في رأس الإضافة (plugin header)، وعند تهيئة الإضافة (عادةً ما يتم ذلك في الملف الرئيسي)، من الضروري تحميل ملفات اللغة المطلوبة.

function myplugin_load_textdomain() {
    load_plugin_textdomain('my-first-plugin', false, dirname(plugin_basename(__FILE__)) . '/languages/');
}
add_action('init', 'myplugin_load_textdomain');

بعد ذلك، يمكنك استخدام شيء مشابه لـ__('Hello World', 'my-first-plugin')يتم استخدام طريقة معينة للكتابة لتمييز السلاسل النصية. يمكن للمترجمين استخدام أدوات مثل Poedit، وذلك وفقًا للنتائج المتولدة..potإنشاء ملفات القوالب.poو.moقم بترجمة الملف، ثم ضعه في المكان المخصص للإضافة (البرنامج الإضافي)./languages/تحت القائمة.

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

الملخصات

تطوير إضافات ووردبريس (WordPress plugins) هو رحلة عملية تحول الأفكار إلى وظائف قوية ومفيدة. تبدأ هذه العملية بإنشاء البيئة المناسبة وكتابة ملفات الإضافة الأساسية، ثم تتعمق تدريجياً في آليات الربط الأساسية (hooks) وواجهات برمجة التطبيقات (APIs) الخاصة بووردبريس، وفي النهاية تتعرف على مواضيع متقدمة مثل تنظيم الكود والأمان والتدويل (internationalization). جوهر هذه العملية كلها يكمن في فهم بنية ووردبريس المبنية على الأحداث (event-driven architecture)، واستخدام آليات الإجراءات (actions) والمرشحات (filters) لتوسيع الوظائف الأساسية بشكل سلس. تذكر دائماً أن البدء بميزة بسيطة والتطوير التدريجي، مع وضع أمان الكود وتجربة المستخدم في المقام الأول، هو السبيل الأمثل لتصبح مطور إضافات ناج

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

ما هي لغات البرمجة التي يجب إتقانها لتطوير إضافات (plugins) لووردبريس (WordPress) باستخدام الكود ###؟
لتطوير إضافات (Plugins) لووردبريس (WordPress)، من الضروري إتقان لغة PHP، نظرًا لأن قاعدة برمجة ووردبريس نفسها مكتوبة بلغة PHP. بالإضافة إلى ذلك، فإن الميزات الأمامية (الواجهة البرمجية للمستخدم) غالبًا ما تتطلب استخدام HTML وCSS وJavaScript. أما بالنسبة للتفاعل مع قواعد البيانات، فإن معرفة أساسيات SQL مفيدة أيضًا.$wpdbتقوم الفئة بتغليف معظم العمليات (الدوال).

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

خلال مرحلة التطوير، يُنصح بتفعيل وضع التصحيح (Debugging Mode) في ووردبريس.wp-config.phpفي الملف، سيتم…WP_DEBUGتم تعيين الثابت على قيمةtrueيمكنك أيضًا استخدام…error_log()تقوم الدالة بتسجيل المعلومات في سجل الأخطاء الخاص بالخادم. ولتصحيح الأخطاء بشكل أكثر فعالية، يمكن استخدام أدوات متخصصة مثل Xdebug أو Query Monitor لتتبع تنفيذ الكود وعمليات الاستعلام عن البيانات في قاعدة البيانات.

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

يمكن للإضافات (البرامج الإضافية) أن تعمل من خلال واجهة برمجة التطبيقات (API) الخاصة بووردبريس (WordPress)، مثل…wp_remote_get()， wp_remote_post()يتم إجراء الاتصالات الآمنة والمستقرة مع الخدمات الخارجية باستخدام واجهة برمجة التطبيقات (API) الخاصة بـ WordPress. تتضمن واجهة برمجة التطبيقات الخاصة بـ WordPress ميزات مثل معالجة التوقيت (التأخير في الاستجابة) والتحقق من صحة بروتوكول SSL، مما يجعلها أكثر موثوقية من استخدام دوال مثل `curl` أو `file_get_contents` المتوفرة في لغة PHP مباشرة. عند معالجة الاستجابات، من المهم جدًا فحص أي أخطاء والتعامل مع

كيف يمكنني إضافة جداول قاعدة بيانات مخصصة إلى إضافتي (plugin)؟

على الرغم من أن جدول خيارات ووردبريس كافٍ لمعالجة معظم حالات تخزين الإعدادات، إلا أن البيانات المنظمة قد تكون أكثر ملاءمة للتخزين في جداول مخصصة. يمكنك القيام بذلك باستخدام خيوط التنشيط (activation hooks) لregister_activation_hookيتم تنفيذ جملة SQL لإنشاء الجدول أثناء عملية تسجيل الدالة. يجب استخدامها بالتأكيد.$wpdb->prefixللتأكد من أن بادئة الجدول صحيحة، واستخدم…dbDeltaتوجد دوال مخصصة لإنشاء أو تحديث هيكل الجداول بشكل آمن. يجب أن تتم أي عمليات استعلام على الجداول المخصصة من خلال هذه الدوال فقط.$wpdbيتم ذلك على الكائنات.

كيف يمكنني التأكد من أن إضافتي تتوافق مع الإضافات الأخرى أو المواضيع (Themes)؟

保持兼容性的最佳实践是：使用WordPress核心API和标准钩子；为函数、类、选项名添加唯一前缀（如使用插件缩写）；将功能封装在类或命名空间中以避免命名冲突；避免直接修改全局变量；并在执行可能影响全局状态的操作（如注册短码、自定义文章类型）前，先检查是否已经存在。在发布前，尽可能多地在不同环境中进行测试。

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

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

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

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

الوسوم