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

همانند مسیرهای محلی سرور که دارای توابعی برای تعیین مسیر آنها بودند ، مسیرهای URL نیز دارای توابعی هستند که در این مطلب به آنها خواهیم پرداخت .

تابع plugin_url() : این تابع URL کامل دایرکتوری افزونه ها را برمی گرداند .

http://example.com/wp-content/plugins

تابع includes_url() : این تابع URL کامل دایرکتوری includes را بر می گرداند .

http://example.com/wp-includes

تابع content_url() : این تابع URL کامل دایرکتوری content را بر می گرداند .

http://example.com/wp-content

تابع admin_url() : این تابع URL بخش مدیریت را بر می گرداند .

http://example.com/wp-admin

تابع site_url() : این تابع URL سایت جاری را برمی گرداند .

http://example.com

تابع home_url() : این تابع  URL صفحه خانه وردپرس را بر می گرداند .

http://example.com

دقت داشته باشید که تابع site_url() به آدرس وردپرس و تابع home_url() به آدرس سایت اشاره می کنند . این دو تابع در حالت استاندارد یک آدرس را برمی گردانند ، اما با تغییر مسیر پوشه های وردپرس ، آدرس های برگردانده شده توسط این توابع متفاوت خواهند بود .

در منوی تنظیمات / عمومی وردپرس دو تنظیم با نام های ” نشانی وردپرس (URL) ”  و  ” نشانی سایت (URL) ” وجود دارد . تنظیم ” نشانی وردپرس ” محل فایل های هسته وردپرس و تنظیم ” نشانی سایت ” آدرس اصلی سایت وردپرسی شماست .

به عنوان مثال فرض کنید که بخواهید وردپرس را در یک زیردایرکتوری به نام wordpress نصب کنید . در این حالت تابع site_url()  به فایل های هسته وردپرس یعنی آدرس http://example.com/wordpress اشاره خواهند کرد (تنظیم نشانی وردپرس) . این در حالی است که شما می خواهید آدرس سایت شما برای بازدیدکنندگان سایت متفاوت باشد و بر همین اساس در تنظیم نشانی سایت آدرس http://example.com  را وارد می کنید و تابع home_url() نیز همین آدرس را بر می گرداند ( تنظیم نشانی سایت ) .

بهترین دوست شما در هنگام ایجاد و توسعه افزونه های وردپرس تابع plugins_url() است که بیشترین استفاده را از آن خواهید داشت .

توسط این تابع شما می توانید به آسانی URL کامل هر فایلی در دایرکتوری افزونه را تعیین کنید .

پارامتر $path مسیر نسبی ، نسبت به URL افزونه – این پارامتر اختیاری می باشد .

پارامتر $plugin فایل افزونه ای که شما می خواهید آدرس نسبت به آن برگشت داده شود – این پارامتر اختیاری می باشد .

به عنوان مثال فرض کنید شما می خواهید از یک تصویر برای آیکن افزونه خود استفاده کنید . شما می توانید به سادگی و توسط کدی مانند زیر اینکار را انجام دهید :

در دستور بالا ، پارامتر اول در تابع plugins_url مسیر نسبی فایل تصویر مورد نظر و پارامتر دوم فایلی است که مسیر نسبی نسبت به آن محاسبه می شود .

نتیجه کد بالا را در بخش زیر مشاهده می کنید :

<img src=”http://example.com/wp-content/plugins/my-custom-plugin/images/icon.png” >

در اینجا برخی ویژگی های تابع plugins_url()  برای تعیین URL های افزونه را با هم مرور می کنیم :

  • پشتیبانی از دایرکتوری افزونه mu-plugins
  • شناسایی اتوماتیک SSL – بنابراین اگر SSL فعال باشد آدرس URL برگشتی شامل https خواهد بود .
  • با استفاده از ثابت WP_PLUGIN_URL می توان موقعیت افزونه را حتی زمانی که کاربر پوشه plugins را جابجا کرده باشد را تعیین کرد .
  • پشتیبانی از وردپرس چند سایته بوسیله ثابت WPMU_PLUGIN_URL
تعیین مسیر به صورت محلی در افزونه وردپرستابع فعال سازی افزونه وردپرس
پیشنهاد می کنیم برای دریافت آخرین مطالب کانال تلگرام کانی تمزرا دنبال کنید .