[Package] GP247/front

Sửa trên GitHub 
  _____  _____     ___  _  _   _____ 
 / ____|  __ \   |__ \| || | |___  |
| |  __| |__) |     ) | || |_   / / 
| | |_ |  ___/     / /|__   _| / /  
| |__| | |        / /_   | |  / /   
 \_____|_|       |____|  |_| /_/

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

Gói nền tảng frontend & CMS cho GP247

composer require gp247/front

Tổng lượt tải Phiên bản ổn định mới nhất Giấy phép Ask DeepWiki

Giới thiệu

GP247/Front là gói nền tảng cho toàn bộ tầng frontend của GP247 — không phải lớp giao diện/theme thuần túy. Gói này vừa cung cấp website công khai (storefront) và hệ quản lý nội dung (CMS), vừa là hạ tầng dùng chung để các gói frontend khác (như gp247/shop) kế thừa. Đây là thành phần bắt buộc cho một site GP247 đầy đủ, đóng vai trò cho tầng frontend tương tự như gp247/core cho tầng quản trị.

Các tính năng chính:

  • Quản lý nội dung trang (Page / CMS)
  • Hệ thống template linh hoạt + cơ chế resolve view theo template đang dùng
  • Hệ thống plugin mở rộng
  • Quản lý điều hướng, menu, liên kết & banner
  • Tích hợp biểu mẫu liên hệ & đăng ký
  • Hạ tầng dùng chung cho frontend (base Livewire component, layout, route) để các gói khác cắm vào

Cài đặt

  1. Cài đặt gói

    composer require gp247/front

  2. Cấu hình routing: mở file bootstrap/app.php:

  • Comment dòng cấu hình web routes:

    //GP247 comment
//web: __DIR__.'/../routes/web.php',

  1. Đăng ký service provider trong bootstrap/providers.php:

    return [
    // ... các providers hiện có
    GP247\Front\FrontServiceProvider::class,
];

  2. Chạy lệnh cài đặt:

php artisan gp247:front-install

Tính năng chính

Quản lý Trang

  • Tạo và quản lý trang tĩnh
  • Hỗ trợ SEO cho từng trang
  • Kiểm soát truy cập

Giao diện

  • Hệ thống Mẫu Linh hoạt
  • Bố cục tùy chỉnh cho từng phần
  • Thiết kế tương thích

Tùy chỉnh giao diện quản trị:

php artisan vendor:publish --tag=gp247:front-admin

Các view sẽ được lưu trữ tại: resources/views/vendor/gp247-front-admin

Cập nhật view của template mặc định (GP247Front):

php artisan vendor:publish --tag=gp247:front-view

Các view sẽ được lưu trữ tại: app/GP247/Templates/GP247Front

Publish tài nguyên public (css/js/ảnh) của template mặc định:

php artisan vendor:publish --tag=gp247:front-public

Các tài nguyên sẽ được lưu trữ tại: public/GP247/Templates/GP247Front

Mở rộng

  • Hỗ trợ Plugin
  • Tích hợp module tùy chỉnh
  • API để phát triển tính năng

Ghi đè (override) controller

Bước 1: Copy các file controller muốn ghi đè trong vendor/gp247/front/src/Controllers (hoặc src/Api/Controllers) -> app/GP247/Front/Controllers (hoặc app/GP247/Front/Api/Controllers)

Bước 2: Đổi namespace từ GP247\Front\Controllers (hoặc GP247\Front\Api\Controllers) thành App\GP247\Front\Controllers (hoặc App\GP247\Front\Api\Controllers) — chỉ thêm App vào phía trước, giữ nguyên phần còn lại.

Tài liệu

Để xem tài liệu chi tiết, truy cập tài liệu

Giấy phép

GP247/Front là phần mềm mã nguồn mở được cấp phép theo giấy phép MIT.