Hướng dẫn cách sửa lỗi “jQuery Is Not Defined” trong WordPress [2025]

Trong quá trình xây dựng và tối ưu website WordPress, lỗi “jQuery Is Not Defined” là một trong những vấn đề phổ biến khiến trang web hoạt động không đúng ý. Vậy nguyên nhân là do đâu và cách sửa lỗi ‘WordPress jQuery Is Not Defined Error'” như thế nào? Cùng Tino tìm hiểu qua bài viết này nhé!

Lỗi “WordPress jQuery Is Not Defined” là gì?

Lỗi “WordPress jQuery Is Not Defined” xảy ra khi một trang web WordPress cố gắng sử dụng thư viện jQuery nhưng không thể tìm thấy hoặc tải được thư viện này, thường do jQuery chưa được tích hợp đúng cách hoặc bị xung đột trong quá trình tải.

jQuery là một thư viện JavaScript phổ biến giúp đơn giản hóa việc viết mã tương tác trên website, và WordPress mặc định đã tích hợp sẵn jQuery để hỗ trợ các tính năng như menu dropdown, slider hoặc các hiệu ứng động. Tuy nhiên, lỗi có thể xuất hiện nếu theme hoặc plugin bạn đang sử dụng yêu cầu jQuery nhưng nó bị vô hiệu hóa (do xung đột phiên bản), đường dẫn đến file jQuery bị sai hoặc một đoạn mã tùy chỉnh không khai báo đúng cách.

Điều này dẫn đến việc các chức năng phụ thuộc vào jQuery ngừng hoạt động, gây ảnh hưởng đến trải nghiệm người dùng và khả năng hiển thị của trang web.

Nguyên nhân chính gây ra lỗi “jQuery Is Not Defined” trong WordPress

Thiếu thư viện jQuery

WordPress không tự động tải jQuery trừ khi theme hoặc plugin yêu cầu. Nếu mã nguồn của bạn cần jQuery nhưng lại không gọi thư viện này đúng cách, trình duyệt sẽ báo lỗi “jQuery is not defined”.

Ví dụ:

<script>

jQuery(document).ready(function() {

console.log("Trang web đã sẵn sàng!");

});

</script>

Nếu WordPress chưa nạp jQuery trước đoạn mã này, nó sẽ ngay lập tức báo lỗi.

Thứ tự tải script bị sai

WordPress sử dụng hệ thống hàng đợi wp_enqueue_script() để quản lý script. Nếu jQuery được tải sau các file JavaScript tùy chỉnh cần dùng đến nó, lỗi này sẽ xuất hiện.

Ví dụ:

• File custom.js của bạn gọi jQuery, nhưng jQuery lại nằm sau custom.js trong danh sách file tải.
• Sử dụng defer hoặc async không đúng chỗ khiến script tải lệch thứ tự.

Xung đột plugin hoặc theme

Một số plugin hoặc theme tự động gọi jQuery từ nguồn ngoài (như CDN của Google) thay vì dùng phiên bản WordPress tích hợp sẵn. Điều này dễ dẫn đến:

• Gọi nhiều phiên bản jQuery cùng lúc gây xung đột.
• Lỗi “jQuery is not defined” do phiên bản jQuery không tương thích.

Phiên bản jQuery lỗi thời hoặc không tương thích

WordPress thường cập nhật phiên bản jQuery kèm theo lõi hệ thống. Nếu theme hoặc plugin gọi phiên bản jQuery quá cũ (hoặc ngược lại, bản mới nhưng không tương thích), dễ xảy ra lỗi.

Ví dụ:

• Phiên bản jQuery cũ thiếu hàm cần thiết cho mã JavaScript hiện đại.
• Plugin cố tình thay thế jQuery gốc của WordPress dẫn đến lỗi định nghĩa.

Cấu hình sai trong file functions.php

Một số theme tùy chỉnh file functions.php không đúng cách, dẫn đến:

• Vô tình xóa bỏ jQuery mặc định của WordPress (wp_deregister_script).
• Gọi nhầm phiên bản hoặc không tải đúng thư viện cần thiết.

Ví dụ lỗi phổ biến:

function remove_default_jquery() {

wp_deregister_script('jquery');

}

add_action('wp_enqueue_scripts', 'remove_default_jquery');

Đoạn mã trên sẽ xóa bỏ jQuery mặc định, nếu bạn quên thay thế bằng phiên bản khác sẽ khiến lỗi xuất hiện ngay lập tức.

Lỗi đường dẫn hoặc CDN

Nếu jQuery được tải từ một CDN bên ngoài (Content Delivery Network) và CDN đó gặp sự cố (ví dụ: không khả dụng hoặc bị chặn bởi tường lửa), trình duyệt sẽ không thể tải được thư viện jQuery. Điều này dẫn đến lỗi “jQuery Is Not Defined”.

4 cách sửa lỗi “jQuery Is Not Defined” trong WordPress hiệu quả

Lưu ý quan trọng: Trước khi thực hiện bất kỳ thao tác chỉnh sửa nào, hãy sao lưu (backup) website để tránh mất dữ liệu quan trọng nếu xảy ra sự cố nhé!

1. Thêm đoạn mã vào file wp-config.php

Cách đầu tiên và cũng là cách phổ biến nhất là thiết lập đường dẫn tuyệt đối (ABSPATH) trong file lõi WordPress.

Bạn hãy mở file wp-config.php thông qua File Manager trong cPanel hoặc FTP Client như FileZilla và chèn đoạn mã sau:

if ( !defined('ABSPATH') )

define('ABSPATH', dirname(__FILE__) . '/');

define('CONCATENATE_SCRIPTS', false);

Giải thích:

• ABSPATH: Định nghĩa đường dẫn chính xác đến thư mục cài đặt WordPress.
• CONCATENATE_SCRIPTS: Thiết lập giá trị false giúp WordPress không nối các file script lại với nhau, từ đó giảm nguy cơ lỗi jQuery không được định nghĩa.

2. Thêm jQuery từ Google kèm dự phòng (Fallback)

Việc sử dụng jQuery qua CDN giúp website tải nhanh hơn. Tuy nhiên, đôi khi CDN bị lỗi hoặc mất kết nối sẽ gây ra lỗi jQuery. Để khắc phục, bạn có thể thêm phương án dự phòng (fallback) như sau:

<script>

window.jQuery || document.write('<script src="http://mysite.com/jquery.min.js"><\/script>')

</script>

Giải thích:

• window.jQuery: Kiểm tra xem jQuery đã tải chưa.
• Nếu chưa, document.write() sẽ tự động tải file jQuery từ đường dẫn dự phòng trên server của bạn (mysite.com).

Mẹo: Bạn có thể thay http://mysite.com/jquery.min.js bằng link jQuery tải sẵn từ thư viện của bạn để đảm bảo độ ổn định.

3. Thêm thư viện jQuery thủ công vào header.php

Nếu hai cách trên vẫn không khắc phục được lỗi, bạn có thể thử chèn trực tiếp thư viện jQuery vào file header.php của theme.

Bước 1: Vào trang Google Hosted Libraries và sao chép đoạn mã CDN phiên bản jQuery mới nhất.

Ví dụ:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>

Bước 2: Mở file header.php trong thư mục theme của bạn (wp-content/themes/tên-theme).

Bước 3: Dán đoạn mã vừa sao chép ngay bên dưới thẻ <head> như sau:

<head>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>

</head>

Bước 4: Lưu lại file và kiểm tra xem lỗi đã biến mất chưa.

Mẹo: Cách này cũng áp dụng được cho các thư viện JavaScript khác như Bootstrap, Vue.js, …

Đảm bảo jQuery đã được tải đúng cách

Nếu bạn đã chèn jQuery mà lỗi vẫn xuất hiện, có thể vấn đề nằm ở việc mã nguồn không tải đúng thư viện.

Bước 1: Kiểm tra mã nguồn trang web bằng cách nhấn F12 hoặc chuột phải chọn Inspect Element (Kiểm tra) trên trình duyệt -> chọn Console.

Bước 2: Tìm thẻ <script src=””> trong phần <head> để xác nhận jQuery đã được tải đúng chưa.

Ví dụ đoạn mã cần tìm:

<script src="/js/jquery-3.7.1.0.min.js" type="text/javascript"></script>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/j query.min.js"></script>

• Nếu URL sai hoặc thiếu dấu (/), hãy chỉnh lại đường dẫn đúng.
• Để kiểm tra link jQuery hoạt động không, copy URL và dán thẳng lên trình duyệt xem có tải được file không.

Meo: Khi sao chép link, hãy kiểm tra kỹ xem có dính khoảng trắng thừa ở đầu hoặc cuối URL không — đây là lỗi nhỏ nhưng rất dễ gây ra lỗi lớn!

4. Cập nhật WordPress, plugin và theme

Cập nhật phiên bản WordPress mới nhất

Trước tiên, hãy đảm bảo rằng phiên bản WordPress cốt lõi của bạn đã được cập nhật.

Truy cập vào Dashboard (Bảng điều khiển) -> Updates (Cập nhật).

Nếu có bản cập nhật mới, hãy nhấp vào “Update to version X.X.X” để tiến hành nâng cấp.

Cập nhật plugin và theme WordPress

Ngay bên dưới phần cập nhật WordPress core, bạn sẽ thấy danh sách các plugin cần cập nhật. Chọn tất cả các plugin cần nâng cấp và nhấn “Update Plugins“.

Tương tự, bạn vào mục Giao diện -> Chọn tất cả các theme và nhấn “Update Themes” để cập nhật.

Kết luận

Lỗi “WordPress jQuery Is Not Defined Error” có thể khiến website mất đi nhiều tính năng quan trọng và ảnh hưởng đến trải nghiệm người dùng. Tuy nhiên, chỉ cần nắm vững nguyên nhân và áp dụng đúng cách các bước khắc phục trên, bạn hoàn toàn có thể giải quyết lỗi này một cách triệt để. Chúc bạn thành công!

Những câu hỏi thường gặp