PrizeX کیا ہے
PrizeX ایک PHP پر مبنی پرائز، گیمنگ اور مارکیٹ پلیس پلیٹ فارم ہے: آکشنز، لاٹری، مسٹری باکس، آرکیڈ گیمز کا کلسٹر، ملٹی سیلر ای کامرس شاپ اور والیٹ/کوائن اکانومی — سب کچھ ایک ہی سیلف ہوسٹڈ ایپلیکیشن میں۔ یہ پلگ ان/تھیم آرکیٹیکچر کے ساتھ آتا ہے، جس میں ایک ایڈمن پینل اور 38 پیمنٹ گیٹ وے پلگ انز شامل ہیں جو کارڈز، والیٹس، کرپٹو اور علاقائی پروسیسرز کا احاطہ کرتے ہیں، اور اس کے علاوہ 3 دستی پیمنٹ طریقے جو کرنل میں پہلے سے موجود ہوتے ہیں۔
کوئی SaaS لاک اِن نہیں: آپ اسے اپنی ہوسٹنگ پر انسٹال کرتے ہیں، ڈیٹابیس آپ کا اپنا ہوتا ہے، اور لائسنس پر تاحیات اپڈیٹس ملتی ہیں۔ ہر شعبہ (آکشنز، لاٹری، مسٹری باکس، گیمز، شاپ) ایڈمن پینل سے الگ الگ آن یا آف کیا جا سکتا ہے — نئی انسٹالیشن کسی ایک ہی شعبے کے پراڈکٹ کے طور پر بھی چل سکتی ہے اور پورے سویٹ کے طور پر بھی۔
کور کوڈ کبھی کسی پلگ ان پر لازمی طور پر منحصر نہیں ہوتا۔ ہر شعبہ، ہر پیمنٹ گیٹ وے اور ہر سوشل لاگ اِن plugins/ کے نیچے ایک پلگ ان ہے، جسے باقی سائٹ کو خراب کیے بغیر فعال، غیر فعال یا ڈیلیٹ کیا جا سکتا ہے۔
ٹیبل پریفکس tbl_، کوئی ORM نہیں، اور زیادہ تر پریپیئرڈ اسٹیٹمنٹس۔ ہر پلگ ان اپنے ٹیبلز کا خود مالک ہے اور انہیں ایسے db_delta() انسٹالر کے ذریعے مائیگریٹ کرتا ہے جسے بار بار چلانا محفوظ ہے۔
یہ کس پر چلتا ہے
PrizeX عام شیئرڈ ہوسٹنگ یا VPS پر چلتا ہے — بس ویب سرور میں URL رِی رائٹ کی سہولت ہونی چاہیے، اس کے علاوہ کسی خاص سرور کنفیگریشن کی ضرورت نہیں۔
* database/migrations/ کے نیچے کئی فائلیں ADD COLUMN IF NOT EXISTS استعمال کرتی ہیں، جو صرف MariaDB کا ایکسٹینشن ہے۔ سادہ MySQL 8.0/8.4 اسے رد کر دیتا ہے — اس لیے ڈیٹابیس کے طور پر MariaDB استعمال کریں، ڈیولپمنٹ اور پروڈکشن دونوں میں۔
نئی انسٹالیشن کو چلانا
نئے سیٹ اپ کے لیے کوئی انسٹال وزرڈ نہیں ہے — آپ اسکیما براہِ راست امپورٹ کرتے ہیں اور انوائرنمنٹ فائل کنفیگر کرتے ہیں۔
- PHP ڈیپینڈینسیز انسٹال کریں:
composer install - انوائرنمنٹ ٹیمپلیٹ کاپی کریں اور اپنے ڈیٹابیس کی تفصیلات بھریں:
cp .env.example .env database/production.sqlکو اُس ڈیٹابیس میں امپورٹ کریں جس کا نام آپ کی.envمیں درج ہے — اس سے پورا اسکیما بن جاتا ہے۔- پہلے سے شامل ایڈمن اکاؤنٹ کو بدل دیں (نیچے دیا گیا نوٹ دیکھیں)، پھر
/admin/پر لاگ اِن کریں۔
database/production.sql کے ساتھ tbl_admin کی ایک رو (admin@wowcodes.in) آتی ہے جس کا پاس ورڈ ہیش ہر انسٹالیشن پر ایک جیسا ہوتا ہے۔ لائیو ہونے سے پہلے اسے ڈیلیٹ کریں اور اپنا اکاؤنٹ ڈالیں:
php -r "echo password_hash('your-password', PASSWORD_BCRYPT), \"\n\";"DELETE FROM tbl_admin;
INSERT INTO tbl_admin (username, email, password, image, status, permission_settings)
VALUES ('yourname', 'you@example.com', '<hash from the command above>', '', 1, 1);لوکل ڈیولپمنٹ کے لیے PHP کا بلٹ اِن سرور Apache کے بغیر کام کر جاتا ہے: php -S localhost:8000 router.php — دھیان رہے کہ یہ سرور .htaccess کو بالکل نظرانداز کر دیتا ہے، اس لیے router.php وہی روٹنگ رولز خود دوبارہ لکھ کر لاگو کرتا ہے (دیکھیں ویب سرور سیٹ اپ)۔
انوائرنمنٹ ویری ایبلز
ماحول کے مطابق بدلنے والی تمام سیٹنگز .env میں رہتی ہیں، جو vlucas/phpdotenv کے ذریعے لوڈ ہوتی ہے۔ .env.example کو .env کے نام سے کاپی کریں (یہ git سے باہر رہتی ہے) اور ہر ماحول کے لیے اصل قدریں سیٹ کریں — کم از کم ڈیٹابیس کی تفصیلات، اسکیما امپورٹ سے پہلے۔
پوری سائٹ کی وہ سیٹنگز جو ماحول کے ساتھ نہیں بدلتیں (ایپ کا نام، کرنسی، فعال پلگ انز، فعال تھیم اور ہر شعبے کے آن/آف بٹن) ڈیٹابیس میں tbl_settings کے اندر رہتی ہیں، اور فائلوں کے بجائے ایڈمن پینل سے سنبھالی جاتی ہیں۔
ویب سرور سیٹ اپ
روٹنگ اور سیکیورٹی کے رولز — خوبصورت URLs، .env/connection.php/لاگ فائلوں تک براہِ راست رسائی کی روک تھام، اور اپ لوڈ کیے گئے مواد کو PHP کے طور پر چلنے سے روکنا — پورے پروجیکٹ میں پھیلی .htaccess فائلوں میں طے ہوتے ہیں۔ Apache اور LiteSpeed/OpenLiteSpeed انہیں بغیر کسی اضافی سیٹنگ کے خود پڑھ لیتے ہیں۔
nginx پر nginx.conf.example استعمال کریں، جو اِن میں سے ہر رول کو nginx کے server{} بلاک کی صورت میں دہراتی ہے — اپنے ماحول کے مطابق server_name، root اور PHP-FPM ساکٹ ایڈجسٹ کر لیں۔
.htaccess (پروڈکشن)، router.php (لوکل php -S ڈیو سرور) اور nginx.conf.example (nginx) — تینوں وہی روٹنگ رولز الگ الگ لاگو کرتے ہیں۔ خوبصورت URL والا نیا روٹ شامل کرنے کا مطلب ہے تینوں کو اپڈیٹ کرنا۔
ریکویسٹ آرکیٹیکچر
اسٹور فرنٹ کا ہر صفحہ (index.php، item.php، …) includes/header.php کے ذریعے اِس ترتیب سے بوٹ ہوتا ہے:
connection.php سیشن شروع کرتا ہے، .env کی تفصیلات کے ساتھ mysqli کے ذریعے کنیکٹ ہوتا ہے، tbl_settings کو APP_NAME اور CURRENCY جیسے کانسٹنٹس میں لوڈ کرتا ہے، اور موجودہ صارف کو لاگ اِن کرنے کے ساتھ ڈیوائس فنگر پرنٹ کی ایک رو بھی بناتا ہے۔ plugins_load() ہر فعال پلگ ان کو بوٹ کرتا ہے اور plugins_loaded ہُک چلاتا ہے — یہی وہ لمحہ ہے جب فعال شعبوں کی اصل، موجودہ فہرست معلوم ہوتی ہے، اور اسی لیے header.php بعد میں پرانی سیٹنگز کے فلیگز (شاپ، ملٹی سیلر، آکشن، لاٹری) کو پلگ انز کی حقیقی فعال حالت کے ساتھ دوبارہ ملاتا ہے۔
ایڈمن پینل اس بوٹ اسٹریپ کو دہراتا نہیں — admin/includes/connection.php ایڈمن کے لیے مخصوص سیشن/ایرر سیٹنگز کرتا ہے اور پھر وہی روٹ والا includes/connection.php شامل کر لیتا ہے۔
پلگ ان سسٹم
پلگ ان دراصل plugins/<slug>/plugin.php ہے — ہیڈر کمنٹ میں لکھی میٹا ڈیٹا، جو فائل چلائے بغیر پڑھ لی جاتی ہے — اور اس کے ساتھ زیادہ تفصیلی کیٹلاگ معلومات کے لیے ایک اختیاری plugin.json۔ فعال پلگ انز tbl_settings.active_plugins میں JSON ارے کے طور پر محفوظ ہوتے ہیں۔
- ٹیبلز کی ملکیت — ہر پلگ ان اپنی
includes/schema.phpخود بناتا ہے، جو فعال ہوتے وقت چلتی ہے اور بار بار چلنے پر محفوظdb_delta()ہیلپر استعمال کرتی ہے (CREATE TABLE IF NOT EXISTS+ صرف اضافے والاALTER TABLE ADD COLUMN)۔ کوئی پلگ ان کسی دوسرے پلگ ان کے ٹیبلز کو ہاتھ نہیں لگاتا۔ - رجسٹریاں پہلے لوڈ ہوتی ہیں —
add_admin_page،add_route،add_cron_job،add_api_routeاورregister_moduleسب کسی بھی پلگ ان کے لوڈ ہونے سے پہلے طے ہو جاتے ہیں، اس لیے پلگ ان کی ٹاپ لیول کالز کبھی فیٹل ایرر نہیں دیتیں، چاہے وہ پلگ ان آخر میں غیر فعال ہی کیوں نہ رہے۔ - صاف ستھری ہٹائی — پلگ ان ڈیلیٹ کرنے پر اس کی
uninstall.phpچلتی ہے اور اس کا فولڈر ہٹ جاتا ہے؛plugins/<slug>/سے باہر کسی چیز کو اس کی فائلوں کی لازمی ضرورت نہیں ہونی چاہیے، تاکہ پلگ ان کے جانے کے بعد باقی سائٹ چلتی رہے۔
تھیم سسٹم
تھیم assets/themes/<slug>/ میں رہتا ہے — ایک manifest.php، ایک theme.css، تھیم ہُکس کے لیے functions.php اور اختیاری components/۔ فعال تھیم tbl_settings.active_theme میں محفوظ ہوتا ہے، اور اگر کوئی سیٹ نہ ہو تو editorial فال بیک کے طور پر استعمال ہوتا ہے۔
کمپوننٹ اِس ترتیب سے تلاش کیا جاتا ہے: پہلے فعال تھیم کا اپنا components/ فولڈر، پھر کسی پلگ ان کا وہ کمپوننٹس فولڈر جو اُس نے register_module() کے ذریعے بتایا ہو، اور آخر میں مشترکہ روٹ components/۔ عملی طور پر اس کا مطلب یہ ہے کہ مشترکہ ڈیفالٹ ایک ہی بار components/ میں رہتا ہے، اور کوئی بھی تھیم — یا کوئی فعال شعبہ پلگ ان — کسی خاص کمپوننٹ کے راستے کو اپنی کاپی سے بدل سکتا ہے۔
ڈیٹابیس
ٹیبل پریفکس tbl_، خام mysqli، اور زیادہ تر پریپیئرڈ اسٹیٹمنٹس۔ SQL فائلیں، اہمیت کی ترتیب سے:
database/core-schema.sql— ہاتھ سے سنبھالے جانے والے صرف کرنل ٹیبلز؛ شعبوں اور پلگ انز کے ٹیبلز جان بوجھ کر شامل نہیں کیے جاتے۔database/production.sql— خودکار طور پر بنتی ہے (کور اسکیما + ہر پلگ ان کا اپنا انسٹال روٹین، ایک عارضی ڈیٹابیس سے ڈمپ کر کے)۔ نئی انسٹالیشن کے لیے آپ یہی امپورٹ کرتے ہیں۔database/sandbox.sql— لوکل ڈیولپمنٹ کے لیے ڈیمو/سیڈ ڈیٹا۔database/migration.sql— پہلے سے موجود انسٹالیشنز کے لیے یکجا اپ گریڈ اسکرپٹ، جسے بار بار چلانا محفوظ ہے۔database/migrations/<slug>/up.sql(اور جہاں واپسی ممکن ہو وہاںdown.sqlبھی) — ہر مائیگریشن کے لیے الگ فائل۔
ماڈیولز
ہر ماڈیول ایک ہی انسٹالیشن میں آتا ہے اور ایڈمن پینل سے الگ الگ آن یا آف کیا جا سکتا ہے۔
آکشنز
لائیو بڈنگ، ملٹی سیلر پورٹل اور کمیشن انجن کے ساتھ۔ بنیادی پلگ ان: plugins/auction۔
لاٹری
ٹکٹ والے ڈرا، جن کے شیڈول، انعامات اور فاتحین کی اطلاعات قابلِ ترتیب ہیں۔ بنیادی پلگ ان: plugins/lottery۔
مسٹری باکس
قابلِ ترتیب پرائز پول اور ریویل اینیمیشنز — صارف باکس خریدتا ہے اور فوراً دیکھ لیتا ہے کہ کیا جیتا۔ پلگ ان: plugins/mystery-box۔
گیمز اور ریوارڈز
games/ کے نیچے آرکیڈ گیمز کا ایک کلسٹر، اور اس کے ساتھ انگیجمنٹ اور کمائی والے پلگ انز:
شاپ اور مارکیٹ پلیس
پروموشنز اور مرچنڈائزنگ ٹولنگ کے ساتھ ملٹی سیلر ای کامرس لیئر۔ بنیادی پلگ انز: plugins/shop، plugins/multivendor۔
والیٹ، کوائنز اور سرمایہ کاری
پورے پلیٹ فارم کا ایک ہی والیٹ، جو ہر ماڈیول میں مشترک ہے۔
ریفرلز اور ریوارڈز
تصدیق، اعتماد اور کمپلائنس
یوٹیلیٹیز
ایڈمن پینل
ایڈمن پینل admin/ کے نیچے رہتا ہے اور اسٹور فرنٹ کے بوٹ اسٹریپ کو دہراتا نہیں — یہ ایڈمن کے لیے مخصوص سیشن/ایرر سیٹنگز کرتا ہے، پھر وہی روٹ والا includes/connection.php شامل کر لیتا ہے۔ صفحات add_admin_page() کے ذریعے رجسٹر ہوتے ہیں، جو سائیڈ بار کی انٹری، کیپیبلٹی گیٹنگ، CSRF اور لاگ اِن کی جانچ سنبھالتا ہے؛ صرف ایڈمن کے لیے JSON ایکشنز add_admin_ajax() کے ذریعے رجسٹر ہوتے ہیں اور admin/ajax.php?action=<slug> سے چلتے ہیں۔
آئٹمز، بینرز، صفحات، مینوز، بلاگ۔
خودکار اور دستی گیٹ ویز کا انتظام، دستی پیمنٹس کا جائزہ، پے آؤٹ ایکسپورٹس۔
یوزر گروپس، رولز، سیلر کی تفصیلات، اور صارف بن کر لاگ اِن کرنا۔
ٹرانزیکشن/آرڈر/صارف ایکسپورٹس، کرون لاگز، ایرر ٹریکنگ، ایڈمن ایکٹیویٹی لاگز۔
ای میل کمپینز، ٹیمپلیٹس، نیوز لیٹرز، پش نوٹیفکیشنز، نوٹیفکیشن لاگ۔
پلگ انز اور تھیمز فعال/غیر فعال کریں، ہر صفحے کی الگ SEO سیٹنگز، اور پوری سائٹ کی سیٹنگز۔
اسٹور فرنٹ تھیمز
assets/themes/ کے نیچے پانچ تھیمز آتے ہیں، جنہیں ہر انسٹالیشن پر ایڈمن پینل سے بدلا جا سکتا ہے۔ ہر تھیم مشترکہ کمپوننٹس کی اپنی کاپی اپنے components/ فولڈر میں رکھتا ہے۔
سفید کارڈز اور ہلکے سایوں کے ساتھ سادہ، جدید انداز — تقریباً ہر قسم کی شاپ کے لیے محفوظ اور ہمہ جہت انتخاب۔
گرم کاغذی رنگت اور واضح ٹائپوگرافی کے ساتھ صاف ستھرا، میگزین جیسا انداز — ایک نکھرے ہوئے، قابلِ اعتماد اسٹور فرنٹ کے لیے۔
ڈیفالٹ فال بیک تھیمسنہری جھلک والا جراتمند، پُرتعیش ڈارک تھیم — ایسا جو پُرجوش اور اعلیٰ درجے کا محسوس ہو۔
روایتی بازاروں سے متاثر گرم اور خوب سجا ہوا انداز، دائیں سے بائیں لکھی جانے والی زبانوں کی سپورٹ کے ساتھ۔
ڈراؤنا اور تہواری موسمی انداز — گہرے جامنی پس منظر اور کدو جیسی چمکتی نارنجی جھلک کے ساتھ۔
پیمنٹ گیٹ ویز
38 خودکار گیٹ ویز پلگ انز کی ملکیت ہیں — ہر ایک اپنے plugins/gateway-<slug>/ فولڈر میں رہتا ہے اور add_payment_gateway() کے ذریعے خود کو کرنل میں رجسٹر کرتا ہے۔ کسی گیٹ وے کو فعال کرتے ہی وہ کام کرنے لگتا ہے؛ چیک آؤٹ ڈسپیچر (payment_processor.php) میں کسی مخصوص گیٹ وے کا نام تک ہارڈ کوڈ نہیں۔
3 دستی طریقے کرنل کے ساتھ ہی شامل ہونے والی gateway_type = 'manual' روز ہیں، جن میں کنفیگر کرنے کے لیے کوئی init/verify کوڈ نہیں — یہ صرف پیمنٹ کی ہدایات یا QR کوڈ دکھاتے ہیں۔ manual-gateway-builder پلگ ان ایڈمن کو کوڈ چھوئے بغیر مزید کسٹم دستی پیمنٹ طریقے شامل کرنے دیتا ہے۔
کچھ گیٹ ویز (Stripe، Razorpay، Midtrans، Venmo) ایسے چیک آؤٹ فلو کے لیے render ہُک بھی رجسٹر کرتے ہیں جنہیں کلائنٹ سائیڈ JS درکار ہوتی ہے — جیسے Stripe Checkout کا بوٹ اسٹریپ، یا Razorpay/Midtrans/Braintree کی SDK جسے پہلے سرور پر بنی آرڈر ID یا ٹوکن چاہیے ہوتا ہے۔ باقی ہر گیٹ وے بغیر کسی اضافی کرنل وائرنگ کے کام کرتا ہے۔
API اور AJAX لیئرز
api/v1/— موبائل ایپ اور بیرونی صارفین کے لیے JWT سے تصدیق شدہ REST API۔api/v1/middleware/*.phpفائلیںAuthorization: Bearer <token>ہیڈر کی جانچ کرتی ہیں۔ پلگ انز اپنے اینڈ پوائنٹسadd_api_route()کے ذریعے شامل کرتے ہیں۔ajax/— اسٹور فرنٹ کی اپنی JS (کارٹ، کوپن، نوٹیفکیشنز) کے لیے اندرونی AJAX، جس کی تصدیق سیشن کوکی سے ہوتی ہے۔ اس میں کوئی ٹوکن لیئر نہیں — یہconnection.phpکے بنائے ہوئے PHP سیشن پر انحصار کرتا ہے۔- اوپر کی سطح پر بکھرا ہوا
api/— بغیر ورژن کے متفرق اینڈ پوائنٹس، جیسےgeo_location.php،exchange-rate.phpاورofferwall_postback.php۔
موبائل ایپ
mobile/ ایک الگ Capacitor + Ionic پروجیکٹ ہے — لائیو سائٹ کے گرد ایک WebView ریپر، نہ کوئی خودمختار SPA اور نہ محض api/v1 کا صارف۔ اس کی capacitor.config.ts میں server.url آپ کے ڈومین کی طرف اشارہ کرتا ہے۔ اس کی اپنی package.json ہے اور یہ پروجیکٹ کی روٹ سے بلڈ نہیں ہوتا:
cd mobile
npm run sync
npm run open:ios
npm run open:androidاپڈیٹس اور مائیگریشنز
کسی لائیو ڈیٹابیس پر database/migration.sql یا کوئی بھی database/migrations/<slug>/up.sql چلانے سے پہلے اسنیپ شاٹ لے لیں:
mysqldump --single-transaction -u<user> -p<pass> <db> > pre-deploy-$(date +%Y%m%d-%H%M%S).sqlزیادہ تر مائیگریشنز کے ساتھ ایک down.sql بھی آتی ہے جو صرف اُسی ایک تبدیلی کو واپس کر دیتی ہے۔ چند ایسی مائیگریشنز جو محض ڈھانچہ بڑھانے کے بجائے پہلے سے موجود ڈیٹا بدل دیتی ہیں، اُن کے ساتھ ایسی down.sql آتی ہے جو صرف یہ بتاتی ہے کہ وہ کچھ کیوں نہیں کرتی — ایسی صورت میں واپس جانا ہو تو ڈیپلائے سے پہلے لیے گئے ڈمپ سے بحال کریں۔
سیکیورٹی سے متعلق نکات
- امپورٹ کے فوراً بعد پہلے سے شامل ایڈمن کی تفصیلات بدل دیں (دیکھیں انسٹالیشن)۔
.env،connection.phpاور لاگ فائلوں تک براہِ راست HTTP رسائی ساتھ آنے والے.htaccess/ nginx رولز سے بند ہے — اِن رولز کو ہٹائیں نہیں۔- اپ لوڈ کیا گیا مواد اس طرح سرو کیا جاتا ہے کہ وہ PHP کے طور پر چل نہ سکے — یہ پابندی ایپلیکیشن کی سطح پر نہیں بلکہ ویب سرور کنفیگ کی سطح پر لاگو ہوتی ہے۔
- پیمنٹ گیٹ وے کی تفصیلات ہر گیٹ وے کے لیے الگ الگ ایڈمن پینل سے سیٹ ہوتی ہیں اور سرور کی طرف محفوظ رہتی ہیں — یہ کبھی اسٹور فرنٹ تک نہیں پہنچتیں۔
ٹیسٹنگ
کوئی PHPUnit سویٹ نہیں ہے۔ composer test دراصل bin/run-probes.php چلاتا ہے، جو includes/_probes/ اور ہر پلگ ان کے اپنے _probes/ فولڈر کی ہر probe_*.php فائل کو جمع کرتا ہے، پھر ہر ایک کو CLI سب پروسیس کے طور پر چلا کر اس کا ایگزٹ کوڈ جانچتا ہے۔
composer test # run every probe
php plugins/<slug>/_probes/probe_*.php # run a single probe directly
php bin/run-probes.php --all # also run destructive probes (skipped by default)اکثر پوچھے گئے سوالات
سپورٹ اور وسائل
اب بھی اٹکے ہوئے ہیں، یا کوئی ایسی چیز درکار ہے جو اس صفحے پر نہیں؟