Flexible Website Order
محرك الطلب السريع والدفع عند الاستلام (COD) مع نظام التتبع الذكي الفائق للإعلانات والحملات التسويقية.
العرض الترويجي للموديل في متجر أودو (Marketplace Listing)
عنوان التطبيق والوصف المختصر:
العنوان التجاري (Title):
Flexible Website Order | 1-Click COD Express Checkout & Deep Tracking
الطلب السريع بضغطة واحدة والدفع عند الاستلام مع التتبع الذكي الشامل للحملات والإعلانات.
الملخص الترويجي (Summary):
حوّل زوار موقعك إلى مشترين فوراً دون تعقيدات السلة التقليدية! بلوك احترافي للطلب السريع بنظام الدفع عند الاستلام COD مع تحديث فوري للمتغيرات والأسعار، ودعم كامل لمنشئ النماذج الرسمي، وتتبع دقيق وشامل لجميع معلمات UTM ومعرفات الإعلانات Click IDs (Google, Facebook, TikTok...).
أبرز المزايا التنافسية (Key Selling Points):
- رفع معدل التحويل (Conversion Rate): تقليص خطوات الشراء من 5 خطوات إلى خطوة واحدة سريعة على نفس الصفحة.
- تكامل تام مع Odoo 19: متوافق 100% مع نسختي Community و Enterprise ونظام القوالب الجديد.
- محرك تتبع ذكي للجلسات: ربط تلقائي للطلبات المتكررة في نفس الجلسة بحملتها الإعلانية الأولى بذكاء.
- أمان وموثوقية في حفظ البيانات: تحقق صارم من صحة أرقام الهواتف وعدم قبول أرقام وهمية أو حروف.
بطاقة مواصفات الموديل (Module Specs):
| الاسم الفني | website_express_cod_order |
|---|---|
| التوافق | Odoo 19.0 (Community & Enterprise) |
| التصنيف في أودو | Website / eCommerce / Sales |
| الترخيص (License) | OPL-1 (قابل للبيع في متجر أودو) |
| الاعتماديات الأساسية | website, sale, utm |
| الفئة في شريط الأدوات | Products & Form (فئة مستقلة ومنظمة) |
من يستفيد من هذا التطبيق؟
متاجر التجارة الإلكترونية التي تعتمد على الدفع عند الاستلام (COD) في دول الخليج، شمال أفريقيا، والأسواق الناشئة، ومسؤولو التسويق عبر وسائل التواصل (Media Buyers) الراغبون في تتبع العائد الإعلاني ROAS بدقة متناهية.
الدليل الوظيفي واستخدام واجهة المستخدم (Functional Manual)
سحب وإفلات البلوك
افتح أي صفحة في الموقع في وضع التعديل (Edit Mode)، وانتقل لقسم Products & Form واسحب بلوك Flexible & Express Order لأي مكان تريده في الصفحة.
اختيار المنتج وتخصيصه
اضغط على عمود المنتج لتظهر لك خيارات Product Showcase في الشريط الجانبي. اختر المنتج، وتحكم في إظهار أو إخفاء السعر، الخصم، التقييم، معرض الصور، وتحديد نمط العرض (متحرر، بطاقة ناعمة، بطاقة مرتفعة).
تعديل الزر والنموذج
اضغط على زر الطلب لتظهر قائمة Submit Button في الشريط الجانبي لتعديل النص، اللون، الحجم، الاستدارة، والظل، أو أضف حقولاً مخصصة للنموذج عبر منشئ النماذج الرسمي.
ميزة تحرير مظهر المنتج والزر:
تم تحرير المنتج من القوالب الضيقة ليظهر بمظهر عصري انسيابي واسع النطاق (Edge-to-Edge Floating)، كما تم توفير خيارات التحكم بالزر في الشريط الجانبي مباشرة مع التوافق الكامل مع النوافذ المنبثقة القياسية في أودو 19.
نظام التتبع الذكي الفائق (Advanced Tracking & Attribution)
كيف يعمل محرك التتبع الذكي في الموديل؟
عند دخول الزائر إلى الصفحة من أي إعلان ممول، يلتقط الموديل تلقائياً في الواجهة الخلفية كافة معلمات التتبع ويحفظها في جلسة التصفح بذكاء متطور يضمن:
- التقاط معلمات UTM كاملة:
utm_source(المصدر)،utm_medium(الوسيط)،utm_campaign(الحملة)،utm_term(الكلمة المفتاحية)،utm_content(المحتوى). - دعم كافة معرفات النقرات العالمية (Click IDs):
gclid(Google),fbclid(Facebook),ttclid(TikTok),wbraid/gbraid(Google iOS),msclkid(Bing),twclid(X/Twitter),sccid(Snapchat),epik(Pinterest),li_fat_id(LinkedIn). - تتبع الطلبات المتكررة في نفس الجلسة: إذا طلب العميل منتجاً ثم اشترى منتجاً آخر بعد دقائق في نفس الجلسة، يُسجل الطلب الثاني كطلب تابع لنفس الحملة الإعلانية مع وسام تنبيهي في الـ Chatter
طلب إضافي متكرر: رقم 2 في نفس الجلسة! - الاستشعار التلقائي للحملات الجديدة (Fresh Campaign Detection): إذا نقر العميل على إعلان جديد بحملة جديدة، يكتشف النظام فوراً وجود معلمات جديدة ويقوم بتهيئة الجلسة لتوثيق الحملة الجديدة بدقة متناهية.
معاينة بطاقة التتبع في محادثة الطلب (Chatter Preview):
| صفحة الطلب: | https://example.com/promo-landing |
| معلومات UTM: | Snapchat Ads Eid_Sale_2026 |
| معرف الإعلان: | sccid: 98a76b54 |
الهندسة المعمارية والبرمجية (Technical Architecture)
هيكل مجلدات الموديل (Directory Tree):
├── __init__.py
├── __manifest__.py
├── controllers/
│ ├── __init__.py
│ └── main.py # RPC Endpoints (/express_cod/get_product_data, /express_cod/submit_order)
├── models/
│ ├── __init__.py
│ └── sale_order.py # Sale Order fields (landing_page_url, click_id, tracking display)
├── views/
│ ├── sale_order_views.xml # Backend Tree/Form views, tracking columns & pages
│ ├── snippets/
│ │ ├── snippets.xml # Registers snippet in Products & Form category
│ │ └── s_express_cod_order.xml # Snippet XML template
│ └── templates/
│ ├── thank_you_page.xml # Thank You Confirmation page
│ └── cod_documentation.xml # Official Documentation web page
├── static/
│ └── src/
│ ├── snippets/s_express_cod_order/
│ │ ├── 000.scss # Modern liberated SCSS styling
│ │ └── express_cod_interaction.js # OWL public interaction & Form send patch
│ └── builder/
│ └── plugins/
│ ├── express_cod_option_plugin.js # Builder option plugin & container hook
│ └── express_cod_option.xml # Product & Button sidebar XML templates
└── tests/
├── __init__.py
└── test_express_cod.py # 7 Comprehensive unit tests (100% passing)
نقاط النهاية البرمجية (API & RPC Endpoints):
| المسار (Route) | النوع (Type) | الصلاحية (Auth) | الوظيفة والبيانات |
|---|---|---|---|
/express_cod/get_product_data |
JSON-RPC | public | جلب تفاصيل المنتج، المتغيرات، التقييمات، الصور، والأسعار مع خصم الكميات فوراً. |
/express_cod/submit_order |
JSON-RPC | public | إنشاء أو تحديث جهة الاتصال (Partner)، إنشاء أمر البيع (Sale Order)، ربط معلمات UTM و Click ID، وتوثيق سجل الـ Chatter، ثم إرجاع رابط التوجيه. |
/order-thank-you |
HTTP | public | عرض صفحة الشكر وتأكيد الطلب برقم الطلبية وبيانات العميل. |
/cod-documentation |
HTTP | public | عرض صفحة التوثيق الرسمية للموديل. |
دليل المطورين ووكلاء الذكاء الاصطناعي (Developer & AI Agent Guide)
إذا كنت مطوراً أو وكيل ذكاء اصطناعي (AI Coding Agent) تقوم بصيانة أو توسيع هذا الموديل مستقبلاً، إليك القواعد والأسس المعمارية الهامة:
معالجة منع تصادم النموذج (Form Patch):
لا تقم أبداً بإزالة ترقيع patch(Form.prototype, { send() { ... } }) في express_cod_interaction.js؛ فهو الذي يمنع مكتبة النماذج الافتراضية في أودو من محاولة إرسال طلب 500 متعارض بالتوازي مع طلب الـ RPC السريع.
تكامل شريط أدوات البناء (Builder Options):
يتم تسجيل حاويات الشريط الجانبي عبر ترقيع computeContainers في BuilderOptionsPlugin، حيث يتم ربط ExpressCodProductOption بعمود المنتج و ExpressCodSubmitButtonOption بزر الإرسال.
تشغيل الاختبارات الآلية (Running Unit Tests):
للتأكد من سلامة جميع أجزاء الموديل بعد أي تعديل مستقبلي، شغل الأمر التالي: