راهنمای جامع پورفای
به مستندات رسمی سیستم مدیریت محتوای پورفای خوش آمدید. پورفای یک پلتفرم اوپنسورس و قدرتمند برای راهاندازی فروشگاه فایل است که با استفاده از لاراول ۱۲ و فیلامنت ۵.۳ توسعه یافته است.
این راهنما به شما کمک میکند تا از نصب اولیه تا تنظیمات پیشرفته، گامبهگام پیش بروید.
پیشنیازهای نصب
قبل از شروع نصب، مطمئن شوید که سرور شما موارد زیر را پشتیبانی میکند:
- PHP: نسخه 8.3 یا بالاتر
- Composer: نسخه ۲.x
- MySQL/MariaDB: نسخه ۵.۷ یا بالاتر
- NGINX/Apache: با پشتیبانی از SSL
نصب و راهاندازی
با توجه به اینکه پورفای یک سی ام اس قدرتمند در بیس لاراول هست ، ولی برای نصب آن کافی است فایل دانلودی را در هاست خود آپلود کرده و مسیر install که به صورت پیشفرض با باز کردن وبسایت در مرورگر نمایش داده میشود را طی نمایید.
تمام وابستگی های این سی ام اس در خود سیستم وجود دارند و نیازی به نصب مجدد نخواهید داشت
نصب و راه اندازی دستی
جهت نصب دستی در صورتی که کامپوزر روی هاست شما فعال نیست ابتدا این فایل .env را دریافت نموده و اطلاعات دیتابیس و نام پوشه ها و آدرس سایت خود را جایگزین کنید و به جای فایل .env در پوشه PourFi قرار دهید.
وارد دیتابیس خود شده و این فایل را ایمپورت کنید. دانلود فایل Sql
وارد جدول settings شده و مقدار site_url را با آدرس سایت خود جایگزین کنید
در مسیر PourFi/storage فایلی به اسم installed بسازید و مقدار داخل آنرا برابر با تاریخ و ساعت حالا خود قرار دهید . برای مثال : 2026-03-20 10:55:06
حالا از مسیر yoursiteurl/admin وارد پنل ادمین خود شوید.اطلاعات ادمین:
username : admin@pourfi.ir password : Admin@2026
تنظیمات محیطی (.env)
در جدول زیر مهمترین پارامترهای فایل .env برای پورفای آورده شده است:
| کلید | توضیحات | پیشفرض |
|---|---|---|
APP_URL |
آدرس کامل سایت | http://localhost |
ROOTDIR |
مسیر روت فروشگاه | /home/{host_user}/public_html |
DiskUpload |
نام پوشه آپلود تصاویر پست و محصولات | uploads |
DiskFiles |
نام پوشه آپلود فایل های فروشی (قبل از public_html) | FileDisk |
درگاه های پرداخت
در حال حاضر پورفای از درگاه پرداخت زرین پال پشتیبانی میکند و پس از پرداخت به صورت خودکار محصول فعال میشود . برای افزودن درگاه های دیگر میتوانید فایل app/Http/Controllers/invoiceController.php را ویرایش نموده و درگاه های دیگر خود را نیز به آن اضافه کنید و در فایل Blade امکان انتخاب درگاه را فراهم نمایید
دو تابع PaymentStart برای هدایت به درگاه پرداخت و تابع CallbackPayment برای وریفای پرداخت استفاده میشود.
پنل مدیریت
پنل مدیریت پورفای با استفاده از فیلامنت ۵.۳ ساخته شده است. برای دسترسی به پنل:
- به آدرس
/adminبروید. (شما در هنگام نصب میتوانید آدرس آنرا تغییر دهید و همچنین از تنظیمات در بخش مدیریت نیز میتوانید آنرا ویرایش کنید.) - با اطلاعاتی که هنگام نصب وارد شده وارد شوید .
- در داشبورد میتوانید محصولات، کاربران و سفارشات را مدیریت کنید.
ساختار فایلها
پورفای از ساختار استاندارد لاراول پیروی میکند، اما بخشهای کلیدی آن عبارتند از:
/app
/Filament
/Resources
/ProductResource.php
/UserResource.php
/Models
Product.php
Order.php
/routes
web.php
/api.phpمشارکت در پروژه
ما از مشارکتهای شما استقبال میکنیم! برای مشارکت:
- یک Fork از پروژه ایجاد کنید.
- یک شاخه (Branch) جدید برای ویژگی خود بسازید (
git checkout -b feature/AmazingFeature). - تغییرات خود را Commit کنید (
git commit -m 'Add some AmazingFeature'). - به شاخه اصلی Push کنید (
git push origin feature/AmazingFeature). - یک Pull Request باز کنید.