=== Vietnamtutor Core ===
Contributors: anthonynguyen, vietnamtutor
Donate link: https://vietnamtutor.com
Tags: security, performance, admin, white-label, vietnamtutor, smtp, contact-buttons, system-info, custom-404
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0-alpha.10
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Hệ thống quản trị website WordPress toàn diện: Bảo mật đa lớp, tối ưu hóa hiệu năng, White-label thương hiệu, và đồng bộ tự động với Central Admin.

== Description ==

**Vietnamtutor Core** là plugin nền tảng được phát triển riêng cho hệ sinh thái website WordPress thuộc Vietnamtutor. Plugin cung cấp giải pháp toàn diện về bảo mật, tối ưu tốc độ tải trang, tùy biến thương hiệu quản trị (White-label), tiện ích liên hệ nổi đa kênh, cấu hình SMTP ổn định và cơ chế tự động đồng bộ tài nguyên với máy chủ quản trị trung tâm (Vietnamtutor Central Admin Server).

### Tính Năng Nổi Bật

* **Bảo Mật Đa Lớp (Hardening & Protection):**
    * Chống tấn công Brute-force: Giới hạn số lần đăng nhập và đăng ký sai với thời gian tạm khóa linh hoạt.
    * Ẩn thông tin nhạy cảm: Ẩn phiên bản WordPress trong header và feeds, tắt XML-RPC, vô hiệu hóa file editor (`DISALLOW_FILE_EDIT`).
    * Tự động chặn Author Query Scanning (`?author=N`) để bảo vệ tài khoản quản trị viên.
    * Chặn truy cập trái phép vào REST API cho người dùng chưa xác thực.
    * Tự động cấu hình Security Headers (X-Content-Type-Options, X-Frame-Options, X-XSS-Protection, Referrer-Policy, HSTS) qua cả PHP runtime và file `.htaccess`.
    * Bảo vệ các tệp nhạy cảm (`wp-config.php`, `.htaccess`, error logs, backup files) và vô hiệu hóa Directory Browsing.
    * Bộ lọc bình luận chống spam thông minh (chặn liên kết thừa, ký tự ngoại lai, honeypot).

* **Tối Ưu Hiệu Năng (Performance Tuning):**
    * Dọn dẹp header WordPress: Loại bỏ RSD link, WLW manifest, shortlinks, emoji scripts và oEmbed không cần thiết.
    * Tắt Gutenberg Block Editor, khôi phục Classic Editor gọn nhẹ, tối ưu trải nghiệm biên tập nội dung.
    * Giới hạn dung lượng tải lên thư viện Media (Upload File Size Limit) chống quá tải bộ nhớ lưu trữ.
    * Tự động dọn dẹp cơ sở dữ liệu định kỳ mỗi ngày (xóa post revisions cũ, auto drafts, rác thùng rác, spam comments, transients quá hạn).
    * Hỗ trợ tải lên định dạng vector SVG an toàn.

* **Đồng Bộ & Đăng Ký Tự Động (Central Admin Sync):**
    * Cơ chế Zero-Configuration Auto-Discovery: Tự động kích hoạt đăng ký domain website với máy chủ trung tâm (`clients.vietnamtutor.com`).
    * Tự động đồng bộ gói dịch vụ (Plan), giới hạn dung lượng (Quota GB), trạng thái đăng ký và kênh hỗ trợ kỹ thuật trực tiếp trên Dashboard.
    * Khả năng phục hồi cao (Circuit Breaker & Fallback): Lưu cache thông minh (12h TTL) giúp website hoạt động mượt mà ngay cả khi đường truyền kết nối máy chủ quản trị gặp sự cố.
    * Hệ thống cập nhật plugin tự động từ máy chủ riêng (Self-hosted In-Dashboard Updater).

* **Thương Hiệu & Giao Diện Quản Trị (White-label & Design System):**
    * Áp dụng hệ thống nhận diện Vietnamtutor Design System với bảng màu hiện đại Electric Violet (`#783AFB`) và Coral Flame (`#FF5B49`).
    * Tùy biến toàn diện trang đăng nhập (`wp-login.php`): Logo tùy chỉnh, nền thương hiệu, loại bỏ liên kết mặc định của WordPress.
    * Tùy biến Admin Bar và chân trang Admin: Logo riêng, văn bản bản quyền và thông tin hỗ trợ kỹ thuật.
    * Quản trị menu admin: Ẩn bớt các mục menu không cần thiết cho các tài khoản biên tập viên / khách hàng.

* **Tiện Ích Tương Tác & Chăm Sóc Khách Hàng:**
    * Nút liên hệ nổi đa kênh (Floating Contact Widget): Zalo, Số điện thoại (Hotline), Facebook Messenger, Telegram, Chỉ đường Google Maps, Email.
    * Hiệu ứng chuyển động mượt mà, hỗ trợ bật/tắt linh hoạt theo nhu cầu.

* **Hệ Thống & Tiện Ích Mở Rộng:**
    * Trang báo lỗi 404 tùy chỉnh chuẩn responsive, đồng bộ thiết kế thương hiệu và tích hợp thanh tìm kiếm thông minh.
    * Cấu hình gửi mail qua SMTP dễ dàng, có công cụ gửi thử nghiệm kiểm tra tính thông suốt.
    * Chèn mã theo dõi / custom scripts vào Header và Footer nhanh chóng mà không cần sửa code theme.
    * Bảng nhật ký hoạt động (Activity Log) và kiểm tra sức khỏe hệ thống máy chủ (System Diagnostics).

== Installation ==

1. Tải gói cài đặt `vietnamtutor-core.zip` từ trang quản trị trung tâm hoặc bản phát hành mới nhất.
2. Đăng nhập vào trang Quản trị WordPress (`wp-admin`).
3. Điều hướng tới **Plugins (Gói mở rộng) > Add New (Thêm gói mở rộng mới) > Upload Plugin (Tải plugin lên)**.
4. Chọn file `vietnamtutor-core.zip` và nhấn **Install Now (Cài đặt ngay)**.
5. Nhấn **Activate Plugin (Kích hoạt)**.
6. Sau khi kích hoạt, plugin sẽ tự động thiết lập các lớp bảo mật cơ bản và kết nối đồng bộ thông tin với hệ thống Vietnamtutor.
7. Truy cập menu **Vietnamtutor** trên thanh điều hướng bên trái để tùy chỉnh các thông số bảo mật, giao diện, tối ưu và liên hệ theo ý muốn.

== Frequently Asked Questions ==

= Plugin có tương thích với các theme và plugin khác không? =
Có. Vietnamtutor Core được thiết kế theo tiêu chuẩn hook và filter chính quy của WordPress, không can thiệp đè nát core files và có cơ chế bảo vệ dự phòng (fallback) để đảm bảo độ tương thích tối đa.

= Làm thế nào để thay đổi URL máy chủ quản trị trung tâm? =
Bạn có thể định nghĩa hằng số `VNT_ADMIN_URL` trong file `wp-config.php`:
`define('VNT_ADMIN_URL', 'https://clients.vietnamtutor.com');`

= Plugin tự động cập nhật như thế nào? =
Vietnamtutor Core tích hợp sẵn bộ quản lý cập nhật tự lưu trữ (Self-Hosted Updater). Khi có phiên bản mới trên máy chủ Vietnamtutor, WordPress sẽ hiển thị thông báo cập nhật trực tiếp tại trang **Plugins** và **Dashboard > Updates**.

= Nếu mất kết nối với Admin Server thì website có bị gián đoạn không? =
Hoàn toàn không. Plugin tích hợp kiến trúc Circuit Breaker và bộ đệm Transient Cache (12 giờ). Mọi thông tin gói đăng ký sẽ dùng dữ liệu sao lưu nội bộ mà không làm chậm tốc độ tải trang hoặc trang quản trị wp-admin.

== Screenshots ==

1. Dashboard tổng quan với Vietnamtutor Design System, thông tin gói dịch vụ, mức sử dụng bộ nhớ và liên hệ hỗ trợ.
2. Thiết lập bảo mật đa tầng: Giới hạn đăng nhập, chống Spam, Security Headers và phân quyền REST API.
3. Tùy biến tối ưu hiệu suất, dọn dẹp header và hẹn giờ dọn rác database tự động.
4. Quản lý White-label: Đổi logo đăng nhập, logo Admin bar và thông tin chân trang thương hiệu riêng.
5. Cấu hình tiện ích nút liên hệ nổi đa kênh (Zalo, Hotline, Messenger, Telegram, Maps).

== Changelog ==

= 1.0.0-alpha.10 =
* Sửa lỗi đường dẫn tải gói cập nhật plugin (`download_url`) từ máy chủ quản trị trung tâm.
* Đồng bộ quy trình đóng gói phát hành tự động cập nhật thông tin metadata và changelog cho Central Admin Server (`info.json`).
* Tối ưu kích thước gói phát hành và hoàn thiện chuẩn định dạng tài liệu plugin WordPress.

= 1.0.0-alpha.9 =
* Khắc phục cơ chế kiểm tra bản cập nhật tự động trong WordPress (`vnt_core_update_transient`).
* Cải thiện bộ lọc `plugins_api` và quy trình nâng cấp một chạm trong trang quản trị.
* Xử lý xóa cache transient tức thì khi người dùng bấm "Check for updates".

= 1.0.0-alpha.8 =
* Khắc phục triệt để lỗi định dạng URL rewrite và xử lý dấu gạch chéo (`/`) khi gọi REST API về máy chủ quản trị.
* Cải tiến bộ xử lý chuẩn hóa tham số `domain` khi gửi yêu cầu đồng bộ.
* Tăng cường xử lý ngoại lệ khi kết nối mạng phản hồi mã lỗi HTTP 4xx hoặc 5xx.

= 1.0.0-alpha.7 =
* Bổ sung cơ chế Tự Động Đăng Ký Khách Hàng (Zero-Config Client Auto-Discovery).
* Tự động đăng ký domain mới vào máy chủ trung tâm với gói dịch vụ mặc định khi kích hoạt plugin.
* Thiết lập lịch WP-Cron hàng ngày (`vnt_daily_sync_site_info_event`) để tự động làm mới dung lượng lưu trữ và trạng thái dịch vụ.
* Bổ sung nút bấm làm mới thông tin thủ công ("Đồng bộ ngay") trong trang Dashboard.

= 1.0.0-alpha.6 =
* Cập nhật schema metadata và chuẩn hóa thông tin phiên bản plugin cho Central Admin Server.
* Chuẩn hóa text domain `vietnamtutor-core` và header plugin WordPress.
* Tinh chỉnh hiển thị danh sách tiện ích và nhật ký hoạt động.

= 1.0.0-alpha.5 =
* Tự động hóa quy trình đóng gói và triển khai phiên bản (`deploy.sh`).
* Hỗ trợ tự động tăng phiên bản ngữ nghĩa (semantic versioning: auto, patch, minor, major).
* Tự động đóng gói ZIP loại trừ các tệp tài liệu nội bộ và thư mục phát triển.

= 1.0.0-alpha.4 =
* Triển khai hằng số cấu hình động `VNT_ADMIN_URL` cho phép tùy biến endpoint máy chủ quản trị qua `wp-config.php`.
* Bổ sung hàm tiện ích trợ giúp `vnt_get_admin_url()`.
* Đảm bảo tính linh hoạt khi triển khai trên các môi trường Local, Staging và Production.

= 1.0.0-alpha.3 =
* Tinh chỉnh cấu hình kịch bản triển khai và đóng gói phát hành.
* Tối ưu quy trình đồng bộ tệp nén vào kho lưu trữ phát hành nội bộ.

= 1.0.0-alpha.2 =
* Triển khai mô hình Circuit Breaker cho các tác vụ gọi API ngoại vi.
* Lưu trữ bộ đệm dự phòng `vnt_site_info_backup` phòng trường hợp mất mạng hoặc phản hồi chậm.
* Đảm bảo thời gian tải trang quản trị wp-admin không bị ảnh hưởng bởi các kết nối từ xa.

= 1.0.0-alpha.1 =
* Nâng cấp giao diện người dùng Admin Dashboard theo bộ nhận diện thương hiệu Vietnamtutor Design System.
* Tích hợp màu chủ đạo Electric Violet (`#783AFB`), màu nhấn Coral Flame (`#FF5B49`) và font chữ hiện đại.
* Thiết kế lại các thẻ thống kê tài nguyên, trạng thái bảo mật và giao diện responsive.

= 1.0.0-alpha =
* Bản phát hành alpha ban đầu.
* Chuyển đổi toàn diện thương hiệu từ Tembase sang Vietnamtutor Core.
* Tái cấu trúc mã nguồn: Đổi tiền tố hằng số, biến, bảng cấu hình từ `TB_`/`tb_` sang `VNT_`/`vnt_`.
* Hỗ trợ tự động chuyển đổi dữ liệu cấu hình cũ sang định dạng mới.

== Upgrade Notice ==

= 1.0.0-alpha.10 =
Bản phát hành tối ưu đường dẫn tải gói cập nhật từ máy chủ trung tâm và đồng bộ hóa quy trình phát hành. Khuyến nghị tất cả các website nâng cấp lên phiên bản này.
