Very customizable and easy to use shopping system, open source project based on laravel
 
 
 
 
 
 
Go to file
A1Gard 042a4d6d75 fixed responsive ui
.github/workflows added mail register & reset password
app added under construction logic and one theme part
bootstrap added minify output
config added version
database added under construction logic and one theme part
docs added hide menu category and group
public added under construction logic and one theme part
resources fixed responsive ui
routes added under construction logic and one theme part
storage added price sort
tests added sample test unit
.editorconfig initialized laravel 11.x
.env.example update readme and env
.gitattributes initialized laravel 11.x
.gitignore update readme and env
LICENSE Initial commit
README-fa.md updated read me
README.md updated read me
artisan initialized laravel 11.x
composer.json added version
composer.lock added swagger for project api
package.json fixed font ui button
phpunit.xml initialized laravel 11.x
vite.config.js added client assets
yarn.lock fixed font ui button

README.md

xShop logo

xShop/v2

[!NOTE] xShop is an open source shop developed in laravel, very customizable!

New Features:

  • Dashboard panel changes
  • Integration of Vue.js and laravel
  • Advanced charts
  • Better customizable with AI & languages
  • Fixed Technical issues
  • Project size compression
  • UI/UX is more specific
  • Developer Friendlier

Documentation

Installation [ Development mode ]

[!IMPORTANT]
Create new database and rename .env.example to .env then update you .env configs so run this commands:

git clone https://github.com/4xmen/xshop.git
cd xshop
cp .env.example .env
composer install
php artisan migrate:fresh --seed
php artisan storage:link
php artisan key:generate
php artisan serv

# to develop front-end
npm i
php artisan client
npm install @rollup/rollup-win32-x64-msvc # just for windows if the below line dose not work
npm run dev

# or with yarn

yarn install
php artisan client
yarn add @rollup/rollup-win32-x64-msvc # just for windows if the below line dose not work
yarn dev

[!TIP] Default admin email is : developer@example.com (developer) or admin@example.com (admin) and default password is: password

image seeding

  • Download & prepare images
php artisan seeding:prepare
  • nor copy your image folder to database/seeders/images/
  • then: Seeding image for models: [Group, Category, Post, Product, Slider]
php artisan seeding:image Product digital

Or to seed all models:

php artisan seeding:all digital

First parameter is Model, Second is image seeder directory available [bag, clothe, digital, sport, posts, makeup] You can create your directory and put your image into new directory then use image seeder

Requirement

  • php 8.2.x or above [ php-gd, sqlite3, php-soap]
  • mysql or mariadb or sqlite
  • composer
  • recommends install imagemagick on server to more image performance

Deploy guide

We recommend deploy xShop on VPS, so create database and run this commands:

cd /home/[yourUsername]/[pathOfYourWebsitePublicHTML]
git clone  https://github.com/4xmen/xshop.git . # if this command not work make empty this folder
cp .env.example .env
nano .env # edit your config db, url, etc.
composer install
php artisan migrate:fresh --seed
php artisan storage:link
php key:generate
npm install 
php artisan client
npm run build

Make your site optimize & production mode

nano .env # make APP_DEBUG false, APP_ENV production
php artisan optimize
composer install --optimize-autoloader --no-dev

Add cron job

You must add crontab for your project:

crontab -e

Add this line:

* * * * * cd /home/[yourusername]/[your-public-html-project-root] && php artisan schedule:run >> /dev/null 2>&1

make xController

Controller with log and semi-automatic CURD with logs
User [model]

php artisan make:xcontroller User

make theme part

Theme part usable in area

PartName [theme aprt name]

segmentName [group, category, preloader, ...],

php artisan  make:part PartName segmentName

client optimize

Optimize client assets, scss,js,css

php artisan client
php artisan build

theme parts file

  • PartName.php: onCreate, onRemove, onMount actions of theme part
  • PartName.blade.php: your theme part blade code
  • PartName.scss: your theme part scss
  • PartName.js: your theme part javascript
  • screenshot.png: screenshot preview of theme part

Demo

Online demo available here: https://xshop.xstack.ir/

Screenshots

1

2

3

4

5

Access to xShop/v1

[!WARNING]
xShop/v1 available here: https://github.com/4xmen/xshop.v1

Developed With Love ! ❤️