آشنایی با wp_enqueue در وردپرس و نحوه استفاده از آن

اگر فایل header یا footer یک پوسته وردپرسی را مشاهده کرده باشید، حتما توابع wp_head() و wp_footer() را دیده‌اید. این توابع برای فراخوانی اسکریپت‌ها و استایل‌های یک پوسته به صورت پویا کاربرد دارند و به طراحان پوسته و توسعه دهندگان افزونه‌های وردپرس اجازه اتصال فایل‌های مورد نیاز برای اجرای پوسته و افزونه‌های مختلف از طریق تابع wp_enqueue یا به صورت دقیق تر wp_enqueue_script() و wp_enqueue_style() را می‌دهد. دو تابع ذکر شده به ترتیب برای اتصال فایل‌های جاوا اسکریپت و استایل مورد استفاده قرار می‌گیرند و شامل چند پارامتر‌ می‌شوند که برای تعیین نسخه و انتخاب مکان فراخوانی آن‌ها مورد استفاده قرار می‌گیرد.

wp_enqueue

تابع  wp_enqueu به طور کلی شامل پارامتر‌های زیر می شود:

  • $handle

این پارامتر نام اسکریپت را تعیین می کند.

  • $src

از طریق این پارامتر آدرس فایل مورد نظر جهت فراخوانی مشخص می‌شود.

  • $deps

این پارامتر که بوسیله یک آرایه مشخص می‌شود پیشنیاز‌های اسکریپت مورد نظر را مشخص می‌کند.

  • $ver

این پارامتر ورژن یا نسخه اسکریپت را مشخص می‌کند.

  • $in_footer

این پارامتر که از جنس bool  یا شرطی است مکان فراخوانی اسکریپت را مشخص می‌کند. اگر مقدار آن روی true تنظیم شود اسکریپت در فوتر پوسته (از طریق تابع wp_footer()) فراخوانی می شود؛ اگر مقدار برابر false باشد اسکریپت در header و توسط تابع wp_header() فراخوانی می‌شود.

مثال:

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

اگر اسکریپت مورد نظر در کتابخانه وردپرس موجود باشد نحوه فراخوانی به صورت زیر است:

در صورتی که در یک پوسته اسکریپت مورد نظر لازم باشد پس از یک اسکریپت خاص فراخوانی شود کدی مشابه کد زیر خواهد داشت:

برای فراخوانی اسکریپت به همین صورت، برای یک افزونه:

و در نهایت نحوه فراخوانی یک اسکریپت در صفحه تنظیمات افزونه:

نکته: توابع  wp_enqueue باید در فایل functions.php مورد استفاده قرار گیرند.

فیسبوک توییتر گوگل + لینکداین تلگرام واتس اپ کلوب