getkirby/kql

🔍 KQL: Ngôn ngữ truy vấn dữ liệu mạnh mẽ cho Kirby CMS

Kết hợp tính linh hoạt của cấu trúc dữ liệu Kirby, sức mạnh của GraphQL và đơn giản của REST.

KQL (Kirby Query Language) là một plugin cho Kirby CMS, thêm một endpoint /api/query cho phép người dùng gửi các yêu cầu POST bằng JSON để truy vấn và lấy về dữ liệu được tùy chỉnh hoàn toàn. Thay vì phụ thuộc vào cấu trúc cố định của REST truyền thống, KQL cho phép bạn mô tả chính xác những gì cần lấy — từ trường, trang, tệp, người dùng cho đến cách chúng được định dạng.

✨ Điểm nổi bật

• Truy vấn linh hoạt: Dùng query để truy cập bất kỳ phần nào của dữ liệu Kirby.
• Điều khiển kết quả chi tiết: select giúp chọn thuộc tính, trường hoặc cả cấu trúc lồng nhau.
• Hỗ trợ phân trang: Tích hợp sẵn pagination để giới hạn số lượng kết quả.
• Xử lý phương thức trường: Có thể gọi trực tiếp các phương thức như page.text.kirbytext.
• Xác thực an toàn: Endpoint yêu cầu xác thực bằng Basic Auth hoặc token.
• Dễ tích hợp: Gửi yêu cầu bằng bất kỳ thư viện HTTP nào, ví dụ: fetch trong JavaScript.
• Cài đặt đơn giản: Hỗ trợ cài qua Composer hoặc tải thủ công.

💡 Vì sao đáng chú ý

KQL không chỉ là một lớp API truyền thống — nó mang lại khả năng truy vấn dữ liệu mạnh mẽ như GraphQL nhưng với cú pháp đơn giản và dễ hiểu, phù hợp ngay cả với dự án nhỏ. Đặc biệt hữu ích khi xây dựng ứng dụng headless hoặc cần lấy dữ liệu một cách linh hoạt từ Kirby mà không cần viết code PHP phứức tạp.

---

#Kirby #HeadlessCMS #QueryLanguage #GraphQL #REST #OpenSource #TiniX