mirror of https://github.com/4xmen/xshop.git
added persian readme
parent
16e422fd51
commit
d43045d073
@ -0,0 +1,189 @@
|
|||||||
|
<div dir="rtl">
|
||||||
|
<div align="center">
|
||||||
|
<img width="250" src="resources/images/xshop-logo.svg" alt="xShop logo">
|
||||||
|
</div>
|
||||||
|
|
||||||
|
# xShop/v2
|
||||||
|
|
||||||
|
> [!NOTE]
|
||||||
|
> xShop یک سیستم فروشگاه نوشته شده در لاراول با قابلیت سفارشیسازی فراوان
|
||||||
|
|
||||||
|
## امکانات نگارش جدید
|
||||||
|
|
||||||
|
- تغییرات اساسی در کنترل پنل
|
||||||
|
- یکپارچهسازی Laravel & vujs.js
|
||||||
|
- نمودارهای پیشرفته
|
||||||
|
- بهینهسازی سایتهای چند زبانه و افزایش بهرهوری هوش مصنوعی ترجمان
|
||||||
|
- اصلاح مشکلات تکنیکی
|
||||||
|
- کاهش سایز پروژه
|
||||||
|
- UI/UX شخصیسازی شده
|
||||||
|
- دوستانه تر شدن محیط توسعه
|
||||||
|
|
||||||
|
## نحوه نصب [ حالت توسعه دهنده ]
|
||||||
|
|
||||||
|
> [!مهم]
|
||||||
|
> ابتدا یک دیتابیس درست کنیدد و سپس `.env.example` را به `.env` تغییر دهید و `.env` کارهای زیر به ترتیب مراحل اجرای
|
||||||
|
> پروژه روی لوکال هاست میباشد :
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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 install -g yarn
|
||||||
|
yarn install
|
||||||
|
php artisan client
|
||||||
|
yarn dev
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> اطلاعات ورود اولیه : `developer@example.com` (به عنوان توسعه دهنده) یا `admin@example.com` (به عنوان مدیر) و
|
||||||
|
> گذرواژه : `password`
|
||||||
|
|
||||||
|
## افزودن تصاویر نممونه
|
||||||
|
|
||||||
|
- دانلود و آمادهسازی تصاویر
|
||||||
|
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
php artisan seeding:prepare
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
- nor copy your image folder to `database/seeders/images/`
|
||||||
|
- then: Seeding image for models: [Group, Category, Post, Product, Slider]
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
php artisan seeding:image Product digital
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
> شما ابتدا باید مدل را نوشته و سپس فولدر مورد نظر برای تصاویر را وارد کنید[bag, clothe, digital, sport, posts, makeup]
|
||||||
|
> همچنین میتوانید یک پوشه درخواه پر از تصاویر jpg دلخواه را در آن پر کنید
|
||||||
|
|
||||||
|
## ملزومات
|
||||||
|
|
||||||
|
- php 8.2.x یا بالاتر با همراه افزونهها [ `php-gd`, `sqlite3`, `php-soap`]
|
||||||
|
- mysql یا mariadb یا sqlite
|
||||||
|
- composer
|
||||||
|
- پیشنهاد میشود imagemagick برای افزایش راندمان تصاویر نصب کنید
|
||||||
|
|
||||||
|
## راهنمای انتشار
|
||||||
|
|
||||||
|
قویا پیشنهاد میکنیم از vps به جا میزبان اشتراکی استفاده کنید و بعد از ساختن دیتابیس دستورات زیر را اجرا کنید:
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## بهینه سازی سایت و آماده سازی نسخه نهایی
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nano .env # make APP_DEBUG false, APP_ENV production
|
||||||
|
php artisan optimize
|
||||||
|
composer install --optimize-autoloader --no-dev
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## ساختن xController
|
||||||
|
|
||||||
|
درواقع xController یک کنترولر بسیار پیشرفته با همراه لاگ و CRUD برای توسعه آسان است با فرض زیر:
|
||||||
|
User [`model`]
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
php artisan make:xcontroller User
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## make theme part
|
||||||
|
|
||||||
|
Theme part usable in area
|
||||||
|
|
||||||
|
PartName [`theme aprt name`]
|
||||||
|
|
||||||
|
segmentName [`group`, `category`, `preloader`, ...],
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
php artisan make:part PartName segmentName
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## client بهینهسازی فضای
|
||||||
|
|
||||||
|
برا بهینه سازی کلیه دارایهای سایت `scss`,`js`,`css`
|
||||||
|
|
||||||
|
|
||||||
|
<div dir="ltr">
|
||||||
|
|
||||||
|
```bash
|
||||||
|
php artisan client
|
||||||
|
```
|
||||||
|
</div>
|
||||||
|
|
||||||
|
### توضیحات پروندههای قسمت قالب
|
||||||
|
|
||||||
|
- PartName.php: `onCreate`, `onRemove`, `onMount` برای انجام اعمال قسمت
|
||||||
|
- PartName.blade.php: برای قرارگرفتن کدهای blade code
|
||||||
|
- PartName.scss:برای افزودن ویژگیهای scss
|
||||||
|
- PartName.js: برای افزودن javascript
|
||||||
|
- screenshot.png: و یک پیشنمایش از قسمت قالب
|
||||||
|
|
||||||
|
## Demo / دمو
|
||||||
|
|
||||||
|
> برای دیدن یک دموی آنلاین : <a href="https://xshop.xstack.ir/login">https://xshop.xstack.ir/</a>
|
||||||
|
|
||||||
|
### تصاویر محیطی
|
||||||
|
|
||||||
|
![1](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot1.png)
|
||||||
|
|
||||||
|
![2](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot2.png)
|
||||||
|
|
||||||
|
![3](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot3.jpg)
|
||||||
|
|
||||||
|
![4](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot4.png)
|
||||||
|
|
||||||
|
![5](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot5.jpg)
|
||||||
|
|
||||||
|
## دسترسی به نگارش xShop/v1
|
||||||
|
|
||||||
|
> [!هشدار]
|
||||||
|
> xShop/v1 قابل دسترس در اینجا: <a href="https://github.com/4xmen/xshop.v1">https://github.com/4xmen/xshop.v1</a>
|
||||||
|
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
توسعه داده شده با محبت ! ❤️
|
||||||
|
</p>
|
||||||
|
</div>
|
Loading…
Reference in New Issue