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

S-Cart

composer create-project gp247/s-cart my-shop

Phần mềm bán hàng trực tuyến mã nguồn mở, miễn phí, xây dựng trên GP247 và Laravel

Packagist Downloads Latest Stable Version License Ask DeepWiki

🏠 Trang chủ · 🚀 Demo · 📚 Tài liệu · 🤖 Skill cho AI agent · 💬 Nhóm Facebook

Giao diện cửa hàng S-Cart Trang quản trị S-Cart

Giới thiệu

S-Cart là phần mềm bán hàng trực tuyến miễn phí, mã nguồn mở (giấy phép MIT), dành cho chủ cửa hàng, doanh nghiệp và lập trình viên. Cài xong, bạn có ngay một cửa hàng trực tuyến hoàn chỉnh (sản phẩm, giỏ hàng, đơn hàng, khách hàng, trang nội dung) cùng trang quản trị. Toàn bộ S-Cart miễn phí để dùng, sửa và tích hợp vào hệ thống của bạn; plugin Pro là phần tùy chọn khi cửa hàng cần mở rộng, ví dụ nhiều cửa hàng hoặc sàn nhiều người bán.

S-Cart được xây dựng theo bốn nguyên tắc:

Nguyên tắc Bạn nhận được
🎯 Giải đúng việc của người bán hàng SEO, sao lưu & phục hồi, phân quyền, báo cáo có sẵn ngay khi cài, không cần plugin. Cài đặt và cập nhật chỉ bằng vài lệnh.
🌍 Chạy ở nhiều môi trường Từ shared hosting không có cron tới VPS, Docker.
🔐 An toàn Một lớp phân quyền và nhật ký chung cho trang quản trị, API và AI agent; mật khẩu, khoá bên thứ ba được mã hoá khi lưu.
🧩 Dễ tùy biến Mở rộng bằng plugin và template, ghi đè giao diện hay xử lý mà không sửa mã gốc — cập nhật không làm mất phần bạn đã sửa.

Đọc xong trang này, bạn sẽ cài được S-Cart trên máy hoặc server của mình, biết cách cập nhật và tùy biến nó.

Công nghệ S-Cart 3.x: PHP ≥ 8.3 · Laravel 13 · GP247 · Tailwind CSS 3 · MySQL / MariaDB

S-Cart và GP247

S-Cart = GP247/core + GP247/front + GP247/shop + GP247/mcp

GP247 là hệ sinh thái mã nguồn mở trên Laravel để xây dựng ứng dụng web cho doanh nghiệp. S-Cart là sản phẩm bán hàng trực tuyến dựng trên nền đó, gồm bốn package:

Package Đảm nhận
gp247/core Lõi: trang quản trị, phân quyền, cấu hình, plugin & template
gp247/front Giao diện cửa hàng, nội dung (CMS)
gp247/shop Sản phẩm, giỏ hàng, đơn hàng, khách hàng
gp247/mcp MCP server cho AI agent

Bạn chỉ cần cài S-Cart — cả bốn package được cài kèm, không phải cài GP247 riêng.

✨ Có gì trong S-Cart

Nhóm Chức năng
🛍️ Bán hàng Sản phẩm, giỏ hàng, đơn hàng, khách hàng
🌏 Đa quốc gia Đa ngôn ngữ, đa tiền tệ
📰 Nội dung (CMS) Danh mục, trang nội dung; tin tức (plugin News miễn phí)
💳 Thanh toán & vận chuyển Plugin thanh toán, phương thức vận chuyển, mã giảm giá, tính thuế
🔐 Quản trị & bảo mật Phân quyền theo vai trò (quản trị viên, quản lý, marketing…), nhật ký thao tác, CAPTCHA
📊 Công cụ kinh doanh Xử lý đơn hàng, quản lý khách hàng, thống kê & báo cáo
🤖 Sẵn sàng cho AI (MCP server) MCP server có sẵn (tắt cho tới khi bạn bật): kết nối AI agent (Claude, Cursor, VS Code…) với cửa hàng qua chuẩn Model Context Protocol và hỏi bằng ngôn ngữ tự nhiên — "tuần này bán được bao nhiêu?", "sản phẩm nào sắp hết hàng?", "đơn OR-1024 đã thanh toán chưa?". Agent hoạt động thay mặt một tài khoản admin với đúng quyền của tài khoản đó, xác thực bằng token, che thông tin khách hàng, ghi nhật ký mọi lệnh gọi
🧩 Mở rộng Plugin theo mô hình HMVC, chợ plugin/template trực tuyến, API bảo mật cho app di động
⭐ Plugin Pro Multi-vendor (sàn nhiều người bán) · Multi-store (nhiều cửa hàng) · Quản lý thu chi (nhập hàng, trả hàng, thu chi & công nợ)

🧰 Yêu cầu hệ thống

Thành phần Yêu cầu
PHP 8.3 trở lên
Composer Bản 2.x
Cơ sở dữ liệu MySQL hoặc MariaDB — tạo sẵn một database trống
Quyền ghi thư mục storage · bootstrap/cache · app/GP247 · public/GP247 · public/vendor · resources/views/vendor · vendor

💡 Dùng Docker thì không cần cài PHP, Composer, MySQL trên máy — xem Cách 3.

🚀 Cài đặt

📘 Hướng dẫn cài đặt đầy đủ — chọn bộ cài (S-Cart, GP247 CMS, chỉ core), hosting không có dòng lệnh, thêm front/shop vào site đang có, xử lý sự cố: Cài đặt GP247 và S-Cart.

Chọn một trong ba cách:

Cách Phù hợp khi
1. Composer ⭐ Cài lên hosting, VPS, hoặc máy dùng Laragon/XAMPP — khuyến nghị
2. Git clone Muốn lấy mã nguồn mới nhất từ GitHub để phát triển/đóng góp
3. Docker Không muốn cài PHP/MySQL trên máy

Cách 1 — Composer (khuyến nghị)

  1. Mở Terminal (Windows: "Command Prompt" hoặc terminal của Laragon), kiểm tra Composer đang chạy bằng PHP nào:

    composer diagnose
    

    Dòng PHP version phải là 8.3 trở lên.

    ⚠️ Nếu PHP cũ hơn 8.3, Composer không báo lỗi mà lặng lẽ cài bản S-Cart 1.x rất cũ. Chuyển Composer sang PHP 8.3 trở lên rồi mới làm bước 2.

  2. Tạo dự án (thay my-shop bằng tên thư mục bạn muốn):

    composer create-project gp247/s-cart my-shop
    cd my-shop
    
  3. Mở file .env trong thư mục dự án, sửa phần database cho khớp database bạn đã tạo:

    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=ten_database
    DB_USERNAME=ten_dang_nhap
    DB_PASSWORD=mat_khau
    

    Giá trị mặc định DB_HOST=mysql-local chỉ dành cho Docker — cài trực tiếp thì đổi thành 127.0.0.1.

  4. Khởi tạo S-Cart:

    php artisan gp247:install
    

    Lệnh sẽ hỏi xác nhận, gõ yes. Khi cài xong, khối cuối cùng trên màn hình in ra đường dẫn trang quản trị, tên đăng nhập admin và một mật khẩu ngẫu nhiên.

    ⚠️ Mật khẩu chỉ hiện một lần, ngay sau khi cài thành công — không lưu ở đâu, không in lại. Chép vào trình quản lý mật khẩu trước khi đóng Terminal.

  5. (Tùy chọn) Thêm dữ liệu mẫu để xem thử:

    php artisan gp247:shop-sample
    
  6. Mở trình duyệt:

    Trang Địa chỉ Đăng nhập
    Cửa hàng http://ten-mien-cua-ban —
    Quản trị http://ten-mien-cua-ban/gp247_admin admin / mật khẩu in ra ở bước 4

    🔑 Đăng nhập xong, đổi email tài khoản sang email thật (Thiết lập tài khoản ở góc trên) để dùng được Quên mật khẩu.

Cách 2 — Git clone

git clone https://github.com/gp247net/s-cart.git
cd s-cart
cp .env.example .env
composer install

Sau đó làm tiếp bước 3 → 6 của Cách 1 (sửa .env, chạy gp247:install, mở trình duyệt).

Cách 3 — Docker

Có hai file cấu hình tách biệt — luôn dùng đúng file cho đúng môi trường:

File Môi trường
docker-compose.yml dev — máy cá nhân
docker-compose.prod.yml prod — server thật

Máy cá nhân (dev):

git clone https://github.com/gp247net/s-cart.git
cd s-cart
cp .env.example .env
docker compose up -d --build
docker compose exec app php artisan key:generate
docker compose exec app php artisan gp247:install
docker compose exec app php artisan gp247:shop-sample   # tùy chọn

Mở website tại http://localhost:8000.

Server thật (prod):

git clone https://github.com/gp247net/s-cart.git
cd s-cart
cp .env.example .env
# Sửa .env: APP_ENV=production, APP_DEBUG=false, DB_*, SC_DOCKER_WWWUSER/SC_DOCKER_WWWGROUP — xem DOCKER_vi.md
docker compose -f docker-compose.prod.yml up -d --build
docker compose -f docker-compose.prod.yml exec app php artisan key:generate
docker compose -f docker-compose.prod.yml exec app php artisan gp247:install
docker compose -f docker-compose.prod.yml run --rm node   # build CSS/JS

⚠️ Trên prod luôn thêm -f docker-compose.prod.yml. Quên nó là chạy nhầm cấu hình dev (bật debug, chạy quyền root, cài Xdebug…).

📘 Hướng dẫn từng bước và xử lý sự cố Docker: DOCKER_vi.md.

🔄 Cập nhật phiên bản

📘 Hướng dẫn đầy đủ: Cập nhật GP247 và S-Cart · site còn ở dòng 2.x: Nâng cấp lên dòng 3.x.

  1. Sao lưu database và thư mục app/GP247, public/GP247 trước khi cập nhật.

  2. Tải mã nguồn mới:

    composer update gp247/core gp247/front gp247/shop gp247/mcp
    

    Site cài trước S-Cart 3.5 (chưa có MCP server): chạy thêm một lần composer require gp247/mcp -W.

  3. Áp dụng thay đổi lên site (an toàn, không xóa dữ liệu, không ghi đè bản dịch hay template bạn đã sửa):

    php artisan gp247:update
    
  4. Kiểm tra lại:

    php artisan gp247:info
    

⚠️ Chỉ chạy composer update là chưa đủ — luôn chạy thêm bước 3.

Tùy chọn nâng cao (ghi đè bản dịch bằng --overwrite-lang, làm mới asset/view bằng --publish=…) có thể ghi đè tùy biến của bạn — đọc kỹ Cập nhật GP247 và S-Cart — Tùy chọn nâng cao trước khi dùng.

🎨 Tùy biến & mở rộng

Bạn muốn… Cách làm
Tạo plugin mới php artisan gp247:make-plugin --name=PluginName
Tạo template mới php artisan gp247:make-template --name=TemplateName
Đóng gói file zip để phân phối Thêm --download=1 vào hai lệnh trên
Sửa một màn của template mặc định php artisan gp247:template-publish GP247Front --file=screen/home.blade.php rồi sửa file ở app/GP247/Templates/GP247Front/
Sửa giao diện trang quản trị php artisan vendor:publish --tag=gp247:core-view (core) · --tag=gp247:front-admin (front) · --tag=gp247:shop-view-admin (shop)
Đổi cấu hình upload file (lfm) php artisan vendor:publish --tag=config-lfm
Ghi đè hàm helper gp247_* Khai báo tên hàm trong config/gp247_functions_except.php, rồi viết hàm mới trong app/GP247/Helpers/*.php
Ghi đè controller Xem bên dưới
Thêm route cho trang quản trị Dùng hằng số GP247_ADMIN_PREFIX và GP247_ADMIN_MIDDLEWARE — xem routes.php của core

💡 Template mặc định GP247Front được nạp trực tiếp từ package, nên file bạn chưa publish sẽ tự nhận bản mới khi cập nhật. Chỉ publish đúng file bạn cần sửa.

Ghi đè controller

Áp dụng cho mọi controller (kể cả API) của GP247/Core, GP247/Front, GP247/Shop:

  1. Tạo file cùng đường dẫn con và cùng tên trong app/GP247/{Core|Front|Shop}/....

  2. Cho class mới extends controller gốc trong vendor/gp247/....

  3. Thêm App\ vào đầu namespace gốc, giữ nguyên phần còn lại:

    Namespace gốc Namespace mới
    GP247\Core\Controllers App\GP247\Core\Controllers
    GP247\Core\Api\Controllers App\GP247\Core\Api\Controllers
    GP247\Front\... / GP247\Shop\... App\GP247\Front\... / App\GP247\Shop\...

📘 Tài liệu chi tiết: Tạo plugin · Tạo template · Toàn bộ lệnh CLI

📂 Cấu trúc thư mục

(+) = thư mục do GP247 tạo và quản lý.

my-shop/
├── app/GP247/
│   ├── Core(+)        ← ghi đè controller của Core
│   ├── Front(+)       ← ghi đè controller của Front
│   ├── Shop(+)        ← ghi đè controller của Shop
│   ├── Helpers(+)     ← file *.php ở đây được nạp tự động
│   ├── Plugins(+)     ← plugin (gp247:make-plugin)
│   └── Templates(+)   ← template (gp247:make-template) + file template đã publish để sửa
├── public/GP247/
│   ├── Core(+)        ← CSS/JS trang quản trị
│   ├── Plugins(+)
│   └── Templates(+)
├── resources/views/vendor/
│   ├── gp247-admin(+)        ← view quản trị của Core đã publish
│   ├── gp247-front-admin(+)  ← view quản trị của Front đã publish
│   └── gp247-shop-admin(+)   ← view quản trị của Shop đã publish
└── vendor/gp247/
    ├── core           ← lõi: quản trị, phân quyền, cấu hình
    ├── front          ← giao diện cửa hàng, CMS
    ├── shop           ← sản phẩm, giỏ hàng, đơn hàng
    └── mcp            ← MCP server cho AI agent

🔧 Biến môi trường hay dùng

Khai báo trong file .env:

Biến Mặc định Ý nghĩa
GP247_ADMIN_PREFIX gp247_admin Đường dẫn trang quản trị, ví dụ ten-mien.com/gp247_admin
GP247_API_MODE 1 Bật (1) / tắt (0) API
GP247_DB_PREFIX gp247_ Tiền tố tên bảng — ⚠️ không đổi được sau khi cài
GP247_ADMIN_LOG 1 Ghi nhật ký truy cập trang quản trị
GP247_SEO_LANG 0 Thêm mã ngôn ngữ vào URL cửa hàng (/vi/..., /en/...)
GP247_ENCRYPTION_KEY (trống) Khóa mã hóa riêng cho mật khẩu SMTP, license… — xem ghi chú trong .env.example