<PhatLam/>/docsVI

README

A WordPress/WooCommerce plugin that lets customers build a PC step by step, with an AI assistant that advises by budget and needs.

PC BuilderUpdated 21 Oct 2026

Tân Doanh Build PC

Version: 2.10.5 (2026-10-06)
Author: Steven Lam | Website: 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.

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
    • 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

Find the plugin useful? Please leave a 5-star rating.