Tra Cứu Văn Bằng - WordPress Plugin

Plugin WordPress cho phép tra cứu và quản lý thông tin văn bằng, chứng chỉ trực tuyến.

📋 Tổng quan

Plugin "Tra Cứu Văn Bằng" cung cấp giải pháp toàn diện để quản lý và tra cứu thông tin văn bằng, chứng chỉ. Plugin hỗ trợ import/export dữ liệu CSV, tạo mã QR cho văn bằng, xuất bản sao văn bằng dưới dạng DOCX và chia sẻ thông tin xác thực.

✨ Tính năng chính

Quản trị (Admin)

• ✅ Quản lý danh sách văn bằng với giao diện thân thiện
• 📤 Import dữ liệu từ file CSV (hỗ trợ hàng loạt)
• 📥 Export dữ liệu ra file CSV
• 🖼️ Upload và quản lý hình ảnh văn bằng qua WordPress Media Library
• 🔍 Tìm kiếm và phân trang dữ liệu
• ✏️ Thêm, sửa, xóa thông tin văn bằng
• 📊 Hỗ trợ nhiều loại văn bằng (Văn Bằng, Văn Bằng Văn Hóa)

Frontend (Người dùng)

• 🔎 Tra cứu văn bằng theo mã người học
• 📱 Tạo mã QR tự động cho mỗi văn bằng
• 📄 Xuất bản sao văn bằng dưới dạng DOCX (Word)
• 📷 Xuất hình ảnh văn bằng (PNG) với html2canvas
• 🔗 Chia sẻ link xác thực văn bằng
• 🎨 Giao diện responsive, tương thích mobile

🔧 Yêu cầu hệ thống

• WordPress 5.0 trở lên
• PHP 7.4 trở lên
• Composer (để cài đặt dependencies)
• MySQL 5.6 trở lên

📦 Cài đặt

1. Cài đặt từ source code

# Clone repository
git clone https://github.com/yourusername/Tra-Cuu-VBCC.git

# Di chuyển vào thư mục plugin
cd Tra-Cuu-VBCC

# Cài đặt dependencies với Composer
composer install

2. Cài đặt vào WordPress

1. Upload thư mục plugin vào /wp-content/plugins/
2. Đăng nhập vào WordPress Admin
3. Vào Plugins → Tìm "Tra Cứu Văn Bằng"
4. Click Activate để kích hoạt plugin

3. Kích hoạt plugin

Khi kích hoạt, plugin sẽ tự động:

• Tạo bảng {prefix}_van_bang trong database
• Thiết lập cấu trúc dữ liệu cần thiết

📖 Hướng dẫn sử dụng

Quản trị viên

Import dữ liệu từ CSV

1. Vào QL Văn Bằng trong menu WordPress Admin
2. Click tab Import CSV
3. Chọn file CSV (định dạng mẫu):

   ma_nguoi_hoc,ho_ten,gioi_tinh,ngay_sinh,noi_sinh,dan_toc,chuyen_nganh,xep_loai,so_hieu_van_bang,so_vao_so_cap,ngay_cap,hinh_anh_url
   VB001,Nguyễn Văn A,Nam,01/01/1990,Hà Nội,Kinh,Công nghệ thông tin,Giỏi,12345,001,15/06/2024,https://example.com/image.jpg

4. Click Import CSV

Lưu ý:

• Dòng đầu tiên là header (sẽ được bỏ qua)
• Cột đầu tiên (ma_nguoi_hoc) là khóa duy nhất
• Định dạng ngày: dd/mm/yyyy
• Hình ảnh có thể là URL (sẽ được tải về và lưu vào Media Library)

Export dữ liệu

1. Vào QL Văn Bằng
2. Click nút Export CSV
3. File CSV sẽ được tải về với encoding UTF-8 (BOM)

Quản lý từng văn bằng

• Thêm mới: Click "Thêm văn bằng mới", điền thông tin và lưu
• Chỉnh sửa: Click "Sửa" ở văn bằng cần chỉnh sửa
• Xóa: Click "Xóa" (có xác nhận)

Người dùng (Frontend)

Thêm shortcode vào trang/bài viết

[tra_cuu_van_bang]

Shortcode sẽ hiển thị form tra cứu văn bằng.

Tra cứu văn bằng

1. Truy cập trang có shortcode [tra_cuu_van_bang]
2. Nhập Mã người học hoặc các thông tin khác
3. Click Tra cứu
4. Xem kết quả và thực hiện các thao tác:
   • 📱 Xem mã QR
   • 📄 Tải bản sao (DOCX)
   • 📷 Tải hình ảnh (PNG)
   • 🔗 Chia sẻ link xác thực

🗂️ Cấu trúc thư mục

Tra-Cuu-VBCC/
├── assets/
│   ├── css/                    # Stylesheets
│   │   ├── tcvb-style.css
│   │   ├── tcvb-combined-style.css
│   │   └── tcvb-combined-qr-modal.css
│   └── js/                     # JavaScript files
│       ├── tcvb-admin-script.js
│       ├── tcvb-script.js
│       └── tcvb-combined-script.js
├── includes/
│   ├── tcvb-activation.php     # Database setup
│   ├── tcvb-admin-page.php     # Admin UI & logic
│   ├── tcvb-shortcode.php      # Frontend shortcode
│   └── tcvb-combined-shortcode.php
├── vendor/                     # Composer dependencies
├── composer.json               # Composer configuration
├── tra-cuu-van-bang.php        # Plugin bootstrap
├── uninstall.php               # Uninstall cleanup
└── README.md                   # Tài liệu này

🔐 Bảo mật

Plugin áp dụng các biện pháp bảo mật WordPress chuẩn:

• ✅ Nonce verification cho mọi form submission
• ✅ Capability checks (manage_options cho admin)
• ✅ Data sanitization với sanitize_text_field()
• ✅ Output escaping với esc_html(), esc_url()
• ✅ Prepared statements cho SQL queries

🛠️ Phát triển

Dependencies

Plugin sử dụng các thư viện sau:

PHP:

• phpoffice/phpword - Tạo file DOCX

JavaScript (CDN):

• QRCode.js - Tạo mã QR
• html2canvas - Chụp ảnh màn hình
• docx.js - Xử lý file DOCX
• FileSaver.js - Lưu file từ browser

Testing

Kiểm tra cú pháp PHP:

php -l path\to\file.php

Debug

Bật WP Debug trong wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

🔄 Changelog

Version 2.4.8

• ✨ Cải thiện giao diện admin
• 🐛 Sửa lỗi import CSV với encoding UTF-8
• 🎨 Tối ưu responsive design

Version 2.0.0

• ✨ Thêm tính năng xuất DOCX
• ✨ Thêm mã QR cho văn bằng
• 🔧 Cải thiện xử lý hình ảnh

Version 1.0.0

• 🎉 Phiên bản đầu tiên
• ✨ Import/Export CSV
• ✨ Tra cứu văn bằng cơ bản

📝 License

[Chỉ định license của bạn ở đây]

👥 Tác giả

• Gemini & Rồng Con HG
• Website: https://gemini.google.com/

🤝 Đóng góp

Contributions, issues và feature requests đều được chào đón!

📞 Hỗ trợ

Nếu bạn gặp vấn đề hoặc có câu hỏi, vui lòng tạo issue trên GitHub repository.

---

Made with ❤️ for WordPress