---
title: "README"
url: https://phatdev.net/docs/tandoanh-theme/readme
lang: vi
updated: 2026-10-20
alternate:
  en: https://phatdev.net/en/docs/tandoanh-theme/readme
markdown: https://phatdev.net/docs/tandoanh-theme/readme.md
---

# README

Thuộc bộ tài liệu: [Tân Doanh](https://phatdev.net/docs/tandoanh-theme.md)

> Block theme (FSE) cho cửa hàng máy tính Tân Doanh, chạy trên Nginx, PHP 8.2-FPM, MariaDB và Redis.

## Tân Doanh Theme

Block theme (FSE) cho cửa hàng máy tính **Tân Doanh** - chạy trên Nginx, PHP 8.2-FPM, MariaDB và Redis.

## Tổng quan

- Kiến trúc **Full Site Editing** (block theme, WordPress 6.x).
- Tối ưu WooCommerce: card sản phẩm, PDP, filter, trả góp, checkout VN 2 cấp.
- Tối ưu hiệu năng theo PageSpeed Insights (critical CSS, defer JS, lazy load, mobile cache).
- Dark/Light mode, responsive toàn thiết bị.

## Trang quản trị "Tân Doanh Theme"

Toàn bộ cấu hình theme gom về một menu duy nhất trong wp-admin:

| Tab | Chức năng |
|-----|-----------|
| **Dashboard** | Tình trạng hệ thống, truy cập nhanh, thông tin theme, nhật ký |
| **Tốc độ** | Tối ưu PageSpeed: critical CSS, defer/delay JS, lazy load, mobile cache |
| **Mega Menu** | Cấu hình mega menu danh mục có hình ảnh |
| **Trang chủ** | Quản lý các list sản phẩm hiển thị ngoài trang chủ |
| **Contact Footer** | Cấu hình dock liên hệ nổi (Zalo, hotline, messenger...) |
| **Thanh toán** | Bật/tắt gói quà, mã giảm giá, xuất VAT, email khuyến mãi |
| **Trả góp** | Cấu hình bảng tính trả góp (lãi suất, kỳ hạn) |
| **Popup** | Popup banner theo trang (cookie/trigger) |
| **Dịch ngôn ngữ** | Dịch VI→EN bằng AI, phục vụ SSR `/en/` |
| **Tính năng** | Danh mục toàn bộ tính năng đang hoạt động trong theme |

## Image sizes

Theo cấu hình ảnh chung của site: `thumbnail` 100×100, `small` 300×300, `medium` 450×450, `medium_large` 600×600, cùng bộ `td-responsive-{320,480,720,960,1200}` cho srcset. Sửa được ở **Settings → Media** và Customizer/theme_mod.

## Cache & Deploy

- Sau khi sửa PHP: nạp lại PHP-FPM (opcache không tự kiểm tra thay đổi tệp).
- Xoá cache đúng cách: chỉ xoá `cache/all/`, không xoá cả `cache/`.
- Bump `TANDOANH_THEME_VERSION` + ghi CHANGELOG mỗi thay đổi.