A1Gard aa3f6e06e6 | 11 hours ago | |
---|---|---|
.github/workflows | 2 months ago | |
app | 14 hours ago | |
bootstrap | 2 months ago | |
config | 1 month ago | |
database | 1 month ago | |
public | 2 months ago | |
resources | 5 days ago | |
routes | 4 weeks ago | |
storage | 4 months ago | |
tests | 3 months ago | |
.editorconfig | 7 months ago | |
.env.example | 14 hours ago | |
.gitattributes | 7 months ago | |
.gitignore | 14 hours ago | |
LICENSE | 2 years ago | |
README-fa.md | 3 weeks ago | |
README.md | 14 hours ago | |
artisan | 7 months ago | |
composer.json | 11 hours ago | |
composer.lock | 1 month ago | |
package.json | 3 months ago | |
phpunit.xml | 7 months ago | |
vite.config.js | 5 months ago | |
yarn.lock | 3 months ago |
README.md
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
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) oradmin@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
Access to xShop/v1
[!WARNING]
xShop/v1 available here: https://github.com/4xmen/xshop.v1
Developed With Love ! ❤️