آموزش ساخت پلاگین برای وردپرس با PHP

ساخت پلاگین برای وردپرس یکی از بهترین روش‌ها برای افزودن امکانات سفارشی به سایت است و با یادگیری آن می‌توان وارد دنیای توسعه حرفه‌ای با PHP و WordPress شد. در ادامه، به‌صورت رسمی و گام‌به‌گام، آموزش ساخت یک پلاگین ساده اما استاندارد را ارائه می‌دهم:

پیش‌نیازها

  • آشنایی پایه با زبان PHP

  • آشنایی با ساختار فایل‌ها و پوشه‌های وردپرس

  • نصب وردپرس محلی (با ابزارهایی مثل XAMPP یا LocalWP)

گام ۱: ساخت پوشه پلاگین

۱. به مسیر زیر در وردپرس بروید:

wp-content/plugins/

۲. یک پوشه جدید بسازید، مثلاً:

my-custom-plugin

گام ۲: ایجاد فایل اصلی پلاگین

درون پوشه بالا، یک فایل با پسوند .php بسازید، مثلاً:

my-custom-plugin.php

درون آن، اطلاعات اولیه پلاگین را بنویسید:

/*
Plugin Name: My Custom Plugin
Description: یک پلاگین ساده برای نمایش پیام در پایین هر پست
Version: 1.0
Author: نام شما
*/

گام ۳: افزودن عملکرد اولیه (مثلاً افزودن پیام به انتهای مطالب)

function my_custom_footer_message($content) {
    if (is_single()) {
        $content .= '<p style="color: green; font-weight: bold;">از بازدید شما سپاسگزاریم!</p>';
    }
    return $content;
}
add_filter('the_content', 'my_custom_footer_message');

این کد بررسی می‌کند اگر صفحه‌ی تکی پست بود (is_single())، در پایان محتوای آن یک پیام اضافه کند.

گام ۴: فعال‌سازی پلاگین

وارد پیشخوان وردپرس شوید:

افزونه‌ها ← افزونه‌های نصب‌شده
پلاگین شما با عنوان "My Custom Plugin" ظاهر می‌شود → روی فعال‌سازی کلیک کنید.

گام ۵: افزودن فایل CSS یا JS (اختیاری)

برای اضافه کردن فایل CSS به پلاگین:

function my_plugin_assets() {
    wp_enqueue_style('my-plugin-style', plugin_dir_url(__FILE__) . 'style.css');
}
add_action('wp_enqueue_scripts', 'my_plugin_assets');

فایل style.css را در پوشه پلاگین بسازید.

ساختار نهایی پلاگین

my-custom-plugin/
├── my-custom-plugin.php
└── style.css (اختیاری)

نکات حرفه‌ای برای توسعه پلاگین

  • از plugin_dir_path(__FILE__) و plugin_dir_url(__FILE__) برای مسیرها استفاده کنید

  • پلاگین‌ها را ایمن بنویسید (بررسی دسترسی‌ها و ورودی‌ها)

  • از توابع اکشن و فیلتر وردپرس برای تعامل با هسته استفاده کنید

  • در صورت نیاز از پنل تنظیمات پلاگین استفاده کنید (با تابع add_options_page)

اگر بخوای، می‌تونم گام‌به‌گام باهات یک پلاگین کاربردی حرفه‌ای‌تر بسازم، مثلاً:

  • پلاگین فرم تماس با ذخیره داده‌ها در دیتابیس

  • پلاگین شمارنده بازدید

  • پلاگین ارسال ایمیل خودکار