
به اشتراک بگذارید
افزودن جاوااسکریپت به وردپرس یکی از کارهایی است که تقریباً هر مدیر سایت، طراح فرانتاند یا کاربر مبتدی حداقل یکبار به آن نیاز پیدا میکند. از نصب یک اسکریپت ردیابی ساده گرفته تا اجرای یک فانکشن پویا روی یک برگه خاص؛ همیشه لازم است بدانیم «چطور JS را درست، ایمن و استاندارد» به وردپرس اضافه کنیم. اهمیت این موضوع زمانی مشخص میشود که بدانید افزودن اشتباه JS میتواند مشکلات زیر را ایجاد کند:
- کاهش سرعت بارگذاری صفحه (Page Speed)
- ایجاد تداخل بین قالب و افزونهها
- مشکلات امنیتی (مانند اجرای اسکریپتهای ناخواسته)
- از کار افتادن بخشهایی از سایت پس از آپدیت وردپرس
💡 به همین دلیل، در این مقاله با تمرکز بر سه روش اصلی، ایمن و کاربردی به شما آموزش میدهیم:
- روش استاندارد و توسعهای (Enqueue)
- روش سریع و مشروط با هوکها
- روش مبتدی با افزونه و بلوک HTML
💡 بهترین و استانداردترین روش همیشه Enqueue است. این روش تنها راه تضمینی برای جلوگیری از تداخل اسکریپتهاست.
آنچه در این مقاله میخوانید:

افزودن JavaScript به وردپرس چیست؟
افزودن JavaScript در وردپرس یعنی اضافهکردن یک قطعه کد اجرایی که رفتار سایت را تغییر میدهد؛ چه در یک برگه، چه در یک نوشته یا حتی در کل سایت. وردپرس مانند یک «ساختمان بزرگ» است و هر اسکریپت مانند یک وسیله برقی که باید در جای درست و با سیمکشی صحیح نصب شود. اگر جاوااسکریپت در جای اشتباه قرار گیرد، ممکن است مشکلات زیر ایجاد شود:
- خطاهای جاوااسکریپت در کنسول مرورگر
- بلوک شدن اجرای اسکریپتهای دیگر
- افت سرعت سایت
چرا باید JS را اصولی به وردپرس اضافه کنیم؟
افزودن اصولی جاوااسکریپت باعث میشود اسکریپتها بدون تداخل با قالب و افزونهها اجرا شوند و سایت دچار خطاهای ناگهانی نشود. این کار سرعت بارگذاری صفحات را حفظ کرده و مدیریت کدها را در آینده سادهتر میکند. استفاده از روشهای استاندارد، امنیت بیشتری ایجاد کرده و سایت را برای بهروزرسانیهای بعدی آماده نگه میدارد.
1- افزودن جاوا اسکریپت به وردپرس با روش استاندارد (Enqueue)
استفاده از روش Enqueue باعث میشود اسکریپتها بهصورت اصولی و بدون تداخل با سایر بخشهای سایت بارگذاری شوند. این روش بهترین انتخاب برای حفظ سرعت، امنیت و سازگاری سایت با قالب و افزونههاست. اگر پروژه شما حرفهای است یا قصد دارید اسکریپتها را مدیریتپذیر نگه دارید، Enqueue استانداردترین و مطمئنترین راهکار است.
افزودن جاوا اسکریپت به وردپرس با روش Enqueue مناسب کیست؟
- توسعهدهندگان
- مدیران سایت با سطح فنی متوسط
- پروژههایی که نیاز به سرعت بالای سایت دارند
چرا روش Enqueue بهترین است؟
وردپرس توابع داخلی برای مدیریت اسکریپتها دارد. استفاده از این توابع باعث میشود:
- اسکریپتها تکراری بارگذاری نشوند
- امکان درج در Head یا Footer وجود داشته باشد
- کنترل وابستگیها ممکن باشد
🔸 مثال واقعی: افزودن JS فقط به چند برگه خاص 2025
یکی از مشتریان وبداده قصد داشت کد Analytics را فقط در چند برگه خاص بارگذاری کند. با Enqueue و شرط is_page مشکل بدون استفاده از پلاگین حل شد و سرعت سایت 32٪ بهتر شد.
چگونه اسکریپت را Enqueue کنیم؟
این کد را باید در فایل
functions.php قالب فعال وردپرس قرار دهید. برای دسترسی به این فایل، از طریق cPanel وارد File Manager شده و به مسیر زیر بروید:/public_html/wp-content/themes/your-theme/functions.php اگر میخواهید کد با تغییر قالب از بین نرود، میتوانید یک افزونه اختصاصی (Custom Plugin) بسازید و این کد را داخل آن قرار دهید:
کد زیر را در فایل functions.php قالب (یا افزونه اختصاصی) قرار دهید:
function wd_enqueue_custom_js() {
wp_enqueue_script(
'wd-custom-js',
get_stylesheet_directory_uri() . '/js/custom.js',
array('jquery'),
'1.0.0',
true
);
}
add_action('wp_enqueue_scripts', 'wd_enqueue_custom_js'); 📌 نکته مهم
اگر میخواهید JS فقط در یک برگه خاص اجرا شود:
اگر میخواهید JS فقط در یک برگه خاص اجرا شود:
if (is_page(123)) {
wp_enqueue_script(...);
} 2- افزودن JS به برگه یا نوشته با هوکها (روش سریع)
این روش زمانی کاربرد دارد که بخواهید یک اسکریپت سبک و کوتاه را فقط در یک برگه یا نوشته اجرا کنید، بدون اینکه فایل JS جداگانه بسازید. هوکها به شما اجازه میدهند اسکریپت را در مکانهایی مثل Footer یا Head تزریق کنید و اجرای آن را با شرطگذاری محدود نمایید. این روش سریع است، اما برای پروژههای بزرگ یا اسکریپتهای سنگین توصیه نمیشود.
📝 در واقع این روش مناسب زمانی است که:
- نمیخواهید فایل JS جدا بسازید
- فقط برای یک برگه خاص میخواهید JS اضافه کنید
👈 مثال کاربردی:
add_action('wp_footer', function(){
if(is_single(45)){
echo '<script>alert("Hello!")</script>';
}
}); 📌 این روش سریع است، اما برای پروژههای بزرگ توصیه نمیشود.
3- افزودن JS با افزونه یا بلوک HTML (برای مبتدیها)
بسیاری از کاربران نمیخواهند فایل functions.php را ویرایش کنند. پس از افزونه استفاده میکنند.
افزونههای پیشنهادی برای افزودن جاوا اسکریپت به وردپرس:
- Code Snippets

- Insert Headers and Footers

- Simple Custom CSS & JS

افزودن با بلوک HTML
در ویرایشگر گوتنبرگ:
- افزودن بلوک HTML
- قرار دادن تگ
<script>
📌 این روش برای اسکریپتهای ساده مناسب است.
جدول مقایسه روشهای اضافه کردن کد جاوا به وردپرس
در این جدول میتوانید بهصورت خلاصه ببینید هر کدام از روشهای افزودن جاوااسکریپت برای چه نوع کاربری و چه سناریویی مناسبتر است. اگر پروژهتان جدی و بلندمدت است، روش Enqueue بهترین انتخاب از نظر سرعت و پایداری است؛ برای تست اسکریپتهای سبک در چند صفحه، هوکها گزینه سریعتری هستند. وقتی هم ترجیح میدهید اصلاً وارد کدنویسی نشوید، افزونهها راهحلی سادهتر ولی با انعطاف و کارایی کمتر نسبت به دو روش دیگر هستند.
| روش | امنیت | سرعت | مناسب برای | توضیح |
|---|---|---|---|---|
| Enqueue | بسیار بالا | عالی | حرفهایها | بهترین روش 2025 |
| هوکها | متوسط | خوب | کاربران نیمهحرفهای | سریع و کاربردی |
| افزونه | متوسط | متوسط | مبتدیها | نیاز به دانش کم |
📌 خدمات وبداده
وبداده یکی از معتبرترین ارائهدهندگان سرویسهای سرور مجازی، هاست و دامنه در ایران است. اگر نیاز به زیرساخت حرفهای برای توسعه وردپرس دارید:
- ✅ سرور مجازی NVMe با سرعت بسیار بالا
- ✅ منابع کاملاً اختصاصی
- ✅ بدون اورسل
بهترین VPS ایران با پنل مدیریت اختصاصی، هارد NVMe و پهنای باند بالا
برای مشاهده پلنهای
سرور مجازی ایران وبداده
روی دکمه زیر کلیک کنید
سرور مجازی ایران وبداده
روی دکمه زیر کلیک کنید
نتیجهگیری: 3 روش برای افزودن جاوا اسکریپت به برگه و نوشته های وردپرس
افزودن جاوااسکریپت به وردپرس و یا افزودن کد جاوا اسکریپت به فوتر وردپرس کاری ساده است، اما باید استاندارد انجام شود. در این مقاله سه روش اصلی — Enqueue، هوکها و افزونه — بهصورت کامل توضیح داده شد. اگر سرعت، امنیت و سازگاری سایت برای شما مهم است، همیشه از روش اول استفاده کنید. وبداده نیز با ارائه سرورهای قدرتمند، کمک میکند تا وردپرس شما با بیشترین سرعت و کمترین خطا اجرا شود.
در صورت سؤال، در بخش نظرات وبداده همراه شما هستیم!
سوالات متداول از نجوه افزودن جاوا اسکریپت به وردپرس
1- آیا میتوانم JS را مستقیماً در برگه وارد کنم؟
بله؛ با بلوک HTML، اما برای پروژههای حرفهای مناسب نیست.




