GP247

  _____  _____     ___  _  _   _____ 
 / ____|  __ \   |__ \| || | |___  |
| |  __| |__) |     ) | || |_   / / 
| | |_ |  ___/     / /|__   _| / /  
| |__| | |        / /_   | |  / /   
 \_____|_|       |____|  |_| /_/    

🌐 Language: 🇻🇳 Tiếng Việt · 🇬🇧 English (current) · 🇯🇵 日本語

Install the core (Laravel already set up):

composer require gp247/core

Home page | Official documentation | Official agent skills | Official fanpage

About GP247

GP247 is a powerful, secure, flexible, and AI-agent-friendly open-source system built on the Laravel framework.

GP247/core 3.x tech stack: PHP ≥ 8.3 · Laravel 13 · Livewire 4 · Tailwind CSS 3 (prebuilt — no Node needed) · MySQL / MariaDB

Main components in the GP247 ecosystem:

• [Package] GP247/core: The core of the entire ecosystem. GP247/core can operate independently as a Laravel admin.
• [Package] GP247/front: A package that provides the basic features for a business CMS.
• [Package] GP247/shop: Provides the full features of an e-commerce website.

[Project] S-Cart = GP247/core + GP247/front + GP247/shop

Laravel core:

GP247 3.x

Core laravel framework 13.x

Website structure using GP247

Website-folder/
|
├── app
│     └── GP247
│           ├── Core(+) //Customize controller of Core
│           ├── Helpers(+) //Auto load Helpers/*.php
│           ├── Plugins(+) //Use `php artisan gp247:make-plugin --name=NameOfPlugin`
  //(IF you have gp247/front installed)//
│           ├── Front(+) //Customize controller of Front 
  //(IF you have gp247/shop installed)//
│           ├── Shop(+) //Customize controller of Shop 
│           └── Templates(+) /Use `php artisan gp247:make-template --name=NameOfTempate`
├── public
│     └── GP247
│           ├── Core(+)
│           ├── Plugins(+)
  //(IF you have gp247/front installed)//
│           └── Templates(+)
├── resources
│            └── views/vendor
│                           |── gp247-admin(+) //Customize view core
│                           |── gp247-front-admin(+) //(IF you have gp247/front installed)//
│                           └── gp247-shop-admin(+) //(IF you have gp247/shop installed)//
├── vendor
│     ├── gp247/core
│     ├── gp247/front
│     └── gp247/shop
├── .env
│     └── GP247_ACTIVE=1 //ON|OFF gp247
└──...

Quick Installation Guide

📘 Full installation guide — choosing a package set (S-Cart, GP247 CMS, core only), hosting without a command line, adding front/shop to an existing site, troubleshooting: Installing GP247 and S-Cart.

• Step 1: Prepare the Laravel source

  Refer to the command:

  composer create-project laravel/laravel website-folder

• Step 2: Install the gp247/core package

  Move to Laravel directory (in this example is website-folder), and run the command:

  composer require gp247/core

• Step 3: Check the configuration in the .env file

  Ensure that the database configuration and APP_KEY information in the .env file are complete.

  If the APP_KEY is not set, use the following command to generate it:

  php artisan key:generate

• Step 4: Configure database

Default, GP247 uses mysql. The configuration will be saved in the .env file as follows:

  DB_CONNECTION=mysql
  DB_HOST=127.0.0.1
  DB_PORT=3306
  DB_DATABASE=gp247
  DB_USERNAME=root
  DB_PASSWORD=

If you want to use sqlite for quick testing, please change the connection in the .env file to sqlite, and comment out the DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD lines.

    DB_CONNECTION=sqlite
    #DB_HOST=127.0.0.1
    #DB_PORT=3306
    #DB_DATABASE=gp247
    #DB_USERNAME=root
    #DB_PASSWORD=

• Step 5: Initialize gp247

  Run the command:

  php artisan gp247:install

  gp247:install auto-detects the GP247 packages present and installs them in order (core [+front] [+shop]); it asks to confirm by default, add --force=1 for an unattended install.

  When it finishes, the last block of the output prints the admin path, the user name admin and a random password. The password is shown only once — copy it before you close the Terminal. To choose it yourself, add --admin-password="...".

• Step 6: Add error handling

  To add custom error handling to your application, open the bootstrap/app.php file and add the following code to the withExceptions function:

        // GP247 add new
        $exceptions->report(function (\Throwable $e) {
            try {
                if (function_exists('gp247_handle_exception')) {
                    gp247_handle_exception($e);
                }
            } catch (\Throwable $inner) {
                \Log::error($e->getMessage(), ['exception' => $e]);
            }
        });
  

  This code will help you handle exceptions through the gp247_handle_exception function if it exists.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗