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

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

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

كيفية إنشاء إضافة ووردبريس بنفسك: الفهم قبل الكود

قبل كتابة أي سطر كود، يجب أن تفهم حقيقة مهمة جدًا:
إضافة ووردبريس ليست برنامجًا معقدًا، بل ملف (أو مجموعة ملفات) تُعرّف ووردبريس بوظيفة جديدة.

أي إضافة، مهما كانت كبيرة، تبدأ من:

• مجلد
• ملف PHP واحد
• ترويسة تعريف بسيطة

كل ما بعد ذلك تطوير تدريجي.

الخطوة الأولى: تحديد وظيفة الإضافة بوضوح

أكبر خطأ يقع فيه المبتدئون هو:

“لننشئ إضافة ثم نرى ماذا نفعل بها”

الصحيح هو العكس.

اسأل نفسك:

• ما المشكلة التي أريد حلها؟
• هل الإضافة للزوار أم للإدارة؟
• هل ستعمل عبر شورت كود؟ صفحة؟ إعدادات؟

أمثلة:

• أداة فحص (دومين – سرعة – SEO)
• صندوق تنبيه
• شورت كود مخصص
• صفحة إعدادات داخل لوحة التحكم

كلما كانت الوظيفة محددة، كان التنفيذ أسهل وأنجح.

اقرأ أيضا : أداة فحص الدومين أثورتي (Domain Authority): دليلك الشامل لقياس قوة موقعك

الخطوة الثانية: إنشاء مجلد الإضافة في المكان الصحيح

ادخل إلى المسار التالي في الاستضافة:

public_html/wp-content/plugins/

أنشئ مجلدًا جديدًا باسم واضح، مثل:

my-first-plugin

اسم المجلد مهم:

• استخدم أحرفًا صغيرة
• بدون مسافات
• بدون رموز

الخطوة الثالثة: إنشاء ملف الإضافة الأساسي

داخل المجلد، أنشئ ملف PHP بنفس اسم المجلد:

my-first-plugin.php

ثم ضع بداخله ترويسة الإضافة، وهي ما يتعرف عليه ووردبريس:

<?php
/*
Plugin Name: My First Plugin
Description: إضافة ووردبريس مخصصة تم إنشاؤها يدويًا.
Version: 1.0
Author: Mubarak
*/

⚠️ بدون هذه الترويسة، لن تظهر الإضافة في لوحة التحكم.

بعد حفظ الملف:

• اذهب إلى لوحة تحكم ووردبريس
• الإضافات
• ستجد الإضافة جاهزة للتفعيل

الخطوة الرابعة: إضافة وظيفة بسيطة (اختبار فعلي)

لنبدأ بشيء عملي:
إنشاء شورت كود يعرض نصًا.

أضف داخل نفس الملف:

function my_first_plugin_shortcode() {
    return '<div>هذه أول إضافة ووردبريس أنشأتها بنفسي</div>';
}
add_shortcode('my_plugin', 'my_first_plugin_shortcode');

الآن:

• فعّل الإضافة
• ضع هذا الشورت كود داخل أي مقالة أو صفحة:

[my_plugin]

إذا ظهر النص، فالإضافة تعمل فعليًا.

الخطوة الخامسة: تنظيم الكود باحتراف

مع تطور الإضافة، لا تضع كل شيء في ملف واحد.

الهيكل الأفضل يكون مثل:

my-first-plugin/
│
├── my-first-plugin.php
├── assets/
│   ├── css/
│   └── js/
├── includes/
│   └── functions.php

ثم تستدعي الملفات من الملف الرئيسي:

require_once plugin_dir_path(__FILE__) . 'includes/functions.php';

هذا التنظيم:

• يسهل الصيانة
• يمنع التعارض
• يجعل الإضافة قابلة للتطوير

الخطوة السادسة: إضافة CSS و JavaScript بشكل صحيح

لا تضع الأكواد عشوائيًا في الهيدر أو الفوتر.

الطريقة الصحيحة داخل الإضافة:

function my_plugin_assets() {
    wp_enqueue_style(
        'my-plugin-style',
        plugin_dir_url(__FILE__) . 'assets/css/style.css'
    );

    wp_enqueue_script(
        'my-plugin-script',
        plugin_dir_url(__FILE__) . 'assets/js/script.js',
        array('jquery'),
        null,
        true
    );
}
add_action('wp_enqueue_scripts', 'my_plugin_assets');

بهذا:

• لا تكسر القالب
• لا تسبب تعارضًا
• تحافظ على أداء الموقع

الخطوة السابعة: متى تحتاج PHP فقط؟ ومتى تحتاج JavaScript؟

• PHP: منطق، حسابات، جلب بيانات، شورت كود
• JavaScript: تفاعل المستخدم، أزرار، تحميل بدون تحديث
• CSS: الشكل فقط

قاعدة ذهبية:

لا تكتب JavaScript إذا كان PHP يكفي
ولا تكتب PHP إذا كان JavaScript هو الحل الأنسب

الخطوة الثامنة: اختبار الإضافة بطريقة صحيحة

قبل الاعتماد عليها:

• جرّبها مع قالب آخر
• عطّل إضافات أخرى مؤقتًا
• راقب الأخطاء (debug)

لا تعتمد على:

“اشتغلت مرة وخلاص”

الإضافات الجيدة تُختبر في ظروف مختلفة.

أخطاء شائعة يجب تجنبها

• وضع الكود داخل محرر HTML بدل الإضافة
• الاعتماد على إضافات إدخال أكواد بدل ملف مخصص
• عدم استخدام أسماء فريدة للدوال
• نسيان حماية المدخلات (خصوصًا في الأدوات)

لماذا إنشاء إضافة بنفسك أفضل من الاعتماد على إضافات جاهزة؟

• تحكم كامل
• أداء أفضل
• أمان أعلى
• لا اشتراكات مفاجئة
• لا توقف مفاجئ للخدمة

والأهم:
تفهم ماذا يحدث داخل موقعك فعلًا.

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

الفرق بين موقع عادي وموقع احترافي غالبًا لا يكون في القالب… بل في الأدوات المخصصة التي بُنيت خصيصًا له.

الأسئلة الشائعة (FAQ)

هل أحتاج خبرة برمجية كبيرة لإنشاء إضافة؟

لا. الأساسيات كافية للبدء، والخبرة تأتي بالممارسة.

هل يمكن أن تكسر الإضافة موقعي؟

نعم، إذا كُتبت بشكل خاطئ. لذلك الاختبار مهم.

هل يمكن تحويل الإضافة إلى منتج مدفوع؟

نعم، وبسهولة إذا بُنيت بهيكل صحيح من البداية.

هل الإضافات المخصصة أفضل من الجاهزة؟

في الوظائف المحددة: نعم.
في الوظائف العامة: يعتمد على الهدف.