TỔNG QUAN

WP Elasticsearch Giải Quyết Vấn Đề Gì?

Bạn đang gặp phải những vấn đề này?
  • ⏱️ Website chậm chạp khi tìm kiếm với hàng nghìn bài viết/sản phẩm?
  • 🔍 Khách hàng không tìm thấy nội dung dù gõ đúng từ khóa?
  • 📉 Trải nghiệm kém khi filter nhiều điều kiện phức tạp?
  • 🐌 Database quá tải khi có nhiều truy vấn đồng thời?
  • ⚠️ Mất hàng giờ để query báo cáo, thống kê từ SQL?

WP Elasticsearch là giải pháp chuyên nghiệp giúp bạn:

  • ⚡ Tăng tốc tìm kiếm lên 100 lần - Kết quả hiển thị tức thì dù hàng triệu records
  • 🎯 Tìm kiếm thông minh - Full-text search, gõ sai chính tả vẫn tìm được
  • 🔄 Đồng bộ real-time - Cập nhật ngay khi thay đổi nội dung WordPress/WooCommerce
  • 📊 Thay thế SQL phức tạp - Giảm tải database 70-90%, query nhanh gấp 5-10 lần
  • 💪 Ổn định & bảo mật - 3 phương thức index: AJAX (Nonce), Cron (Token), CLI (Anti-timeout)
Kết quả bạn nhận được: Tìm kiếm nhanh hơn → Database nhẹ hơn → Trải nghiệm tốt hơn → Tăng chuyển đổi & doanh số

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

⚡ Hiệu Suất Vượt Trội

  • Tìm kiếm tức thì với hàng triệu records
  • Thay thế SQL, giảm tải database 70-90%
  • Query phức tạp nhanh gấp 5-10 lần
  • Không làm chậm website gốc

🔄 Đồng Bộ Đa Dạng

  • Sản phẩm (products) - Hoàn chỉnh
  • Danh mục (terms) - Đang phát triển
  • Đơn hàng (orders) - Đang phát triển
  • Người dùng (users) - Đang phát triển

🛡️ Bảo Mật & An Toàn

  • AJAX Mode: Nonce security
  • Cron Mode: Token chống spam
  • CLI Mode: Chống timeout
  • Không làm mất dữ liệu gốc

📊 Quản Lý Dễ Dàng

  • Giao diện trực quan, dễ sử dụng
  • Test API trực tiếp với JSON Editor
  • Generate cURL command tự động
  • Console logs theo dõi real-time

Yêu Cầu Cài Đặt

👉 Bạn cần chuẩn bị:
Yêu cầu Phiên bản tối thiểu Khủyến nghị
WordPress 5.0+ Phiên bản mới nhất
WooCommerce 3.0+ Phiên bản mới nhất
PHP 7.4+ PHP 8.0 trở lên
Elasticsearch 7.x 7.x hoặc 8.x
RAM Server 256MB 512MB+ cho >10,000 sản phẩm
⚠️ Lưu ý quan trọng

Nếu bạn chưa có Elasticsearch, vui lòng liên hệ admin server để cài đặt. Plugin này chỉ đồng bộ dữ liệu, không bao gồm việc cài đặt Elasticsearch.

BẮT ĐẦU SỬ DỤNG

🎉 Chỉ cần 3 bước đơn giản: Kích hoạt → Kết nối → Đồng bộ dữ liệu

Bước 1: Kích Hoạt Plugin

  1. Vào WordPress Admin → Plugins
  2. Tìm WP Elasticsearch
  3. Click Activate
Plugin sẽ tự động:
  • ✅ Tạo cơ sở dữ liệu theo dõi
  • ✅ Bật chế độ cập nhật tự động
  • ✅ Chuẩn bị sẵn sàng sử dụng

Bước 2: Kiểm Tra Menu

Sau khi kích hoạt, bạn sẽ thấy menu Elastic Search trên thanh quản trị:

📦 Index Product Đồng bộ sản phẩm WooCommerce
⚙️ Config Cấu hình kết nối Elasticsearch
📊 Log Xem nhật ký hoạt động

CẤU HÌNH CHI TIẾT

📍 Truy cập: WordPress Admin → Elastic Search → Config

Trang Config có 6 phần cấu hình theo thứ tự từ trên xuống dưới:

3.1. List Module (Chọn Loại Dữ Liệu Cần Đồng Bộ)

💡 Giải thích: Chọn loại dữ liệu nào bạn muốn đồng bộ lên Elasticsearch.
Module Mô tả Trạng thái
Product Sản phẩm WooCommerce Đã hoàn thiện
Term Danh mục sản phẩm Đang phát triển
Order Đơn hàng Đang phát triển
User Người dùng Đang phát triển
✅ Hiện tại: Chọn Product để đồng bộ sản phẩm WooCommerce.

3.2. Product Configuration (Cấu Hình Sản Phẩm)

💡 Phần này CHỈ hiện khi bạn chọn Product ở List Module

Index Settings (Cài Đặt Index)

Index Name Tên index sản phẩm (ví dụ: products)
⚠️ QUAN TRỌNG: Tên này sẽ được thêm Index Prefix phía trước!
Nếu Index Prefix là web_wp_ và Index Name là products
→ Index thực tế trên ES sẽ là: web_wp_products
Batch Size Số sản phẩm xử lý mỗi lần (mặc định: 100)
- Website nhỏ (<5K sản phẩm): 50-100
- Website vừa (5-20K sản phẩm): 100-200
- Website lớn (>20K sản phẩm): 200-500

Indexable Post Statuses (Trạng Thái Sản Phẩm Được Đồng Bộ)

Chọn trạng thái sản phẩm nào sẽ được đồng bộ lên Elasticsearch:

  • publish - Sản phẩm đã xuất bản (nên chọn)
  • draft - Bản nháp (tùy nhu cầu)
  • pending - Chờ duyệt (tùy nhu cầu)
  • private - Riêng tư (tùy nhu cầu)
✅ Khuyến nghị: Chỉ chọn publish để đồng bộ sản phẩm đã xuất bản.

3.3. General Configuration (Cấu Hình Kết Nối Elasticsearch)

Elasticsearch URL URL server Elasticsearch:
http://localhost (local)
http://192.168.1.100 (IP server)
https://domain.com (domain)
Port Cổng kết nối (mặc định: 9200)
Authentication No Auth: Không cần username/password
Basic Auth: Cần username và password
Username Tên đăng nhập (nếu dùng Basic Auth)
Password Mật khẩu (nếu dùng Basic Auth)
Index Prefix QUAN TRỌNG: Tiền tố thêm vào TẤT CẢ các index
Ví dụ: Nếu Index Prefix là web_wp_
→ Index Product: web_wp_products
→ Index Term: web_wp_terms
→ Index Order: web_wp_orders
💡 Mục đích: Phân biệt nhiều website dùng chung 1 Elasticsearch server
Timeout Thời gian chờ kết nối (giây, mặc định: 30)
Tăng lên nếu server Elasticsearch chậm
✅ Sau khi điền xong: Click "Test Connection" để kiểm tra kết nối trước khi lưu.

3.4. Index Mode (Chế Độ Đánh Index) ⭐ QUAN TRỌNG

⚠️ Chọn 1 trong 3 chế độ: AJAX, CLI, hoặc Cron API
Chế Độ Cách Hoạt Động Bảo Mật Dùng Khi Nào?
AJAX Mode Click nút "Index Product" trên Admin Panel
Sử dụng admin-ajax.php 		Nonce Verification
Chỉ Admin mới chạy được 		✅ Website nhỏ (<5K sản phẩm)
✅ Đánh index thủ công
✅ Không cần setup cron
CLI Mode Chạy qua WP-CLI command:
wp es index products 		Server-side Only
Không timeout, chống gián đoạn 		✅ Website trung/lớn (>10K sản phẩm)
✅ Chạy trong Server/SSH
✅ Setup cron job tự động
✅ VPS/Dedicated server
Cron API Mode Gọi REST API endpoint:
/wp-json/sync/es?token=xxx 		Security Token Required
Token bảo vệ API endpoint 		✅ Shared hosting (không có SSH)
✅ Muốn gọi từ bên ngoài (cURL)
✅ Chạy song song nhiều batch
✅ Setup cPanel Cron Jobs

Chi Tiết Từng Mode:

🖱️ AJAX Mode (Admin Panel)

Cách sử dụng:

  1. Chọn Index Mode: Ajax trong Config
  2. Vào trang Index Product
  3. Click nút "Index Product"
  4. Đợi tiến trình chạy xong

Ưu điểm:

  • ✅ Đơn giản, không cần setup gì thêm
  • ✅ Xem progress bar realtime
  • ✅ An toàn với Nonce verification

Nhược điểm:

  • ❌ Có thể timeout với website lớn
  • ❌ Phải ngồi đợi, không tự động
⌨️ CLI Mode (WP-CLI Command)

Cách sử dụng:

  1. Chọn Index Mode: CLI trong Config
  2. SSH vào server
  3. Chạy command:
# Index 1 batch (100 sản phẩm)
wp es index products

# Index với batch size tùy chỉnh
wp es index products --batch-size=500

# Index liên tục đến hết
wp es index products --continuous

# Bỏ qua lock check
wp es index products --force

Setup Cron Job (tự động mỗi phút):

# Crontab
* * * * * cd /path/to/wordpress && wp es index products >/dev/null 2>&1

Ưu điểm:

  • ✅ Không bao giờ timeout
  • ✅ Chạy nền, tự động với cron
  • ✅ Hiệu suất cao nhất
  • ✅ Xử lý được hàng triệu sản phẩm

Nhược điểm:

  • ❌ Cần SSH access
  • ❌ Phải cài WP-CLI
  • ❌ Shared hosting thường không hỗ trợ
🌐 Cron API Mode (REST API Endpoint)

Cách sử dụng:

  1. Chọn Index Mode: Cron API trong Config
  2. Click "🔑 Generate Token" để tạo Security Token
  3. Copy Cron URL (có dạng: /wp-json/sync/es?token=xxx)
  4. Setup trong cPanel Cron Jobs hoặc dùng cURL

Ví dụ cURL:

curl -X GET "https://your-site.com/wp-json/sync/es?token=YOUR_TOKEN"

Setup trong cPanel Cron Jobs (chạy mỗi 5 phút):

*/5 * * * * curl -X GET "https://your-site.com/wp-json/sync/es?token=YOUR_TOKEN" >/dev/null 2>&1

Ưu điểm:

  • ✅ Hoạt động trên Shared Hosting
  • ✅ Không cần SSH
  • ✅ Gọi từ bất kỳ đâu (cURL, cron service)
  • ✅ Chạy song song nhiều batch
  • ✅ Bảo mật bằng Security Token

Nhược điểm:

  • ❌ Phải bảo mật token cẩn thận
  • ❌ Có thể timeout nếu hosting giới hạn
🔒 BẢO MẬT: KHÔNG chia sẻ token công khai! Token này cho phép bất kỳ ai có token đều có thể trigger đồng bộ.

3.5. Synchronization Mode (Chế Độ Đồng Bộ)

Chế Độ Hoạt Động Dùng Khi Nào?
Real-time Sync Tự động cập nhật Elasticsearch ngay khi:
- Thêm/sửa/xóa sản phẩm
- Thay đổi giá, stock
- Cập nhật category, tags 		✅ Website nhỏ/vừa
✅ Cần dữ liệu luôn mới nhất
✅ Ít thao tác bulk update
Queue Mode Đánh dấu sản phẩm cần sync
Chạy hàng loạt sau bằng Cron/CLI 		✅ Website lớn
✅ Import hàng loạt thường xuyên
✅ Tiết kiệm tài nguyên
💡 Khuyến nghị: Dùng Real-time Sync nếu website <20K sản phẩm và cập nhật thủ công. Dùng Queue Mode nếu có hệ thống import/sync tự động.

3.6. Mapping Settings (Cài Đặt Cấu Trúc Index)

💡 Với 90% website: Không cần thay đổi phần này! Chỉ điều chỉnh khi hiểu rõ Elasticsearch.
Cài Đặt Giá Trị Mặc Định Dùng Khi Nào?
Number of Shards 1 Tăng lên 3-5 nếu >100K sản phẩm
Phân tán dữ liệu, tăng hiệu suất
Number of Replicas 0 Tăng lên 1-2 nếu có nhiều ES node
Tạo bản sao backup
Total Field Limit 15000 Tăng nếu sản phẩm có rất nhiều fields/attributes
ES giới hạn mặc định 1000 fields
⚠️ Lưu ý: Thay đổi Shards/Replicas yêu cầu XÓA và TẠO LẠI index. Backup dữ liệu trước!

QUY TRÌNH INDEX LẦN ĐẦU

🎯 Mục tiêu: Đưa tất cả sản phẩm WooCommerce lên Elasticsearch theo 5 bước rõ ràng!
Bước 1️⃣ Cấu Hình Kết Nối (Config Page)

📍 Truy cập: WordPress Admin → Elastic Search → Config

  1. Chọn Product trong List Module
  2. Nhập Index Name trong Product Configuration (ví dụ: products)
  3. Điền thông tin Elasticsearch URL, Port, Auth trong General Configuration
  4. Chọn Index Mode: AJAX / CLI / Cron API (đọc phần 3.4 để chọn đúng)
  5. Click "Save"
💡 Quan trọng: Index Name bạn nhập ở Config sẽ được thêm Index Prefix phía trước.
Ví dụ: Index Prefix = web_wp_, Index Name = products → Index thực tế: web_wp_products
Bước 2️⃣ Tạo Mapping (Index Product Page)

📍 Truy cập: WordPress Admin → Elastic Search → Index Product

  1. Click nút "📋 Create Mapping"
  2. Đợi 5-10 giây
  3. Thấy thông báo "✅ Successfully" là xong!
💡 Giải thích: Tạo "bản thiết kế" (schema) để Elasticsearch biết cách lưu trữ sản phẩm. Chỉ làm 1 lần duy nhất!
Bước 3️⃣ Chuẩn Bị Dữ Liệu (Index Product Page)

Vẫn ở trang Index Product:

  1. Click nút "📦 Prepare Index Data"
  2. Plugin sẽ đánh dấu tất cả sản phẩm cần đồng bộ
  3. Bạn sẽ thấy số lượng sản phẩm Pending (chờ index)
💡 Giải thích: "Lập danh sách" sản phẩm cần đưa lên Elasticsearch. Rất nhanh, chỉ vài giây dù hàng nghìn sản phẩm!
Bước 4️⃣ Bắt Đầu Index (Tùy Theo Index Mode)

Cách thực hiện tùy vào Index Mode bạn đã chọn ở Bước 1:

🖱️ Nếu dùng AJAX Mode:

  1. Vẫn ở trang Index Product
  2. Click nút "▶️ Index Product"
  3. Theo dõi thanh tiến trình (progress bar)
  4. Đợi đến khi hoàn thành 100%
⚠️ Lưu ý: KHÔNG đóng trình duyệt khi đang chạy! Website nhỏ/vừa (<5K sản phẩm) dùng mode này OK.

⌨️ Nếu dùng CLI Mode:

  1. SSH vào server
  2. Di chuyển đến thư mục WordPress
  3. Chạy command:
# Index liên tục đến hết
wp es index products --continuous

# Hoặc setup cron chạy mỗi phút (khuyến nghị)
* * * * * cd /path/to/wordpress && wp es index products >/dev/null 2>&1
✅ Ưu điểm: Không timeout, chạy nền, phù hợp website lớn >10K sản phẩm.

🌐 Nếu dùng Cron API Mode:

  1. Đảm bảo đã tạo Security Token ở Config (Bước 1)
  2. Copy Cron URL từ Config page
  3. Setup trong cPanel Cron Jobs:
*/5 * * * * curl -X GET "https://your-site.com/wp-json/sync/es?token=YOUR_TOKEN" >/dev/null 2>&1

Hoặc chạy thủ công bằng cURL để test:

curl -X GET "https://your-site.com/wp-json/sync/es?token=YOUR_TOKEN"
✅ Ưu điểm: Dùng được trên Shared Hosting, không cần SSH.
Bước 5️⃣ Kiểm Tra Kết Quả

📍 Truy cập: WordPress Admin → Elastic Search → Index Product

Xem thống kê trong Statistics panel:

  • DB Count: Tổng số sản phẩm trong Database
  • ES Count: Tổng số sản phẩm trên Elasticsearch
  • Success: Số sản phẩm index thành công
  • Failed: Số sản phẩm lỗi (nếu có)
  • Pending: Số sản phẩm chờ index (phải = 0)
✅ Hoàn Tất: Nếu DB Count = ES Count và Pending = 0 → Đồng bộ thành công 100%!
💡 Sau khi index lần đầu:
- Mọi thay đổi sản phẩm (thêm/sửa/xóa) sẽ tự động sync nếu bật Real-time Sync
- Plugin tự động verify và sửa lỗi mỗi giờ (Auto Verify & Sync)
- Bạn có thể xem log chi tiết tại: Elastic Search → Log

6. AUTO VERIFY & SYNC

6.1. Giới Thiệu

Auto Verify & Sync là tính năng mới v1.4.2 - tự động kiểm tra và đồng bộ dữ liệu giữa Database và Elasticsearch mỗi giờ.

Chạy tự động qua cron job WordPress mỗi giờ - Không cần cấu hình gì!

6.2. Quy Trình Hoạt Động

  1. Kiểm Tra Tổng Số (Verify Total Count)
    • So sánh tổng số sản phẩm trên Database vs Elasticsearch
    • Nếu khác: tiếp tục bước 2
  2. Phát Hiện Sản Phẩm Thiếu (Find Missing Products)
    • Tìm sản phẩm tồn tại trên DB nhưng không có trên ES
    • Đánh dấu để reindex tự động
  3. Phát Hiện Sản Phẩm Thừa (Find Extra Products)
    • Tìm sản phẩm tồn tại trên ES nhưng bị xóa trên DB
    • Xóa tự động khỏi ES
  4. Sửa Sản Phẩm Lỗi (Fix Failed Products)
    • Tìm sản phẩm có status=2 (lỗi) vẫn tồn tại trên ES
    • Xóa khỏi ES để không ảnh hưởng
  5. Ghi Log (Database Logging)
    • Ghi lại tất cả hoạt động vào database
    • Xem chi tiết từ Admin → Elasticsearch → Log

6.3. Xem Nhật Ký

Truy cập WordPress Admin → Elasticsearch → Log để xem:

  • 📝 Tất cả hoạt động verify & sync
  • 🔍 Tìm kiếm theo từ khóa
  • 🏷️ Lọc theo loại log
  • 📅 Lọc theo ngày
  • ⬆️⬇️ Sắp xếp theo cột

CẬP NHẬT TỰ ĐỘNG

🎉 Tin vui: Sau khi đồng bộ lần đầu, BẠN KHÔNG CẦN LÀM GÌ THÊM! Plugin tự động cập nhật mọi thay đổi.

Plugin Tự Động Cập Nhật Khi Bạn:

📝 Thêm/Sửa Sản Phẩm

  • Tạo sản phẩm mới
  • Chỉnh sửa thông tin
  • Đổi giá, tên, mô tả
  • Cập nhật hình ảnh

🏷️ Quản Lý Phân Loại

  • Thay đổi danh mục
  • Thêm/bớt tags
  • Cập nhật thuộc tính
  • Đổi brand

📦 Cập Nhật Kho

  • Thay đổi số lượng
  • Đặt trạng thái stocked
  • Cập nhật SKU
  • Quản lý variations

🗑️ Xóa Sản Phẩm

  • Chuyển vào thùng rác
  • Xóa vĩnh viễn
  • Khôi phục từ rác
  • Tự động dọn dẹp
⚡ Nhanh Như Thế Nào?

Khi bạn click "Cập nhật" sản phẩm trong WordPress:

  • ✅ Dữ liệu được đánh dấu cập nhật ngay lập tức
  • ✅ Elasticsearch nhận thông tin sau vài giây
  • ✅ Khách hàng tìm kiếm thấy dữ liệu mới luôn

Bạn không cần chạy lại đồng bộ thủ công!

XỬ LÝ SỰ CỐ

🤖 Tính năng thông minh: Plugin tự động kiểm tra và sửa lỗi đồng bộ mỗi giờ - Bạn không cần làm gì cả!

Plugin Tự Động Sửa Những Vấn Đề Này:

❌ Vấn Đề: Sản Phẩm Thiếu Trên Elasticsearch

Nguyên nhân: Có thể do lỗi mạng, server quá tải khi đồng bộ...

Giải pháp: Plugin tự động phát hiện và đồng bộ lại sản phẩm thiếu.

♻️ Vấn Đề: Sản Phẩm Thừa Trên Elasticsearch

Nguyên nhân: Bạn đã xóa sản phẩm trong WooCommerce nhưng ES chưa xóa...

Giải pháp: Plugin tự động xóa sản phẩm không còn tồn tại.

⚠️ Vấn Đề: Sản Phẩm Lỗi Đồng Bộ

Nguyên nhân: Một số sản phẩm fail nhiều lần...

Giải pháp: Plugin tự động dọn dẹp và thử đồng bộ lại.

✅ Kết quả: Dữ liệu giữa WooCommerce và Elasticsearch luôn đồng bộ 100% mà bạn không cần theo dõi!

Xem Nhật Ký Hoạt Động

Muốn biết plugin đã làm gì? Vào WordPress Admin → Elasticsearch → Log

  • 📝 Xem tất cả hoạt động tự động
  • 🔍 Tìm kiếm theo từ khóa
  • 📊 Kiểm tra số liệu thống kê
  • ⏰ Xem lịch sử theo ngày

TÙY BIẾN NÂNG CAO

Developer Documentation: Danh sách các WordPress Hooks kích hoạt đồng bộ tự động.
Nhóm Action Hooks Mô Tả
Review comment_post
deleted_comment
transition_comment_status 		Thêm/xóa/thay đổi review
Stock woocommerce_product_set_stock
woocommerce_variation_set_stock 		Thay đổi stock

7. WP-CLI COMMANDS

6.1. Giới Thiệu

WP-CLI cho phép index từ command line - lý tưởng cho:

  • Server operations
  • Cron jobs
  • CI/CD pipelines
  • Large-scale indexing

6.2. Index Products

Basic Usage
wp es index products
With Options
# Custom batch size (default: 100)
wp es index products --batch-size=500

# Continuous mode - process all batches until complete
wp es index products --batch-size=500 --continuous

# Force start (bỏ qua lock check)
wp es index products --force

# Combine options
wp es index products --batch-size=200 --continuous --force
Lưu ý về --continuous flag:
  • Không có flag (mặc định): Xử lý 1 batch rồi dừng → Thích hợp cho cron job gọi mỗi phút
  • Có flag --continuous: Xử lý tất cả batch cho đến hết → Thích hợp cho chạy manual một lần

6.3. Get Statistics

wp es stats

8. ELASTICSEARCH API TEST

Giao diện test Elasticsearch API trực tiếp
Hỗ trợ JSON Editor, cURL Command generator và Response viewer.

Truy cập: Elasticsearch > Test Search

8.1. Tính Năng

JSON Editor Tab

  • Code Editor: Syntax highlighting cho JSON
  • Format JSON: Tự động format code đẹp
  • Load Sample: Tải query mẫu theo type
  • Validation: Kiểm tra JSON hợp lệ trước khi gửi

cURL Command Tab

  • Auto Generate: Tự động tạo cURL từ JSON
  • Full Config: Bao gồm URL, auth, headers, body
  • Copy Clipboard: Click để copy command
  • Terminal Ready: Format chuẩn để chạy

Response Viewer

  • Body Tab: Hiển thị JSON với syntax highlighting
  • Headers Tab: Xem response headers
  • Search in Response: Tìm kiếm trong kết quả
  • Navigation: Di chuyển giữa kết quả

8.2. Cách Sử Dụng - Gửi Request

Bước 1-2: Chọn Method và Type
  • Method: POST hoặc GET
  • Type: Product (Term/Order đang phát triển)
Bước 3-4: Nhập JSON Query
{
  "query": {
    "bool": {
      "must": [
        {
          "match": {
            "post_title": "áo"
          }
        }
      ]
    }
  },
  "size": 10,
  "from": 0
}

Hoặc click "Load Sample" để tải query mẫu, sau đó click "Format JSON" để format code.

Bước 5-6: Gửi và Xem Kết Quả

Click "Send Request" và xem kết quả trong Response panel.

8.3. Generate cURL Command

➡️ Tự động tạo cURL command từ JSON query của bạn!
  1. Nhập JSON query trong JSON Editor tab
  2. Chuyển sang tab "cURL Command"
  3. Xem cURL command được tạo tự động
  4. Click "Copy cURL" để copy
  5. Paste vào terminal để chạy
Ví Dụ cURL Command
curl -X POST \
  "https://domain.com:9200/wp_products/_search" \
  -H "Content-Type: application/json" \
  -u "username:password" \
  -d '{
  "query": {
    "match": {
      "post_title": "áo"
    }
  },
  "size": 10
}'

8.4. Tìm Kiếm Trong Response

  1. Nhập từ khóa vào ô "Search in response..."
  2. Kết quả sẽ được highlight màu vàng
  3. Dùng nút ↑ ↓ để navigate giữa kết quả

8.5. Ví Dụ Queries

Search sản phẩm theo tên
{
  "query": {
    "match": {
      "post_title": "samsung galaxy"
    }
  }
}
Bool query với filter
{
  "query": {
    "bool": {
      "must": [
        {"match": {"post_title": "áo"}}
      ],
      "filter": [
        {"range": {"regular_price": {"gte": 100000}}}
      ]
    }
  }
}
Aggregation query
{
  "size": 0,
  "aggs": {
    "categories": {
      "terms": {
        "field": "category_ids",
        "size": 10
      }
    }
  }
}

11. MÃ TRẠNG THÁI

10.1. Product Status Codes

Code Tên Màu Ý Nghĩa
0 Pending 🔵 Xanh dương Chờ đánh index
1 Success 🟢 Xanh lá Đã index thành công
2 Failed 🔴 Đỏ Index thất bại
5 Processing 🟡 Vàng Đang xử lý

📝 CHANGELOG

Version 1.4.8 (11/02/2026) - LATEST!

  • Fix Sửa README.html thiếu chi tiết 3 Index Mode (AJAX/CLI/Cron API)
  • Docs Viết lại phần Cấu Hình Chi Tiết với 6 subsections rõ ràng
  • Docs Thêm bảng so sánh 3 Index Mode: bảo mật, use cases, commands
  • Docs Nêu rõ Index Name nằm ở Config page, không phải Index Product page
  • Docs Quy trình Index lần đầu: 5 bước từ Config → Verify kết quả
  • Docs Giải thích Index Prefix áp dụng cho TẤT CẢ indices

Version 1.4.7 (11/02/2026)

  • Docs Cập nhật toàn bộ documentation theo code mới nhất (README.md)
  • Docs Viết lại phần Cấu hình chi tiết cho 3 Index Mode: AJAX, CLI, Cron API
  • Docs Thêm hướng dẫn cấu hình Product Configuration
  • Docs Thêm Quy trình Index lần đầu rõ ràng từ Bước 1-5
  • Fix Sửa thông tin sai lệch về Index Prefix và Index Name

Version 1.4.6 (11/02/2026)

  • Fixed Sửa lỗi cursor nhảy về đầu khi nhập text trong JSON Editor
  • Feature Collapsible JSON Viewer - Thu gọn/mở rộng JSON tree trong Response Body
  • UI/UX Hiển thị ▶/▼ icons và preview (X items/keys) khi thu gọn
  • Performance Tối ưu cursor position tracking với character offset

Version 1.4.5 (11/02/2026)

  • New Thêm Elasticsearch API Test interface với JSON Editor
  • New cURL Command Generator - auto generate cURL từ JSON query
  • New Response Viewer với search-in-response feature
  • New Tab switching: JSON Editor ↔ cURL Command
  • UI/UX Modern code editor với syntax highlighting
  • Feature Copy cURL command to clipboard với 1 click

Version 1.4.4 (11/02/2026)

🐛 Sửa Lỗi Nghiêm Trọng:

  • 🔧 Fix 92 Products Infinite Loop Bug: Sửa lỗi 92 sản phẩm lặp vô hạn mỗi ngày
    • Layer 1: Hook 15-16 (scheduled sales) thêm get_post_type() validation
    • Layer 2: es_sync_product() validate product tồn tại qua get_post()
    • Layer 3: index_data() gọi remove_products_batch() khi empty post data
    • Root cause: Orphaned postmeta cho deleted products trigger scheduled sales hooks

✨ Cải Tiến Error Handling:

  • 🛡️ Index Mode Validation: Cải thiện validation và error messages
    • Thay showLockErrorWithForceStart() bằng showNoti() + state reset
    • Rút gọn error message: "Index mode must be %s (current: %s)"
    • Thêm i18n support (English + Vietnamese)
    • Validation hoàn toàn server-side

🎨 Cải Tiến UI/UX:

  • 📊 Progress Panel Improvements: Tối ưu hiển thị
    • Lazy initialization: Chỉ tạo progress panel sau AJAX success đầu tiên
    • Thêm loading overlay ngay khi bắt đầu indexing
    • Fix positioning: Progress nằm giữa main buttons và Advanced Options
    • Indexing Console luôn nằm dưới Progress Panel
  • 🔘 Advanced Options Button States:
    • Thêm #reindex_all_products và #reindex_failed_products vào disableAllButtons()
    • Tất cả 7 buttons (5 main + 2 advanced) disable đồng thời khi indexing
    • Advanced Options toggle không bị đẩy xuống

🌍 Đa Ngôn Ngữ:

  • Thêm indexModeMustBe: "Index mode must be %s (current: %s)"
  • Thêm mode labels: Ajax, CLI, Cron API
  • Cập nhật wp-es.pot, wp-es-vi_VN.po

📝 Files Modified:

  • hook.php - 3-layer validation for product sync
  • process/product_pr.php - Cleanup invalid products
  • assets/js/admin.js - UI improvements & lazy init
  • process/index.php - Shortened error messages
  • languages/ - Added i18n strings

Version 1.4.3 (08/01/2026)

⚡ Performance Optimization:

  • 🚀 Cached Index Checking: Loại bỏ HEAD request chậm
    • Thêm check_index_exists() method trong PRODUCT_PR
    • Kiểm tra từ get_indices_stats() raw_data đã load
    • Giảm thời gian load: 60s → <1s (98% faster)
  • ⚡ Optimized get_status(): Không gọi ES API mỗi page load
    • Trả về field product_index_exists
    • Reuse cached data thay vì query lại
  • ✅ Smart Validation: index_data() kiểm tra mapping trước
    • Ngăn indexing khi chưa có mapping
    • Tránh lỗi "index not found"

🎨 UX Improvements:

  • ✨ Instant UI Updates: JavaScript xóa warning ngay lập tức
    • fadeOut() animation khi create mapping thành công
    • Enable 7 buttons instantly (prepare, index, reset, delete, advanced...)
    • Không reload page, chỉ AJAX refresh stats
  • 🎯 Dynamic Notice Management: Xử lý cả template và dynamic notice
    • Notice từ status-product.php template
    • Notice tạo động trong JavaScript
    • Smooth transitions với fadeOut()

🔧 Code Changes:

  • 🔒 Strict Configuration: create_mapping() yêu cầu config
    • Không còn default value 'wp_products'
    • Báo lỗi nếu chưa có configuration
  • 🧹 Code Cleanup: Xóa obsolete functions
    • Removed: has_mapping()
    • Removed: set_mapping_status()
  • 📦 Better Organization: Logic đúng chỗ
    • CONFIG_PR::get_product_config()
    • Removed JS to PHP data passing

🐛 Bug Fixes:

  • Fixed: Warning notice vẫn hiển thị sau successful mapping
  • Fixed: Dynamic notice không có ID để xóa
  • Fixed: Page load 60s do HEAD request

📝 Files Modified:

  • process/product_pr.php - Added check_index_exists(), removed obsolete methods
  • admin/product_ad.php - Uses product_index_exists field
  • admin/template-path/status-product.php - Added notice ID
  • assets/js/admin.js - Instant UI updates, remove notices
  • process/config_pr.php - Added default config values

Version 1.4.2 (28/12/2025)

✨ New Features:

  • 🔄 Auto Verify & Sync Process (VERIFY_PR Class): Tự động kiểm tra mỗi giờ
    • Auto-detect missing products - Tìm sản phẩm bị thiếu trên ES
    • Auto-detect extra products - Tìm sản phẩm thừa trên ES
    • Auto-fix failed products - Xóa sản phẩm lỗi khỏi ES
    • Comprehensive logging - Ghi log chi tiết tất cả hoạt động
  • 📊 Database Logging System (LOG_PR Class): Lưu audit trail vĩnh viễn
    • Ghi vào bảng wp_es_logs thay vì console
    • Tên log có thể cấu hình để lọc
    • Admin Log page hiển thị tất cả logs với search/filter
  • 🎯 Code Consolidation: Phương thức cha tập trung
    • is_index_enabled($type) - Kiểm tra index type
    • get_index_name($index_type) - Lấy tên index
    • Loại bỏ duplicate methods trong child classes

🔧 Improvements:

  • Configuration-driven batch sizes - Đọc từ max_rows config
  • Logging system migration - Từ CONSOLE_PR sang LOG_PR
  • Enhanced logging coverage - Ghi log tất cả verify operations
  • Vietnamese translations - Đầy đủ dịch tiếng Việt

🐛 Bug Fixes:

  • Fixed ES_SETTING undefined constant
  • Fixed get_api() deprecated calls
  • Fixed get_product_index_name() method call
  • Fixed product_db.php using get_option() directly

📝 Technical Details:

  • New VERIFY_PR class cho auto verify & sync
  • Enhanced LOG_PR class với database logging
  • Cron job chạy mỗi giờ: es_cron_auto_verify_sync
  • Log categories: verify_sync, verify_delete_extra, verify_fix_failed

Version 1.4.1 (05/12/2025)

✨ New Features:

  • 🎯 Product Configuration Section: Thêm phần cấu hình riêng cho Product
    • Tag-based input cho Indexable Post Statuses (publish, draft, pending, private...)
    • Auto-suggestion cho các WordPress post statuses phổ biến
    • Section tự động hiện/ẩn theo checkbox Product
  • 📦 CONFIG_DB Class: Class mới quản lý config tập trung
    • get_option_keys() - Lấy danh sách option keys của plugin
    • delete_all_options() - Xóa tất cả options khi uninstall
    • get/update_indexable_statuses() - Quản lý indexable statuses
    • get/set/release_indexing_lock() - Quản lý indexing lock
  • 🗑️ Uninstall Cleanup: Tự động xóa tất cả plugin options khi uninstall
    • es_setting, es_indexable_statuses
    • es_logs_per_page, es_indexing_lock, es_stop_indexing

🔧 Improvements:

  • Product count now respects configured indexable statuses
  • Moved get_indexable_statuses() to PRODUCT_DB class
  • Added i18n strings for Product Configuration section

🐛 Bug Fixes:

  • Fixed product count mismatch - chỉ đếm products với configured statuses
  • Fixed missing cleanup of plugin options on uninstall

Version 1.4.0 (01/12/2025)

✨ New Features:

  • 📝 Log Admin Page Redesign: Complete UI overhaul matching Product Admin style
  • 🗑️ Delete All Logs Confirmation: Custom showConfirm() popup dialog

🐛 Bug Fixes:

  • Fixed HTML nested forms error in Log Admin
  • Fixed Log Admin page not loading CSS/FontAwesome icons
  • Fixed count_product() total calculation

Version 1.3.9 (28/11/2025)

🔥 Major Changes:

  • 🚀 OPTIMIZED HOOKS: Giảm từ 32 hooks xuống 16 hooks không trùng lặp
    • Loại bỏ các hooks redundant (edit_post, post_updated, woocommerce_new_product, etc.)
    • Tăng hiệu năng, giảm overhead khi save product
  • ✨ ES DELETE HANDLING: Xử lý xóa sản phẩm khỏi Elasticsearch
    • action='deleted' → Xóa document khỏi ES (product bị xóa vĩnh viễn)
    • action='trashed' → Re-index với post_status='trash'
    • Priority system: 'deleted' action không bị override
  • 🔄 AUTO RESET STUCK: Tự động reset cả index stuck và delete stuck
    • Status 5 → Status 0 sau 5 phút
    • Status 7 → Status 6 sau 5 phút

New Features:

  • ✅ process_realtime_delete() - Xử lý xóa realtime qua ES API
  • ✅ mark_products_for_delete_batch() - Queue mode delete
  • ✅ mark_products_processing_delete() - Realtime mode delete
  • ✅ Separate tracking cho index vs delete operations
  • ✅ Added product_shipping_class taxonomy support

Improvements:

  • 🎯 Simplified es_sync_product() function với Vietnamese comments
  • 🎯 Trigger merging khi cùng 1 product trigger nhiều hooks trong 1 request
  • 🎯 Better logging với trigger count display
  • 🎯 Variation stock changes now sync parent product

Status Codes Updated:

Code Name Description
0pending_indexChờ đánh index
1index_successIndex thành công
2index_failedIndex thất bại
5processing_indexĐang xử lý index
6pending_deleteChờ xóa khỏi ES
7processing_deleteĐang xử lý xóa
8delete_successXóa thành công
9delete_failedXóa thất bại

Version 1.3.8 (20/11/2025)

Improvements:

  • 🚀 Simplified Analyzer Language - now defaults to English (removed from UI)
  • 🌐 Full multilingual support for CLI commands using __() function
  • 🎯 Removed --max-batches parameter from CLI (simplified usage)
  • 🔄 Added --continuous flag for CLI: single batch for cron, continuous for manual
  • 🐛 Fixed continuous flag logic check in batch processing loop
  • 📝 Updated CLI messages: "Logging to database" → "Saving logs to database"
  • 🔧 Improved CLI command workflow for better cron job compatibility

Breaking Changes:

  • ⚠️ Analyzer Language setting removed from Config UI (hardcoded to 'english')
  • ⚠️ --max-batches CLI parameter removed (use --continuous flag instead)

Version 1.3.7 (19/11/2025)

New Features:

  • ✨ Console Monitor with real-time logs
  • ✨ 18 WordPress hooks for auto-sync
  • ✨ WP-CLI commands support
  • ✨ Advanced mapping settings (shards, replicas, field limit)
  • ✨ Analyzer language configuration
  • ✨ Reindex all/failed products buttons
  • ✨ Force clear lock mechanism
  • ✨ Batch sync at shutdown hook

Improvements:

  • 🚀 Optimized database queries
  • 🚀 Better bulk indexing performance
  • 🚀 Lock mechanism to prevent conflicts
  • 🚀 Auto-reset stuck products (5 min)
  • 🚀 Auto-cleanup old logs (7 days)

Bug Fixes:

  • 🐛 Fixed nested mapping for taxonomies
  • 🐛 Fixed memory issues with large batches
  • 🐛 Fixed lock not releasing on error
  • 🐛 Fixed console logs encoding

Developer:

  • 🔧 Added 10+ action/filter hooks
  • 🔧 Comprehensive hook documentation
  • 🔧 Example code snippets

Version 1.3.6 (14/10/2025)

Initial release

HỖ TRỢ

📚 Tài Liệu

Đọc kỹ tài liệu hướng dẫn này và các file trong thư mục doc/.

📧 Email Support

Gửi yêu cầu hỗ trợ qua email:
aboyit@hotmail.com

🌐 Website

Truy cập website:
webnew.info.vn

📄 LICENSE

GPL-2.0 License

Copyright (C) 2025 Aboyit

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

🎉 Cảm ơn bạn đã sử dụng WP Elasticsearch!