Lỗi “XML declaration allowed only at the start of the document” trên sitemap WordPress là một sự cố thường gặp, khiến sitemap không thể hiển thị đúng định dạng và gây ảnh hưởng trực tiếp đến việc các công cụ tìm kiếm như Google lập chỉ mục cho website của bạn. Bài viết này, sẽ hướng dẫn bạn cách khắc phục lỗi trên một cách nhanh chóng và dễ dàng nhất, giúp sitemap hoạt động ổn định trở lại.
Cách sửa “XML declaration allowed only at the start of the document”
Để khắc phục lỗi “XML declaration allowed only at the start of the document” trên sitemap WordPress, bạn hãy thực hiện theo các bước sau. Lỗi này thường do khoảng trắng hoặc ký tự lạ gây ra, làm gián đoạn việc Google lập chỉ mục website của bạn.
Bước 1: Tạo file whitespace_fix.php
Đầu tiên, bạn đăng nhập vào hosting và truy cập thư mục gốc của WordPress. Tại đây, bạn tạo một file mới tên là whitespace_fix.php.
Sau đó mở file để chỉnh sửa và dán đoạn mã sau vào rồi lưu lại.
<?php
function ___wejns_wp_whitespace_fix($input) {
$allowed = false;
$found = false;
foreach (headers_list() as $header) {
if (preg_match("/^content-type:\\s+(text\\/|application\\/((xhtml|atom|rss)\\+xml|xml))/i", $header)) {
$allowed = true;
}
if (preg_match("/^content-type:\\s+/i", $header)) {
$found = true;
}
}
if ($allowed || !$found) {
return preg_replace("/\\A\\s*/m", "", $input);
} else {
return $input;
}
}
ob_start("___wejns_wp_whitespace_fix");
?>
Bước 2: Include file whitespace_fix.php vào index.php
Tiếp theo, bạn mở file index.php cũng nằm trong thư mục gốc của WordPress.
Bạn thêm dòng include('whitespace_fix.php'); vào ngay đầu file, trước bất kỳ đoạn mã nào khác, rồi lưu lại.
Ví dụ:
<?php
include('whitespacefix.php');
// các dòng mã tiếp theo...
Bước 3: Kiểm tra kết quả
Cuối cùng, bạn hãy xóa bộ nhớ đệm (cache) của website và truy cập lại đường dẫn sitemap (thường là /sitemap_index.xml) để kiểm tra. Nếu sitemap hiển thị đúng định dạng XML và không còn thông báo lỗi, bạn đã xử lý thành công.
Lưu ý khi sửa lỗi “XML declaration allowed only at the start of the document”
Lỗi “XML declaration allowed only at the start of the document” phát sinh khi có sự xuất hiện của các khoảng trắng không mong muốn, ký tự lạ, hoặc BOM (Byte Order Mark) ở vị trí trước thẻ khai báo XML. Để khắc phục triệt để vấn đề này, bạn chỉ cần kiểm tra và loại bỏ các yếu tố gây lỗi khỏi những tệp tin cấu hình hoặc theme, đặc biệt là wp-config.php và functions.php.
Sau khi hoàn tất chỉnh sửa, một bước quan trọng bạn không nên bỏ qua là xóa bộ nhớ đệm (cache) của website và kiểm tra lại sitemap để chắc chắn rằng tệp tin đã được Google đọc và xử lý thành công.
Trên đây là toàn bộ hướng dẫn để sửa lỗi “XML declaration allowed only at the start of the document” trên Sitemap WordPress. Nếu trong quá trình thực hiện bạn có bất kỳ thắc mắc hoặc cần hỗ trợ thêm, đừng ngần ngại để lại bình luận bên dưới bài viết, chúng tôi sẽ phản hồi để hỗ trợ bạn một cách chi tiết và kịp thời.
VIETNIX – DỊCH VỤ HOSTING, VPS TỐC ĐỘ CAO, ỔN ĐỊNH, BẢO MẬT
- Địa chỉ: 265 Hồng Lạc, Phường Bảy Hiền, Thành Phố Hồ Chí Minh
- Điện thoại: 1800 1093
- Email liên hệ: sales@vietnix.com.vn
- Website: https://vietnix.vn/
