--- title: "README" url: https://phatdev.net/en/docs/tandoanh-buildpc/readme lang: en updated: 2026-10-20 alternate: vi: https://phatdev.net/docs/tandoanh-buildpc/readme markdown: https://phatdev.net/en/docs/tandoanh-buildpc/readme.md --- # README Part of the doc set: [PC Builder](https://phatdev.net/en/docs/tandoanh-buildpc.md) > A WordPress/WooCommerce plugin that lets customers build a PC step by step, with an AI assistant that advises by budget and needs. ## Tân Doanh Build PC **Version:** 2.10.5 (2026-10-06) **Author:** Steven Lam | **Website:** [tandoanh.vn](https://tandoanh.vn) A professional WordPress/WooCommerce plugin that lets customers build a PC configuration step by step, equipped with a **smart AI Assistant** that recommends an optimal build based on budget and needs. Note: the current version is 2.10.5. The description below summarizes the main features of the 1.x and 2.x lines; for changes from 2.2.2 onward see the [Changelog](https://phatdev.net/en/docs/tandoanh-buildpc/changelog). **Highlight of v2.2.2:** **Important bug fix** - Fixes the `"Security verification failed"` error that appeared when WP Rocket cached HTML containing an expired WordPress nonce (12-24h). The new class `TanDoanhBuildPC_NonceRefresh` automatically refreshes the nonce through an uncached AJAX endpoint, for new users as well as long-open tabs (refresh every 30 minutes). --- ## Main Features ### **AI Assistant (virtual advisor)** The plugin's core feature, using Google Gemini to advise on PC configurations. **Key features:** - **Smart advice**: Chat with the AI to get a suitable configuration (gaming, graphics, office) - **Budget analysis**: Automatically builds a configuration that uses 94-99% of the budget - **Compatibility check**: Makes sure all components work together, especially Intel/AMD sockets - **8 complete components**: Suggests a full set from the processor to the case - **One-click apply**: Moves the AI configuration into the builder instantly **Recent improvements:** - v2.0.2: Security hardening (8 vulnerabilities), performance optimisation, cache invalidation, composite index - v2.0.1: Complete backup and debug tools (Server Health Monitor, AI log management, security fixes) - v2.0.0: Smart AI Index (filters 4522 down to 1544 products, cuts tokens 35-45%, scheduled rebuilds) - v1.6.8: CSS/JS optimisation -850KB, Info tab, PageSpeed +15 - v1.6.7: Multi-builder support, AI admin dropdown to choose a builder ### **AI Index System (NEW in v2.0.0)** A system that automatically builds a list of products suitable for the AI, replacing the traditional cache. **Key features:** - **Smart product filtering**: Indexes only 1544 of 4522 products (filters out price <= 0, unsuitable stock, out-of-stock products) - **Clean data for the AI**: The list contains only products that are actually used to build PCs, no junk data - **Lower API cost**: Leaner data means API tokens **drop 15-20%**, saving Gemini costs - **Automatic status saving**: Records the number of indexed products, making rebuild progress easy to follow - **Scheduled rebuilds**: Supports automatic rebuilds hourly, daily or weekly - **New dashboard**: A clearer AI Index management interface, showing "1544 products indexed" **How it works:** 1. Admin clicks "Rebuild AI Index" → the plugin scans WooCommerce products 2. Filters suitable products → saves them to the index table (1544 products) 3. The AI Assistant uses the index list → recommends accurate configurations 4. API tokens drop 15-20% compared with the traditional cache ### **Manual PC Build** - **Clear steps**: Choose each type of component in order - **Smart filters**: Automatically filter compatible products - **High speed**: The modal loads quickly with smart caching - **Saved progress**: Saves automatically and continues across multiple tabs ### **Backup/Restore (NEW in v1.6.7)** - **Full backup**: Export builders + steps + plugin settings to a JSON file - **Fast restore**: Import a configuration from a backup file in one click - **Drag-drop import**: Drag and drop the JSON file to import easily - **Multi-builder**: Supports several builders with a smart dropdown selector ### **Automation** - **Auto-detection (v1.6.1)**: The plugin configures itself on any website - **One-click sync**: The admin only needs to press a button to set up the AI - **Works everywhere**: No code changes required ### **Sharing and Export** - **WooCommerce integration**: Add the whole configuration to the cart - **HTML email**: Send a professional summary - **PDF + QR Code**: Export a PDF file with a QR code - **Direct printing**: Supports printing with an optimised layout - **Responsive**: Displays well on every device --- ## Performance Improvements (v1.6.8) ### CSS/JS Loading Optimisation - **850KB less bandwidth**: Assets load only when the `[tandoanh_buildpc]` shortcode is present - **20 fewer HTTP requests**: Nothing loads on the home page, product pages or blog - **PageSpeed +10-15 points**: Improves SEO and user experience - **New Info tab**: Quick statistics and a live changelog inside the Admin ### How to check Before v1.6.8: 20 files (~850KB) loaded on every page After v1.6.8: 0 files on pages without the shortcode, 20 files only when needed --- ## Important Update History ## Important Update History **v2.0.3 (2025-11-12)** - Mobile UX improvements (dynamic modal header, gradient title, 50% smaller CSS) **v2.0.2 (2025-11-02)** - Security hardening (8 critical vulnerabilities), performance optimisation, 96% fewer queries **v2.0.1 (2025-10-30)** - Complete backup and debug tools, Server Health Monitor **v2.0.0 (2025-10-28)** - Smart AI Index, filters 4522 down to 1544 products, cuts tokens 35-45% **v1.6.8 (2025-01-17)** - CSS/JS optimisation -850KB, Info tab, PageSpeed +15 **v1.6.7 (2025-10-16)** - Full Backup/Restore, multi-builder AI admin --- ## Installation and Usage 1. Upload the plugin folder to `/wp-content/plugins/` 2. Activate the plugin in the WordPress admin 3. Go to **Build PC** to create builders and set up the steps 4. **Enable the AI:** - Get a Gemini API Key: [aistudio.google.com/apikey](https://aistudio.google.com/apikey) - Go to **Build PC → AI Settings** and paste the API Key - Go to **Build PC → Đồng bộ AI** (AI Sync) and click "Đồng bộ ngay" (Sync now) 5. Use the shortcode `[tandoanh_buildpc]` wherever it should appear 6. **Backup/Restore:** Go to **Build PC → Cài đặt** (Settings) **→ Backup/Restore tab** ### File Structure (Summary) ``` tandoanh-buildpc/ ├── assets/ │ ├── css/ # Modular CSS (core, components, admin, AI) │ └── js/ # JS modules (managers, admin, AI chat) ├── includes/ │ ├── ai/ # AI module (Gemini, mappers, prompts) │ ├── templates/ # PHP templates │ └── *.php # Core classes (admin, ajax, frontend) └── tandoanh-buildpc.php # Main file ``` ### Technical Characteristics - **Modular CSS/JS**: Split into components, loaded conditionally by shortcode - **AI Module**: Integrates Gemini 2.0 Flash with rate limiting - **Performance**: Transient cache, AJAX lazy loading, conditional assets - **Security**: Nonce validation, sanitize/escape, capability checks --- ## Support - **Documentation**: [docs.tandoanh.vn](https://docs.tandoanh.vn) - **Email**: admin@tandoanh.vn - **Hotline**: +84.379.678910 --- **Find the plugin useful? Please leave a 5-star rating.**