الطابعات الحرارية وملصقات البث

إعداده في 6 خطوات

قبل البدء: تحتاج هذه الميزة إلى تطبيق Windows المستقل. يجب أن تظهر طابعتك كطابعة Windows عادية. يطبع Social Stream عبر برنامج تشغيل Windows، ولا يرسل أوامر ESC/POS أو ZPL الخام أو أوامر SDK الخاصة بالمصنّع.

صل الطابعة عبر USB وشغّلها وثبّت برنامج تشغيلها في Windows. اطبع صفحة اختبار من Windows للتأكد من عملها.
في Social Stream، افتح Global settings and tools → Mechanics - Connections & Integrations → Printer Control.
انقر على العثور على الطابعات (Find printers). اختر الطابعة باسمها الظاهر في Windows.
أدخل عرض الورق (مم). عادةً هو 58, 80، أو 62.
اترك طول الملصق الثابت (Fixed label length) على 0 لورق الإيصالات. للملصقات المقصوصة، أدخل طول الملصق بالملليمتر في اتجاه تغذية الورق.
انقر على اختبار الطباعة. إذا قُصت حافة، زد الهامش الآمن في جانبها واختبر مجدداً.

تلائم الهوامش الآمنة الافتراضية، 2 مم يميناً ويساراً، كثيراً من طابعات إيصالات 58 مم الاقتصادية. يحدد برنامج التشغيل مساحة الطباعة الفعلية، لذا أبقِ استخدام المساحة القابلة للطباعة (Use printable area) محدداً ما لم تختبر خياراً آخر.

طباعة ملصق عندما يتبرع شخص

💰 تبرع / إكرامية (Donation / Tip)الحد الأدنى للمبلغ: 10

🖨️ طباعة ملصق حراري (Print Thermal Label)

{username}
{donation}

24 pt · عريض · في الوسط

افتح محرر Event Flow وأنشئ تدفقاً جديداً.
أضف محفز تبرع / إكرامية (Donation / Tip) . اضبط الحد الأدنى للمبلغ (Minimum Amount) إذا كنت تريد الطباعة للتبرعات الأكبر فقط.
أضف طباعة ملصق حراري (Print Thermal Label) (ضمن Integrations) ووصل المشغّل به.
اكتب {username}، ثم سطر جديد، ثم {donation}. اختر حجم الخط ووزنه ومحاذاته وعدد النسخ.
اترك تجاوز الطابعة والطول الثابت في الإجراء فارغاً أو 0. ستُستخدم إعدادات Printer Control.
انقر على اختبار التدفق (Test Flow). أدخل اسماً وفعّل تتضمن تبرعًا (Has Donation)، أضف مبلغاً وشغّله. سيطبع ملصقاً حقيقياً.

متغيرات مفيدة أخرى: {message}, {source}, {donationAmount}، و {counterValue}. تعمل أيضاً القيم التي أنشأتها خطوات سابقة في التدفق.

طباعة المبيعات والهدايا وأرقام الطلبات

أريد طباعة…	افعل هذا
المبيعات	استخدم نوع الحدث مع `purchase`. تبرع / إكرامية (Donation / Tip) يحتاج إلى `hasDonation`، ولذلك يفوّت معظم المبيعات.
هدايا مكتملة	استخدم `gift` أو `giftfunded`. رشّح بحسب المزود عند الحاجة.
رقم طلب متسلسل	أضف العداد قبل إجراء الطباعة.

راجع حقول أحداث التجارة لمعرفة محتوى كل عملية بيع.

اجعل اسم المشتري عريضًا والعنصر عاديًا

اضبط وزن الخط إلى النص المحدد.
أدخل هذا كنص للملصق:

**{username}**
{subtitle}

النص داخل ** فقط يصبح عريضاً. لا حاجة إلى HTML أو JavaScript.
استخدم أقواساً مفردة. تضع المبيعات اسم المنتج في {subtitle}. قد تكون الكمية في {meta.commerce.quantity}.
إذا أنشأت خطوة سابقة buyer، استخدم **{buyer}** بدلاً من ذلك.
لا يرسل Shopify وeBay اسم المشتري. استخدم عداد طلبات أو بطاقة تقتصر على المنتج.
تحتفظ الملصقات المضبوطة على All bold أو Normal بمظهرها.

لمن يبني التدفقات: نتائج الطباعة وأرقام المشترين

يضيف الإجراء meta.thermalPrintResult.success، مع خطأ أو رمز عند الفشل، لتستخدمها الخطوات اللاحقة. يعني النجاح إرسال المهمة إلى Windows، ولا يثبت خروج الورق. افحص طابور الطباعة في Windows قبل إعادة المحاولة لتجنب الملصقات المكررة.

يرقّم Counter المشتريات لا المشترين الفريدين. لإعطاء كل مشتريات الشخص الرقم نفسه، تحتاج قائمة مستقلة تربط المشتري برقمه، تُصفّر في بداية كل بث. حقل السبب في User Memory نص عادي، وليس عداد أرقام مشترين.

ملصقات عناصر Whatnot

تنزيل تدفق Whatnot النموذجي. يطبع اسم المشتري بخط عريض واسم العنصر ومعرّف الطلب إن توفر. وإذا فشل الدفع، يطبع ملصقاً منفصلاً بعنوان فشل الدفع مع التفاصيل المتاحة في ذلك الإشعار.

في التطبيق المستقل، أعدّ التحكم في الطابعة (Printer Control) وشغّل طباعة الاختبار.
افتح محرر Event Flow، انقر على استيراد (Import)، واختر الملف المنزّل.
اختر Whatnot: ملصقات العناصر + تحذيرات الدفع. افحص إجرائي الطباعة كليهما. يستخدمان طابعة Printer Control وطول الملصق المحدد فيها.
فعّل التدفق واحفظه. يُستورد وهو معطل.
أبقِ مصدر Whatnot مفتوحاً مع تفعيل التقاط أحداث البث.

ملصق البيع لا يعني تأكيد الدفع. يُطبع كل إشعار عند وصوله. لا ينتظر التدفق الدفع ولا يصحح ملصقاً سابقاً ولا يوزع أرقام المشترين. تُطبع الحقول الناقصة فارغة. إشعار فشل بلا تفاصيل المشتري أو العنصر أو الطلب لا يحدد الملصق المرتبط به.

كيف يعمل التدفق النموذجي

يستخدم نوع الحدث (متقدم) → حدث مخصص (Event Type (Advanced) → Custom Event) لـ product_sold و payment_failed، مع ترشيح Whatnot. لا تُطبع المزايدات وإشعارات انتهاء المزاد. راجع حقول أحداث Whatnot.

اختر الورق

بكرة إيصالات

لقسائم الشراء وتذاكر الطوابير والإيصالات بأي طول. اترك طول الملصق الثابت على 0.

بكرة ملصقات مستمرة

لشرائط الأسماء اللاصقة بأي طول. تعمل مثل ورق الإيصالات، لكن الطابعة أو برنامج التشغيل يجب أن يتولى القطع.

ملصقات مقصوصة مسبقًا

للشارات وملصقات المنتجات المتطابقة. حدد الطول الثابت بدقة واختر نوع الورق نفسه في تفضيلات الطباعة في Windows.

بطاقة شراء

المشتري #12

Inky
كوب Ninja أزرق

ورق إيصالات 58 مم. يزداد الطول مع النص.

شكرًا لك

INKY

$25.00 CAD

ملصق مقصوص مسبقاً بحجم ثابت: الاسم والتبرع.

استلام

A-037

سترة Ninja بغطاء رأس
مقاس L

ملصق بضائع أو استلام يستخدم تفاصيل الحدث وعداداً.

أمثلة للطابعات

الطابعة	مناسب لـ	ملاحظات
طابعة «POS-58» عامة	إيصالات 58 مم اقتصادية	عادةً USB. تختلف الأسماء وبرامج التشغيل بحسب البائع. استُخدمت POS-58 بسيطة لاختبار Social Stream.
Epson TM-T20III	طابعة إيصالات أكثر متانة	USB. ورق 80 مم، أو 58 مم بالمحوّل المرفق.
Brother QL-800	ملصقات وشارات أسماء	USB. حتى 62 مم، ورق مقصوص أو متصل، مع قاطع تلقائي.
Brother QL-820NWB	محطة ملصقات مشتركة أو شبكية	USB وEthernet وWi-Fi وBluetooth.
Zebra ZD220	ملصقات أوسع للمنتجات أو الشحن أو الأساور	USB. وسائط بعرض نحو 25–112 مم. تتوفر نسخ حرارية مباشرة ونسخ نقل حراري.

هذه أمثلة وليست قائمة مختبرة. قبل الشراء، تحقق من أن الطراز المحدد لديه برنامج تشغيل Windows حديث، ويدعم حجم ملصقاتك، ويظهر كطابعة Windows عادية.

ضبط الملصقات ذات الحجم الثابت

ملصقات 3 × 1 بوصة (بما فيها Munbyn BT320): اضبط العرض إلى 76.2 مم والطول الثابت إلى 25.4 مم عندما يدخل جانب البوصة الواحدة أولاً. اختر الورق والاتجاه نفسيهما في تفضيلات طباعة Windows. ابدأ بخط 12–14 نقطة.

القاعدة	السبب
قِس في اتجاه تغذية الورق	الملصق 62 × 29 مم يكون عادةً بعرض 62 مم وطول ثابت 29 مم.
طابق إعدادات Windows أيضاً	اضبط نوع الورق واتجاهه واستشعار الفجوة/العلامة والقاطع بالقيم نفسها في تفضيلات طباعة برنامج التشغيل.
الطول الثابت يبقى ثابتاً	لا تضاف تغذية ورق إضافية. قد يُقص النص الأطول من الملصق أو يمتد إلى التالي بحسب برنامج التشغيل.
اختبر أطول نص لديك	تحتاج الأسماء الطويلة وخيارات المنتج والأسطر الإضافية مساحة أكبر أو نصاً أصغر.
قد لا تعمل الملصقات القصيرة جداً	يطلب Social Stream طولاً لا يقل عن 20 مم. قد يظل برنامج التشغيل يقيّد أحجام الصفحات القصيرة.

توضح الحدود الجانبية في طباعة الاختبار العرض الآمن. ويتبع الارتفاع نص الاختبار، ولا يحدد إطار الملصق كله.

أفكار للبث

ملصقات أسماء الداعمين لجدار أو مجسّم أو خريطة أو لوحة تقدم.
بطاقات بضائع أو تكليفات أو مشروبات أو استلام عند وصول الطلبات.
تذاكر سحب. أضف حدود المعدل وفحوص الأهلية قبل خطوة الطباعة.
شارات VIP أو اختيارات الفرق أو رموز التحديات أو ملصقات الإنجازات.
قائمة مهام قصيرة لمنتج يجلس بجوارك.

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

حل المشكلات

المشكلة	جرّب هذا
لا تظهر أي طابعة	تأكد من أن Windows يستطيع طباعة صفحة اختبار. أعد تشغيل Social Stream وانقر Find printers مجدداً.
يبلغ عن النجاح لكن لا يطبع شيئاً	افتح طابور الطابعة في Windows. ابحث عن توقف مؤقت أو عدم اتصال أو أخطاء الورق أو برنامج التشغيل أو المنفذ.
إحدى الحواف مقصوصة	أبقِ Use printable area مفعلاً. زد الهامش الآمن في ذلك الجانب.
ورق فارغ أكثر من اللازم	استخدم طولاً ثابتاً 0 للإيصالات. قلل الهامش السفلي والتغذية الإضافية. للملصقات، حدد الطول الدقيق.
يُطبع الملصق على ورقتين	النص أطول من الملصق أو حجم الورق في Windows غير صحيح. استخدم نصاً أقل أو خطاً أصغر أو تباعداً أضيق أو هوامش أصغر.
Test Flow يستخدم طابعة غير صحيحة	حدد طابعة بديلة في خطوة Print Thermal Label. عند تركها فارغة، يستخدم الاختبار في المحرر طابعة Windows الافتراضية.