نظرة عامة على متجر Alg2mer

متجر Alg2mer، المطور باستخدام PHP، هو منصة تجارة إلكترونية شاملة تتضمن تطبيقًا محمولًا، صُممت لتسهيل إدارة جميع جوانب الأعمال التجارية والتفاعلات مع العملاء بسلاسة.

• متطلبات البيئة
• تعليمات الإعداد
• تخصيص الشعارات
• تفاصيل التكوين
• تفعيل اشعارات فايربيز
  • طريقة إنشاء firebase_credentials.json
  • إنشاء مشروع Firebase
• تفعيل الروابط العميقة
  • لنظام iOS:
  • لنظام Android:
• الوظائف الزمنية المطلوبة

متطلبات البيئة

تأكد من أن بيئة الاستضافة الخاصة بك تلبي المتطلبات التالية:

• إصدار PHP: يُطلب php8.1 للحصول على أفضل أداء.
• خادم قاعدة البيانات: يُدعم نظام إدارة قواعد البيانات MySQL.
• خادم الويب: تتوافق المنصة مع خوادم Apache و nginx.

تعليمات الإعداد

اتبع هذه الخطوات لتثبيت وتكوين متجر Alg2mer:

1. تحضير قاعدة البيانات: أنشئ قاعدة بيانات جديدة على خادمك.
2. استيراد SQL: استورد ملف SQL الموجود في .sql/shop.sql إلى قاعدة البيانات الجديدة.
3. ملفات المشروع: انقل ملفات المشروع إلى دليل العام لخادمك.
4. ملف التكوين: انسخ ملف التكوين المثالي باستخدام cp config.example.json config.json.
5. تكوين الإعدادات: عدّل config.json ليطابق إعدادات خادمك وقاعدة بياناتك.
6. التبعيات: نفذ composer install لتثبيت التبعيات الخاصة بPHP.
7. مُهيئ قاعدة البيانات: توجه إلى https://your-domain.com/seeder.php لتعبئة قاعدة البيانات بالبيانات الأولية.
8. الوصول كمدير: قم بتسجيل الدخول باستخدام بيانات الدخول الافتراضية للمدير (رقم الهاتف: 123456789, كلمة المرور: 123456) لبدء استخدام النظام.
9. تدابير الأمان: أنشئ مستخدمًا إداريًا جديدًا وعطّل الحساب الافتراضي لتعزيز الأمان.
10. الإطلاق: استكشف واستمتع بميزات متجر Alg2mer.

تخصيص الشعارات

قم بتخصيص مظهر المنصة عن طريق تحديث الشعارات:

• الشعار الأساسي: استبدل /assets/img/brand/blue.png بشعارك ذو اللون الأساسي.
• الأيقونة: قم بتحديث /assets/img/brand/favicon.png بأيقونة الشعار الخاص بك.
• الشعار الأبيض: غيّر /assets/img/brand/white.png إلى شعارك ذو اللون الأبيض والخلفية الشفافة.

تفاصيل التكوين

قم بتكوين نظامك بمعايير محددة لضمان سير العمل بسلاسة:

• server_url: حدد مسار جذر الخادم.
• db_mode: اختر بين pdo (افتراضي) و mysqli للتفاعل مع قاعدة البيانات.
• database_config: حدد إعدادات قاعدة البيانات هنا.
• sms_driver: اختر بوابة SMS. تشمل الخيارات بوابات محلية مثل brqsms و niloge، بالإضافة إلى الخيارات الدولية مثل twilio و vonage و plivo.
• jwt_secure: استخدم UUID فريد لتوليد رموز JWT للأمان.
• ttl: حدد مدة صلاحية الرمز.
• company_name: حدد اسم شركتك باللغة العربية لعرضه في النظام.
• company_name_en: اسم شركتك باللغة الإنجليزية.
• company_url: URL لموقع شركتك.
• IMAGE_MAX_SIZE و VIDEO_MAX_SIZE: حدد الحجم الأقصى المسموح به لملفات الصور والفيديو.
• ses_name: قم بتخصيص أسماء معاملات الجلسة لمزيد من الأمان.
• enable_ssl: تمكين (1) أو تعطيل (0) SSL.
• bulk_limit: حدد الحد الأقصى لعدد رسائل SMS المرسلة في دفعة واحدة.
• env: اختر production للحصول على كامل الوظائف أو development للاختبار باستخدام رمز SMS افتراضي.

تفعيل اشعارات فايربيز

لتمكين إرسال الإشعارات إلى التطبيق، يجب عليك إنشاء ملف firebase_credentials.json واستبدال الملف الموجود في المجلد الجذر للمشروع.

طريقة إنشاء firebase_credentials.json

1. الدخول إلى Firebase Console

   • انتقل إلى Firebase Console.
   • اختر مشروعك.

2. فتح إعدادات المشروع

   • انقر على أيقونة ⚙️ الإعدادات، ثم اختر إعدادات المشروع.

3. إنشاء مفتاح حساب الخدمة

   • انتقل إلى علامة التبويب حسابات الخدمة.
   • اضغط على "إنشاء مفتاح خاص جديد".
   • سيتم تنزيل ملف .json، وهو ملف firebase_credentials.json.

4. حفظ الملف بأمان

   • انقل الملف إلى المجلد الجذر في مشروعك.
   • تأكد من عدم رفعه إلى مستودعات الكود (مثل إضافته إلى .gitignore).

إنشاء مشروع Firebase

إذا لم يكن لديك مشروع في Firebase بعد، يمكنك اتباع الخطوات الموضحة في دليل إعداد خدمات Google لإنشاء مشروعك وإعداده بشكل صحيح.

تفعيل الروابط العميقة

لدمج الروابط العميقة في تطبيقك، تتطلب تعديلات على جانب الخادم (Backend) لكل من منصتي iOS وAndroid. هذه التعديلات تشمل ملفات مخصصة لكل نظام تشغيل. اتبع الإرشادات التالية لتفعيل الروابط العميقة لتطبيقك:

لنظام iOS:

لإعداد الروابط العميقة لتطبيق iOS، يلزم تعديل ملف .well-known/apple-app-site-association. إليك الخطوات:

1. انتقل إلى ملف .well-known/apple-app-site-association وافتحه.
2. ابحث عن العبارة YOUR_TEAM_ID.com.example.app.
3. استبدل YOUR_TEAM_ID بمعرف فريق المطورين الخاص بك في Apple.
4. استبدل com.example.app بمعرف حزمة تطبيقك.
5. احفظ التغييرات وأغلق الملف.
6. للتأكد من أن كل شيء تم إعداده بشكل صحيح، استخدم أداة التحقق من AASA (Apple App Site Association) عبر هذا الرابط.

لنظام Android:

لإعداد الروابط العميقة لتطبيق Android، ينطوي الأمر على ملف .well-known/assetlinks.json. اتبع هذه الخطوات:

1. افتح ملف .well-known/assetlinks.json.
2. أدخل اسم حزمة تطبيقك في حقل package_name.
3. أدرج بصمات شهادة SHA-256 في مصفوفة sha256_cert_fingerprints. يمكنك الحصول عليها من قسم App Signing في Google Play Console.
4. احفظ التغييرات وأغلق الملف.
5. للتحقق من الإعداد، استخدم أداة Digital Asset Links عبر هذا الرابط.

الوظائف الزمنية المطلوبة

لأتمتة إرسال الرسائل، أضف هذه الوظيفة الزمنية إلى خادمك:

* * * * * curl https://your-domain.com/api/v1/cron/process_sms.php

هذا التحسين والترجمة يهدفان إلى تقديم وثائق واضحة وسهلة الفهم للمستخدمين الناطقين بالعربية، مع الحفاظ على دقة المعلومات الفنية.