Trang chủ › Plugin WordPress

Plugin WordPress Kqxs

Cài plugin, nhận API key tự động và chèn kết quả xổ số vào WordPress bằng 7 shortcode.

Plugin WordPress

Kết quả xổ số, chèn bằng một dòng

Kqxs lấy kết quả từ KQXS API và hiển thị trên WordPress qua 7 shortcode. Không cần biết code — chọn trong trang quản trị, sao chép, dán vào bài viết.

7 shortcode
Miền Bắc · Trung · Nam
Vietlott
Thống kê
Dò số

Tải plugin (.zip) Xem cách cài

Tệp nén cài thẳng qua Plugins → Cài mới → Tải plugin lên. Yêu cầu WordPress 6.0 trở lên và PHP 7.4 trở lên.

[kqxs_results region="MB"]

Miền Bắc — bảng mẫu
Đặc biệt	12221
Giải nhất	33704
Giải nhì	95134 17327
Giải ba	04217 82286 56322
Giải bảy	21 77 29 97

1 Cài đặt plugin

Từ lúc tải về tới lúc chạy được mất chừng một phút. Bạn không phải tự đi lấy API key.

Tải và cài

Bấm nút "Tải plugin (.zip)" ở đầu trang.
Trong WordPress vào Plugins → Cài mới → Tải plugin lên, chọn tệp vừa tải, bấm Cài đặt.
Bấm Kích hoạt.

Muốn cài tay thì giải nén rồi chép thư mục kqxs vào wp-content/plugins/, sau đó kích hoạt trong danh sách Plugins.

Chưa kích hoạt thì shortcode không chạy. WordPress chỉ nạp plugin khi nó đang bật — shortcode chưa được đăng ký sẽ hiện ra dưới dạng chữ thô trên trang.

Kích hoạt xong là có tài khoản

Ngay lần tải trang quản trị kế tiếp, plugin tự đăng ký một tài khoản gói Free cho tên miền của site, nhận API key và lưu vào Cài đặt. Bạn sẽ thấy một thông báo báo việc đó đã xảy ra.

Chép ngay mã khách hàng. Vào Kqxs → Tài khoản, mã hiện dạng AB23C-DE45F-GH67J-KM89N. Máy chủ chỉ hiện API key đúng một lần; mất key thì mã này là cách duy nhất lấy lại. Gỡ plugin sẽ xoá mã khỏi site, nên hãy lưu ra ngoài.

2 Tài khoản và gói dịch vụ

Menu Kqxs → Tài khoản chia làm ba tab.

Tab "Tài khoản & gói"

Hiện trạng thái kết nối, mã khách hàng, hạn dùng của gói đang chạy, và bảng giá lấy trực tiếp từ máy chủ.

Gói	Giá	Lượt gọi/ngày	Tính năng
Free	Miễn phí	100	Dữ liệu cơ bản
Starter	200.000 ₫/tháng	1.000	Dữ liệu cơ bản
Pro	300.000 ₫/tháng	5.000	Thêm thống kê
VIP	500.000 ₫/tháng	50.000	Toàn bộ API

[kqxs_thongke] cần gói Pro trở lên. Trên gói Free, máy chủ từ chối endpoint thống kê và shortcode đó sẽ báo lỗi — đúng hành vi, không phải hỏng.

Nâng gói

Bấm gói muốn dùng. Plugin tạo đơn trên chính tài khoản hiện tại và hiện mã QR chuyển khoản kèm số tiền và nội dung chuyển khoản.

Nội dung chuyển khoản phải đúng từng ký tự. Sai một ký tự là hệ thống không đối soát được và gói không tự kích hoạt.
Trong lúc hiện QR, trang tự hỏi máy chủ — 2,5 giây một lần trong 2 phút đầu, rồi giãn dần. Thanh toán xong là trang tự tải lại với gói mới.
Vẫn có nút "Tôi đã chuyển khoản — kiểm tra" để hỏi ngay.
Đơn có hiệu lực 30 phút. Hết hạn thì khối QR tự biến mất — mã QR chết mà còn hiện là mời người ta chuyển tiền vào chỗ không đối soát được.

Nâng gói không đổi API key. Key đang chạy giữ nguyên, chỉ quyền lợi thay đổi. Bạn không phải sửa gì trong Cài đặt.

Cài lại plugin — lấy lại quyền truy cập

Xoá plugin chỉ xoá dữ liệu phía site; máy chủ vẫn giữ nguyên tài khoản. Cài lại, plugin sẽ báo tên miền đã có tài khoản. Lúc đó nhập mã khách hàng vào ô "Đã có tài khoản?" ở tab đầu để nhận API key mới.

Khôi phục sẽ thu hồi key cũ ngay lập tức. Nếu một site khác đang dùng chung key đó, site kia sẽ ngừng lấy được dữ liệu. Plugin từ chối khôi phục khi site hiện tại vẫn còn key chạy được.

Hai tab còn lại

Lịch sử thanh toán — mọi đơn đã tạo, số tiền, nội dung chuyển khoản và trạng thái. Đơn "đã nhận tiền, đang kích hoạt" khác với "đã kích hoạt": tiền về rồi nhưng gói chưa gắn xong.
Lượt gọi API — số lượt đã dùng hôm nay, hạn mức, số còn lại, và bảng theo từng ngày. Bảng theo ngày có số liệu từ hôm sau, vì máy chủ gộp số của mỗi ngày sau nửa đêm.

3 Chèn shortcode vào trang

Không cần nhớ cú pháp. Trang quản trị dựng sẵn chuỗi shortcode cho bạn.

Dùng trang dựng shortcode

Vào Kqxs → Shortcode.
Bấm một thẻ trong lưới để chọn loại shortcode.
Chỉnh thuộc tính ở cột trái — chuỗi shortcode bên phải tự cập nhật theo.
Bấm Xem thử để thấy kết quả thật ngay tại đó.
Bấm Sao chép, rồi dán vào bài viết hoặc trang.

Chuỗi sinh ra luôn ngắn nhất có thể — thuộc tính nào đang để mặc định thì không xuất hiện trong shortcode.

Trang này cũng liệt kê đầy đủ ý nghĩa từng thuộc tính và vài ví dụ sẵn cho mỗi shortcode.

Nếu trang trắng sau khi dán: nội dung có thể vẫn ở đó nhưng theme không in ra. Xem mục Xử lý sự cố.

Danh sách shortcode

Mọi thuộc tính đều không bắt buộc — bỏ trống thì dùng giá trị mặc định. Giá trị sai sẽ tự rơi về mặc định chứ không gây lỗi trang.

[kqxs_results]

Kết quả xổ số — Kết quả theo miền, theo đài hoặc theo ngày.

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`region`	MB · MN · MT	theo cài đặt	Miền
`province`	chữ	trống	Mã đài Ví dụ tphcm. Có giá trị thì bỏ qua thuộc tính miền.
`date`	YYYY-MM-DD	trống	Ngày Định dạng YYYY-MM-DD. Để trống lấy kỳ mới nhất.
`limit`	số nguyên 1–10	`1`	Số kỳ
`layout`	table · compact	`table`	Kiểu hiển thị
`show_loto`	0 · 1	`1`	Hiện bảng loto 2 số cuối

[kqxs_results region="MB"]

[kqxs_results region="MN" limit="3" layout="compact"]

[kqxs_results province="tphcm" limit="3"]

[kqxs_today]

Đài xổ hôm nay — Danh sách đài quay hôm nay kèm trạng thái.

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`region`	MB · MN · MT	trống	Lọc theo miền Để trống hiện tất cả các miền.
`show_status`	0 · 1	`1`	Hiện trạng thái

[kqxs_today]

[kqxs_today region="MN" show_status="0"]

[kqxs_live]

Kết quả trực tiếp — Tự cập nhật trong khung giờ quay.

cần JavaScript

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`region`	MB · MN · MT	theo cài đặt	Miền
`date`	YYYY-MM-DD	trống	Ngày
`refresh`	số nguyên 5–120	`15`	Chu kỳ làm mới (giây)

[kqxs_live region="MB"]

[kqxs_live region="MN" refresh="10"]

[kqxs_check]

Dò số — Form cho khách nhập số và đối chiếu với kết quả.

cần JavaScript

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`province`	chữ	trống	Đài chọn sẵn Ví dụ tphcm. Để trống thì khách tự chọn.
`date`	YYYY-MM-DD	trống	Ngày mặc định

[kqxs_check]

[kqxs_check province="tphcm"]

[kqxs_vietlott]

Kết quả Vietlott — Mega 6/45, Power 6/55, Max 3D, Keno.

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`game`	all · mega · power · max3d · keno	`all`	Trò chơi

[kqxs_vietlott]

[kqxs_vietlott game="mega"]

[kqxs_provinces]

Danh mục đài — Danh sách đài theo miền.

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`region`	MB · MN · MT	trống	Miền Để trống hiện tất cả.
`layout`	list · grid	`list`	Kiểu hiển thị
`show_code`	0 · 1	`1`	Hiện mã đài Mã đài dùng cho [kqxs_check] và [kqxs_results]. Tắt nếu chỉ cần tên.

[kqxs_provinces]

[kqxs_provinces region="MT" layout="grid"]

[kqxs_provinces layout="grid" show_code="0"]

[kqxs_thongke]

Thống kê — Lô gan, tần suất, đầu-đuôi, dự đoán. Chỉ mang tính tham khảo.

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`type`	lo-gan · tan-suat · dau-duoi · du-doan	`lo-gan`	Loại thống kê
`region`	MB · MN · MT	theo cài đặt	Miền
`days`	số nguyên 7–90	`30`	Số ngày thống kê Không áp dụng cho loại Dự đoán.
`limit`	số nguyên 5–100	`20`	Số dòng hiển thị Dùng cho Lô gan, Tần suất và Dự đoán.
`kind`	pair · special	`pair`	Nhóm lô gan Chỉ dùng cho loại Lô gan.
`show_matrix`	0 · 1	`0`	Hiện ma trận đầu × đuôi Chỉ dùng cho loại Đầu - đuôi.

[kqxs_thongke type="lo-gan" region="MB"]

[kqxs_thongke type="tan-suat" region="MN" days="60"]

[kqxs_thongke type="dau-duoi" region="MB" show_matrix="1"]

[kqxs_thongke type="du-doan" region="MB"]

Thuộc tính chung

Ba thuộc tính dưới đây dùng được với mọi shortcode ở trên.

Thuộc tính	Nhận giá trị	Mặc định	Ý nghĩa
`title`	chữ	trống	Tiêu đề Để trống thì không hiện tiêu đề.
`class`	chữ	trống	Class CSS thêm
`template`	chữ	trống	Template thay thế Chỉ dùng khi theme override template.

Không còn thuộc tính cache. Plugin không cache dữ liệu, nên không có gì để chỉnh.

Trang Cài đặt

Sáu mục, chia ba nhóm. Chỉ một mục bắt buộc, và nó thường đã được điền sẵn.

Mục	Mặc định	Ý nghĩa
Kết nối
API key	tự điền	Mục DUY NHẤT bắt buộc. Plugin tự điền khi kích hoạt. Key gửi qua header x-api-key từ phía máy chủ và không bao giờ lộ ra front-end.
Thời gian chờ (giây)	8	Chờ máy chủ API bao lâu thì bỏ cuộc. Giá trị ngoài khoảng 1–30 sẽ được kẹp lại.
Hiển thị
Miền mặc định	MB	Dùng khi shortcode không chỉ định thuộc tính region.
Định dạng ngày	d/m/Y	Theo cú pháp hàm date() của PHP.
Hiện dòng miễn trừ trách nhiệm	1	Hiển thị "Kết quả chỉ mang tính tham khảo" dưới mỗi shortcode.
Tài nguyên
Chỉ nạp CSS/JS ở trang có shortcode	1	Tắt thì CSS/JS của plugin nạp trên mọi trang. Nên để bật.

Nút Test kết nối nằm ở cột phải. Bấm để chắc chắn máy chủ nhận key hiện tại:

Kết nối OK — máy chủ phản hồi bình thường.
API key không hợp lệ — key sai hoặc đã bị thu hồi.
Không kết nối được — máy chủ API đang không phản hồi.

Lượt gọi API

Plugin không cache bất cứ thứ gì. Hiểu rõ mục này trước khi chọn gói, vì nó quyết định site của bạn tiêu bao nhiêu lượt mỗi ngày.

1shortcode hiển thị = 1 lượt gọi
Nshortcode trên một trang = N lượt mỗi lượt xem
0lượt cho request bị từ chối

Hai shortcode giống hệt nhau trên cùng một trang vẫn tính hai lượt. Không có tầng đệm nào giữa trang của bạn và máy chủ.

Việc	Tính vào hạn mức
Lấy dữ liệu thành công	+1
Bị từ chối vì gói không có tính năng	+0
Xem trang Tài khoản, bảng giá, lịch sử, lượt gọi	+0

Làm phép tính trước khi chọn gói. Một trang có 3 shortcode, trên gói Free 100 lượt/ngày, sẽ cạn hạn mức sau khoảng 33 lượt xem. Sau đó khách vào sẽ thấy thông báo lỗi. [kqxs_live] tự làm mới theo chu kỳ nên mỗi nhịp là thêm một lượt nữa, nhân với số người đang mở trang.

Cache toàn trang làm số liệu lệch. Nếu site dùng WP Rocket, LiteSpeed, Cloudflare hay tương tự, cả trang HTML được phục vụ từ bộ nhớ đệm và plugin không hề chạy — lượt xem tăng nhưng lượt gọi API thì không. Đó là chuyện nằm ngoài plugin.

Theo dõi số thực tế ở Kqxs → Tài khoản → Lượt gọi API.

Xử lý sự cố

Những tình huống đã gặp thật, kèm cách nhận biết.

Dán shortcode vào trang nhưng không hiện gì cả

Kiểm tra theo thứ tự này.

1. Plugin đã kích hoạt chưa? Nếu chưa, shortcode chưa được đăng ký và WordPress in ra chữ thô.

2. Theme có in nội dung trang không? Với theme khối (Twenty Twenty-Four trở đi), nếu mẫu Trang bị sửa trong Trình sửa giao diện và mất khối "Nội dung bài viết", thì mọi trang đều trống — không riêng trang có shortcode. Dấu hiệu: các trang khác cũng trống. Cách sửa: Giao diện → Trình sửa → Mẫu → Trang, chọn "Xoá tuỳ chỉnh".

3. Có API key chưa? Chưa có thì khách không thấy gì, còn quản trị viên thấy dòng nhắc kèm đường dẫn tới trang Cài đặt.

Báo "Tên miền này chưa được đăng ký cho API key"

Key hợp lệ nhưng gắn với tên miền khác. Thường gặp khi bạn chép database từ site khác sang, hoặc đổi tên miền của site.

Vào Kqxs → Tài khoản xem dòng "Tên miền" — đó là tên miền mà key đang gắn vào. Nếu khác tên miền hiện tại, liên hệ nhà cung cấp để thêm tên miền, hoặc đăng ký một tài khoản mới cho site này.

Báo "Gói free không bao gồm endpoint này"

Đúng hành vi, không phải lỗi. [kqxs_thongke] cần gói Pro trở lên. Các shortcode còn lại chạy được trên gói Free.

Nâng gói ở Kqxs → Tài khoản, hoặc bỏ shortcode thống kê khỏi trang.

Đang chạy tốt thì đột nhiên báo lỗi giữa ngày

Nhiều khả năng đã hết hạn mức trong ngày. Xem Kqxs → Tài khoản → Lượt gọi API: nếu số còn lại bằng 0 thì đúng là vậy, và hạn mức reset vào đầu ngày hôm sau.

Plugin không cache, nên mỗi lượt xem trang tiêu số lượt bằng số shortcode trên trang đó. Ước lượng lại rồi nâng gói nếu cần.

Cài lại plugin xong thì mất API key

Xoá plugin sẽ xoá toàn bộ dữ liệu phía site, gồm cả API key và mã khách hàng. Máy chủ thì vẫn giữ nguyên tài khoản.

Cài lại, plugin sẽ báo tên miền đã có tài khoản. Nhập mã khách hàng vào ô "Đã có tài khoản?" ở Kqxs → Tài khoản để nhận key mới. Không còn giữ mã thì phải liên hệ nhà cung cấp.

Cập nhật plugin lên bản mới thì không mất gì — chỉ xoá mới xoá dữ liệu.

Chuyển khoản rồi mà gói chưa kích hoạt

Ngân hàng thường mất vài chục giây tới vài phút. Trang tự hỏi lại theo chu kỳ; bạn cũng có thể bấm "Tôi đã chuyển khoản — kiểm tra".

Quá lâu vẫn chưa được thì kiểm tra nội dung chuyển khoản: sai một ký tự là hệ thống không đối soát vào đơn nào. Đối chiếu với mã ghi trong Lịch sử thanh toán rồi liên hệ nhà cung cấp kèm mã đó.

Đơn hiện "đã nhận tiền, đang kích hoạt" nghĩa là tiền đã về nhưng bước gắn gói chưa xong — trường hợp này cần nhà cung cấp can thiệp.

Các nút trong trang quản trị không phản ứng

Gần như luôn là trình duyệt đang giữ bản JavaScript cũ. Tải lại bằng Ctrl + Shift + R (Windows) hoặc Cmd + Shift + R (macOS).

Plugin gắn thời điểm sửa file vào địa chỉ CSS/JS nên các lần cập nhật sau tự nạp bản mới.

Dò số báo không tìm thấy đài

Mã đài phải khớp đúng danh mục của API. Một số mã không có dấu gạch nối như bạn tưởng — ví dụ TP.HCM là tphcm, không phải tp-hcm.

Chèn [kqxs_provinces] vào một trang nháp để xem danh sách đài đầy đủ theo từng miền.

Máy chủ API đang lỗi thì trang hiện gì?

Khách xem trang thấy một dòng thông báo trung tính. Quản trị viên thấy thêm nguyên văn câu báo của máy chủ để biết đường xử lý.

Vì plugin không cache nên không có bản lưu nào để hiển thị thay — API lỗi là không có dữ liệu.

Muốn đổi giao diện bảng kết quả

Theme có thể ghi đè bất kỳ mẫu hiển thị nào. Chép file từ kqxs/public/partials/shortcodes/ vào thư mục kqxs/ trong theme rồi sửa.

Ví dụ: your-theme/kqxs/results-table.php. Plugin ưu tiên theme con, rồi theme cha, rồi mới đến bản của chính nó — nên cập nhật plugin sẽ không đè mất bản sửa.