manifest / utilities / warranty-csv-importer

Warranty CSV Importer

Plugin độc lập để import dữ liệu bảo hành từ file CSV/Excel vào hệ thống. Hỗ trợ tiếng Việt, export dữ liệu và ghi đè thông minh. Không xung đột với các plugin/theme khác.

by Websiteveloper · github.com/huanbv/warranty-csv-importer · website

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/huanbv/warranty-csv-importer/archive/refs/heads/main.zip

Readme github.com/huanbv/warranty-csv-importer ↗

Plugin WordPress chuyên nghiệp để import/export dữ liệu bảo hành từ file CSV/Excel với hỗ trợ tiếng Việt đầy đủ.

✨ Tính Năng Chính

📥 Import Dữ Liệu

✅ Import từ Excel (.xlsx) - Khuyên dùng
✅ Import từ CSV - Tự động xử lý encoding
✅ Drag & drop file tiện lợi
✅ Tự động sửa lỗi encoding tiếng Việt
✅ Kiểm tra trùng lặp thông minh

📤 Export Dữ Liệu

✅ Export ra Excel (.xlsx)
✅ Export ra CSV với UTF-8 BOM
✅ Giữ nguyên định dạng tiếng Việt
✅ Backup toàn bộ dữ liệu

🔄 Ghi Đè Thông Minh

✅ Popup xác nhận khi phát hiện trùng lặp
✅ 3 lựa chọn: Ghi đè / Bỏ qua / Hủy
✅ Hiển thị danh sách mã trùng
✅ Cập nhật dữ liệu an toàn

📋 File Mẫu

✅ Tải file mẫu có sẵn dữ liệu tiếng Việt
✅ Template chuẩn để nhập liệu
✅ Hướng dẫn chi tiết

📦 Cài Đặt

Cách 1: Upload trực tiếp

Tải thư mục warranty-csv-importer
Upload vào wp-content/plugins/
Kích hoạt trong WordPress Admin → Plugins
Truy cập Import Bảo Hành trong menu

Cách 2: Qua WordPress Admin

Plugins → Add New → Upload Plugin
Chọn file zip của plugin
Click Install Now
Kích hoạt plugin

🚀 Sử Dụng Nhanh

Import Dữ Liệu

1. Tải file mẫu (nếu cần)
2. Chuẩn bị file Excel/CSV
3. Chọn file hoặc kéo thả
4. Tick "Ghi đè" nếu muốn cập nhật dữ liệu cũ
5. Click "Import Dữ Liệu"

Export Dữ Liệu

1. Click "Export Excel" hoặc "Export CSV"
2. File tự động tải về

Ghi Đè Dữ Liệu

Không tick "Ghi đè":

Bỏ qua dữ liệu trùng
Popup hỏi nếu phát hiện trùng

Có tick "Ghi đè":

Tự động cập nhật dữ liệu trùng
Không hiện popup

📊 Định Dạng File

Các Cột Bắt Buộc

Cột	Mô Tả	Bắt Buộc
Post Type	Loại post (mặc định: guarantee_period)	Không
dbh_mabaohanh	Mã bảo hành	Có
dbh_masanpham	Mã sản phẩm	Không
dbh_tenkhachhang	Tên khách hàng	Không
dbh_diachi	Địa chỉ	Không
dbh_phone	Số điện thoại	Không
dbh_buydate	Ngày mua (m/d/Y, d/m/Y, Y-m-d)	Không
dbh_nvbanhang	Nhân viên bán hàng	Không
dbh_hangbaohanh	Hạng bảo hành	Không
dbh_hangbaohanh_other	Hạng bảo hành khác	Không
Status	Trạng thái (publish, draft...)	Không

File Mẫu

Post Type,dbh_mabaohanh,dbh_masanpham,dbh_tenkhachhang,dbh_diachi,dbh_phone,dbh_buydate,dbh_nvbanhang,dbh_hangbaohanh,dbh_hangbaohanh_other,Status
guarantee_period,BH001,SP001,Nguyễn Văn A,Hà Nội,0123456789,01/12/2025,Trần Thị B,12,12,publish
guarantee_period,BH002,SP002,Lê Thị C,TP HCM,0987654321,15/11/2025,Phạm Văn D,24,24,publish

🎯 Use Cases

Case 1: Import Lần Đầu

☐ Không tick ghi đè
→ Tất cả dữ liệu được thêm mới

Case 2: Cập Nhật Dữ Liệu

☑ Tick ghi đè
→ Dữ liệu trùng được cập nhật
→ Dữ liệu mới được thêm

Case 3: Export → Sửa → Import Lại

1. Export Excel
2. Sửa trong Excel
3. Import với tick ghi đè
→ Dữ liệu được cập nhật

🛠️ Yêu Cầu Hệ Thống

WordPress: 5.0 hoặc cao hơn
PHP: 7.2 hoặc cao hơn
PHP Extensions:
- ZipArchive (cho Excel)
- mbstring (cho tiếng Việt)

📝 Changelog

Version 1.1.0 - 2025-12-05

Tính Năng Mới

✅ File mẫu Excel tự động - Tạo sẵn file .xlsx khi activate
✅ File mẫu CSV tự động - Tạo sẵn file .csv khi activate
✅ 2 nút tải file mẫu - Riêng biệt cho Excel và CSV
✅ Dữ liệu mẫu thực tế - 5 bản ghi tiếng Việt đầy đủ
✅ Tự động kiểm tra - Tái tạo file nếu bị xóa

Cải Tiến

🔧 Phân biệt rõ "Tải Mẫu" vs "Export Dữ Liệu"
🔧 Giao diện button có icon phân loại
🔧 Class Sample Generator quản lý file mẫu
🔧 Hướng dẫn chi tiết hơn

Files Mới

includes/class-sample-generator.php
templates/warranty-sample.xlsx (auto)
templates/warranty-sample.csv (auto)
templates/README.md

Version 1.0.0 - 2025-12-05

Tính Năng

✅ Import từ CSV và Excel
✅ Export ra CSV và Excel
✅ Ghi đè dữ liệu thông minh
✅ Popup xác nhận trùng lặp
✅ File mẫu để download
✅ Tự động xử lý encoding tiếng Việt

Cải Tiến

✅ Giao diện đẹp với drag & drop
✅ Progress bar khi import
✅ Báo cáo chi tiết kết quả
✅ Namespace riêng (wci-) tránh xung đột

� Troubleshooting

Plugin hoạt động ngay sau khi kích hoạt, không cần cấu hình thêm.

Tùy Chỉnh

Bạn có thể sửa các file sau:

assets/css/admin.css - Giao diện
assets/js/admin.js - Chức năng
templates/sample-data.csv - File mẫu

🐛 Troubleshooting

Lỗi: "Không thể đọc file XLSX"

Nguyên nhân: Server không có ZipArchive
Giải pháp: Dùng file CSV thay vì Excel

Lỗi: Tiếng Việt bị lỗi font

Nguyên nhân: File CSV không phải UTF-8
Giải pháp:

Dùng Excel (.xlsx) - Tự động UTF-8
Hoặc lưu CSV với UTF-8 encoding

Lỗi: File quá lớn

Nguyên nhân: Giới hạn upload của server
Giải pháp: Tăng upload_max_filesize trong php.ini

🤝 Đóng Góp

Nếu bạn muốn đóng góp:

Fork repository
Tạo branch mới (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add some AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Tạo Pull Request

📞 Liên Hệ & Hỗ Trợ

Developer: Websiteveloper
Website: https://websiteveloper.com
Email: contact@websiteveloper.com

Báo Lỗi

Tạo issue trên GitHub hoặc email cho chúng tôi.

Yêu Cầu Tính Năng

Gửi email với mô tả chi tiết tính năng bạn cần.

📄 License

Plugin này được phát hành dưới giấy phép GPLv2 or later.

Copyright (C) 2025 Websiteveloper

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

Xem file LICENSE.txt để biết thêm chi tiết.

🙏 Credits

Developed by Websiteveloper
Không sử dụng thư viện bên ngoài
Tương thích với WordPress coding standards
Tested trên WordPress 5.0 - 6.4
Tested trên PHP 7.2 - 8.2

Warranty CSV Importer

Install

✨ Tính Năng Chính

📥 Import Dữ Liệu

📤 Export Dữ Liệu

🔄 Ghi Đè Thông Minh

📋 File Mẫu

📦 Cài Đặt

Cách 1: Upload trực tiếp

Cách 2: Qua WordPress Admin

🚀 Sử Dụng Nhanh

Import Dữ Liệu

Export Dữ Liệu

Ghi Đè Dữ Liệu

📊 Định Dạng File

Các Cột Bắt Buộc

File Mẫu

🎯 Use Cases

Case 1: Import Lần Đầu

Case 2: Cập Nhật Dữ Liệu

Case 3: Export → Sửa → Import Lại

🛠️ Yêu Cầu Hệ Thống

📝 Changelog

Version 1.1.0 - 2025-12-05

Tính Năng Mới

Cải Tiến

Files Mới

Version 1.0.0 - 2025-12-05

Tính Năng

Cải Tiến

� Troubleshooting

Tùy Chỉnh

🐛 Troubleshooting

Lỗi: "Không thể đọc file XLSX"

Lỗi: Tiếng Việt bị lỗi font

Lỗi: File quá lớn

🤝 Đóng Góp

📞 Liên Hệ & Hỗ Trợ

Báo Lỗi

Yêu Cầu Tính Năng

📄 License

🙏 Credits

🌟 Screenshots

1. Giao Diện Import

2. Popup Xác Nhận Trùng Lặp

3. Kết Quả Import