🌐 Ngôn ngữ: 🇻🇳 Tiếng Việt (hiện tại) · 🇬🇧 English · 🇯🇵 日本語

Plugin Tin tức cho GP247

Plugin quản lý tin tức cho GP247 Framework với các tính năng sau:

Tính năng chính

Quản lý danh mục tin tức đa cấp
Quản lý bài viết theo danh mục
Hỗ trợ đa ngôn ngữ cho danh mục và bài viết
URL thân thiện SEO

Giấy phép

GP247 News Plugin là phần mềm mã nguồn mở theo giấy phép MIT.

Hướng dẫn cài đặt

GP247 hỗ trợ 4 cách cài đặt tiện ích (plugin/template): Online (từ thư viện chính thức), Import (tải lên file .zip), Thủ công (chép thư mục vào server) và Dòng lệnh (CLI, từ gp247 3.x).

Tham khảo tài liệu chính thức: Hướng dẫn cài đặt tiện ích.

Cách 1: Cài đặt Online (từ thư viện)

Bước 0 — Đăng ký API License (chỉ làm một lần):

Vào phần cấu hình API License trong Admin.
Nhấn "Đăng ký/Thiết lập" để lấy license key miễn phí.
Hệ thống tự lưu key vào biến GP247_API_LICENSE trong file .env.

Các bước cài:

Vào menu Plugin (hoặc Template) và chọn tab Online.
Duyệt thư viện tiện ích GP247, dùng tìm kiếm/lọc để chọn plugin phù hợp phiên bản Core hiện tại.
Nhấn Install — hệ thống tự tải về, kiểm tra tương thích, giải nén và cài đặt.
Cài xong sẽ có thông báo thành công và plugin hiện trong danh sách đã cài.
Lưu ý: tiện ích trả phí cần thêm license key riêng của tiện ích đó, ngoài API License miễn phí.

Cách 2: Import file zip

Vào menu Plugin và chọn tab Import.
Chọn file .zip của plugin từ máy rồi nhấn Upload — hệ thống tự kiểm tra và cài đặt.
Yêu cầu với file zip:
- Chỉ chấp nhận định dạng .zip, dung lượng tối đa 50MB.
- Phải chứa file gp247.json ở thư mục gốc.
- Không được trùng configKey với tiện ích đã có.

Cách 3: Cài đặt thủ công

Giải nén mã nguồn và chép thư mục plugin (chứa AppConfig.php và gp247.json) vào:
- app/GP247/Plugins/News
Nếu plugin có thư mục public, chép nội dung của nó sang:
- public/GP247/Plugins/News
Plugin sẽ tự xuất hiện trong Admin > Extensions > Plugins (trạng thái chưa cài). Tìm "News" và nhấn Install để kích hoạt.

Cách 4: Cài bằng dòng lệnh (CLI, gp247 3.x)

Từ gp247 3.x, bạn có thể tải News từ thư viện GP247 và cài ngay bằng dòng lệnh mà không cần mở admin. Mở Terminal tại thư mục gốc website rồi chạy:

# 1) Chỉ làm 1 lần cho mỗi website: đăng ký API License (miễn phí) để kết nối thư viện GP247
php artisan gp247:ext-register-license

# 2) Tải plugin từ thư viện và cài
php artisan gp247:ext-install --type=plugin --key=News

Trước bước 1, kiểm tra APP_URL trong .env là domain thật của website (không để http://localhost), vì license được gắn với domain này.
Cài xong, plugin được bật sẵn và cache tự làm mới, bạn không cần thao tác gì thêm trong admin.
Lệnh tự kiểm tra điều kiện khai báo trong gp247.json (phiên bản core, gói composer, plugin phụ thuộc). Nếu thiếu, lệnh dừng lại và báo rõ thiếu gì.
Plugin này cần gói gp247/front đã được cài; nếu thiếu, lệnh sẽ dừng lại và báo.
Nếu thư mục app/GP247/Plugins/News đã có sẵn trên máy (chép thủ công hoặc có sẵn theo bộ cài), lệnh sẽ cài tại chỗ, không tải lại.
Nếu plugin đã được cài, lệnh sẽ từ chối. Để lên bản mới, chạy php artisan gp247:ext-update --type=plugin --key=News.
Thêm --json vào cuối lệnh để nhận kết quả dạng máy đọc được (dùng cho script/CI).
Mục Sau khi cài đặt bên dưới (Enable/Disable, Config, chạy php artisan optimize:clear khi cần) vẫn giữ nguyên.
Chi tiết: Hướng dẫn cài đặt Plugin & Template · Tra cứu lệnh.