Khi website của bạn cần đổi cấu trúc đường dẫn trước khi đưa vào sitemap, bạn có thể cài một đoạn script chuyển đổi URI trong phần cài đặt SEO. Script này không dùng để sửa dữ liệu gốc của bài viết hay sản phẩm, mà dùng để tạo ra phiên bản URI mới khi hệ thống hiển thị và xuất sitemap XML.

Khi nào nên dùng script chuyển đổi URI

Bạn nên dùng tính năng này khi:
  • Muốn đổi tiền tố đường dẫn, ví dụ từ /posts/... sang /blog/...
  • Muốn chuẩn hóa cấu trúc link cho sitemap
  • Muốn giữ dữ liệu cũ trong hệ thống nhưng xuất sitemap theo định dạng URI mới
Nếu website của bạn không cần đổi cấu trúc link, có thể để trống phần này.

Script này tác động đến đâu

Script chuyển đổi URI có 3 đặc điểm quan trọng:
  • Chỉ áp dụng khi hệ thống tạo URI dùng cho sitemap
  • Không ghi đè URI gốc đã lưu trong dữ liệu
  • Nếu script sai cú pháp, hệ thống sẽ không cho lưu cài đặt
Nói ngắn gọn: đây là lớp chuyển đổi ở bước xuất sitemap, không phải công cụ sửa dữ liệu hàng loạt.

Cách cài đặt

  1. Vào khu vực quản trị SEO.
  2. Mở menu Cài đặt.
  3. Tìm trường Script chuyển đổi liên kết URI.
  4. Dán đoạn script bạn muốn dùng vào ô này.
  5. Nhấn Lưu hoặc dùng Ctrl + S / Command + S.
Sau khi lưu thành công, hệ thống sẽ dùng script đó để tạo URI sitemap.
Screenshot 2026-03-26 at 23.02.56.png

Ví dụ dễ hiểu

Giả sử website của bạn có nội dung truyện dài kỳ và muốn hiển thị mỗi loại nội dung theo một đường dẫn khác nhau trong sitemap. Bạn có thể dùng script sau:
javascript var uri = link.uri; if (link.sourceType == 'ezyarticle_posts') { var post = postService.getSimplePostById(link.sourceId); if (post != null) { if (post.type == 'TRUYEN_DAI_KY') { if (post.parentId == 0) { uri = '/story-details?slug=' + post.slug; } else { uri = '/story-reading?slug=' + post.slug + '&chapterIndex=' + post.priority; } } } } uri;
Ví dụ nếu bạn chưa muốn chuyển đổi gì bạn có thể để trống cài đặt.

Cách hiểu đơn giản về nội dung script

Script là một đoạn JavaScript ngắn.
Trong đó:
  • link là liên kết hiện tại mà hệ thống đang xử lý
  • link.getLinkUri() là URI gốc của liên kết đó
  • Kết quả cuối cùng của script phải là URI mới mà bạn muốn đưa vào sitemap
Nếu bạn không quen viết JavaScript, cách an toàn nhất là dùng các mẫu thay thế đơn giản như replace(...).

Kiểm tra sau khi cài đặt

Sau khi lưu script, bạn nên kiểm tra ngay:
  1. Vào mục Sitemap
  2. Chọn một nhóm liên kết
  3. Xem cột URL có hiển thị đúng URI mới hay chưa
  4. Nếu đã đúng, bấm nút lưu sitemap để tạo lại file sitemap XML
Cách này giúp bạn xác nhận script đang cho ra đúng đường dẫn trước khi gửi sitemap cho công cụ tìm kiếm.

Khi hệ thống báo lỗi

Nếu bấm lưu mà không thành công, nguyên nhân thường là:
  • Script sai cú pháp
  • Script không trả về kết quả hợp lệ
  • Có ký tự thừa khi copy/paste
Cách xử lý nhanh:
  • Xóa bớt phần phức tạp
  • Thử lại với mẫu đơn giản như link.getLinkUri()
  • Khi lưu được rồi mới bổ sung từng bước chuyển đổi

Lưu ý quan trọng

  • Nên thử trên một quy tắc đơn giản trước
  • Không nên thay đổi quá nhiều cấu trúc URI cùng lúc nếu chưa kiểm tra sitemap
  • Nếu website có nhiều loại nội dung, hãy xác nhận tất cả các nhóm liên kết vẫn ra đúng URL
  • Nếu bạn không có người phụ trách kỹ thuật, hãy nhờ bộ phận triển khai hỗ trợ viết script đầu tiên

Kết luận

Tính năng Script chuyển đổi liên kết URI giúp bạn linh hoạt đổi URI dùng trong sitemap mà không cần sửa dữ liệu gốc. Cách dùng an toàn nhất là nhập một đoạn JavaScript ngắn, lưu lại, vào mục Sitemap để kiểm tra kết quả, rồi mới tạo lại sitemap XML.
Nếu bạn muốn, mình có thể viết tiếp cho bạn một phiên bản bài này theo đúng format tài liệu hướng dẫn sử dụng sản phẩm, hoặc soạn sẵn 5-10 mẫu script phổ biến để người dùng chỉ việc copy dùng.