Thông tin repository

Git Repository: https://git.nospace.network/thscore/sport-wp-widgets

Branch chính: main

Các phiên bản mới cần được upload lên s3 theo thư mục: /s3/buckets/sports-plugin (Liên hệ devops để lấy tài khoản S3)

I. Tổng quan plugin Widgets WP (KQXS)

Widgets WP (KQXS) là plugin WordPress cung cấp hệ thống shortcode mạnh mẽ giúp hiển thị dữ liệu xổ số, thống kê và các tiện ích liên quan một cách linh hoạt trên website.

Plugin được thiết kế để:

Dễ dàng tích hợp vào mọi theme WordPress

Hỗ trợ hiển thị dữ liệu động thông qua AJAX

Tối ưu hiệu suất và trải nghiệm người dùng

Cho phép sử dụng nhiều shortcode trên cùng một trang mà không xung đột

⚙️ Tính năng chính

🎰 Hiển thị kết quả xổ số theo miền, tỉnh, ngày

📊 Hệ thống thống kê đa dạng (tần suất, gan, theo lô, chi tiết)

⚡ Cập nhật kết quả trực tiếp (live) theo thời gian thực

📋 Danh sách kết quả có phân trang và “Load more”

🔍 Dò vé số nhanh chóng

💰 Hiển thị thêm tiện ích: giá vàng, tỷ giá, thời tiết

🛠️ Công cụ đồng bộ dữ liệu thủ công trong Admin

🧩 Cách hoạt động

Plugin hoạt động dựa trên cơ chế:

Sử dụng shortcode để nhúng dữ liệu vào bài viết / trang

Gọi dữ liệu thông qua AJAX API để đảm bảo tải nhanh và không reload trang

Hỗ trợ cron hoặc đồng bộ thủ công để cập nhật dữ liệu

Cho phép cấu hình linh hoạt thông qua hệ thống customizer nội bộ

🧑‍💻 Đối tượng sử dụng

Website tin tức xổ số

Website tài chính / tiện ích

Blog hoặc portal cần hiển thị dữ liệu động

Developer muốn tích hợp nhanh dữ liệu xổ số vào WordPress

🚀 Điểm nổi bật

Không cần code vẫn sử dụng được (chỉ cần shortcode)

Hỗ trợ nhiều block dữ liệu trên cùng một trang

Thiết kế tối ưu cho SEO và tốc độ tải trang

Dễ mở rộng và tùy chỉnh

📌 Lưu ý

Một số tính năng (như live) sử dụng AJAX polling → nên dùng hợp lý để tránh tải server

Nên đảm bảo cron hoặc API hoạt động ổn định để dữ liệu luôn cập nhật

Không nên đặt quá nhiều shortcode nặng trên cùng một trang

👉 Plugin phù hợp cho việc xây dựng hệ thống hiển thị xổ số chuyên nghiệp, linh hoạt và dễ mở rộng trên nền tảng WordPress.

II. Cài đặt plugin

Cách 1: Upload thủ công

Tải file plugin từ link:

https://dnkmg74tc9ukn.cloudfront.net/sport-wp-widgets.zip

Vào Admin → Plugins → Add New → Upload Plugin
Chọn file .zip và nhấn Install Now
Nhấn Activate để kích hoạt

Cách 2: Cài qua FTP

Giải nén file plugin
Upload vào thư mục:

/wp-content/plugins/

Vào Admin WordPress → Plugins
Kích hoạt plugin

III. Kiểm tra sau cài đặt

Plugin xuất hiện trong danh sách Plugins
Không có lỗi khi activate
Có thể sử dụng shortcode

IV. Danh sách Shortcode & Cách sử dụng

Plugin cung cấp nhiều shortcode giúp hiển thị dữ liệu xổ số và tiện ích.
Bạn có thể chèn shortcode vào Post, Page hoặc Widget trong WordPress.

🎰 1. `[lottery]` – Kết quả xổ số

Mô tả:
Hiển thị bảng kết quả xổ số theo miền và ngày (load bằng AJAX).

Cách dùng:

[lottery]

Ví dụ:

[lottery region="B"]
[lottery region="N" date="2025-12-24"]

Thuộc tính:

Thuộc tính	Mô tả	Mặc định
region	Miền (B: Bắc, T: Trung, N: Nam)	B
date	Ngày (Y-m-d)	Hôm nay

📋 2. `[lottery_table]` – Danh sách kết quả

Mô tả:
Hiển thị danh sách kết quả xổ số, có phân trang và nút “Xem thêm”.

Cách dùng:

[lottery_table region="B"]

Ví dụ:

[lottery_table region="N" code="XSBD"]
[lottery_table region="N" code="XSBD" date="2025-12-24"]

Thuộc tính:

Thuộc tính	Mô tả	Bắt buộc	Mặc định
region	Miền (B, T, N)	✔	Không lọc
code	Mã đài	✖	Không lọc
date	Ngày	✖	Không lọc
limit	Số bản ghi mỗi lần tải	✖	10

📍 3. `[lottery_region]` – Kết quả theo miền

Mô tả:
Hiển thị kết quả xổ số theo miền, hỗ trợ load thêm.

Cách dùng:

[lottery_region region="B"]

Ví dụ:

[lottery_region region="N"]
[lottery_region region="T" date="2025-12-24"]
[lottery_region region="N" limit="20"]

Thuộc tính:

Thuộc tính	Mô tả	Bắt buộc	Mặc định
region	Miền (B, T, N)	✔	B
date	Ngày	✖	Mới nhất
limit	Số bản ghi	✖	10

⚡ 4. `[lottery_live]` – Xổ số trực tiếp

Mô tả:
Hiển thị kết quả xổ số realtime (live) trong ngày.

Cách dùng:

[lottery_live]

Ví dụ:

[lottery_live region="N"]
[lottery_live region="T"]
[lottery_live region="N" code="XSMN"]

Thuộc tính:

Thuộc tính	Mô tả	Bắt buộc	Mặc định
region	Miền (B, T, N)	✔	B
code	Mã đài	✖	Không lọc

Lưu ý:

Dữ liệu cập nhật bằng AJAX polling

Nên dùng trong giờ quay số

Không nên đặt quá nhiều shortcode live trên 1 trang

🔍 5. `[lottery_search]` – Dò vé số

Mô tả:
Hiển thị form dò vé số trúng thưởng.

Cách dùng:

[lottery_search]

📊 6. `[lottery_statistics_batch]` – Thống kê theo lô

Cách dùng:

[lottery_statistics_batch type="0"]

Giá trị:

type="0": theo miền

type="1": theo tỉnh

📈 7. `[lottery_statistics_frequency]` – Thống kê tần suất

Cách dùng:

[lottery_statistics_frequency type="0"]

📊 8. `[lottery_statistics_frequency_detail]` – Tần suất chi tiết

Cách dùng:

[lottery_statistics_frequency_detail type="1"]

🔥 9. `[lottery_statistics_gan]` – Thống kê gan

Cách dùng:

[lottery_statistics_gan type="0"]

💰 10. `[gold_price_slider]` – Giá vàng

Mô tả:
Hiển thị slider giá vàng.

[gold_price_slider]

💱 11. `[exchange_rate_slider]` – Tỷ giá

Mô tả:
Hiển thị slider tỷ giá ngoại tệ.

[exchange_rate_slider]

🌦️ 12. `[weather_info]` – Thời tiết

Mô tả:
Hiển thị thông tin thời tiết.

[weather_info]

✅ Ghi chú chung

Shortcode có thể dùng nhiều lần trên cùng 1 trang

Không nên lạm dụng quá nhiều shortcode nặng (live, statistics)

Dữ liệu được tải bằng AJAX → không ảnh hưởng tốc độ load ban đầu

Nên kết hợp layout hợp lý để tối ưu UX

👉 Tip:
Bạn có thể kết hợp nhiều shortcode để tạo trang xổ số hoàn chỉnh:

[lottery_live region="B"]

[lottery region="B"]

[lottery_statistics_batch type="0"]

Tổng quan

Thông tin repository#

I. Tổng quan plugin Widgets WP (KQXS)#

⚙️ Tính năng chính#

🧩 Cách hoạt động#

🧑‍💻 Đối tượng sử dụng#

🚀 Điểm nổi bật#

📌 Lưu ý#

II. Cài đặt plugin#

Cách 1: Upload thủ công#

Cách 2: Cài qua FTP#

III. Kiểm tra sau cài đặt#

IV. Danh sách Shortcode & Cách sử dụng#

🎰 1. [lottery] – Kết quả xổ số#

📋 2. [lottery_table] – Danh sách kết quả#

📍 3. [lottery_region] – Kết quả theo miền#

⚡ 4. [lottery_live] – Xổ số trực tiếp#

🔍 5. [lottery_search] – Dò vé số#

📊 6. [lottery_statistics_batch] – Thống kê theo lô#

📈 7. [lottery_statistics_frequency] – Thống kê tần suất#

📊 8. [lottery_statistics_frequency_detail] – Tần suất chi tiết#

🔥 9. [lottery_statistics_gan] – Thống kê gan#

💰 10. [gold_price_slider] – Giá vàng#

💱 11. [exchange_rate_slider] – Tỷ giá#

🌦️ 12. [weather_info] – Thời tiết#

✅ Ghi chú chung#

Thông tin repository

I. Tổng quan plugin Widgets WP (KQXS)

⚙️ Tính năng chính

🧩 Cách hoạt động

🧑‍💻 Đối tượng sử dụng

🚀 Điểm nổi bật

📌 Lưu ý

II. Cài đặt plugin

Cách 1: Upload thủ công

Cách 2: Cài qua FTP

III. Kiểm tra sau cài đặt

IV. Danh sách Shortcode & Cách sử dụng

🎰 1. `[lottery]` – Kết quả xổ số

📋 2. `[lottery_table]` – Danh sách kết quả

📍 3. `[lottery_region]` – Kết quả theo miền

⚡ 4. `[lottery_live]` – Xổ số trực tiếp

🔍 5. `[lottery_search]` – Dò vé số

📊 6. `[lottery_statistics_batch]` – Thống kê theo lô

📈 7. `[lottery_statistics_frequency]` – Thống kê tần suất

📊 8. `[lottery_statistics_frequency_detail]` – Tần suất chi tiết

🔥 9. `[lottery_statistics_gan]` – Thống kê gan

💰 10. `[gold_price_slider]` – Giá vàng

💱 11. `[exchange_rate_slider]` – Tỷ giá

🌦️ 12. `[weather_info]` – Thời tiết

✅ Ghi chú chung