ووردبريس هو أحد أنظمة إدارة المحتوى الأكثر شعبية في العالم، ويتيح للمستخدمين والمطورين إمكانية تخصيص مواقعهم بطرق لا حصر لها من خلال الإضافات (Plugins). في هذا الدليل، سنشرح كيفية إنشاء إضافة ووردبريس من الصفر مع شرح مفصل لكل خطوة.
1. إعداد البيئة التطويرية
قبل أن تبدأ، يجب أن تملك بيئة تطوير محلية على جهازك. يمكنك استخدام أدوات مثل XAMPP أو MAMP لإنشاء سيرفر محلي يعمل عليه ووردبريس لتطوير واختبار الإضافات.
2. إنشاء مجلد الإضافة
ابدأ بإنشاء مجلد جديد في دليل wp-content/plugins الخاص بموقع ووردبريس. اسم المجلد يجب أن يكون فريداً ويعبر عن وظيفة الإضافة التي تنوي تطويرها. على سبيل المثال، إذا كنت تطور إضافة للتواصل، يمكنك تسميته my-first-plugin.
3. إنشاء ملف الإضافة الرئيسي
داخل المجلد الذي أنشأته، قم بإنشاء ملف PHP رئيسي للإضافة. سمي الملف بنفس اسم المجلد، على سبيل المثال my-first-plugin.php. في هذا الملف، ستبدأ بكتابة ترويسة الإضافة.
4. كتابة ترويسة الإضافة
الترويسة هي مجموعة من التعليقات التي توضح معلومات أساسية عن الإضافة. تبدأ بكتابة الترويسة في أعلى ملف الإضافة الرئيسي كما يلي:
|
1 2 3 4 5 6 7 8 9 10 |
<?php /* Plugin Name: My First Plugin Plugin URI: https://example.com/my-first-plugin Description: This is my first WordPress plugin. Version: 1.0 Author: Your Name Author URI: https://example.com License: GPL2 */ |
5. إضافة الوظائف الأساسية
الآن بعد أن أعددت ترويسة الإضافة، يمكنك البدء بإضافة بعض الوظائف الأساسية. كمثال بسيط، سنضيف رسالة تحية إلى شريط الأدوات في واجهة الإدارة:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
// منع الوصول المباشر إلى الملف if (!defined('ABSPATH')) { exit; // Exit if accessed directly } // إضافة عنصر إلى شريط الأدوات في واجهة الإدارة function my_first_plugin_admin_bar() { global $wp_admin_bar; $wp_admin_bar->add_menu(array( 'id' => 'my_first_plugin_hello', 'title' => 'Hello, World!', 'href' => false, )); } add_action('wp_before_admin_bar_render', 'my_first_plugin_admin_bar'); |
6. تفعيل الإضافة
لتفعيل الإضافة، توجه إلى لوحة تحكم ووردبريس، ثم إلى قسم “الإضافات”. يجب أن ترى إضافتك مدرجة هناك. اضغط على “تفعيل” لتفعيل الإضافة.
7. إضافة صفحة إعدادات مخصصة
يمكنك إضافة صفحة إعدادات مخصصة لإضافتك في واجهة الإدارة لتخصيص الإضافة. في هذا المثال، سنضيف صفحة إعدادات بسيطة:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
// إنشاء صفحة الإعدادات function my_first_plugin_add_admin_menu() { add_menu_page( 'My First Plugin Settings', // عنوان الصفحة 'My First Plugin', // عنوان القائمة 'manage_options', // القدرة المطلوبة 'my-first-plugin', // اسم القائمة 'my_first_plugin_settings_page' // الدالة التي تعرض الصفحة ); } add_action('admin_menu', 'my_first_plugin_add_admin_menu'); // عرض محتوى صفحة الإعدادات function my_first_plugin_settings_page() { ?> <div class="wrap"> <h1>My First Plugin Settings</h1> <form method="post" action="options.php"> <?php settings_fields('my_first_plugin_settings_group'); do_settings_sections('my-first-plugin'); submit_button(); ?> </form> </div> <?php } |
8. تسجيل الإعدادات
لتسجيل الإعدادات التي ستستخدمها في صفحة الإعدادات، يمكنك استخدام الدالة register_setting:
|
1 2 3 4 5 |
// تسجيل إعدادات الإضافة function my_first_plugin_register_settings() { register_setting('my_first_plugin_settings_group', 'my_first_plugin_option'); } add_action('admin_init', 'my_first_plugin_register_settings'); |
9. إضافة إعدادات مخصصة
لإضافة إعدادات مخصصة إلى صفحة الإعدادات، يمكنك استخدام الدالة add_settings_section وadd_settings_field:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
// إضافة قسم وإعدادات مخصصة function my_first_plugin_settings_init() { add_settings_section( 'my_first_plugin_section', // معرف القسم 'Settings Section', // عنوان القسم 'my_first_plugin_section_callback', // دالة عرض القسم 'my-first-plugin' // صفحة الإعدادات ); add_settings_field( 'my_first_plugin_option', // معرف الإعداد 'Sample Option', // عنوان الإعداد 'my_first_plugin_option_callback', // دالة عرض الإعداد 'my-first-plugin', // صفحة الإعدادات 'my_first_plugin_section' // القسم ); register_setting('my_first_plugin_settings_group', 'my_first_plugin_option'); } add_action('admin_init', 'my_first_plugin_settings_init'); // دالة عرض القسم function my_first_plugin_section_callback() { echo 'This is a sample settings section.'; } // دالة عرض الإعداد function my_first_plugin_option_callback() { $value = get_option('my_first_plugin_option'); echo '<input type="text" name="my_first_plugin_option" value="' . esc_attr($value) . '">'; } |
نصائح إضافية
- التدويل: استخدم وظائف ووردبريس للتدويل مثل
__()و_e()لجعل إضافتك قابلة للترجمة. - الأمان: تحقق من مدخلات المستخدمين لمنع الهجمات الأمنية مثل XSS و SQL Injection.
- الأداء: حافظ على أداء إضافتك بكفاءة وتجنب كتابة كود قد يبطئ الموقع.
- التوثيق: احرص على توثيق الكود الخاص بك ليكون سهل الفهم والصيانة.
خاتمة
بمجرد أن تتقن الأساسيات، يمكنك الانتقال إلى تطوير إضافات أكثر تعقيدًا تضيف قيمة لمواقع ووردبريس الخاصة بك أو للعملاء. تطوير إضافات ووردبريس يمكن أن يكون ممتعًا ومجزيًا، حيث يتيح لك تخصيص وتحسين مواقعك بشكل كبير. بالتوفيق في رحلتك التطويرية!