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

# README

Part of the doc set: [Tân Doanh](https://phatdev.net/en/docs/tandoanh-theme.md)

> Block theme (FSE) for the Tân Doanh computer store, running on Nginx, PHP 8.2-FPM, MariaDB and Redis.

## Tân Doanh Theme

Block theme (FSE) for the **Tân Doanh** computer store, running on Nginx, PHP 8.2-FPM, MariaDB and Redis.

## Overview

- **Full Site Editing** architecture (block theme, WordPress 6.x).
- WooCommerce optimizations: product cards, PDP, filters, installments, two-level Vietnam checkout.
- Performance tuned against PageSpeed Insights (critical CSS, deferred JS, lazy loading, mobile cache).
- Dark/Light mode, responsive on all devices.

## "Tân Doanh Theme" admin page

All theme settings are gathered into a single menu in wp-admin:

| Tab | Function |
|-----|-----------|
| **Dashboard** | System status, quick access, theme information, logs |
| **Tốc độ** (Speed) | PageSpeed optimization: critical CSS, defer/delay JS, lazy load, mobile cache |
| **Mega Menu** | Configure the category mega menu with images |
| **Trang chủ** (Homepage) | Manage the product lists shown on the homepage |
| **Contact Footer** | Configure the floating contact dock (Zalo, hotline, Messenger...) |
| **Thanh toán** (Payment) | Turn gift packaging, discount codes, VAT invoicing and promotion emails on or off |
| **Trả góp** (Installments) | Configure the installment calculator (interest rates, terms) |
| **Popup** | Page-based popup banners (cookie/trigger) |
| **Dịch ngôn ngữ** (Language translation) | VI→EN translation with AI, serving the server-side rendered `/en/` pages |
| **Tính năng** (Features) | A catalog of every feature currently active in the theme |

## Image sizes

Following the shared image configuration: `thumbnail` 100×100, `small` 300×300, `medium` 450×450, `medium_large` 600×600, plus the `td-responsive-{320,480,720,960,1200}` set for srcset. Adjustable in **Settings → Media** and in the Customizer/theme_mod.

## Cache & Deploy

- After editing PHP: reload PHP-FPM (opcache does not re-check files for changes).
- Clear the cache the right way: delete only `cache/all/`, never the whole `cache/` folder.
- Bump `TANDOANH_THEME_VERSION` and add a CHANGELOG entry for every change.