wp_enqueue در وردپرس،قسمت اول

سلام دوستان عزیز وقت شما بخیر
در ادامه آموزش های وردپرس در این سری از آموزش ها در خدمت شما عزیزان هستیم با آموزش یکی ار کاربردی ترین توابع در وب سایت وردپرسی که شاید شما نیز به این آموزش نیاز داشته باشید و برای شما نیز مفید باشد.پس تا انتها با من همراه باشید با قسمت اول آموزش wp_enqueue در وردپرس .

در این اموزش وردپرس به معرفی تابع کاربردی wp_enqueue در وردپرس میپردازیم و تمامی موارد موجود در این مورد را بررسی میکنیم.دوستان عزیز کار این تابع در واقع رجیستر کردن فایل های css و js در وب سایت وردپرسی می باشد.این تابع در وب سایت های وردپرسی بیشتر در مواردی از قبیل ساخت افزونه وردپرس و ساخت شورت کد وردپرس استفاده میشود. برای مثالی برای درک بهتر این موضوع فرض کنید که افزونه وردپرس عضویت در خبرنامه برای وب سایت های وردپرسی می نویسید. اگر بخواهید به این افزونه ای که در حال نوشتن ان هستید استایل مشخصی بدهید می بایست در کدهای خود از تابع wp_enqueue استفاده کنید.

پس شروع کنیم.
شکل اصلی این تابع به صورت زیر است:

<?php wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer ); ?>
<?php wp_enqueue_style( $handle, $src, $deps, $ver, $in_footer ); ?>

اما بپردازیم به معرفی پارامتر های استفاده شده در این تابع وردپرس.
اولین پارامتری که به بررسی آن در وب سایت های وردپرس میپردازیم $handle است دوستان عزیز وارد کردن این پارامتر اجباری است. این پارامتر شامل نام اسکریپت یا استایل در این تابع است و همچنین این پارامتر مقدار پیشفرض ندارد و نوع پارامتر از نوع رشته ای می باشد

پارامتر دومی که وجود دارد پارامتر $src میباشد این پارامتر آدرس لینک فایل اسکریپت با استایل را ذخیره می کند و از نوع پارامتر اختیاری است.دوستان عزیز توجه کنید که نوع پارامتر از نوع رشته ای می باشد. مثلا: http://example.com/wp-content/themes/my-theme/my-theme-script.js
حال در ادامه مواردی که وجود دارد اگر می خواهید آدرس فایل های یک افزونه وردپرس را اینجا قرار دهید از تابع plugins_url() و اگر می خواهید فایل ها را از پوسته وردپرس وب سایت وردپرسی خود فراخوانی کنید از تابع get_template_directory_uri() استفاده کنید.

برای مثال به کد زیر توجه کنید:

<img src="' . plugins_url( 'images/wordpress.png' , __FILE__ ) . '" >;
<img src="' get_template_directory_uri() . '/i,ages/bigtheme.png'">;

مورد بعدی که در این زمینه وجود دارد پارامتر $deps است دوستان عزیز این پارامتر اختیاری است و نوع آن آرایه می باشد. این پارامتر شامل آرایه ای از نام فایل های رجیستر شده است و با استفاده از این پارامتر می گویید که این فایل را به فایل های قبلی که نامشان را در این پارامتر به صورت آرایه قرار داده اید اضافه کنید. در این حالت فایل هایی که نامشان را در این پارامتر ذکر کرده اید قبل از فایل فعلی اجرا خواهند شد.

مورد بعدی در این زمینه پارامتر $ver است دوستان عزیز در این تابع وردپرس این پارامتر اختیاری است و نوع آن از نوع رشته می باشد. در این پارامتر شما شماره نسخه فایل مورد نظر خود را وارد می کنید. اگر مقدار این پارامتر را وارد کنید، به انتهای مسیر query sting اضافه خواهد شد و اگر مقدار را وارد کنید سیستم مدیریت محتوای وردپرس به طور اتوماتیک یک شماره نسخه برای فایل در نظر می گیرد. این زمانی به کار می رود که بخواهید فایل را مرتب بروز کرده و نسخه جدیدی به آن اضافه کنید

دوستان عزیز مورد نهایی از این پارامتر ها $in_footer است توجه کنید که این پارامتر در این تابع وردپرس اختیاری است و نوع آن رشته ای می باشد. به طور طبیعی، اسکریپت ها و فایل های استایل داخل تگ رجیستر می شوند اما مقدار این پارامتر را true قرار دهید فایل قبل از تگ قرار می گیرد. حال توجه کنید که مقدار پیشفرض آن false است

یک مثال از wp_enqueue در وب سایت وردپرسی به صورت زیر است که برای ریجستر فایل ها به صورت تکی استفاده میشود:

function theme_name_scripts() {
	wp_enqueue_style( 'style-name', get_stylesheet_uri() );
	wp_enqueue_script( 'script-name', get_template_directory_uri() . '/js/example.js', array(), '1.0.0', true );
}

add_action( 'wp_enqueue_scripts', 'theme_name_scripts' );

حال میپزدازیم به نحوه استفاده از wp_enqueue در وب سایت های وردپرسی که به صورت زیر است:
دوستان عزیز معمولا برای لینک کردن اسکریپت ها و استایل ها در پوسته های وب سایت های وردپرسی کد آنها را در header.php قالب وردپرس وب سایت قرار میدهند که این روش روش صحیحی برای این کار نیست.برای این منظور و روش صحیح آن بهتر است برای این کار از فانکشن wp_enqueue استفاده کنیم. در کد زیر یک نمونه از نحوه استفاده wp_enqueue در پوسته وردپرس را برای شما دوستان عزیز قرار داده ایم:

<?php function my_scripts_method() { wp_enqueue_script('custom-script',get_stylesheet_directory_uri() . '/js/custom_script.js',array( 'jquery' )); } add_action( 'wp_enqueue_scripts', 'my_scripts_method' ); ?>

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

<?php function my_scripts_method() { wp_enqueue_script('newscript',plugins_url( '/js/newscript.js' , __FILE__ ),array( 'scriptaculous' )); } add_action( 'wp_enqueue_scripts', 'my_scripts_method' ); ?>

دوستان عزیز توجه کنید که در کد فوق فقط به جای get_stylesheet_directory_uri() از plugins_url استفاده شده است که ذکر این نکته نیز ضروری بود.

سخن آخر

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

ممنونم از همراهی شما عزیزان
موفق و پیروز و سربلند باشید دوستان

منبع: بیگ تم مرجع اموزش های وردپرس و هک وردپرس