توثيق بيع الملفات الرقمية والتنزيل الآمن بالرمز لأودو 19

دليل بيع الملفات الرقمية من أودو: جعل المنتج رقميًا ورابط التنزيل الشخصي والبريد وصفحة التنزيل وإدارة الروابط وقراءة سجل التنزيل.

يشرح الإصدار 1.0.0حُدّث في 23 أكتوبر 2026

عن بيع الملفات الرقمية والتنزيل الآمن بالرمز لأودو 19 تنزيل ملف PDF(PDF، 2.3 MB)

ابدأ من هنا

ببساطة: تبيع ملف PDF أو حزمة قوالب أو دورة أو أي ملف آخر. يدفع العميل أو يُؤكَّد الطلب، فيرسل أودو بنفسه رابط تنزيل شخصيًا بالبريد. يتوقف الرابط بعد عدد الأيام أو التنزيلات الذي تحدده، ويُسجَّل كل تنزيل.

نصيحة: لا شيء لتبنيه: ترفق الملفات بمنتج وتفعّل منتج رقمي وتبيعه كأي منتج آخر.

ماذا تحصل عليه

الميزة	ما تفعله
منتج رقمي	فعّل الخانة على أي منتج وأرفق ملفًا أو أكثر.
رابط سري شخصي	رابط واحد لكل سطر رقمي في الطلب، طويل وعشوائي ويستحيل تخمينه.
بريد عند التأكيد	يُرسل بلغة العميل، بما فيها العربية، مع قائمة الملفات.
مدة زمنية	ينتهي الرابط بعد N يومًا (الافتراضي 7، ويمكن ضبطه لكل منتج).
عدّاد التنزيل	يتوقف الرابط بعد N تنزيلات (الافتراضي 5). 0 تعني غير محدود.
ملفات خاصة	لا عنوان عام للملفات: كل تنزيل يمر عبر الرابط.
تحكم	تمديد أو رابط جديد أو إلغاء أو إعادة إرسال بالبريد؛ وسجل لكل تنزيل.
آمن عند الإلغاء	إلغاء الطلب يلغي روابطه.

المتطلبات

البند	التفاصيل
أودو	19.0 (Community أو Enterprise)
التطبيقات المطلوبة	المبيعات (`sale`) وبريد النقاش (`mail`)
البريد	خادم بريد صادر ليصل الرابط إلى العميل
عنوان الويب	ضبط `web.base.url` على عنوانك العام (يُفضَّل https)
الرخصة	OPL-1 (رخصة أودو الخاصة v1.0)

التثبيت

فُكّ ضغط الحزمة. بداخلها taqnix_digital_downloads.zip؛ فُكّه لتحصل على المجلد taqnix_digital_downloads.
انسخ المجلد إلى أحد مجلدات addons_path في خادم أودو وأعد تشغيل أودو.
سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
أزل مرشح «التطبيقات» وابحث عن Digital File Sales واضغط تثبيت.

# أو من سطر الأوامر
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_digital_downloads --stop-after-init

الإعدادات

ببساطة: افتح الإعدادات ← التنزيلات الرقمية. هذه هي الافتراضيات للشركة، ويمكن للمنتج تجاوزها.

الإعداد	ما يفعله
أرسل الروابط بالبريد عند التأكيد	عند تأكيد أمر بيع يحتوي على منتج رقمي يتلقى العميل البريد. أوقفه لإرسال الروابط يدويًا.
مدة صلاحية الرابط	عدد الأيام بعد التأكيد (الافتراضي 7).
التنزيلات المسموحة	كل تنزيل لملف يُحتسب مرة واحدة (الافتراضي 5). 0 تعني غير محدود.

اجعل المنتج رقميًا

ببساطة: افتح المنتج وفعّل منتج رقمي بجانب المبيعات والشراء، ثم افتح تبويب الملفات الرقمية الجديد.

الحقل	ملاحظات
التسمية	ما يراه العميل، مثل «الدليل (PDF)». يمكن ترجمتها.
الملف	ارفع الملف. ويظهر حجمه للعميل.
مدة صلاحية الرابط (أيام)	0 تستخدم افتراضي الشركة؛ وأي رقم آخر يُستخدم لهذا المنتج.
التنزيلات المسموحة	0 تستخدم افتراضي الشركة؛ وأي رقم آخر يُستخدم لهذا المنتج.

نصيحة: استخدم نوع المنتج خدمة إن كنت لا تريد أمر تسليم للعميل. ونوع سلع يعمل أيضًا، لكن أودو ينشئ له تسليمًا.

عند تأكيد الطلب

ببساطة: أكّد عرض السعر كالمعتاد. ينشئ أودو رابطًا لكل سطر رقمي ويرسله إلى العميل بالبريد ويترك ملاحظة في سجل المحادثة. ويظهر زر التنزيلات على الطلب.

الحالة	ما يحدث
الطلب فيه منتجان رقميان	رابطان في بريد واحد.
منتج بلا ملف مرفق	لا رابط؛ وملاحظة في سجل المحادثة تخبرك أي منتج.
عميل بلا بريد إلكتروني	تُنشأ الروابط ولا يُرسل شيء؛ وتخبرك ملاحظة. انسخ الرابط من زر التنزيلات.
التأكيد مرتين أو الضغط على الإرسال ثانية	لا يُنشأ رابط مكرر.
إلغاء الطلب	تُلغى روابطه. أكّده ثانية فيُنشأ رابط جديد.
الدفع إلكترونيًا (التجارة الإلكترونية)	يؤكد أودو الطلب عند استلام الدفع، فيخرج الرابط حينها.

البريد الإلكتروني

ببساطة: يُرسل البريد بلغة العميل. يعرض الملفات وتاريخ الانتهاء وعدد التنزيلات وفيه زر واحد.

نصيحة: استخدم إرسال روابط التنزيل على الطلب لإعادة إرسال الروابط النشطة، مثلًا إن فقد العميل الرسالة. الروابط الملغاة والمنتهية لا تُرسل.

ما يراه العميل

ببساطة: يفتح الزر صفحة بسيطة فيها الملفات وزر تنزيل لكل ملف. وتتبع لغة العميل.

حالة الرابط	ما يراه العميل
نشط	الملفات وتاريخ صلاحية الرابط والتنزيلات المتبقية.
منتهٍ	رسالة بالتواصل مع المتجر لطلب رابط جديد.
بلغ الحد	الرسالة نفسها مع شرح الحد.
ملغى أو عنوان خاطئ	رسالة بأن الرابط غير صالح.

ببساطة: فتح الصفحة لا يستهلك تنزيلًا؛ فقط الضغط على «تنزيل» لملف يستهلك. ملفان في طلب واحد يستهلكان تنزيلين.

إدارة الروابط

ببساطة: المبيعات ← الطلبات ← التنزيلات الرقمية تعرض كل رابط مع عميله وانتهائه والتنزيلات المستخدمة وحالته.

الزر	ما يفعله	من يستخدمه
أرسل إلى العميل بالبريد	يرسل الرابط بالبريد من جديد.	المبيعات
تمديد	يضيف فترة صلاحية أخرى ورصيدًا آخر من التنزيلات. يبقى العنوان نفسه.	مديرو المبيعات
رابط جديد	عنوان سري جديد وانتهاء جديد وعدّاد من الصفر. يتوقف العنوان القديم.	مديرو المبيعات
إلغاء	يوقف الرابط فورًا.	مديرو المبيعات

نصيحة: استخدم رابط جديد إن قال عميل إن الرابط تسرّب. يموت العنوان القديم بمجرد الضغط.

سجل التنزيل

ببساطة: يُسجَّل كل تنزيل وكل محاولة مرفوضة على رابط معروف مع التاريخ والملف والنتيجة وعنوان IP والمتصفح. تجده في المبيعات ← التقارير ← سجل التنزيل أو على الرابط.

كيف يحمي ملفاتك

الإجراء	التفصيل
عنوان سري	رمز عشوائي من 43 حرفًا. لا يمكن تخمينه ولا شيء آخر يحدد التنزيل.
لا عنوان عام للملف	تُخزَّن الملفات بشكل خاص. ولا تقدمها عناوين الملفات المعتادة في أودو للعامة.
عدّاد لا يمكن التحايل عليه	يزيد العدّاد في خطوة واحدة في قاعدة البيانات، فلا تتجاوز النقرات المتزامنة الحد أبدًا.
ملفات ذلك المنتج فقط	لا يقدّم الرابط إلا ملفات منتجه.
محركات البحث والذاكرة المؤقتة	تطلب الصفحات ألا تُفهرَس ولا تُخزَّن مؤقتًا ولا تُمرَّر في المُحيل.
الإلغاء	يتوقف الرابط الملغى أو رابط طلب ملغى فورًا.

مهم: خصوصية رابط التنزيل بقدر خصوصية البريد الذي يحمله. من يملك الرابط يستطيع التنزيل حتى ينتهي. قدّم أودو عبر HTTPS واجعل مدة الصلاحية قصيرة.

الحدود

الحد	التفصيل
رابط واحد لكل سطر طلب	لا تُستخدم كمية السطر: سطر بكمية 3 يعطي رابطًا واحدًا.
الملفات تتبع المنتج	تتشارك متغيرات المنتج ملفات منتجها.
الملفات الكبيرة	يقدّم أودو الملفات. والحجم الذي ترفعه عبر المتصفح تحدده إعدادات خادمك، وقد يحدّ وسيط عكسي التنزيل. للملفات الكبيرة جدًا استخدم خادمًا سريعًا.
عدة قواعد بيانات	مع عدة قواعد بيانات يحتاج الرابط إلى اسم القاعدة. اضبط `dbfilter` ليحدد العنوان القاعدة.
بوابة العملاء	تأتي الروابط بالبريد ومن زر التنزيلات لفريقك؛ ولا تظهر في البوابة.
تسليم البريد	إن لم يستطع خادمك إرسال البريد يُنشأ الرابط أيضًا ويمكن نسخه.

للمطورين

ببساطة: تجاوز هذا الفصل إن كنت تستخدم الوحدة فقط.

البند	التفاصيل
النماذج	`taqnix.digital.file` (ملفات المنتج) و`taqnix.download.token` (الرابط) و`taqnix.download.log` (السجل).
حقول المنتج	`tx_is_digital` و`tx_file_ids` و`tx_link_days` و`tx_max_downloads`.
الطلب	`sale.order._tx_issue_links(send=True)` تنشئ الروابط الناقصة؛ و`_tx_send_links(tokens)` ترسل البريد.
المسارات	`/taqnix/download/<token>` (الصفحة) و`/taqnix/download/<token>/<file_id>` (الملف).

# أنشئ روابط طلب من شيفرتك
order._tx_issue_links(send=False)
for token in order.tx_token_ids:
    print(token.download_url, token.state, token.remaining)

# احسب تنزيلًا بشكل ذري؛ False إن تعذّر استخدام الرابط
if token._claim_download():
    ...

استكشاف الأخطاء

المشكلة	ما العمل
لم يُنشأ رابط	تحقق من تفعيل منتج رقمي على المنتج ومن وجود ملف واحد على الأقل؛ ويخبرك سجل المحادثة عند غياب ملف.
لم يصل العميل بريد	تحقق من أن للعميل بريدًا إلكترونيًا ومن عمل خادم البريد الصادر (الإعدادات ← تقني ← رسائل البريد).
الرابط يفتح «غير صالح»	العنوان ناقص، أو استُبدل الرابط بـرابط جديد.
«انتهى الرابط»	اضغط تمديد على الرابط ثم أرسل إلى العميل بالبريد.
الرابط يشير إلى localhost	اضبط `web.base.url` على عنوانك العام وأزل علامة `web.base.url.freeze` عند الحاجة.
البريد بلغة خاطئة	تأتي اللغة من نموذج جهة اتصال العميل.

التحديث والإزالة

استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_digital_downloads. تبقى الروابط والملفات والسجلات. وقبل إلغاء التثبيت انتبه إلى أن الروابط والملفات والسجلات تُحذف مع الوحدة.

الدعم

المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.