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

أساسيات تطوير الإضافات في ووردبريس والتحضير للبيئة.

يعد تطوير المكونات الإضافية لـ WordPress طريقة أساسية لتوسيع وظائف نظام إدارة المحتوى (CMS). لبدء عملية التطوير، تحتاج أولاً إلى إعداد بيئة تطوير محلية محترفة. يُفضل استخدام أدوات مثل XAMPP أو MAMP أو الأداة الأحدث Local by Flywheel، التي تسمح بإعداد بيئة خادم ويب كاملة على جهاز الكمبيوتر الخاص بك تتضمن PHP وMySQL وApache بسرعة. في الوقت نفسه، تأكد من تثبيت أحدث إصدار من WordPress ومحرر كود فعال يدعم تسليط الضوء على بناء الجمل في PHP، مثل Visual Studio Code أو PHPStorm.

إن الجزء الأساسي في تطوير المكوّنات الإضافية هو فهم بنيتها الأساسية. تكون المكوّنات الإضافية في الأساس عبارة عن واحد أو أكثر من الملفات الموجودة فيwp-content/plugins/ملفات PHP الموجودة في الدليل. المتطلب الأساسي هو إنشاء ملف رئيسي فريد للإضافة. يجب أن تحتوي كل إضافة على تعليقات رأس محددة، تتضمن معلومات عن اسم الإضافة، ووصفها، وإصدارها، ومؤلفها، وما إلى ذلك. تقوم ووردبريس بتحديد الإضافات وإدارتها عن طريق قراءة هذه البيانات الوصفية. على سبيل المثال، تعليقات الرأس لإضافة بسيطة هي كما يلي:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Description: 这是一个用于演示的简单插件。
 * Version: 1.0
 * Author: 开发者名称
 */

بعد وضع ملف PHP الذي يحتوي على هذا التعليق في مجلد المكوّنات، سيكون بإمكانك رؤيته وتفعيله في صفحة “المكوّنات” في اللوحة الخلفية لـ WordPress.

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

دليل الإضافات ومعايير التسمية.

يعد البرنامج المساعد المُنظّم بشكل جيد أمرًا بالغ الأهمية للصيانة والتعاون. يُفضل إنشاء دليل منفصل للبرنامج المساعد ذي الوظائف المعقدة، بدلاً من ملف واحد. يجب أن يكون اسم الدليل قصيرًا وفريدًا وكله أحرفًا صغيرة، وعادةً ما يتوافق مع اسم الملف الرئيسي للبرنامج المساعد الخاص بك. على سبيل المثال، يمكن أن يحتوي برنامج مساعد يُسمى “my-awesome-plugin” على هيكل دليل يتضمن الملف الرئيسي.my-awesome-plugin.phpتخزينcssوjsمجلد، واحد لتعريف الخطافات.includesمجلدات، وكذلك ما يُستخدم للتدويل.languagesمجلد. اتباع هذا الهيكل يمكن أن يحسن قابلية قراءة الكود.

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

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

صفحة الوصول

المفهوم الأساسي: مشغلات الإجراءات والفلاتر.

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

تطبيق مُعلقات الحركة.

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

function myplugin_prepend_content($content) {
    $prepend_text = '<p>هذا المحتوى تم إضافته بواسطة الإضافة (البرنامج الإضافي) الخاصة بي.</p>';
    return $prepend_text . $content;
}
add_filter('the_content', 'myplugin_prepend_content');

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

function myplugin_footer_notice() {
    echo '<p>يتم دعم هذا الموقع بواسطة الإضافات (البرامج الإضافية) الخاصة بي!</p>';
}
add_action('wp_footer', 'myplugin_footer_notice');

ميكانيزم استخدام الفلتر.

يتم استخدام الفلاتر لتعديل أي بيانات قبل عرضها أو إدخالها في قاعدة البيانات. على عكس خطوات العمل، تتلقى الفلاتر قيمةً ما ويجب أن تُرجع قيمةً مُعالجةً. يمكنك استخدامها من خلالadd_filter()استخدم وظيفة لإضافة فلتر. مثال شائع هو تعديل طول ملخص المقالة، وربطه بـexcerpt_lengthالمرشحات:

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

function myplugin_custom_excerpt_length($length) {
    return 20; // 将摘要长度改为20个单词
}
add_filter('excerpt_length', 'myplugin_custom_excerpt_length');

يتيح لك فهم نظام الخطافات أن تجعل إضافاتك تعمل بسلاسة مع نواة WordPress والإضافات الأخرى.

بناء مكون إضافي كامل الوظائف.

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

تهيئة المكوّنات وإنشاء جداول البيانات.

الفئة الرئيسية للمكوّن الإضافي هيPost_View_Counter。
أولاً، عند تفعيل الإضافة (باستخدامregister_activation_hook) إنشاء جدول بيانات لتخزين عدد المرات التي تم فيها قراءة الكتاب.

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

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

صفحة الوصول

class Post_View_Counter {
    public function __construct() {
        register_activation_hook(__FILE__, array($this, 'activate'));
        add_action('wp_enqueue_scripts', array($this, 'enqueue_scripts'));
        add_action('wp_ajax_nopriv_record_view', array($this, 'record_view'));
        add_action('wp_ajax_record_view', array($this, 'record_view'));
        add_filter('the_content', array($this, 'display_view_count'));
    }

public function activate() {
        global $wpdb;
        $table_name = $wpdb->prefix . 'post_views';
        $charset_collate = $wpdb->get_charset_collate();
        $sql = "CREATE TABLE $table_name (
            id mediumint(9) NOT NULL AUTO_INCREMENT,
            post_id bigint(20) NOT NULL,
            view_date datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
            PRIMARY KEY (id)
        ) $charset_collate;";
        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
        dbDelta($sql);
    }

تم استخدام اسم جدول قاعدة البيانات.$wpdb->prefixلضمان التفرد في بيئة متعددة المواقع.

التفاعل بين الواجهة الأمامية والخلفية ومعالجة AJAX.

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

    public function enqueue_scripts() {
        if(is_single()) {
            wp_enqueue_script('pvc-script', plugin_dir_url(__FILE__) . 'js/pvc-script.js', array('jquery'), '1.0', true);
            wp_localize_script('pvc-script', 'pvc_ajax', array(
                'ajax_url' => admin_url('admin-ajax.php'),
                'post_id' => get_the_ID(),
                'nonce' => wp_create_nonce('pvc_nonce')
            ));
        }
    }

بعد ذلك، اكتب دالة معالجة AJAX.record_view()لتلقي طلبات الواجهة الأمامية وإدخال البيانات في قاعدة البيانات بأمان. يجب إجراء فحص الأذونات والتحقق من الأرقام العشوائية هنا لمنع هجمات CSRF.

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

    public function record_view() {
        // 安全检查
        check_ajax_referer('pvc_nonce', 'nonce');
        $post_id = intval($_POST['post_id']);
        // 验证文章是否存在
        if(get_post_status($post_id)) {
            global $wpdb;
            $table_name = $wpdb->prefix . 'post_views';
            $wpdb->insert($table_name, array('post_id' => $post_id));
            wp_die('success');
        }
        wp_die('error', 400);
    }

وفي النهاية، قمنا بذلك من خلالthe_contentيعرض الفلتر عدد المرات التي تمت فيها قراءة المقالة في نهايتها.

    public function display_view_count($content) {
        if(is_single()) {
            global $wpdb, $post;
            $table_name = $wpdb->prefix . 'post_views';
            $view_count = $wpdb->get_var($wpdb->prepare(
                "SELECT COUNT(*) FROM $table_name WHERE post_id = %d", $post->ID
            ));
            $content .= '<p>تم قراءة هذا المقال. <strong>'`.intval($view_count)`.'</strong> مرة أخرى.</p>';
        }
        return $content;
    }
}
new Post_View_Counter();

يغطي هذا المثال العمليات الرئيسية لتطوير المكونات الإضافية، بما في ذلك إدارة دورة الحياة، وعمليات قاعدة البيانات، والاتصالات الآمنة، وتكامل الوظائف.

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

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

صفحة الوصول

تقنيات متقدمة وأفضل الممارسات.

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

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

لكي يستخدم مستخدمون حول العالم إضافتك، يجب أن تدعم التدويل. يستخدم ووردبريس إطار عمل GNU gettext. أولاً، استخدم سلسلة النص الموجهة للمستخدمين في جميع الأماكن.__()、_e()تُستخدم دوال مثل هذه لتغليف (wrapping) الكود.

$greeting = __('你好，世界！', 'my-plugin-textdomain');
_e('这是一个可翻译的句子。', 'my-plugin-textdomain');

بعد ذلك، استخدم أدوات مثل Poedit لإنشاءه..potملفات القالب، والسماح للمترجمين بإنشاء النسخ المقابلة باللغات المطلوبة..poو.moملف. وأخيرًا، استخدمه عند تحميل المكوّن الإضافي.load_plugin_textdomain()يتم استخدام الدالة لتحميل الترجمة. وهذا يؤدي إلى زيادة كبيرة في قبول البرنامج المساعد في الأسواق غير الناطقة باللغة الإنجليزية.

صفحة الإعدادات وواجهة برمجة التطبيقات للخيارات.

عادةً ما توفر الإضافات المهنية صفحة إعدادات. يوفر ووردبريس مجموعة قوية منSettings APIلإنشاء الخيارات والتحقق منها وحفظها بأمان.
تحتاج إلى استخدامadd_options_page()أوadd_menu_page()اضغط على "إضافة" لإضافة صفحة إدارية. بعد ذلك، استخدمregister_setting()、add_settings_section()وadd_settings_field()لإنشاء نموذج وربطه بالخيارات الموجودة في قاعدة البيانات.
دائمًا، تحقق من إدخال المستخدم وقم بتنقيته، باستخدامsanitize_text_field()、intval()انتظر الدالات، واستخدمها عند الإخراج.esc_html()أوesc_attr()يتم إجراء التشفير لمنع هجمات XSS.

تحسين الأداء وتعزيز الأمان.

من حيث الأداء، يجب استخدامه بشكل معقول.wp_cache_get()وwp_cache_set()استخدم وظائف التخزين المؤقت لكائنات WordPress لتخزين نتائج الاستعلام. بالنسبة لعمليات قاعدة البيانات المتكررة، تأكد من أن عبارات SQL مُحسّنة وتُستخدم بشكل صحيح.$wpdb->prepare()قم بإجراء استعلام على الجملة التحضيرية لمنع حقن SQL.
فيما يتعلق بالأمان، لا تثق أبدًا في المدخلات التي يقدمها المستخدم. بالإضافة إلى التنقية والهروب المذكورين أعلاه، يجب استخدامها عند معالجة العمليات الحساسة (مثل طلبات AJAX أو إرسال النماذج).wp_verify_nonce()وcheck_ajax_referer()لفحص الأرقام العشوائية، واستخدم.current_user_can()تحقق من أذونات المستخدم. سيؤدي ذلك إلى إنشاء خط دفاع أمني قوي للإضافة.

الملخصات

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

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

ما هي المعرفة الأساسية اللازمة لتطوير إضافات WordPress؟
يتطلب تطوير مكوّنات WordPress على الأقل معرفةً أساسيةً بلغة PHP، بما في ذلك مفاهيم البرمجة الموجهة للكائنات. كما يجب أن يكون لديك فهم أساسي لـ HTML وCSS وJavaScript (خاصةً jQuery) وMySQL. والأهم من ذلك، يجب أن تكون على دراية ببنية WordPress الأساسية، وخاصةً نظام الإجراءات والفلاتر (Actions and Filters)، والمتغيرات العالمية، وفئات عمليات قاعدة البيانات.$wpdbوكذلك عملية عمل قوالب الموضوعات.

كيف يمكنك تصحيح أخطاء المكوّن الإضافي لـ WordPress الذي طورته بنفسك؟

أكثر الطرق فعالية هي تفعيل وضع التصحيح في ووردبريس. فيwp-config.phpفي الوثيقة، يتم تعيين الإعدادات.define(‘WP_DEBUG’, true);سيتم عرض أخطاء PHP وتحذيراتها وإشعاراتها مباشرة على الصفحة. أما بالنسبة لتصحيح الأخطاء المنطقية الأكثر تعقيدًا، فيمكن استخدام…error_log()تقوم الوظيفة بكتابة معلومات المتغيرات في سجل الأخطاء الخاص بالخادم، أو باستخدام أدوات تصحيح PHP احترافية مثل Xdebug. بالنسبة إلى AJAX والتفاعل مع الواجهة الأمامية، تعد أدوات المطور في المتصفح (لوحة التحكم ولوحة الشبكة) ضرورية.

كيف يتوافق مكوّني الإضافي مع المكوّنات الإضافيّة أو المظاهر الأخرى؟

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

كيف يمكنك إرسال إضافتك إلى دليل الإضافات الرسمي لـ WordPress؟

أولاً، تحتاج إلى إنشاء حساب على WordPress.org وتقديم المكوّن الإضافي. يجب أن تتوافق شفرة المكوّن الإضافي الخاص بك مع معايير الترميز الرسمية وألا تحتوي على أي شفرة مشفرة أو مربكة. يجب أن يحتوي المكوّن الإضافي على تعليقات رأس تتوافق مع المعايير، وأن يقدم وثيقة README مفصلة قدر الإمكان. يجب أن تدعم جميع سلاسل النصوص التدويل. بعد التقديم، سيقوم فريق مراجعة المكوّنات الإضافية بمراجعته، وسيتحقق بشكل أساسي من الأمان وجودة شفرة المكوّن الإضافي والامتثال لترخيص GPL. بعد الموافقة، سيكون مكوّنك الإضافي متاحًا للبحث وتنزيله من قبل المستخدمين حول العالم.