Việt hoá WooCommerce đúng cách mà không sợ mất khi cập nhật

Khi bạn cài WooCommerce, phần lớn nút bấm và thông báo trong shop đã tự hiện tiếng Việt nhờ gói dịch cộng đồng tải sẵn. Nhưng luôn còn vài chỗ trơ tiếng Anh: tên một trường ở trang thanh toán, dòng trạng thái đơn hàng, hay chuỗi do một plugin phụ sinh ra. Bài này giải thích cơ chế dịch của WooCommerce và cách bạn vá những chỗ còn sót một cách bền vững.

Cơ chế ngôn ngữ của WooCommerce hoạt động thế nào

WooCommerce không nhúng cứng tiếng Việt vào mã nguồn. Thay vào đó, mỗi chuỗi hiển thị được gói trong một hàm dịch, rồi WordPress tra cứu bản dịch tương ứng từ file ngôn ngữ. Có hai loại file đi cùng nhau:

• File .po (portable object — đối tượng dịch dạng văn bản): chứa từng cặp chuỗi gốc tiếng Anh và bản dịch tiếng Việt, con người đọc và sửa được.
• File .mo (machine object — đối tượng dịch dạng máy): bản biên dịch nhị phân của file .po, chỉ máy đọc. WordPress thực tế đọc file .mo này để hiện chữ, không đọc .po.

Vì vậy mỗi lần bạn sửa bản dịch, công cụ phải biên dịch lại .po thành .mo thì thay đổi mới có hiệu lực. Loco Translate làm bước này tự động sau mỗi lần lưu.

Gói dịch có sẵn và ngưỡng 90%

WordPress tự tìm bản dịch tiếng Việt cho WooCommerce trên kho cộng đồng translate.wordpress.org và chỉ tự tải về khi bản đó đạt độ hoàn thành tối thiểu (khoảng 90% theo tài liệu chính thức của WooCommerce). Gói này lưu tại wp-content/languages/plugins/. Đó là lý do bạn cài xong đã thấy gần hết tiếng Việt mà chưa làm gì. Phần chưa được cộng đồng dịch hoặc dịch chưa hợp ngữ cảnh shop của bạn chính là việc còn lại.

Dịch chuỗi còn sót bằng Loco Translate

Loco Translate là plugin miễn phí cho phép sửa file ngôn ngữ ngay trong trang quản trị, không cần phần mềm rời hay dòng lệnh. Các bước:

1. Cài và kích hoạt Loco Translate từ kho plugin WordPress.
2. Vào Loco Translate → Plugins → WooCommerce.
3. Bấm New language, chọn Tiếng Việt (vi_VN). Ở mục thư mục lưu, chọn Custom (thư mục riêng) thay vì System hay Author — đây là điểm mấu chốt sẽ giải thích bên dưới.
4. Bấm vào ngôn ngữ vừa tạo, dùng ô lọc để tìm chuỗi tiếng Anh còn sót, gõ bản dịch tiếng Việt vào ô bên dưới rồi Save.

Để vá đúng chỗ, bạn nên thao tác thật trên shop: mở trang sản phẩm, giỏ hàng, thanh toán, email đơn hàng và ghi lại đúng nguyên văn chuỗi tiếng Anh còn hiện. Sau đó dán vào ô lọc của Loco để định vị nhanh thay vì cuộn qua hàng nghìn chuỗi.

Tại sao phải chọn thư mục Custom

Nếu lưu bản dịch vào thư mục mặc định của plugin, lần cập nhật WooCommerce kế tiếp sẽ ghi đè và bạn mất sạch công sức. Khi chọn Custom, Loco Translate lưu file vào wp-content/languages/loco/plugins/ — nằm ngoài thư mục plugin nên an toàn qua mọi lần nâng cấp. WooCommerce đọc bản dịch theo thứ tự ưu tiên, nên file tuỳ chỉnh của bạn sẽ thắng gói cộng đồng ở những chuỗi trùng. Nếu tự xuất file thủ công, quy ước đặt tên là woocommerce-vi_VN.mo đặt trong wp-content/languages/woocommerce/.

Đồng bộ lại sau khi cập nhật

Mỗi phiên bản WooCommerce mới có thể thêm chuỗi mới. Vào lại Loco Translate, mở bản dịch và bấm nút Sync để quét chuỗi mới từ file mẫu .pot, rồi dịch tiếp phần phát sinh. Đây là việc nên kiểm tra định kỳ, nhất là sau khi nâng cấp lớn.

Việt hoá cả plugin phụ và theme

Một shop thật hiếm khi chỉ có WooCommerce. Cổng thanh toán, đơn vị vận chuyển, plugin lọc sản phẩm — mỗi cái đẻ thêm chuỗi riêng. Loco Translate xử lý chúng theo đúng cách trên: vào Plugins, chọn đúng plugin đó rồi dịch. Với chuỗi nằm trong giao diện, bạn vào Themes thay vì Plugins. Khi tích hợp nhiều thành phần, việc rà từng chuỗi tiếng Anh sót lại là một phần của quy trình dựng và tối ưu shop WooCommerce chỉn chu, đặc biệt khi bạn ghép cổng MoMo hay vận chuyển GHN vốn có nhiều thông báo riêng.

Chỉnh định dạng ngày và tiền theo kiểu Việt

Việt hoá không dừng ở chữ. Hai thứ thường bị bỏ quên là cách hiển thị ngày và tiền.

Nhiều shop muốn đổi ký hiệu mặc định ₫ thành chữ VNĐ. WooCommerce không có sẵn lựa chọn này trong giao diện, nên cần một đoạn mã nhỏ thêm vào theme con (child theme — giao diện con để giữ tuỳ chỉnh an toàn). Hãy đặt nó trong theme con chứ đừng sửa thẳng theme gốc để khỏi mất khi cập nhật.

Sai lầm thường gặp khi việt hoá

• Sửa thẳng file .po trong thư mục plugin: mất khi cập nhật. Luôn dùng thư mục Custom.
• Sửa .po nhưng quên biên dịch .mo: nếu sửa bằng tay ngoài Loco, chữ không đổi vì WordPress chỉ đọc .mo.
• Dịch số ít, bỏ số nhiều và biến thể: nhiều chuỗi WooCommerce có dạng đếm; dịch thiếu sẽ lòi tiếng Anh khi có nhiều mục.
• Đụng vào trang bán hàng mà chưa tối ưu tốc độ: sau khi việt hoá, đừng quên rà lại trải nghiệm thanh toán và tốc độ trang nếu bạn đang chuẩn bị SEO cho web bán hàng.

Câu hỏi thường gặp

Việt hoá WooCommerce có mất khi cập nhật plugin không?

Không, nếu bạn lưu bản dịch vào thư mục Custom (wp-content/languages/loco/) bằng Loco Translate. Bản dịch nằm ngoài thư mục plugin nên cập nhật không ghi đè. Sửa thẳng trong thư mục plugin thì sẽ mất.

Cài WooCommerce xong đã có tiếng Việt sẵn chưa?

Phần lớn có sẵn nhờ gói dịch cộng đồng được WordPress tự tải khi đạt ngưỡng hoàn thành. Tuy vậy vẫn còn chuỗi sót hoặc chưa hợp ngữ cảnh shop của bạn, cần bổ sung thủ công.

Dịch bằng Loco Translate hay PoEdit tốt hơn?

Loco Translate tiện cho đa số vì làm ngay trong trang quản trị và tự biên dịch .mo. PoEdit là phần mềm máy tính, phù hợp người dịch lượng lớn quen làm việc với file ngoại tuyến.