mini woo
1.0.0
Mini Woo هو مشروع يسمح لك بإنشاء تطبيق Mini لـ Telegram ، وهو تطبيق المراسلة مع أكثر من 500 مليون مستخدم نشط ، يتصل بموقع WooCommerce الخاص بك ، وهو منصة التجارة الإلكترونية الأكثر شعبية على الويب.
يستخدم Next.js ، إطار React لإنشاء تطبيقات ويب سريعة وقابلة للتطوير ، و API Telegram BOT و WooCommerce Rest API لتوفير تجربة تسوق سلسة لعملائك على Telegram.
يمكنك استخدام هذا المشروع كقالب لتخصيص تطبيق MINI الخاص بك من خلال العلامة التجارية الخاصة بك والمنتجات والميزات ، أو تعديل واجهة برمجة التطبيقات لتوصيل أي متجر آخر على الإنترنت يدعم خدمات الويب المريحة. هذا المشروع مفتوح المصدر ومجاني للاستخدام. يمكنك العثور على التعليمات المصدرية والوثائق والتثبيت هنا على Github.
لاستخدام هذا المشروع ، تحتاج إلى تعيين متغيرات البيئة التالية:
NEXT_PUBLIC_BASE_PATH هذا هو عنوان URL الأساسي لنشرك. على سبيل المثال ، إذا كنت تنشر على Vercel ، فقد يكون ذلك مثل https://mini-woo-<your-username>.vercel.app .
TELEGRAM_BOT_TOKEN هذا هو رمز الوصول الذي تحصل عليه من BOTFATHER عند إنشاء روبوت TELEGRAM الخاص بك.
TELEGRAM_BOT_SECRET هذه كلمة مرور قمت بتعيينها لتأمين واجهات برمجة التطبيقات الخاصة بك. يمكن أن يكون أي سلسلة ، مثل my-pass أو تجزئة تم إنشاؤها عشوائيًا. يرجى التأكد من إبقائها سرية.
TELEGRAM_PAYMENT_PROVIDER_TOKEN هذا هو رمز مزود الدفع Telegram. يمكنك توصيل طرق الدفع من botfather. مقدمي الدفع ، العملات المدعومة
WOOCOMMERCE_URL هذا هو عنوان URL لموقع WooCommerce الخاص بك. على سبيل المثال ، https://<your-super-cool-store>.com .
WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET هذه هي مفتاح المصادقة والسر الذي تحصل عليه من إعدادات WooCommerce. يمكنك متابعة هذه التعليمات لإنشاءها.
تحتاج إلى نشر تطبيقك على منصة أو خادم من اختيارك.
أسهل طريقة لنشر تطبيق Next.js الخاص بك هي استخدام منصة Vercel من منشئي Next.js. تحتاج إلى شوكة هذا المستودع أولاً.
تحقق من توثيق نشر NEXT.JS لمزيد من التفاصيل.
إذا كنت تفضل نشر التطبيق الخاص بك على الخادم الخاص بك ، فأنت بحاجة إلى نسخ example.env .env ثم ، تحتاج إلى تشغيل الأوامر التالية:
npm run build
npm run start سيؤدي ذلك إلى إنشاء تطبيقك وبدء تشغيله على المنفذ المحدد بواسطة متغير PORT في .env .
تعيين متغيرات البيئة ثم تشغيل:
npm run devيمكنك استخدام https://ngrok.com/
هذه هي الخطوة الأخيرة! تحتاج إلى إعداد webhook لبراعة Telegram لتلقي التحديثات من Telegram. للقيام بذلك ، تحتاج فقط إلى تقديم طلب نشر إلى عنوان URL التالي:
curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var > استبدل <your-deployment-url> بعنوان URL الأساسي لنشرك و <the-secret-password-from-env-var> بقيمة TELEGRAM_BOT_SECRET في متغيرات البيئة الخاصة بك أو .env .
الآن تطبيق MINI جاهز! يمكنك اختباره عن طريق إرسال أوامر أو رسائل إلى روبوت Telegram. يتمتع! ؟
لمعرفة المزيد ، ألق نظرة على الموارد التالية:
ملاحظاتك ومساهماتك مرحب بها!
