دوره های آموزشی آکادمی پی وی لرن (پروژه محور و ویژه بازار کار)



  • ۴
  • شهریور

جلسه ۰۲ : آشنایی با اصول اولیه پلاگین نویسی وردپرس

  • دسته‌بندی‌ها :
جلسه ۰۲ : آشنایی با اصول اولیه پلاگین نویسی وردپرس
    • جزئیات
    • نوع محتواآموزشی

      مقدمه

      با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
      به ” دوره متخصص وردپرس ” خوش آمدید!
      در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
      فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
      در جلسه پیش با ماهیت و کارکرد پلاگین آشنا شدیم و آموختیم که پلاگین چیست و چه استفاده ای دارد.
      در این جلسه آشنایی با اصول اولیه پلاگین نویسی وردپرس را به علاقمندان این دوره ارائه می نماییم.

      اصول اولیه پلاگین نویسی وردپرس

      در ساده ترین شکل ممکن، پلاگین وردپرس یک فایل PHP با یک کامنت هدر پلاگین است.
      اولین اصل از اصول اولیه پلاگین نویسی وردپرس این است که یک دایرکتوری ایجاد کنید تا تمامی فایل های پلاگین خود را به صورت منظم در آن نگه دارید.

      ” اصول اولیه پلاگین نویسی وردپرس ” را با یک فرآیند چند مرحله ای آغاز می کنیم.
      برای ایجاد یک افزونه جدید، مراحل زیر را دنبال نمایید:

      ۱ – به دایرکتوری wp-content وردپرس بروید.
      ۲ – دایرکتوری پلاگین plugins directory را باز کنید.
      ۳ – یک دایرکتوری جدید ایجاد نمایید و آن را بعد از پلاگین نام گذاری کنید (برای مثال plugin-name)
      ۴ – دایرکتوری پلاگین جدید را باز نمایید.
      ۵ – یک فایل PHP جدید بسازید (بهتر است این فایل را بعد از پلاگین تان نام گذاری کنید. plugin-name.php)

      در ادامه می توانید خط دستور Unix را ببینید:

      مثال : 

      در مثال بالا، “vi” نام ویرایشگر متن است.
      از هر ویرایشگری که با آن راحترید استفاده نمایید.

      حالا که PHP پلاگین جدید را ویرایش می کنید؛ باید یک plugin header comment اضافه نمایید.
      plugin header comment متشکل از فیلد خاص PHP است که شامل متادیتاهایی مانند نام، نویسنده، نسخه، مجوز و غیره است.
      plugin header comment با الزامات هدر مطابقت داشته باشد و حداقل شامل نام پلاگین باشد.
      اگر افزونه دارای چند فایل PHP است؛ فقط یک header comment باید در فایل پلاگین وجود داشته باشد.

      مثال : 

      بعد از ذخیره فایل، بهتر است بهتر است یک بار آن را در سایت وردپرس بازبینی نمایید.
      به سایت وردپرسی خود وارد شوید و در قسمت ناوبری سمت چپ Admin وردپرس خود بر روی Plugins کلیک کنید.
      این صفحه یک لیست از تمام افزونه های سایت وردپرسی شما را نمایش می دهد.
      افزونه جدید شما باید در این بخش لیست شده باشد.
      دومین اصل در اصول اولیه پلاگین نویسی وردپرس Hooks یا قلاب ها هستند.

      قلاب ها: اکشن ها و فیلترها

      قلاب های وردپرس به شما این امکان را می دهد که در موارد خاص به وردپرس ضربه بزنید تا موجب بدون ویرایش فایل اصلی وردپرس رفتار آن را تغییر دهید.

      در نوع قلاب در وردپرس وجود دارد:

      • اکشن actions
      • فیلتر filters

      قلاب فیلتر به شما اجازه می دهد که محتوا را در حین بارگذاری ویرایش کرده و به کاربران سایت نمایش دهید.

      Hooks یا قلاب ها تنها مختص متخصصان پلاگین ها نیستند و از آن ها به صورت گسترده ای برای ایجاد قابلیت های پیش فرض هشته وردپرس استفاده می شود.

      قلاب های اصلی برای ایجاد یک پلاگین

      برای ایجاد یک افزونه نیاز به سه قلاب اصلی دارید:

      • () register_activation_hook
      • ()register_deactivation_hook
      • () register_uninstall_hook

      activation hook وقتی پلاگین تان را فعال کنید اجرا می شود.
      از این پلاگین باید استفاده کنید تا یک تابع برای نصب پلاگین تان فراهم کنید.
      برای مثال ایجاد تنظیمات پیش فرض در optionstable.

      deactivation hook وقتی پلاگین تان را غیر فعال کنید اجرا می شود.
      از این پلاگین باید استفاده کنید تا یک تابع برای پاک کردن اطلاعات موقت ذخیره شده پلاگین تان، فراهم نمایید.

      از uninstall methods زمانی استفاده می شود که پلاگین تان را از طریق Admin وردپرس حذف نمایید.
      شما نیز می توانید از این پلاگین برای حذف همه داده های ایجاد شده توسط پلاگین خود، از جمله هر گزینه ای که به جدول اضافه شده؛ استفاده نمایید.

      افزودن قلاب ها Hooks

      می توانید قلاب سفارشی شده خود را با کمک تابع () do_action، که به توسعه دهندگان اجازه گسترش پلاگین ها را می دهد؛ اضافه نمایید.
      این تابع، اجازه گسترش پلاگین ها را از طریق عبور توابع از قلاب ها تان می دهد.

      حذف قلاب ها

      از تابع ()invoke remove_action برای حذف تابع قبلی (که با آن به افزودن قلاب پرداختیم) استفاده نمایید.
      برای مثال اگر پلاگین شما افزوده شده به پلاگین دیگریست می توانید از ()remove_action با تابع فراخوان مشابه که توسط پلاگین قلبی و با ()add_action افزوده شده؛ استفاده نمایید.
      توجه کنید که اولویت انجام این اقدامات خیلی مهم است. زیرا ()remove_action پس از ()add_action اولیه باید اجرا شود.

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

      در جلسات بعدی این دوره مطالب کامل تری در خصوص ساخت قلاب ها و کار با آن ها را خواهید آموخت.

      API های وردپرس

      می دانستید وردپرس شماری از رابط برنامه نویسی کاربردی یا Application Programming Interfaces (به اختصار API) را فراهم می کند؟
      اگر نمی دانید که API چیست و چه کاربردی دارد به طور اختصار باید بگویم :
      API ها می توانند تا حد زیادی کد شما را در پلاگین های خود بنویسند و این یعنی دیگر لازم نیست چرخ را دوباره اختراع کنید! چون قبل از شما افراد زیادی راه شما را رفته و نتایج کارشان را با تواضع در اختیارتان می گذارند و شما کافیست آن ها تست کنید!

      API ها، باعث می شود ذخیره داده ها در پایگاه داده برای پلاگین تان آسان باشد.
      اگر به استفاده از CURL در پلاگین تان فکر می کنید؛ API HTTP ممکن است برای تان خیلی مفید باشد.

      از آن جا که بحث ما در مورد اصول اولیه پلاگین نویسی وردپرس است و نه API پس بهتر است بحث را به سمت API Plugin بکشانیم.
      API Plugin توابع مختلفی دارد که می تواند در توسعه پلاگین ها، کمک شایانی باشد.

      وردپرس چگونه پلاگین ها را بارگیری می کند؟

      وقتی وردپرس لیست پلاگین های نصب شده را در صفحه Plugins WordPress Admin بارگذاری می کند؛ از طریق پوشه پلاگین (و زیر پوشه های آن) جستجو کرده تا فایل php را به همراه plugin header comments وردپرس بیابد.

      اگر کل پلاگین شما تنها شامل یک فایل PHP است، مانند Hello Dolly، این فایل می تواند به طور مستقیم در داخل ریشه پوشه پلاگین قرار گیرد.
      اما به طور معمول، فایل های افزونه در پوشه خود، پس از پلاگین نام گذاری می شوند.

      به اشتراک گذاری پلاگین ساخته خودتان

      گاهی ممکن است افزونه ای که می سازید مختص خود شما و رفع نیاز سایت شما باشد.
      اما اغلب افراد دوست دارند پلاگینی را که ساخته اند با همه کسانی که در جامعه وردپرس حضور دارند به اشتراک بگذارند.
      پیش از آن پلاگین ساخته خود را با دیگران به اشتراک بگذارید باید برای آن یک لایسنس license یا مجوز انتخاب نمایید.
      این کار به کاربران پلاگین شما کمک می کند تا بدانند آیا مجاز به استفاده از کد پلاگین تان، هستند یا خیر.
      توصیه می کنم برای سازگاری بیشتر با هسته وردپرس، لاسینسی را انتخاب کنید که با مجوز GNU و یا
      (+General Public License (GPLv2 کار می کند.

      کلام آخر

      در این جلسه به تفصیل با اولیه پلاگین نویسی وردپرس آشنا شدیم.
      در جلسات بعدی هر یک از موارد اشاره شده را باز هم موشکافانه تر مورد بررسی و یادگیری قرار می دهیم.
      جلسه بعدی را به آموزش تنظیمات هدر پلاگین می پردازیم.
      با پی وی لرن همراه باشید.

      QR:  جلسه ۰۲ : آشنایی با اصول اولیه پلاگین نویسی وردپرس
      به اشتراک بگذارید