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

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

وقتی می‌خواهیم یک پلاگین وردپرس بسازیم، اولین قدم این است که یک پوشه مخصوص برای آن درست کنیم. وردپرس پلاگین‌ها را از داخل یک پوشه مشخص در مسیر نصب وردپرس پیدا می‌کند. این مسیر به‌صورت پیش‌فرض به این شکل است:

wp-content/plugins/

یعنی همه‌ی پلاگین‌های وردپرس داخل پوشه‌ی plugins قرار می‌گیرند که خودش داخل پوشه‌ی wp-content است. برای اینکه وردپرس بتواند پلاگین ما را بشناسد، باید یک پوشه‌ی جداگانه برای پلاگین خودمان در این مسیر ایجاد کنیم.

برای ساخت پوشه‌ی پلاگین، این مراحل را انجام می‌دهیم:

اول در فایل‌منیجر یا محیط ویرایش‌گر آنلاین خود، مسیر wp-content/plugins/ را باز می‌کنیم. در این مسیر، پوشه‌های زیادی می‌بینیم که هر کدام مربوط به یک پلاگین نصب‌شده روی وردپرس است.

سپس یک پوشه‌ی جدید با یک نام منحصربه‌فرد ایجاد می‌کنیم. نام این پوشه بهتر است بدون فاصله، فقط با حروف کوچک انگلیسی و در صورت نیاز با خط تیره یا زیرخط نوشته شود. مثلاً اگر می‌خواهیم پلاگینی بسازیم که یک پیام خوش‌آمدگویی نمایش دهد، می‌توانیم نام پوشه را این‌طور انتخاب کنیم:

hello-message

یا

my_first_plugin

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

نکته‌ی مهم این است که نام پوشه باید یکتا باشد. یعنی نباید پوشه‌ای با همان نام از قبل در مسیر plugins وجود داشته باشد. اگر پوشه‌ای با همان نام وجود داشته باشد، وردپرس ممکن است دچار سردرگمی شود یا پلاگین‌ها با هم تداخل پیدا کنند. پس پیش از ساخت پوشه، مطمئن شوید که چنین نامی قبلاً استفاده نشده است.

بعد از ساخت پوشه، وردپرس هنوز آن را به‌عنوان یک پلاگین نمی‌شناسد. در واقع، خود پوشه به تنهایی کافی نیست. وردپرس برای تشخیص یک پلاگین، به دنبال یک فایل اصلی با پسوند .php می‌گردد که داخل پوشه‌ی پلاگین قرار دارد و داخل آن یک سری اطلاعات خاص نوشته شده است. این فایل اصلی معمولاً هم‌نام با پوشه انتخاب می‌شود، اما الزامی به این کار نیست.

مثلاً اگر پوشه‌ی پلاگین را با نام hello-message ساختیم، می‌توانیم فایل اصلی را با نام hello-message.php درست کنیم. این فایل همان نقطه‌ی شروع پلاگین ما خواهد بود.

در نهایت، ساختار اولیه‌ی پوشه‌ی پلاگین ما به این شکل خواهد بود:

wp-content/
└── plugins/
    └── hello-message/
        └── hello-message.php

در بخش‌های بعدی، محتوای داخل این فایل اصلی را بررسی می‌کنیم و یاد می‌گیریم چطور اطلاعات پلاگین را داخل آن بنویسیم تا وردپرس بتواند آن را شناسایی و فعال کند.