xshop/README-fa.md

<div align="center">
    <img src="media/xstack-shop-logo.svg" alt="xshop logo" width="600">
</div>

# xShop

اکس شاپ یک پروژه اوپن سورس فروشگاهی بر پایه لاراول است که شما می‌توانید به راحتی با سفارشی سازی آن فروشگاه مورد نظر خودتون یا مشتریتون رو راه‌اندازی کنید و حتی از سورس کدش آموزش ببنید

##   امکانات  xshop

- کنترل کامل دسته محصولات
    - دسته محصولات با قابلیت درختی
    - با قابلیت ذخیره ترتیب دسته
    - با قابلیت تعریف متای خاص برای هر دسته
    - مدیریت عکس دسته بندی با بند انگشتی
- مدیریت محصولات
    - فیلد محصولات
        - نام 
        - قیمت پایه
        - دسته اصلی
        - انتخاب سایر دسته بندی ها
        - sku کد
        - خلاصه
        - توضیحات
        - برچسب برای محصولات
    - انبارداری و مدیریت موجودی با قیمت های دلخواه مدیر
    - مدیریت تخفیف برای هر محصول بر اساس درصد و مبلغ
    - مدیریت تصاویر محصول به همراه بند انگشتی
    - قابلیت درج متای خاص برای هر محصول
-  مدیریت سفارشات و صورتحساب ها
- مشتریان
    - تعریف چندین آدرس
    - تعیین مشتری به عنوان همکار
    - کنترل پنل مشتریان
- قابلیت پرس‌ و پاسخ
- سیستم تیکتیگ برای مشتری
- مدیریت شیوه ارسال
- مدیریت متا ها
- مدیریت مطالب
- سرفصل مطالب
- مدیریت گالری
- مدیریت منو سایت
- مدیریت اسلایدر
- مدیریت محصولات
- تنظیمات ویژه
- مدیریت پیوست ها و سیستم پیوست
- ذخیره لاگ admin ها
- مدیریت ادمین ها و کاربران
- سیستم نظرسنجی
- مدیریت تبلیغات
- پشتیبانی از درگاه‌های:
    - زرین پال
    - زیبال
    - pay.ir  
    - بانک صادرات
    - بانک ملت
    - بانک پارسیان
- و امکانات دیگر از جمله، مقایسه محصول و جستجوی پیشرفته

## License
پروژه xshop تحت لیسانس `GPL-3` است بنابراین می‌توانید آسوده خاطر باشید تا ابد اوپن سورس خواهد بود !

[![GPLv3 License](https://img.shields.io/badge/License-GPL%20v3-yellow.svg)](https://opensource.org/licenses/GNU)


[GPL](https://www.gnu.org/licenses/gpl-3.0.en.html)

## راهنمای توسعه 

### نیازمندی‌ها 

- php 8.1 [ `php-gd`, `sqlite3`, `php-soap` ]
- mysql or mariadb
- composer

### توسعه و پیکربندی 

ابتدا پروژه رو دانلود کنید، یک دیتابیس بسازید و سپس `.env.example` به `.env` کپی جدید بگیرید `.env` سپس اطلاعات به روز کنید و دستورات زیر رو بزنید:

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

اکنون می‌توانید در آدرس زیر `http://localhost:8000/dashboard` با رایانه : `admin@example.com` و پسورد: `password` وارد شوید



# راهنمای انتشار

پیشنهاد ما این است که اکس شاپ را روی vps اجرا کنید، برای این کار یک دیتابیس بسازید و دستورات زیر را اجرا کنید:

```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
php artisan db:seed --class=UserSeeder
php artisan db:seed --class=SettingSeeder
nano .env # make APP_DEBUG false, APP_ENV production
php artisan storage:link
php key:generate
composer install --optimize-autoloader --no-dev
```

### اضافه کردن cron job

جهت اجرا کامل برنامه ها زمان‌دار فروشگاه باید یک دستور زیر رو بزنید:

```bash
crontab -e
```

و این خط رو اضافه کنید:
```bash
* * * * * cd /home/[yourusername]/[your-public-html-project-root] && php artisan schedule:run >> /dev/null 2>&1
```
## همکاری و پشتیبانی 

ما خیلی خوشحال می‌شویم از شما را کمک کنیم و یا شما ما رو کمک کنید، در صورت توسعه سورس حتما از pull request شما اتسقبال می‌کنیم و اگر مشکلی داشتید، حتما آن را برطرف می‌کنیم، فقط کافی است یک موضوع در لینک زیر ایجاد کنید:

```
https://github.com/4xmen/xshop/issues
```


## تست پروژه

نکته: تست را حتماً برای نسخه توسعه استفاده کنید نه روی وبسایت زیر بار دستور تست از قرار ذیل است:

```bash
php artisan test
```


## Screen shots

![1](./media/shopscreenshot1.png)
![2](./media/shopscreenshot2.png)
![3](./media/shopscreenshot3.png)
![4](./media/shopscreenshot4.png)
![5](./media/shopscreenshot5.png)
![6](./media/shopscreenshot6.png)
![6](./media/shopscreenshot7.png)



<div align="center"> توسعه داده شده با عشق! ❤️</div>