=== Vietnam Store Toolkit for WooCommerce - Nhật ký thay đổi tiếng Việt ===

= 1.1.6 (08/09/2026) =

* Bổ sung Phường / Xã đã xác thực làm node con của Tỉnh / Thành phố trong cây khu vực Shipping Zones gốc của WooCommerce, đồng thời duy trì hành vi quốc gia, tỉnh/thành, mã bưu chính, thứ tự zone và cache.
* Chất lượng: Tăng cường xác thực bản phát hành bằng CI theo giai đoạn và mức độ rủi ro, cùng các gate bền vững cho quyền sở hữu workflow, review và phát hành.

= 1.1.5 (30/08/2026) =

* Chất lượng: Khôi phục WordPress Plugin Check nghiêm ngặt làm tiêu chuẩn CI chặn bản phát hành sau khi xử lý các phát hiện trong mã nguồn và gỡ bỏ ngoại lệ tạm thời của 1.1.4; CI thông thường hiện kiểm tra đúng gói WordPress.org đã được rà soát.
* Chất lượng: Bổ sung gate bản địa hóa tiếng Việt xác định cho độ đầy đủ POT/PO, tính đồng nhất locale, tính nhất quán MO/PHP/JSON, hợp đồng bản địa hóa JavaScript hiển thị và Plugin Check nghiêm ngặt không cảnh báo trong cả CI lẫn quy trình kiểm tra trước khi phát hành WordPress.org.
* Tương thích: Duy trì ưu tiên gói ngôn ngữ WordPress.org và bản dịch tiếng Việt dự phòng đi kèm trên WordPress 6.3 trở lên mà không tải text domain của plugin quá sớm.
* Tương thích: Bổ sung ngữ nghĩa bàn giao `original_prefix_carrier` theo hướng cộng thêm, đồng thời duy trì hành vi cũ của `carrier` và metadata đã lưu.
* Dành cho nhà phát triển: Bổ sung helper bảo mật nội bộ trung lập với nhà cung cấp cho keyed hash và che dữ liệu nhạy cảm, cùng nền tảng logger có cấu trúc.
* Dành cho nhà phát triển: Tài liệu hóa các hợp đồng mở rộng ổn định cho vận chuyển, theo dõi đơn hàng và hóa đơn điện tử, đồng thời bổ sung kiểm thử hợp đồng kiến trúc vào CI.

= 1.1.4 (22/08/2026) =

* Sửa lỗi: Định dạng đúng tỉnh/thành và phường/xã hợp lệ cho dữ liệu địa chỉ Việt Nam cũ bị thiếu quốc gia mà không nhận nhầm địa chỉ quốc tế không xác định.
* Sửa lỗi: Xác thực cặp tỉnh/thành và phường/xã Việt Nam trước khi lưu địa chỉ đơn hàng trong trang quản trị WooCommerce.
* Bảo mật: Chỉ cho phép MIME PDF/XML trong đúng ngữ cảnh tải lên hóa đơn điện tử đang hoạt động, đồng thời từ chối URL theo dõi thủ công không dùng HTTP/HTTPS trước khi thay đổi dữ liệu đơn hàng.
* Bảo mật: Bổ sung cơ chế giới hạn tần suất có ngưỡng hữu hạn và hỗ trợ filter cho tra cứu đơn hàng công khai, dùng khóa người yêu cầu dựa trên HMAC thay vì lưu địa chỉ IP thô.
* Tương thích: Xác nhận WordPress 7.1 và WooCommerce 11.0.1 với HPOS, Classic Checkout, Checkout Blocks và Store API.
* Dành cho nhà phát triển: Mở rộng kiểm thử hợp đồng cho địa chỉ và audit hardening, đồng thời tích hợp các bộ kiểm thử vào CI.

= 1.1.3 (14/08/2026) =

* Cải tiến: Thu gọn biểu mẫu Tạo vận đơn và Thêm sự kiện vận chuyển trong metabox Vận chuyển của đơn hàng, giữ giao diện gọn gàng và vẫn hỗ trợ thao tác bằng bàn phím.
* Sửa lỗi: Giữ các sự kiện Hành trình vận chuyển thủ công hiển thị trong metabox đơn hàng sau khi lưu.
* Cập nhật: Tinh chỉnh hàng Trạng thái vận chuyển ở trang Tra cứu đơn hàng: Core sẽ ẩn hàng này nếu chưa có sự kiện hành trình, còn thông tin trạng thái do trình kết nối cung cấp vẫn hiển thị.
* Dành cho nhà phát triển: Bổ sung điểm mở rộng để trình kết nối vận chuyển có thể thêm sự kiện hành trình mà không ghi đè trạng thái chi tiết của hãng vận chuyển.

= 1.1.2 (30/7/2026) =

* Bổ sung Plugin URI cùng các URL có thể nhấp tới Website, Tài liệu, Hỗ trợ và nội dung chuyên đề chính thức để xác minh nguồn sản phẩm.
* Thu gọn biểu mẫu cập nhật vận đơn thủ công sau khi đã có mã vận đơn; quản trị viên mở lại biểu mẫu bằng dòng “Cập nhật mã vận đơn” có màu theo admin color scheme của từng người dùng.
* Bổ sung trạng thái vận đơn, dịch vụ, tiền COD và thời gian cập nhật trong email được kích hoạt bởi trình kết nối vận chuyển nội bộ; không hiển thị biểu phí nội bộ của tài khoản shop.
* Dùng tiêu đề riêng `Cập nhật vận chuyển: {trạng thái vận đơn} - Đơn hàng #{order_number}` cho email do plugin nội bộ kích hoạt.
* Sửa triệt để vòng đời placeholder của email vận chuyển và hóa đơn điện tử: khôi phục `{site_title}`, `{site_address}`, `{site_url}`, `{store_email}` ở mỗi lần gửi; làm mới placeholder đơn hàng/vận đơn/hóa đơn và hỗ trợ đúng trong subject, heading cùng nội dung bổ sung qua nhiều lần gửi.
* Ẩn dòng thông tin VAT trong cột Thông tin của danh sách đơn hàng khi tính năng nhận yêu cầu hóa đơn tại trang thanh toán bị tắt, đồng thời giữ nguyên bộ lọc và khả năng xuất dữ liệu hóa đơn lịch sử.
* Chỉ hiển thị biểu mẫu Hành trình vận chuyển thủ công trong metabox đơn hàng sau khi vận đơn thủ công có mã theo dõi đã được tạo.
* Sửa số lượng dịch vụ vận chuyển đang bật trên trang Vietnam store bằng cách đếm trực tiếp các nhà cung cấp khả dụng đã đăng ký.
* Bổ sung email WooCommerce cho quy trình hóa đơn điện tử với mẫu HTML và văn bản thuần, tùy chỉnh trong cài đặt email, gửi thủ công từ metabox đơn hàng và đính kèm tệp PDF/XML hiện có.
* Tự động chuyển trạng thái hóa đơn sang Đã gửi cho khách hàng sau khi gửi email thành công, đồng thời lưu trạng thái, thời gian gửi và hiển thị thông báo kết quả.
* Hoàn thiện bản dịch tiếng Việt cho chức năng gửi email hóa đơn điện tử.

= 1.1.1 (26/7/2026) =

* Bổ sung menu Vietnam store ngay dưới WooCommerce cùng trang cấu hình tập trung cho các tính năng, dịch vụ và công cụ vận hành.
* Cung cấp switch bật/tắt trường địa chỉ, chuẩn hóa điện thoại, thông tin vận chuyển cho khách hàng, quản lý đơn hàng, nhận yêu cầu hóa đơn và quy trình hóa đơn điện tử; màu switch tuân theo color scheme của người dùng.
* Thiết kế hero quản trị với icon plugin và icon menu SVG hình vuông bo góc, ngôi sao năm cánh khoét âm; CSS mask giúp icon hiển thị ổn định khi chuyển trang.
* Tách việc nhận yêu cầu hóa đơn tại checkout khỏi tính thuế WooCommerce và quy trình quản lý hóa đơn điện tử.
* Duy trì khả năng xem thông tin hóa đơn lịch sử trong hộp đơn hàng, bộ lọc và tệp CSV khi cửa hàng ngừng nhận yêu cầu mới.
* Chuyển quy trình hóa đơn điện tử sang chế độ chỉ đọc khi tắt, đồng thời tiếp tục hiển thị trạng thái, nhà cung cấp, số/ký hiệu, ngày phát hành, URL tra cứu, PDF/XML và lịch sử.
* Thay tùy chọn hóa đơn trùng lặp trong WooCommerce Tax Settings bằng liên kết đến trang Vietnam store.
* Sửa logic email Theo dõi vận chuyển để chọn bản ghi hiện hành mới nhất, tránh dùng lại mã vận đơn bị hủy sau khi tạo vận đơn thay thế.
* Rút gọn mã vận đơn GHTK trên giao diện và clipboard còn dãy số cuối sau dấu chấm; mã đầy đủ vẫn được lưu cho API và xử lý nội bộ.
* Tự động ẩn Hành trình vận chuyển thủ công khi có ít nhất một dịch vụ vận chuyển khả dụng, đồng thời giữ biểu mẫu này khi không có trình kết nối.
* Hoàn thiện bản dịch tiếng Việt cho trang cài đặt, trạng thái tính năng và chế độ chỉ đọc hóa đơn.

= 1.1.0 (17/7/2026) =

* Hỗ trợ Cart và Checkout Blocks cho địa chỉ Việt Nam với danh sách Phường/Xã phụ thuộc Tỉnh/Thành.
* Cho phép nhúng Cart/Checkout Block trên trang tùy chỉnh chưa được gán làm trang giỏ hàng hoặc thanh toán mặc định của WooCommerce.
* Đồng bộ địa chỉ Blocks với các trường `state` và `city` của Store API, bao gồm chuẩn hóa và xác thực phía máy chủ.
* Tích hợp yêu cầu hóa đơn GTGT vào Checkout Block qua Additional Checkout Fields API với điều kiện hiển thị và xác thực tương ứng.
* Chuyển yêu cầu hóa đơn GTGT vào phần Tùy chọn thuế; checkout, quản trị đơn hàng và workflow hóa đơn chỉ hoạt động khi WooCommerce bật tính thuế.
* Bổ sung khả năng chuẩn hóa và xác thực số điện thoại Việt Nam cho Store API.
* Hiển thị thông tin vận chuyển trên trang xác nhận đơn hàng của Checkout Block và trang xem đơn hàng trong My Account.
* Xác nhận luồng VietQR trên trang xác nhận đơn hàng và khai báo tương thích Cart/Checkout Blocks sau khi kiểm thử cả Classic lẫn Blocks.
* Cung cấp phương thức Quy tắc phí vận chuyển theo Shipping Zones, gồm điều kiện địa chỉ đến cấp phường/xã, tổng giỏ hàng, khối lượng, mức phân loại vận chuyển, ngưỡng miễn phí, COD, phí mặc định và nhập/xuất CSV.
* Rút gọn các nhãn yêu cầu hóa đơn, vận chuyển, bộ lọc và tra cứu đơn hàng để loại bỏ hậu tố “Việt Nam” không cần thiết.
* Mở rộng công cụ quản lý đơn hàng tương thích HPOS với bộ lọc hóa đơn GTGT, đơn vị vận chuyển, mã vận đơn, trạng thái email theo dõi, tiến độ bàn giao, số điện thoại chuẩn hóa và địa chỉ Việt Nam.
* Cung cấp thao tác hàng loạt để gửi lại email theo dõi, cập nhật đơn vị vận chuyển, xuất CSV giao hàng/hóa đơn và đánh dấu tiến độ bàn giao.
* Xây dựng quy trình hóa đơn điện tử trung lập nhà cung cấp với bảy trạng thái, số/ký hiệu hóa đơn, ngày phát hành, URL tra cứu, tệp PDF/XML, bộ lọc, dữ liệu CSV và nhật ký thay đổi.
* Bổ sung cột Thông tin gọn trên danh sách đơn hàng để hiển thị thông tin vận đơn và trạng thái VAT theo điều kiện.
* Hỗ trợ tracking không cần API với mẫu URL theo hãng, liên kết tự tạo từ mã vận đơn, hãng tùy chỉnh, hành trình thủ công và trang tra cứu bằng block/shortcode.
* Đơn giản hóa hộp Vận chuyển khi chưa đăng ký nhà cung cấp vận chuyển.
* Hoàn thiện bản dịch tiếng Việt cho nút lưu/cập nhật mã vận đơn và các chuỗi giao diện còn thiếu.
* Đặt liên kết Cài đặt email bên cạnh tùy chọn gửi thông tin vận chuyển cho khách hàng.
* Sắp xếp trường Tên và Số điện thoại trên cùng một hàng trong địa chỉ giao hàng.

= 1.0.2 (5/7/2026) =

* Bổ sung mẫu email WooCommerce gửi khách hàng để cập nhật thông tin theo dõi vận chuyển tại Việt Nam.
* Cung cấp hộp kiểm trong phần thông tin vận chuyển Việt Nam của đơn hàng để gửi email theo dõi khi quản trị viên lưu mã vận đơn thủ công.
* Điều chỉnh bảng chi tiết trong email theo dõi vận chuyển cho phù hợp với bố cục mẫu email mới của WooCommerce.
* Hoàn thiện bản dịch tiếng Việt cho email theo dõi vận chuyển và các điều khiển gửi thủ công.

= 1.0.1 (28/6/2026) =

* Bổ sung biểu mẫu vận chuyển thủ công trong phần thông tin vận chuyển Việt Nam của đơn hàng khi chưa đăng ký trình kết nối của đơn vị vận chuyển.
* Cho phép chọn hãng vận chuyển và nhập mã vận đơn thủ công bằng siêu dữ liệu đơn hàng `_vck_shipping_*` tiêu chuẩn của plugin.
* Mở rộng công cụ di chuyển dữ liệu từ Le Van Toan để quét và đồng bộ địa chỉ thanh toán, địa chỉ giao hàng trong hồ sơ khách hàng, địa chỉ đơn hàng và dữ liệu vận chuyển.
* Cải thiện việc di chuyển địa chỉ cũ đối với bí danh phường/xã trước năm 2025 và địa chỉ khách hàng Việt Nam thiếu giá trị quốc gia.
* Tách thông báo tiến trình di chuyển theo dòng địa chỉ đơn hàng, dòng địa chỉ khách hàng và đơn hàng vận chuyển.
* Sắp xếp lại các trường địa chỉ Việt Nam trong hồ sơ khách hàng theo thứ tự: quốc gia, tỉnh/thành phố, phường/xã, dòng địa chỉ 1, dòng địa chỉ 2 và mã bưu chính.

= 1.0.0 (27/6/2026) =

* Bản phát hành công khai đầu tiên với tên Vietnam Store Toolkit for WooCommerce.
* Cung cấp danh sách chọn tỉnh/thành phố và phường/xã Việt Nam cho WooCommerce.
* Tích hợp dữ liệu đơn vị hành chính hai cấp của Việt Nam cho 34 tỉnh/thành phố và 3.321 phường/xã/đặc khu.
* Điều chỉnh các trường thanh toán tại Việt Nam cho họ và tên, thông tin liên hệ, khả năng hiển thị quốc gia, trường công ty và mã bưu chính.
* Bổ sung các trường yêu cầu hóa đơn GTGT và thông tin hóa đơn trong trang quản trị đơn hàng.
* Hiển thị thông tin hóa đơn GTGT trong email New Order gửi quản trị viên cửa hàng.
* Tích hợp VietQR vào WooCommerce Direct bank transfer.
* Cung cấp bộ chọn ngân hàng Việt Nam và mẫu nội dung chuyển khoản cho tài khoản ngân hàng.
* Hiển thị mã QR VietQR trên đơn hàng ở giao diện người dùng, email khách hàng và trang quản trị.
* Bổ sung thao tác sao chép số tài khoản ngân hàng và nội dung chuyển khoản.
* Hỗ trợ chuẩn hóa số điện thoại Việt Nam và lưu trữ siêu dữ liệu tương ứng.
* Xây dựng khung tích hợp đơn vị vận chuyển với siêu dữ liệu đơn hàng được chuẩn hóa và các thao tác quản trị.
* Làm gọn dòng vận chuyển trong trang quản trị WooCommerce bằng cách ẩn siêu dữ liệu kỹ thuật của mức phí vận chuyển.
* Cho phép chọn trước đơn vị vận chuyển khi tạo vận đơn dựa trên phương thức khách hàng chọn tại trang thanh toán, nếu phương thức đó có siêu dữ liệu của đơn vị vận chuyển.
* Bổ sung WooCommerce Status Tools với quy trình một lần nhấp để xử lý địa chỉ đơn hàng và dữ liệu vận chuyển từ plugin của Le Van Toan.
* Thêm cảnh báo bảo vệ quá trình di chuyển cho các cửa hàng chuyển từ plugin của Le Van Toan.
* Chuẩn bị text domain cho WordPress.org, tiền tố công khai duy nhất, thao tác AJAX, biến JavaScript toàn cục và cơ chế kiểm tra quyền yêu cầu.
* Hoàn thiện bản dịch tiếng Việt.
