افزودن CSS و جاوا اسکریپت سفارشی به قالب وردپرس

افزودن CSS و جاوا اسکریپت سفارشی به قالب وردپرس

برای تغییر ظاهر سایت یا اضافه‌کردن یک رفتار تازه، لازم نیست فایل‌های اصلی وردپرس یا قالب والد رو دست‌کاری کنید. روش امن‌تر اینه که فایل CSS و JavaScript خودتون رو داخل قالب فرزند بسازید و با توابع استاندارد وردپرس در صف بارگذاری بذارید. این کار جلوی بارگذاری تکراری فایل‌ها رو می‌گیره و مدیریت وابستگی‌ها، نسخه فایل و کش رو هم راحت‌تر می‌کنه.

توی این آموزش، افزودن CSS و جاوا اسکریپت سفارشی به وردپرس رو قدم‌به‌قدم انجام می‌دیم. اول محل مناسب کد رو انتخاب می‌کنیم، بعد فایل‌ها رو می‌سازیم و در ادامه سراغ بارگذاری شرطی، defer، کد درون‌خطی و پیدا کردن خطاها می‌ریم. اگه فقط یک راه بدون کدنویسی می‌خواید، آموزش افزودن CSS و JS سفارشی با افزونه هم می‌تونه به کارتون بیاد.

آنچه در این مقاله می‌خوانید۱۲ بخش

قبل از افزودن کد سفارشی چه چیزهایی رو باید بدونید؟

تفاوت CSS و جاوا اسکریپت به زبان ساده

CSS ظاهر صفحه رو کنترل می‌کنه. رنگ، فاصله، اندازه نوشته، محل قرارگیری بخش‌ها و نمایش سایت در موبایل نمونه‌هایی از کارهای CSS هستن. اگه هنوز با ساختار این فایل آشنا نیستید، آموزش ساختار اصلی فایل CSS نقطه شروع مناسبیه.

JavaScript رفتار و تعامل صفحه رو می‌سازه. بازشدن یک منو بعد از کلیک، نمایش پنجره پاپ‌آپ یا تغییر محتوای صفحه بدون بارگذاری دوباره، نمونه‌های ساده‌ای از کاربرد JavaScript هستن. پس اگه فقط رنگ دکمه رو عوض می‌کنید، CSS کافیه؛ ولی اگه می‌خواید دکمه بعد از کلیک کاری انجام بده، احتمالاً به JavaScript نیاز دارید.

چه زمانی به CSS یا جاوا اسکریپت سفارشی نیاز دارید؟

وقتی تنظیمات قالب یا افزونه گزینه موردنیازتون رو نداره، کد سفارشی می‌تونه اون تغییر محدود رو انجام بده. مثلاً می‌تونید فاصله اجزای یک صفحه رو اصلاح کنید، یک بخش رو فقط در موبایل پنهان کنید یا برای یک دکمه رفتار مشخصی بسازید.

قبل از کدنویسی، تنظیمات خود قالب و افزونه رو بررسی کنید. اگه همون قابلیت از قبل آماده باشه، استفاده از تنظیمات داخلی معمولاً نگهداری ساده‌تری داره.

چرا نباید کدها رو مستقیم داخل قالب والد بذارید؟

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

تهیه نسخه پشتیبان و آزمایش کد در محیط تست

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

یک اشتباه کوچک در functions.php ممکنه خطای PHP بسازه و دسترسی به سایت رو مختل کنه. پس کدها رو مرحله‌به‌مرحله اضافه کنید و بعد از هر تغییر، صفحه اصلی و پیشخوان رو بررسی کنید.

بهترین محل برای افزودن CSS و جاوا اسکریپت سفارشی کجاست؟

محل کد به کاری که انجام می‌ده بستگی داره. اگه تغییر فقط به ظاهر یا ساختار قالب مربوطه، فایل functions.php قالب فرزند انتخاب مناسبیه. اگه قابلیت باید بعد از تعویض قالب هم باقی بمونه، بهتره اون رو داخل یک افزونه اختصاصی ساده قرار بدید.

  • کد وابسته به قالب: داخل قالب فرزند قرار می‌گیره.
  • قابلیت مستقل از ظاهر: داخل افزونه اختصاصی قرار می‌گیره.
  • تغییر خیلی کوتاه CSS: می‌تونه به فایل CSS قالب فرزند یا بخش CSS اضافی قالب اضافه بشه.
  • کدهای طولانی: بهتره در فایل‌های جداگانه نگهداری بشن.

در این آموزش از قالب فرزند استفاده می‌کنیم. همین توابع رو می‌تونید داخل افزونه اختصاصی هم به کار ببرید؛ فقط روش ساخت آدرس و مسیر فایل در افزونه فرق می‌کنه.

افزودن فایل CSS سفارشی به وردپرس

ساخت فایل CSS در قالب فرزند

داخل پوشه قالب فرزند، یک پوشه به نام assets بسازید. داخل اون پوشه هم یک پوشه به نام css بسازید و فایل custom.css رو داخلش قرار بدید. مسیر نهایی باید شبیه این باشه:

کد
your-child-theme/assets/css/custom.css

برای آزمایش می‌تونید این کد ساده رو داخل فایل بنویسید:

CSS
.site-title {    color: #2271b1;}

کلاس .site-title فقط یک نمونه‌ست. باید اون رو با کلاس واقعی عنصر موردنظرتون عوض کنید.

بارگذاری فایل CSS با wp_enqueue_style

حالا این کد رو به فایل functions.php قالب فرزند اضافه کنید:

PHP
<?phpfunction mihanwp_enqueue_custom_assets() {    wp_enqueue_style(        'mihanwp-custom-style',        get_stylesheet_directory_uri() . '/assets/css/custom.css',        array(),        '1.0.0'    );}add_action('wp_enqueue_scripts', 'mihanwp_enqueue_custom_assets');

اگه فایل functions.php از قبل با <?php شروع شده، این عبارت رو دوباره اضافه نکنید. تابع wp_enqueue_style فایل CSS رو از راه استاندارد وردپرس وارد صف بارگذاری می‌کنه.

توضیح ساده پارامترهای wp_enqueue_style

  1. mihanwp-custom-style شناسه یکتای فایل هست. افزونه‌ها و قالب‌ها با این شناسه فایل رو تشخیص می‌دن.
  2. get_stylesheet_directory_uri() آدرس قالب فعال رو برمی‌گردونه. موقع استفاده از قالب فرزند، این آدرس به پوشه قالب فرزند اشاره می‌کنه.
  3. array() فهرست وابستگی‌هاست. چون فایل نمونه به فایل CSS دیگه‌ای وابسته نیست، این آرایه خالیه.
  4. 1.0.0 نسخه فایل هست و به کنترل کش کمک می‌کنه.

بارگذاری CSS فقط در صفحه‌های مشخص

اگه CSS فقط برای یک صفحه نوشته شده، لازم نیست در همه صفحه‌های سایت بارگذاری بشه. کد زیر فایل رو فقط در برگه‌ای با شناسه 42 وارد می‌کنه:

PHP
<?phpfunction mihanwp_enqueue_page_style() {    if (! is_page(42)) {        return;    }    wp_enqueue_style(        'mihanwp-page-style',        get_stylesheet_directory_uri() . '/assets/css/custom.css',        array(),        '1.0.0'    );}add_action('wp_enqueue_scripts', 'mihanwp_enqueue_page_style');

عدد 42 رو با شناسه برگه خودتون عوض کنید. می‌تونید به‌جای شناسه از نامک برگه هم استفاده کنید؛ مثلاً is_page('contact').

افزودن فایل جاوا اسکریپت سفارشی به وردپرس

ساخت فایل JavaScript در قالب فرزند

داخل پوشه assets یک پوشه به نام js بسازید. بعد فایل custom.js رو داخل اون قرار بدید:

کد
your-child-theme/assets/js/custom.js

برای آزمایش می‌تونید این کد رو داخل فایل بنویسید. این نمونه بعد از آماده‌شدن ساختار صفحه، یک پیام رو در Console مرورگر نمایش می‌ده:

JS
document.addEventListener('DOMContentLoaded', function () {    console.log('Custom JavaScript loaded.');});

بارگذاری فایل با wp_enqueue_script

کد زیر فایل JavaScript رو در انتهای صفحه بارگذاری می‌کنه:

PHP
<?phpfunction mihanwp_enqueue_custom_script() {    wp_enqueue_script(        'mihanwp-custom-script',        get_stylesheet_directory_uri() . '/assets/js/custom.js',        array(),        '1.0.0',        array(            'in_footer' => true,        )    );}add_action('wp_enqueue_scripts', 'mihanwp_enqueue_custom_script');

تابع wp_enqueue_script به وردپرس می‌گه فایل کجاست، چه وابستگی‌هایی داره، نسخه‌اش چیه و کجای صفحه بارگذاری بشه.

توضیح ساده پارامترهای wp_enqueue_script

  1. پارامتر اول شناسه یکتای اسکریپت هست.
  2. پارامتر دوم آدرس فایل JavaScript هست.
  3. پارامتر سوم وابستگی‌ها رو مشخص می‌کنه.
  4. پارامتر چهارم نسخه فایل رو تعیین می‌کنه.
  5. پارامتر پنجم تنظیم‌هایی مثل بارگذاری در انتهای صفحه و راهبرد defer یا async رو می‌گیره.

آرایه تنظیم‌های پارامتر پنجم در وردپرس ۶.۳ و نسخه‌های جدیدتر پشتیبانی می‌شه. اگه سایتتون نسخه قدیمی‌تری داره، اول وردپرس رو در یک محیط امن و با رعایت سازگاری قالب و افزونه‌ها به‌روزرسانی کنید.

تعریف وابستگی‌هایی مثل jQuery

وابستگی یعنی فایل شما برای اجرا به فایل دیگه‌ای نیاز داره. اگه کدتون از jQuery استفاده می‌کنه، شناسه jquery رو داخل آرایه وابستگی بذارید:

PHP
wp_enqueue_script(    'mihanwp-custom-script',    get_stylesheet_directory_uri() . '/assets/js/custom.js',    array('jquery'),    '1.0.0',    array(        'in_footer' => true,    ));

در این حالت وردپرس ترتیب بارگذاری رو مدیریت می‌کنه. jQuery رو دوباره از یک فایل محلی یا CDN بارگذاری نکنید، چون ممکنه دو نسخه از اون وارد صفحه بشه و بین قالب و افزونه‌ها تداخل بسازه. اگه کدتون JavaScript ساده‌ست و از jQuery استفاده نمی‌کنه، آرایه وابستگی رو خالی نگه دارید.

بارگذاری اسکریپت در انتهای صفحه

مقدار 'in_footer' => true باعث می‌شه وردپرس اسکریپت رو نزدیک انتهای بدنه صفحه چاپ کنه. این روش برای خیلی از اسکریپت‌های ظاهری مناسبه، چون محتوای اصلی صفحه زودتر پردازش می‌شه.

قالب باید تابع wp_footer() رو داشته باشه. قالب‌های استاندارد وردپرس این تابع رو قبل از بسته‌شدن تگ body اجرا می‌کنن. اگه اسکریپت انتهای صفحه ظاهر نمی‌شه، وجود همین تابع رو هم بررسی کنید.

استفاده از defer و async چه فرقی داره؟

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

async هم فایل رو بدون متوقف‌کردن پردازش صفحه دریافت می‌کنه، ولی به‌محض آماده‌شدن فایل اون رو اجرا می‌کنه. ترتیب اجرای چند فایل async تضمین‌شده نیست. پس این گزینه بیشتر برای اسکریپت‌های مستقلی مناسبه که به ترتیب اجرا وابسته نیستن.

برای استفاده از defer می‌تونید تنظیم اسکریپت رو این‌طور بنویسید:

PHP
wp_enqueue_script(    'mihanwp-custom-script',    get_stylesheet_directory_uri() . '/assets/js/custom.js',    array(),    '1.0.0',    array(        'in_footer' => true,        'strategy'  => 'defer',    ));

برای async مقدار strategy رو به async تغییر بدید. قبل از استفاده، رفتار فایل و وابستگی‌هاش رو آزمایش کنید؛ انتخاب نادرست ممکنه باعث بشه اسکریپت قبل از آماده‌شدن چیزهایی که لازم داره اجرا بشه.

بارگذاری جاوا اسکریپت فقط در صفحه‌های مشخص

مثل CSS، می‌تونید JavaScript رو هم فقط جایی بارگذاری کنید که واقعاً بهش نیاز دارید:

PHP
<?phpfunction mihanwp_enqueue_contact_script() {    if (! is_page('contact')) {        return;    }    wp_enqueue_script(        'mihanwp-contact-script',        get_stylesheet_directory_uri() . '/assets/js/custom.js',        array(),        '1.0.0',        array(            'in_footer' => true,            'strategy'  => 'defer',        )    );}add_action('wp_enqueue_scripts', 'mihanwp_enqueue_contact_script');

در این نمونه، فایل فقط در برگه‌ای با نامک contact بارگذاری می‌شه. نامک رو با مقدار واقعی برگه خودتون عوض کنید.

ثبت جداگانه فایل با wp_register_script و wp_register_style

تابع‌های wp_register_script و wp_register_style فقط اطلاعات فایل رو در وردپرس ثبت می‌کنن. بعداً می‌تونید همون فایل رو با شناسه‌اش وارد صف کنید.

PHP
<?phpfunction mihanwp_register_assets() {    wp_register_style(        'mihanwp-custom-style',        get_stylesheet_directory_uri() . '/assets/css/custom.css',        array(),        '1.0.0'    );    wp_register_script(        'mihanwp-custom-script',        get_stylesheet_directory_uri() . '/assets/js/custom.js',        array(),        '1.0.0',        array(            'in_footer' => true,        )    );    if (is_page(42)) {        wp_enqueue_style('mihanwp-custom-style');        wp_enqueue_script('mihanwp-custom-script');    }}add_action('wp_enqueue_scripts', 'mihanwp_register_assets');

ثبت جداگانه وقتی به کارتون میاد که می‌خواید اطلاعات فایل یک‌بار تعریف بشه، ولی فقط در شرایط خاصی اون رو وارد صف کنید. همچنین بخش دیگه‌ای از قالب یا افزونه می‌تونه فایل ثبت‌شده رو فقط با شناسه‌اش فراخوانی کنه.

اگه فایل باید همیشه بارگذاری بشه، لازم نیست ثبت و صف‌کردن رو جدا کنید. wp_enqueue_script و wp_enqueue_style می‌تونن آدرس و بقیه پارامترها رو مستقیم بگیرن و هر دو کار رو یکجا انجام بدن.

افزودن CSS و جاوا اسکریپت درون‌خطی

کد درون‌خطی یعنی CSS یا JavaScript به‌جای یک فایل جدا، مستقیم داخل خروجی صفحه قرار می‌گیره. این روش برای چند خط کد پویا یا خیلی کوتاه مناسبه. برای کدهای طولانی، فایل جدا خواناتر و قابل‌مدیریت‌تره.

افزودن CSS کوتاه با wp_add_inline_style

تابع wp_add_inline_style کد CSS رو به یک فایل CSS ثبت‌شده یا صف‌شده وصل می‌کنه:

PHP
<?phpfunction mihanwp_add_inline_css() {    wp_enqueue_style(        'mihanwp-custom-style',        get_stylesheet_directory_uri() . '/assets/css/custom.css',        array(),        '1.0.0'    );    $custom_css = '.site-title { color: #2271b1; }';    wp_add_inline_style('mihanwp-custom-style', $custom_css);}add_action('wp_enqueue_scripts', 'mihanwp_add_inline_css');

شناسه‌ای که به wp_add_inline_style می‌دید باید متعلق به یک فایل CSS صف‌شده باشه. خود کد CSS رو بدون تگ style بنویسید.

افزودن JavaScript کوتاه با wp_add_inline_script

برای JavaScript کوتاه از wp_add_inline_script استفاده کنید:

PHP
<?phpfunction mihanwp_add_inline_js() {    wp_enqueue_script(        'mihanwp-custom-script',        get_stylesheet_directory_uri() . '/assets/js/custom.js',        array(),        '1.0.0',        array(            'in_footer' => true,        )    );    $custom_js = "console.log('Inline JavaScript loaded.');";    wp_add_inline_script('mihanwp-custom-script', $custom_js, 'after');}add_action('wp_enqueue_scripts', 'mihanwp_add_inline_js');

مقدار after کد رو بعد از فایل اصلی چاپ می‌کنه. اگه کد باید قبل از فایل اجرا بشه، می‌تونید از before استفاده کنید. تگ script رو داخل متغیر ننویسید.

چرا چاپ مستقیم کد داخل wp_head انتخاب خوبی نیست؟

از نظر فنی می‌تونید با قلاب wp_head کد رو مستقیم بالای صفحه چاپ کنید، ولی وردپرس در این حالت اطلاعات کافی برای مدیریت اون فایل یا کد نداره. وابستگی‌ها، ترتیب بارگذاری، حذف فایل تکراری و جابه‌جایی کد به بخش مناسب هم سخت‌تر می‌شن.

برای فایل‌ها از توابع صف و برای کدهای کوتاه از توابع درون‌خطی استفاده کنید. این روش با قالب‌ها و افزونه‌های دیگه هماهنگی بهتری داره.

مدیریت نسخه فایل و جلوگیری از مشکل کش

مرورگر، افزونه کش یا CDN ممکنه نسخه قبلی فایل رو نگه داره. پارامتر نسخه یک مقدار به آدرس فایل اضافه می‌کنه تا بعد از تغییر نسخه، مرورگر فایل تازه رو دریافت کنه. مثلاً آدرس نهایی می‌تونه به‌شکل custom.css?ver=1.0.0 دیده بشه.

برای مدیریت دستی می‌تونید بعد از هر تغییر مهم، نسخه رو از 1.0.0 به 1.0.1 تغییر بدید. اگه می‌خواید نسخه به‌صورت خودکار با زمان آخرین تغییر فایل ساخته بشه، از filemtime() استفاده کنید:

PHP
<?phpfunction mihanwp_enqueue_versioned_style() {    $css_path = get_stylesheet_directory() . '/assets/css/custom.css';    $css_url  = get_stylesheet_directory_uri() . '/assets/css/custom.css';    wp_enqueue_style(        'mihanwp-custom-style',        $css_url,        array(),        file_exists($css_path) ? filemtime($css_path) : null    );}add_action('wp_enqueue_scripts', 'mihanwp_enqueue_versioned_style');

get_stylesheet_directory() مسیر واقعی فایل روی سرور رو می‌سازه و get_stylesheet_directory_uri() آدرس قابل‌استفاده در مرورگر رو برمی‌گردونه. تابع filemtime() هم زمان آخرین تغییر فایل رو به‌عنوان نسخه قرار می‌ده.

در پارامتر نسخه، مقدار false باعث می‌شه وردپرس نسخه نصب‌شده خودش رو به آدرس اضافه کنه. مقدار null یعنی هیچ نسخه‌ای به آدرس اضافه نشه. برای فایل سفارشی، یک رشته نسخه مشخص یا زمان آخرین تغییر فایل معمولاً کنترل بهتری روی کش بهتون می‌ده.

نمونه کامل افزودن CSS و جاوا اسکریپت به قالب فرزند

حالا همه بخش‌های اصلی رو در یک نمونه کامل کنار هم می‌ذاریم.

ساخت پوشه‌ها و فایل‌های موردنیاز

کد
your-child-theme/├── functions.php└── assets/    ├── css/    │   └── custom.css    └── js/        └── custom.js

نام پوشه your-child-theme در سایت شما با نام پوشه واقعی قالب فرزند عوض می‌شه.

اضافه‌کردن کد بارگذاری به functions.php

PHP
<?phpfunction mihanwp_enqueue_child_assets() {    $css_path = get_stylesheet_directory() . '/assets/css/custom.css';    $js_path  = get_stylesheet_directory() . '/assets/js/custom.js';    if (file_exists($css_path)) {        wp_enqueue_style(            'mihanwp-custom-style',            get_stylesheet_directory_uri() . '/assets/css/custom.css',            array(),            filemtime($css_path)        );    }    if (file_exists($js_path)) {        wp_enqueue_script(            'mihanwp-custom-script',            get_stylesheet_directory_uri() . '/assets/js/custom.js',            array(),            filemtime($js_path),            array(                'in_footer' => true,                'strategy'  => 'defer',            )        );    }}add_action('wp_enqueue_scripts', 'mihanwp_enqueue_child_assets');

این نمونه قبل از بارگذاری، وجود فایل رو بررسی می‌کنه. نسخه هر فایل هم با آخرین زمان تغییرش ساخته می‌شه. اگه فایل JavaScript شما به jQuery وابسته‌ست، array() مربوط به اون رو به array('jquery') تغییر بدید.

بررسی بارگذاری فایل‌ها در سایت

  1. فایل‌ها رو ذخیره کنید و یکی از صفحه‌های سایت رو باز کنید.
  2. ابزار توسعه‌دهنده مرورگر رو باز کنید.
  3. در بخش Network نام custom.css و custom.js رو جست‌وجو کنید.
  4. بخش Console رو بررسی کنید و مطمئن بشید خطای قرمز ندارید.
  5. اگه فایل قدیمی نمایش داده می‌شه، کش مرورگر، وردپرس و CDN رو پاک کنید.

خطاهای رایج موقع افزودن کد سفارشی

  • استفاده از تابع اشتباه برای CSS: فایل CSS باید با wp_enqueue_style وارد صف بشه، نه wp_enqueue_script.
  • بارگذاری دوباره jQuery: اگه اسکریپت به jQuery نیاز داره، شناسه jquery رو به‌عنوان وابستگی اعلام کنید و نسخه دیگه‌ای از کتابخانه رو دستی وارد نکنید.
  • نوشتن آدرس ثابت: آدرس کامل دامنه رو داخل کد ننویسید. برای قالب فرزند از get_stylesheet_directory_uri() استفاده کنید تا کد بعد از تغییر دامنه هم کار کنه.
  • ویرایش قالب والد: تغییرها ممکنه با به‌روزرسانی قالب پاک بشن. کد رو داخل قالب فرزند یا افزونه اختصاصی بذارید.
  • مسیر یا نام نادرست: حروف بزرگ و کوچک نام فایل در خیلی از سرورها مهمه. نام و مسیر داخل کد باید دقیقاً با فایل واقعی یکی باشه.
  • نمایش نسخه قدیمی: نسخه فایل رو تغییر بدید یا از filemtime() استفاده کنید و بعد کش‌ها رو پاک کنید.
  • خطای JavaScript: یک خطای نگارشی ممکنه ادامه اجرای فایل رو متوقف کنه. اولین خطای قرمز Console معمولاً بهترین نقطه برای شروع بررسیه.
  • شناسه تکراری: برای هر فایل یک شناسه مشخص و یکتا انتخاب کنید تا با قالب یا افزونه‌های دیگه تداخل نداشته باشه.
  • شرط اشتباه: اگه از is_page() استفاده کرده‌اید، شناسه یا نامک برگه رو دوباره بررسی کنید.

چطور مطمئن بشید فایل‌ها درست بارگذاری شدن؟

در Chrome، Firefox یا Edge روی صفحه کلیک راست کنید و گزینه Inspect رو بزنید. این بخش ابزار توسعه‌دهنده مرورگره و بهتون نشون می‌ده مرورگر چه فایل‌هایی رو دریافت کرده و چه خطاهایی رخ داده.

بررسی فایل‌ها در بخش Network

تب Network رو باز کنید و صفحه رو دوباره بارگذاری کنید. نام فایل رو در کادر فیلتر بنویسید. وضعیت 200 معمولاً یعنی فایل با موفقیت دریافت شده. وضعیت 404 یعنی فایل در آدرس نوشته‌شده پیدا نشده و باید مسیر رو اصلاح کنید.

پیداکردن خطاها در بخش Console

تب Console خطاهای JavaScript رو نشون می‌ده. متن خطا معمولاً نام فایل و شماره خط رو هم داره. اول اولین خطای قرمز رو بررسی کنید، چون خطاهای بعدی ممکنه نتیجه همون مشکل اولیه باشن.

بررسی اعمال‌شدن CSS

در تب Elements عنصر موردنظر رو انتخاب کنید. بخش Styles نشون می‌ده چه قانون‌های CSS روی اون اعمال شده‌ان. اگه قانون شما خط خورده، یک قانون دیگه با اولویت بیشتر جای اون رو گرفته. بهتره انتخابگر CSS رو دقیق‌تر کنید و فقط در آخرین راه‌حل سراغ !important برید.

پاک‌کردن کش وردپرس، مرورگر و CDN

بعد از تغییر فایل، اول صفحه رو با بازخوانی کامل مرورگر تازه کنید. اگه نتیجه عوض نشد، کش افزونه بهینه‌سازی یا کش هاست رو پاک کنید. اگه از CDN استفاده می‌کنید، کش اون سرویس رو هم تازه کنید. تغییر نسخه فایل معمولاً کمک می‌کنه مرورگر و لایه‌های کش آدرس جدید رو دریافت کنن.

جمع‌بندی

برای افزودن CSS و جاوا اسکریپت سفارشی به وردپرس، فایل‌ها رو در قالب فرزند یا افزونه اختصاصی نگه دارید و با wp_enqueue_style و wp_enqueue_script بارگذاری کنید. این روش به وردپرس اجازه می‌ده وابستگی‌ها، ترتیب اجرا و نسخه فایل‌ها رو مدیریت کنه.

برای چند خط کد از wp_add_inline_style و wp_add_inline_script کمک بگیرید. فایل‌های مخصوص یک صفحه رو هم شرطی بارگذاری کنید. در آخر، Network و Console مرورگر رو بررسی کنید تا مطمئن بشید مسیر فایل‌ها درسته و کد بدون خطا اجرا می‌شه.

سؤال‌های متداول

آیا می‌تونید CSS سفارشی رو بدون افزونه به وردپرس اضافه کنید؟

بله. می‌تونید فایل CSS رو داخل قالب فرزند بسازید و با wp_enqueue_style بارگذاری کنید. برای چند خط CSS ساده، بخش CSS اضافی قالب هم می‌تونه کافی باشه.

کدهای CSS و جاوا اسکریپت رو باید داخل functions.php بذارید؟

خود CSS و JavaScript طولانی رو بهتره داخل فایل‌های جدا نگه دارید. فقط کد PHP مربوط به ثبت و بارگذاری فایل‌ها داخل functions.php قالب فرزند قرار می‌گیره. قابلیت‌های مستقل از قالب هم بهتره داخل افزونه اختصاصی باشن.

تفاوت wp_enqueue_script و wp_register_script چیه؟

wp_register_script اطلاعات فایل رو ثبت می‌کنه، ولی اون رو لزوماً وارد صفحه نمی‌کنه. wp_enqueue_script فایل رو وارد صف بارگذاری می‌کنه و اگه آدرس و بقیه پارامترها رو بهش بدید، ثبت و صف‌کردن رو یکجا انجام می‌ده.

برای افزودن JavaScript باید jQuery رو جداگانه بارگذاری کنید؟

نه. فقط اگه کدتون واقعاً از jQuery استفاده می‌کنه، jquery رو در آرایه وابستگی‌های wp_enqueue_script قرار بدید. وردپرس ترتیب بارگذاری رو مدیریت می‌کنه و لازم نیست نسخه دیگه‌ای از jQuery رو دستی اضافه کنید.

چرا تغییرات CSS بعد از ذخیره نمایش داده نمی‌شن؟

معمولاً نسخه قبلی فایل در کش مرورگر، وردپرس، هاست یا CDN مونده. نسخه فایل رو تغییر بدید یا از زمان آخرین تغییر فایل استفاده کنید، بعد همه لایه‌های کش رو پاک کنید. مسیر فایل و اولویت قانون CSS رو هم در ابزار توسعه‌دهنده مرورگر بررسی کنید.

نظر شما در این مورد چیه؟

  1. کاربر مهمان۶ اسفند ۱۳۹۸

    سلام خسته نباشید. برای من یسری کد واسه تغییر نظر دهی و ساید بار نوشته شده با css/html توی افزونه کاستوم css هم میذارم اجرا نمیشه هیچ اتفاقی نمیوفته توی سایت.چطوری باید اجراش کنم؟ مرسی

    • تیم پشتیبانیتیم پشتیبانی۶ اسفند ۱۳۹۸

      با سلام
      افزونه های مربوط به کش سایت را غیرفعال کنید و سپس تغییرات مد نظر خود را اعمال کنید

  2. کاربر مهمان۲۸ خرداد ۱۳۹۸

    سلام روز بخیر من خروجی html و جاوااسکریپ دارم که از adobe animate گرفتم میخوام با افزونه ویزوال کامپوزر مه المان html و جاوا داره اجراش کنم ولی نمیشه میشه کمک کنید

    • تیم پشتیبانیتیم پشتیبانی۲۸ خرداد ۱۳۹۸

      سلام پشتیبانی مختص خریداران محصول هست. خریدی با ایمیل شما پیدا نشد.

  3. کاربر مهمان۲۱ فروردین ۱۳۹۷

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

    • رضا راد۲۱ فروردین ۱۳۹۷

      سلام دقت کنید کد کامنت گذاری نشده باشه

  4. کاربر مهمان۲۹ مهر ۱۳۹۶

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

پشتیبانپشتیبانپشتیبانپشتیبانپشتیبان
تیم میهن وردپرس
پشتیبانپشتیبانپشتیبانپشتیبانپشتیبان
تیم میهن وردپرسآنلاین و پاسخگوی شما هستیم.آنلاین

در حال بارگذاری...

هر سوالی دارید بپرسید.پاسخگوی شما هستیم.