پرش به محتوای اصلی
وردپرس

چگونه یک Plugin اختصاصی برای وردپرس بسازیم؟

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

تصویر مفهومی: چگونه یک Plugin اختصاصی برای وردپرس بسازیم؟
فهرست مطالب
  1. قابلیت را از پوسته جدا کنید
  2. حداقل ساختار قابل نصب
  3. ورودی، خروجی و اجازه
  4. فعال‌سازی، حذف و تنظیم
  5. مسیر ساخت تا نصب روی سایت
  6. اشتباه‌هایی که افزونهٔ اختصاصی را ناامن یا شکننده می‌کند
  7. سوالات متداول
  8. منطق را در قالب بگذاریم راحت‌تر نیست؟
  9. تنظیمات را کجا ذخیره کنیم؟
  10. آیا افزونه باید خودش سبک و اسکریپت بیاورد؟
  11. چطور بفهمیم افزونه آمادهٔ تحویل است؟
  12. ادامه مسیر
  13. جمع‌بندی

افزونهٔ اختصاصی وردپرس بسته‌ای است که یک قابلیت مشخص سایت را خارج از پوسته نگه می‌دارد تا با عوض شدن ظاهر، همان قابلیت بماند. ساختنش از یک پوشه، یک شناسنامه و اتصال به هوک شروع می‌شود نه از کپی کردن یک افزونهٔ بزرگ. هر ورودی کاربر باید در سرور سنجیده شود، هر خروجی در صفحه فرار شود و هر عمل مدیریتی به نقش مجاز و نشان امنیتی فرم وصل باشد. افزونه‌ای که فقط در ظاهر مدیر کار می‌کند و این سه را ندارد، قابلیت نیست؛ روزنه است.

قابلیت را از پوسته جدا کنید

اگر رفتار با تعویض قالب هنوز لازم است، جایش افزونه است: نوع نوشته، فرم سازمانی، قاعدهٔ قیمت یا ستون مدیریت. پوسته فقط باید همان داده را نشان دهد.

محدوده را در یک جمله بنویسید. افزونه‌ای که هم‌زمان ظاهر کل سایت، سئو و پرداخت را دست می‌زند، قابل آزمون و قابل حذف نیست. یک قابلیت، یک پوشه.

کد PHP روی صفحه ویرایشگر کد
کد PHP روی صفحه ویرایشگر کد — عکس: lmonk72، مجوز CC0، ویکی‌مدیا کامنز

حداقل ساختار قابل نصب

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

نام تابع، گزینه و جدول را با همان پیشوند شروع کنید. بدون پیشوند، با افزونهٔ دیگر تداخل می‌گیرید و خطا فقط روی بعضی نصب‌ها ظاهر می‌شود.

ورودی، خروجی و اجازه

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

عمل مدیر باید دو شرط داشته باشد: کاربر همان نقش را دارد، و فرم نشان معتبر همان عملیات را آورده است. یکی از این دو به‌تنهایی کافی نیست، چون نشانی را می‌شود از بیرون هم صدا زد.

فعال‌سازی، حذف و تنظیم

اگر افزونه جدول یا نقش تازه لازم دارد، ساختنش را به لحظهٔ فعال‌سازی محدود کنید و در نسخه‌های بعد، ارتقای همان جدول را جدا بنویسید. فعال‌سازی جای مناسب اجرای هر بارِ درخواست نیست.

حذف افزونه نباید بی‌خبر محتوای سایت را پاک کند. اگر داده را پاک می‌کنید، این رفتار را در توضیح افزونه بنویسید و مسیر حذف را از غیرفعال کردن جدا کنید. غیرفعال یعنی توقف موقت، نه نابودی داده.

مسیر ساخت تا نصب روی سایت

  1. قابلیت را در یک جمله بنویسید و تأیید کنید که نباید با تعویض پوسته از بین برود.
  2. پوشه و شناسنامه را با پیشوند یکتا بسازید و کد را به هوک مناسب وصل کنید.
  3. ذخیره را تمیز کنید، خروجی را فرار کنید و عمل مدیر را به نقش و نشان فرم محدود کنید.
  4. ساخت جدول یا نقش را فقط در فعال‌سازی انجام دهید و رفتار حذف داده را صریح کنید.
  5. افزونه را روی پوستهٔ پیش‌فرض، با کاربر مدیر و با کاربر عادی، جداگانه آزمون کنید.

اشتباه‌هایی که افزونهٔ اختصاصی را ناامن یا شکننده می‌کند

  • نوشتن قابلیت داخل پوسته چون مسیر فایل کوتاه‌تر است.
  • پذیرفتن و چاپ کردن ورودی فرم بدون تمیز کردن و بدون فرار کردن.
  • اجرای عمل حساس فقط با شناخت نشانی، بدون نقش کاربر و بدون نشان فرم.
  • پاک کردن محتوای سایت هنگام غیرفعال کردن افزونه.
ویدیوی مرتبط: آموزش ساخت افزونه وردپرس مدیریت کاربران تاکس جلسه اول (منبع: آپارات)

سوالات متداول

منطق را در قالب بگذاریم راحت‌تر نیست؟

برای یک اصلاح ظاهری بله. برای قابلیت، قالب راحتِ امروز تعویض پوستهٔ فردا را گران می‌کند. اگر مشتری پوسته را عوض کند و فرم سازمانی گم شود، انتخاب محل کد اشتباه بوده است.

تنظیمات را کجا ذخیره کنیم؟

در گزینهٔ وردپرس یا جدول خودتان اگر ساختار واقعاً رابطه‌ای است. ذخیره در پروندهٔ افزونه با هر به‌روزرسانی و با چند سرور، ناپایدار است.

آیا افزونه باید خودش سبک و اسکریپت بیاورد؟

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

چطور بفهمیم افزونه آمادهٔ تحویل است؟

فعال و غیرفعال می‌شود، با کاربر بدون اجازه کار حساس را انجام نمی‌دهد، ورودی نادرست را رد می‌کند، و با پوستهٔ پیش‌فرض هم رفتارش می‌ماند. بدون این چهار مورد تحویل ندهید.

ادامه مسیر

این موضوع به صفحات و مقاله‌های زیر وصل است. لینک‌ها برای تصمیم بعدی است، نه فهرست تزئینی.

جمع‌بندی

افزونهٔ اختصاصی یک قابلیت را با نام یکتا، هوک، سنجش ورودی و اجازهٔ مشخص خارج از پوسته نگه می‌دارد. فعال‌سازی جای ساخت ساختار است و حذف باید دربارهٔ سرنوشت داده صریح باشد.

برای بررسی همین موضوع روی پروژهٔ خودتان، از مشاوره و برآورد پروژه در ایلیاوب استفاده کنید. برآورد بعد از دیدن محدودهٔ کار، محتوا و یکپارچه‌سازی انجام می‌شود.

ایلیا محمدی

ایلیا محمدی

معمار وب و بنیان‌گذار ایلیاوب

معمار وب و مشاور فنی پروژه‌های دیجیتال.

مشاوره رایگان واتساپ