You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
xshop/README-fa.md

156 lines
5.5 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<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>