{"id":19427661,"url":"https://github.com/4xmen/xshop","last_synced_at":"2026-02-14T00:16:22.437Z","repository":{"id":171163223,"uuid":"647270127","full_name":"4xmen/xshop","owner":"4xmen","description":"Very customizable and easy to use shopping system, open source project based on laravel","archived":false,"fork":false,"pushed_at":"2024-10-19T01:22:00.000Z","size":100368,"stargazers_count":418,"open_issues_count":0,"forks_count":149,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-10-20T05:46:59.267Z","etag":null,"topics":["ai-translator","customizable-ui","laravel","laravel-dashboard","laravel-ecommerce","laravel-multi-language","laravel-shop","laravel11","open-source","opensource","opensource-projects","persian","shop","shop-cms","shop-website","xstack"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/4xmen.png","metadata":{"files":{"readme":"README-fa.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-30T12:24:51.000Z","updated_at":"2024-10-19T04:50:15.000Z","dependencies_parsed_at":"2024-10-26T20:35:16.121Z","dependency_job_id":null,"html_url":"https://github.com/4xmen/xshop","commit_stats":null,"previous_names":["4xmen/xshop"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4xmen%2Fxshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4xmen%2Fxshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4xmen%2Fxshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4xmen%2Fxshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4xmen","download_url":"https://codeload.github.com/4xmen/xshop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247809964,"owners_count":20999816,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-translator","customizable-ui","laravel","laravel-dashboard","laravel-ecommerce","laravel-multi-language","laravel-shop","laravel11","open-source","opensource","opensource-projects","persian","shop","shop-cms","shop-website","xstack"],"created_at":"2024-11-10T14:12:23.390Z","updated_at":"2026-02-14T00:16:22.288Z","avatar_url":"https://github.com/4xmen.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv dir=\"rtl\"\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003cimg width=\"250\" src=\"resources/images/xshop-logo.svg\" alt=\"xShop logo\"\u003e\n\u003c/div\u003e\n\n# xShop/v3\n\n\u003e [!NOTE]\n\u003e xShop یک سیستم فروشگاه نوشته شده در لاراول با قابلیت سفارشی‌سازی فراوان\n\n## امکانات نگارش جدید\n\n- تغییرات اساسی در کنترل پنل\n- یکپارچه‌سازی Laravel \u0026 vujs.js\n- نمودارهای پیشرفته\n- بهینه‌سازی سایت‌های چند زبانه و افزایش بهره‌وری هوش مصنوعی ترجمان\n- اصلاح مشکلات تکنیکی\n- کاهش سایز پروژه\n- UI/UX شخصی‌سازی شده\n- دوستانه تر شدن محیط توسعه\n- شخصی سازی قالب وبسایت\n- انتقال از وردپرس به xshop\n- پشتیبانی آسان برای وب‌سایت‌های چندزبانه\n- یک پایه سئوی قدرتمند به این معنی است که کاربران دیگر نیازی به نگرانی درباره مسائل فنی سئو ندارند\n\n#### پشتیبانی پیش‌فرض از در‌گاه‌های پرداختی: \n\u003cdiv style=\"background: #ffffff;padding:1rem 7px; display: flex; justify-content: space-evenly;\"\u003e\n\u003cimg src=\"thirdparty/assets/paypal.svg\" style=\"height: 48px\"  alt=\"paypal\"\u003e\n\u003cimg src=\"thirdparty/assets/zarinpal.svg\" style=\"height: 48px\"  alt=\"zarinpal\"\u003e\n\u003cimg src=\"thirdparty/assets/zibal.svg\" style=\"height: 48px\" alt=\"zibal\"\u003e\n\u003c/div\u003e\n\n## مستندات \n\n- [📄 مستندات کامل 📄](https://4xmen.github.io/xshop/#/)\n- [🇺🇸 English read me](README.md)\n\n## نحوه نصب [ حالت توسعه دهنده ]\n\n\u003e [!مهم]  \n\u003e ابتدا یک دیتابیس درست کنیدد و سپس `.env.example` را به  `.env` تغییر دهید و  `.env` کارهای زیر به ترتیب مراحل اجرای\n\u003e پروژه روی لوکال هاست می‌باشد :\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\ngit clone https://github.com/4xmen/xshop.git\ncd xshop\ncp .env.example .env\ncomposer install\nphp artisan migrate:fresh --seed\nphp artisan storage:link\nphp artisan key:generate\nphp artisan serv\n\n# to develop front-end\n\nnpm install -g yarn\nyarn install\nphp artisan client\nyarn dev\n```\n\u003c/div\u003e\n\n\u003e [!TIP]\n\u003e اطلاعات ورود اولیه  : `developer@example.com` (به عنوان توسعه دهنده) یا `admin@example.com` (به عنوان مدیر) و\n\u003e گذرواژه : `password`\n\n## افزودن تصاویر نمونه\n\n- دانلود و آماده‌سازی تصاویر\n\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nphp artisan seeding:prepare\n ```\n\u003c/div\u003e \n\n\n- ویا تصاویر خود را با پوشه مورد نظر در این مسیر کپی کنید: `database/seeders/images/`\n- سپس یکی از مدل ها دلخواه را seed image کنید: [Group, Category, Post, Product, Slider]\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nphp artisan seeding:image Product digital\n```\n\u003c/div\u003e\n\nیا برای همه مدل‌ها یک‌جا از دستور زیر استفاده کنید:\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nphp artisan seeding:all digital\n```\n\u003c/div\u003e\n\n\u003e شما ابتدا باید مدل را نوشته و سپس فولدر مورد نظر برای تصاویر را وارد کنید[bag, clothe, digital, sport, posts, makeup]\n\u003e همچنین می‌توانید یک پوشه درخواه پر از تصاویر jpg دلخواه را در آن پر کنید\n\n## ملزومات\n\n- php 8.2.x یا بالاتر با همراه افزونه‌ها [ `php-gd`, `sqlite3`, `php-soap`]\n- mysql یا mariadb یا sqlite\n- composer\n- پیشنهاد می‌شود imagemagick برای افزایش راندمان تصاویر نصب کنید\n\n## راهنمای انتشار\n\nقویا پیشنهاد می‌کنیم از vps به جا میزبان اشتراکی استفاده کنید و بعد از ساختن دیتابیس دستورات زیر را اجرا کنید:\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\ncd /home/[yourUsername]/[pathOfYourWebsitePublicHTML]\ngit clone  https://github.com/4xmen/xshop.git . # if this command not work make empty this folder\ncp .env.example .env\nnano .env # edit your config db, url, etc.\ncomposer install\nphp artisan migrate:fresh --seed\nphp artisan storage:link\nphp key:generate\nnpm install \nphp artisan client\nnpm run build\n```\n\u003c/div\u003e\n\n## بهینه سازی سایت و آماده سازی نسخه نهایی\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nnano .env # make APP_DEBUG false, APP_ENV production\nphp artisan optimize\ncomposer install --optimize-autoloader --no-dev\n```\n\u003c/div\u003e\n\n## اضافه کردن cron job\n\nجهت اجرا کامل برنامه ها زمان‌دار فروشگاه باید یک دستور زیر رو بزنید:\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\ncrontab -e\n```\n\u003c/div\u003e\n\nو این خط رو اضافه کنید:\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\n* * * * * cd /home/[yourusername]/[your-public-html-project-root] \u0026\u0026 php artisan schedule:run \u003e\u003e /dev/null 2\u003e\u00261\n```\n\u003c/div\u003e\n\n\n## ساختن xController\n\nدرواقع xController یک کنترولر بسیار پیشرفته با همراه لاگ و CRUD برای توسعه آسان است با فرض زیر:\nUser [`model`]\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nphp artisan make:xcontroller User\n```\n\u003c/div\u003e\n\n## make theme part\n\nTheme part usable in area\n\nPartName [`theme aprt name`]\n\nsegmentName [`group`, `category`, `preloader`, ...],\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nphp artisan  make:part PartName segmentName\n```\n\u003c/div\u003e\n\n## client بهینه‌سازی فضای\n\nبرا بهینه سازی کلیه دارای‌های سایت `scss`,`js`,`css`\n\n\n\u003cdiv dir=\"ltr\"\u003e\n\n```bash\nphp artisan client\nphp artisan build\n```\n\u003c/div\u003e\n\n### توضیحات پرونده‌های قسمت قالب \n\n- PartName.php: `onCreate`, `onRemove`, `onMount` برای انجام اعمال قسمت\n- PartName.blade.php: برای قرارگرفتن کد‌های blade code\n- PartName.scss:برای افزودن ویژگی‌های scss\n- PartName.js: برای افزودن javascript\n- screenshot.png: و یک پیش‌نمایش از قسمت قالب\n\n## Demo / دمو\n\n\u003e برای دیدن یک دموی آنلاین : \u003ca href=\"https://xshop.xstack.ir/login\"\u003ehttps://xshop.xstack.ir/\u003c/a\u003e\n\n\n## چطور از وردپرس و ووکامرس به xshop مهاجرت کنیم؟\n\nدر چند مرحله این این کار انجام میشه:\n\n- ابتدا xShop را نصب کنید طبق مراحلی که بالاتر توضیح دادیم (ترجیحا رو localhost(\n- سپس پلاگین xshift را که در پوشه thirdparty هست روی وردپرس نصب کنید\n- سپس دستورات زیر را در فولدر xshop اجرا کنید\n\n```bash\nphp artisan xshift group http://wp.test/\nphp artisan xshift post http://wp.test/\nphp artisan xshift catgory http://wp.test/\nphp artisan xshift product http://wp.test/\n```\n\nبه جای http://wp.test/ آدرس وبسایت قدیمی خود را جایگزین کنید\nو اگر xshop اجازه انتقال اطلاعات را نداد و نیاز به خالی بودن دیتابیس بود می‌توانید دستور زیر رو اجرا کنید:\n\n```bash\nphp artisan xshift clear\n```\n\u003e نکات بسیار مهم: دستور بالا تمام اطلاعات محتوا و محصولات روی سرور فعلی شما را پاک (truncate) می‌کنه\n\n\u003e   نکته: دستورات مهاجرت ممکن است از ۱ دقیقه تا چند ساعت طول بکشد، بستگی به میزان محتوای سایت قبلی به ویژه تعداد تصاویر دارد.\n\n\n### تصاویر محیطی\n\n![1](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot1.png)\n\n![2](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot2.png)\n\n![3](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot3.jpg)\n\n![4](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot4.png)\n\n![5](https://raw.githubusercontent.com/A1Gard/xshop-installer-assets/master/screenshots/xshop-screenshot5.jpg)\n\n## دسترسی به نگارش xShop/v1\n\n\u003e [!هشدار]  \n\u003e xShop/v1 قابل دسترس در اینجا: \u003ca href=\"https://github.com/4xmen/xshop.v1\"\u003ehttps://github.com/4xmen/xshop.v1\u003c/a\u003e\n\n\n\u003cp align=\"center\"\u003e \n   توسعه داده شده با محبت ! ❤️\n\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4xmen%2Fxshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4xmen%2Fxshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4xmen%2Fxshop/lists"}