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

الاستعدادات وإعداد البيئة.

قبل البدء في كتابة الكود، من المهم جدًا إنشاء بيئة عمل مستقرة وفعالة كخطوة أولى نحو النجاح. يجب أن تمتلك بيئة تطوير محلية أو بعيدة يمكنها تشغيل ووردبريس (WordPress). ننصح بشدة باستخدام بيئة التطوير المحلية، مثل Local by Flywheel أو XAMPP أو MAMP، حيث يمكنك إجراء التغييرات والاختبارات بسرعة دون الحاجة إلى نشر المشروع بشكل متكرر على الخادم الحقيقي.

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

<?php
/**
 * Plugin Name: My First Plugin
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 一个简单的自定义插件，用于学习 WordPress 插件开发。
 * Version:     1.0.0
 * Author:      Your Name
 * Author URI:  https://example.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

سيتم إنشاء مجلد الإضافات (plugins) المطلوب (على سبيل المثال… my-first-pluginيتم وضع الملفات في دليل تثبيت WordPress. wp-content/plugins/ أولاً، قم بتنزيل الإضافة من المصدر الموثوق، ثم قم بتثبيتها على موقعك الإلكتروني. بعد ذلك، سجل الدخول إلى واجهة خلفية WordPress، وفي قائمة “الإضافات” (Plugins)، يجب أن تتمكن من رؤية الإضافة التي قمت بتنزيلها، ويمكنك تفعيلها فورًا. ل

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

الهيكل الأساسي للإطار البرمجي للإضافات (Plugin Core Structure Framework)

الإضافة (plugin) ذات البنية الجيدة ليست سهلة الصيانة فحسب، بل تسهل أيضًا التعاون مع المطورين الآخرين. يُنصح باتباع هيكل مجلدات منطقي منذ بداية المشروع. قد تتضمن الإضافة النموذجية المجلدات والملفات التالية: ملف الإضافة الرئيسي (الموجود في المجلد الرئيسي)،includes/ مجلدات (تحتوي على الوظائف الأساسية أو الدوال).admin/ مجلد (يحتوي على الكود المتعلق بالخلفية)public/ مجلد (يحتوي على الكود المتعلق بالجزء الأمامي من التطبيق).assets/ مجلد (يحتوي على ملفات JavaScript وCSS وملفات الصور) بالإضافة إلى ملفات حزم اللغات (language pack files).

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

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

صفحة الوصول

عادةً ما تكون نقطة الدخول المنطقية للإضافات (plugins) موجودة في الملف الرئيسي (main file). هنا، يتعين عليك اتخاذ قرار بشأن اعتماد نمط البرمجة القائم على العمليات (procedural programming) أو النمط القائم على الكائنات (object-oriented programming). بالنسبة للإضافات المعقدة، فإن البرمجة القائمة على الكائنات (OOP) توفر مزاي My_First_Pluginومن خلال ذلك، يتم دمج وظائف الإضافات (Plugins) مع دورة حياة نظام ووردبريس (WordPress) باستخدام ما يُعرف بـ “الخطافات” (Hooks).

تتم توسيع وظائف ووردبريس (WordPress) من خلال آلية الاستجابات (Hooks)، والتي تنقسم بشكل أساسي إلى نوعين: الإجراءات (Actions) والمرشحات (Filters). تسمح استجابات الإجراءات (Action Hooks) بتنفيذ كود مخصص في أوقات محددة، بينما تسمح استجابات المرشحات (Filter Hooks) بتعديل البيانات. add_action() و add_filter() هناك دوال مخصصة لتثبيت (ما يُعرف بـ "مونتاج") الدوال الخاصة بك كإجراءات استجابة (callbacks). على سبيل المثال، يمكن تثبيت هذه الدوال داخل فئة تهيئة الإضافة (plugin initialization class).

class My_First_Plugin {
    public function __construct() {
        // 在管理员菜单初始化时，执行 `create_admin_menu` 方法
        add_action( 'admin_menu', array( $this, 'create_admin_menu' ) );
        // 在文章内容显示前，通过过滤器修改内容
        add_filter( 'the_content', array( $this, 'modify_post_content' ) );
    }

public function create_admin_menu() {
        // 创建菜单的代码
    }

public function modify_post_content( $content ) {
        // 修改内容的代码
        return $content;
    }
}
new My_First_Plugin();

إنشاء واجهة إدارة خلفية للإضافات (Plugins)

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

أولاً، يجب عليك استخدام… add_menu_page() أو add_submenu_page() هناك دوال مخصصة لتسجيل صفحة جديدة في نظام ووردبريس (WordPress). تقوم هذه الدوال بتحديد الموقع المناسب في شريط الجانب الخاص بالمسؤولين (administrator sidebar) حيث يتم عرض القائمة الجديدة. يتم إنشاء محتوى الصفحة من خلال دالة استدعاء مرتدة (callback function)، ويمكنك استخدام هذه الدالة لعرض نماذج HTML أو أي نوع آخر من المحتوى.

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

بالنسبة للإضافات التي تحتاج إلى حفظ الإعدادات، فإن واجهة برمجة التطبيقات (API) الخاصة بإعدادات ووردبريس تعتبر خيارًا قياسيًا وآمنًا. فهي تتعامل مع مسائل التحقق من الصلاحيات، والحقول غير المتعلقة بـ CE (Common Encoding Standards)، والرموز الأمنية، مما يسه register_setting()、add_settings_section() و add_settings_field() لتعريف إعداداتك، إليك مثالاً بسيطاً: إنشاء صفحة إعدادات تحتوي على مربع نصوص.

public function create_admin_menu() {
    add_menu_page(
        '我的插件设置',           // 页面标题
        '我的插件',               // 菜单标题
        'manage_options',         // 权限
        'my-plugin-settings',     // 菜单 Slug
        array( $this, 'settings_page_html' ), // 回调函数
        'dashicons-admin-generic', // 图标
        6
    );

// 注册设置
    register_setting( 'my_plugin_settings_group', 'my_plugin_option_name' );
}

public function settings_page_html() {
    // 检查用户权限
    if ( !current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1></h1>
        <form action="/ar/options.php/" method="post" data-trp-original-action="options.php">
            
        <input type="hidden" name="trp-form-language" value="ar"/></form>
    </div>
    أنا لا أعرف ماذا أقول.

لتحسين تجربة المستخدم، قد تحتاج أيضًا إلى إضافة لغات JavaScript و CSS إلى واجهة الإدارة. يوفر WordPress الأدوات اللازمة لذلك. wp_enqueue_script() و wp_enqueue_style() الدالة، ويُقترح استخدامها من خلال… admin_enqueue_scripts تُستخدم “الخطافات” (hooks) لتحميل هذه الموارد بشكل آمن.

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

الأمان هو جزء لا يمكن التنازل عنه في تطوير الإضافات (البرامج الإضافية). قد تشكل الإضافات التي تحتوي على ثغرات أمنية خطرًا على الموقع بأكمله. المبدأ الأساسي هو: لا تثق أبدًا بمدخلات المستخدمين. يجب معالجة جميع البيانات الواردة من الخارج $_GET、$_POSTسواء كانت قواعد البيانات أو واجهات برمجة التطبيقات (APIs) الأخرى، يجب إجراء عمليات التحقق والتنظيف والتهريب (escaping) عليها جميعًا.

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

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

صفحة الوصول

بالنسبة للبيانات التي سيتم تخزينها في قاعدة البيانات، يجب استخدام… sanitize_text_field()、wp_kses() قم بتنظيف الدوال المستخدمة. بالنسبة للبيانات التي ستعرض على صفحات HTML، استخدم… esc_html()、esc_attr() أو wp_kses_post() قم بتنفيذ عملية التهريب (escaping). عند تنفيذ عمليات الاستعلام على قاعدة البيانات، يجب استخدام الوسائل التي يوفرها ووردبريس بالتأكيد. $wpdb الفئات وطرقها، مثل prepare()لمنع هجمات الاستغلال الخبيث للكود (SQL Injection Attacks).

عدم إجراء التحقق من صحة البيانات (Non-CE Verification) يعتبر عاملاً أساسياً في حماية النماذج من هجمات تزوير الطلبات عبر المواقع (Cross-Site Request Forgery Attacks). من المهم استخدام آليات التحقق هذه لضمان أمان البيانات المقدمة من المستخدمين wp_nonce_field() قم بإنشاء حقول في النموذج، واستخدمها عند معالجة عملية الإرسال. wp_verify_nonce() قم بالتحقق.

تحسين الأداء أمر مهم أيضًا. يجب أن تقوم الإضافات (البرامج المساعدة) بتحميل الموارد حسب الحاجة، وتقوم بتنفيذ الوظائف المطلوبة فقط عند الضرورة. على سبيل المثال، يجب تحميل السكريبتات والأنماط الخاصة بالخلفية فقط على صفحة إد $_GET['page'] المعاملات (Parameters): بالنسبة للوظائف التي قد تؤدي إلى إجراء عدد كبير من عمليات الاستعلام عن البيانات في قاعدة البيانات أو إلى حسابات معقدة، فكر في استخدام آليات التخزين المؤقت (Caching)، مثل استخدام واجهة برمجة التطبيقات (API) Transients في ووردبريس لتخزين البيانات المؤ

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

أخيرًا، يجب أن يحتوي الكود الجيد على تعليقات كافية، وأن يتبع تنسيقًا يتوافق مع معايير ترميز ووردبريس (WordPress Coding Standards)، كما يجب أن يأخذ في الاعتبار إمكانيات التدويل (الترجمة) والتكييف مع اللغات المختلفة (التحليل الدولي). __() و _e() تقوم دوال مثل هذه بتغليف جميع السلاسل النصية المرئية للمستخدمين، وذلك لضمان… load_plugin_textdomain() تم إعداد الدالة بحيث يسهل ترجمة إضافتك (البرنامج الإضافي) في المستقبل.

الاختبار والنشر إلى المستودع الرسمي

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

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

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

صفحة الوصول

يوفر ووردبريس إجراءً قياسيًا للتنصيب والإزالة. يمكنك تسجيل "hook" لعملية الإزالة داخل ملف الإضافة الرئيسي. عندما يقوم المسؤول بحذف الإضافة من الواجهة الخلفية، يقوم ووردبريس بالتحقق مما إذا كان هناك هذا الـ "hook". uninstall.php إذا كانت ملفات معينة موجودة، فسيتم تحميلها وتنفيذها. هذه فرصتك لتنظيف الجداول القاعدية المخصصة أو الإعدادات التي أنشأتها الإضافات.

// 在主插件文件中注册卸载钩子
register_uninstall_hook( __FILE__, 'my_plugin_uninstall' );

function my_plugin_uninstall() {
    // 删除插件创建的选项
    delete_option( 'my_plugin_option_name' );
    // 如果创建了自定义数据库表，也可以在这里删除
    // global $wpdb;
    // $wpdb->query( "DROP TABLE IF EXISTS {$wpdb->prefix}my_custom_table" );
}

بعد الانتهاء من تطوير الإضافة واختبارها وإعداد وثائقها، يمكنك التفكير في تقديمها إلى مجلد الإضافات الرسمي لـ WordPress. لذلك، سيتعين عليك إنشاء مستودع SVN وتقديم الكود وفقًا لهيكل معين (يشمل…). readme.txt الملفات تمت مراجعتها يدويًا بعد تحميلها. بمجرد نجاح عملية النشر، ستحصل على مورد مستقر وموثوق به. https://wordpress.org/plugins/your-plugin-name/ يمكن للمستخدمين تثبيت الإضافة الخاصة بك مباشرةً من خلال واجهة ووردبريس الخلفية الخاصة بهم. هذا يزيد بشكل كبير من مصداقية الإضافة ومن نطاق توزيعها.

الملخصات

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

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

ما هي المعرفة المسبقة المطلوبة لتطوير إضافة (plugin) لمنصة ووردبريس (WordPress) باستخدام الكود ###؟
يجب أن يكون لديك فهم سليم للغة PHP، نظرًا لأن قلب نظام ووردبريس (WordPress) وإضافاته مكتوبة بشكل أساسي بلغة PHP. بالإضافة إلى ذلك، من الضروري معرفة HTML وCSS وJavaScript لإنشاء واجهات المستخدم. كما أن فهم المفاهيم الأساسية لقواعد البيانات MySQL بالإضافة إلى الدوال وآليات الخاصة بووردبريس (مثل الـ hooks) يعتبر أساسًا مهمًا للتطوير الناجح.

كيفية تصحيح المشاكل الموجودة في إضافات ووردبريس (WordPress Plugins)

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

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

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

كيفية التعامل مع تحديثات الإضافات (plugins) وترقيات المستخدمين (user upgrades)

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

ما هي المتطلبات الرئيسية لإضافة إضافة إلى الدليل الرسمي لووردبريس (WordPress Official Directory)؟

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