# إضافات الطباعة والتخصيص للمنتجات المطبوعة والمخصّصة

**الفئة:** المنتجات  ·  **أدنى خطة:** Pro  ·  **القسم:** أدوات الإدارة

أداة **إضافات الطباعة والتخصيص** تضع في صفحة المنتج حقولاً يملؤها الزبون قبل أن يطلب: نص قصير للاسم المراد طباعته، أو نص طويل لرسالة هدية، أو خانة لرفع الصورة المراد طباعتها. يمكن أن يحمل الحقل سعراً إضافياً بالدينار، وتصلك كل إجابة، بما فيها الصورة، في صفحة الطلب. هكذا يأخذ محل الطباعة أو بائع الهدايا المخصّصة الطلب كاملاً في خطوة واحدة، دون أن يعاود الاتصال بالزبون ليطلب منه الصورة.

## شرح بالفيديو[​](#شرح-بالفيديو "رابط مباشر إلى شرح بالفيديو")

[إضافات الطباعة والتخصيص للمنتجات المطبوعة والمخصّصة](https://www.youtube-nocookie.com/embed/78tj1zrwClo)

## ما يمكنك أن تطلبه من الزبون[​](#ما-يمكنك-أن-تطلبه-من-الزبون "رابط مباشر إلى ما يمكنك أن تطلبه من الزبون")

لكل منتج قائمة حقوله الخاصة، وكل حقل من أحد ثلاثة أنواع:

| نوع الحقل                  | ما يظهر للزبون                                              | الإعدادات                                                |
| -------------------------- | ----------------------------------------------------------- | -------------------------------------------------------- |
| **نص قصير (سطر واحد)**     | خانة من سطر واحد، مثلاً للاسم المراد طباعته على كوب         | النص التوضيحي، الحد الأقصى للأحرف، السعر الإضافي، إجباري |
| **نص طويل (متعدد الأسطر)** | خانة من ثلاثة أسطر، مثلاً لرسالة بطاقة هدية                 | النص التوضيحي، الحد الأقصى للأحرف، السعر الإضافي، إجباري |
| **رفع صورة**               | منطقة رفع يختار فيها الزبون صورة ويرى معاينتها مع زر لحذفها | السعر الإضافي، إجباري                                    |

* **نص توضيحي (اختياري)** يظهر داخل الخانة الفارغة كتوجيه، مثلاً "اكتب الاسم المراد طباعته".
* **الحد الأقصى للأحرف** يوقف الخانة عند هذا الطول. اتركه فارغاً لعدم التحديد.
* **سعر إضافي (اختياري)** بالدينار يظهر بجانب عنوان الحقل في صفحة المنتج، مثلاً +200 دج.
* **حقل إجباري** يضيف نجمة إلى العنوان، ولا يستطيع الزبون أن يطلب حتى يملأ الحقل.

حقل رفع الصورة يقبل ملفات `JPG` و`PNG` و`GIF` و`WEBP` حتى `5 MB`. يُحفظ الملف كما أرسله الزبون، دون ضغط ولا تغيير في الصيغة، فتطبع الصورة الأصلية.

## طريقة الإعداد[​](#طريقة-الإعداد "رابط مباشر إلى طريقة الإعداد")

1. افتح **لوحة التحكم → الإضافات**. في قسم **أدوات الإدارة**، اضغط **إدارة الإضافات** على بطاقة **إضافات الطباعة والتخصيص**.
2. تعرض الصفحة منتجاتك النشطة. كل بطاقة تُظهر عدد الحقول وشارة **مفعّل** أو **معطّل**.
3. على المنتج الذي تريده، اضغط **إدارة الإضافات**، ثم **إضافة حقل جديد**.
4. اكتب **عنوان الحقل**، وهو السؤال الذي يقرؤه الزبون، واختر **نوع الحقل**، واضبط الخيارات التي تحتاجها، ثم اضغط **حفظ**.
5. عد إلى بطاقة المنتج واضغط زر التفعيل بجانب **إدارة الإضافات**. تتحول الشارة إلى **مفعّل** وتظهر الحقول في متجرك.

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

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

## ما يراه الزبون[​](#ما-يراه-الزبون "رابط مباشر إلى ما يراه الزبون")

في صفحة المنتج، تظهر الحقول في قسم بعنوان **خيارات التخصيص**، كل حقل بعنوانه، ونجمة إن كان إجبارياً، وسعره الإضافي. السعر المعروض في الصفحة يرتفع بمجرد أن يملأ الزبون حقلاً مدفوعاً، وينزل من جديد إن أفرغه.

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

## كيف يُحسب السعر الإضافي[​](#كيف-يُحسب-السعر-الإضافي "رابط مباشر إلى كيف يُحسب السعر الإضافي")

يُحتسب السعر الإضافي فقط عندما يملأ الزبون ذلك الحقل. الحقل الاختياري الذي يبقى فارغاً لا يضيف شيئاً.

السعر الإضافي يُضاف إلى سعر القطعة الواحدة: إذا طلب الزبون 2 كوب مع اسم مدفوع، يدفعه مرتين. وعندما يختار الزبون عرض كمية، يُضاف مرة واحدة إلى سعر العرض.

المبلغ يُؤخذ دائماً من الحقل كما حفظته أنت، لا مما عرضته صفحة الزبون.

## أين تقرأ الإجابات[​](#أين-تقرأ-الإجابات "رابط مباشر إلى أين تقرأ الإجابات")

افتح الطلب من **الطلبات**. تحت كل سطر منتج، تعرض صفحة الطلب عنوان كل حقل مع إجابة الزبون: النص كما كتبه، أو صورة مصغّرة للصورة المرفوعة. اضغط على الصورة المصغّرة للحصول على ملف الصورة الأصلي. ويظهر في الحقل المدفوع سعره الإضافي بين قوسين، مثلاً (+200 دج).

## كم تكلف[​](#كم-تكلف "رابط مباشر إلى كم تكلف")

ليس لأداة إضافات الطباعة والتخصيص رسوم خاصة بها: هي جزء من خطط Pro وUnlimited وEnterprise. في الخطة المجانية، تعرض البطاقة شارة **PRO** وزر **الترقية إلى Pro** الذي يفتح صفحة الاشتراك. اطلع على [خطة Pro](https://dzbuild.com/ar/ar/docs/plans/pro.md).

الأسعار الإضافية التي تحددها جزء من مجموع الطلب، يدفعها الزبون مثل ثمن المنتج نفسه.

## للمطوّرين[​](#للمطوّرين "رابط مباشر إلى للمطوّرين")

يمكن أيضاً قراءة الحقول واستبدالها عبر DZBuild API. مفتاح API الشخصي من **لوحة التحكم → الإعدادات → واجهة API** يحتاج خطة Enterprise نشطة ويحمل النطاقين أدناه افتراضياً، أما التطبيقات فتتبع [قواعد الوصول](https://dzbuild.dev/concepts) الخاصة بها.

| النقطة                          | النطاق           | ما تفعله                                                                     |
| ------------------------------- | ---------------- | ---------------------------------------------------------------------------- |
| `GET /v1/products/{id}/addons`  | `products:read`  | تُرجع حقول المنتج ومفتاح تشغيلها، `enabled`                                  |
| `POST /v1/products/{id}/addons` | `products:write` | تستبدل كل حقول المنتج بالقائمة المرسلة (20 على الأكثر) ويمكنها ضبط `enabled` |

أضف اسماً إجبارياً بسعر 200 دج إلى المنتج 42 وفعّل حقوله:

```
curl -X POST https://api.dzbuild.app/v1/products/42/addons \

  -H "Authorization: Bearer $DZBUILD_API_KEY" \

  -H "Idempotency-Key: product-42-addons-1" \

  -H "Content-Type: application/json" \

  -d '{"enabled": true, "addons": [{"title": "Name to print", "input_type": "text", "max_length": 20, "extra_price": 200, "is_required": true}]}'
```

كل طلب `POST` يحتاج ترويسة `Idempotency-Key`، وإرسال `"addons": []` يحذف كل الحقول. [صفحة المنتجات في API](https://dzbuild.com/ar/ar/api-docs/resources/products.md) تعرض كل الحقول، مع أمثلة الردود ورموز الأخطاء.

## أسئلة شائعة[​](#أسئلة-شائعة "رابط مباشر إلى أسئلة شائعة")

**هل يمكن أن يكون للمنتج الواحد عدة حقول؟** نعم. اجمع بينها كما تحتاج، مثلاً خانة لرفع الصورة ونص قصير للاسم على الكوب نفسه. صفحة المنتج تعرضها بالترتيب الذي حددته.

**هل تظهر الحقول في صفحات الهبوط؟** لا. تظهر في صفحة المنتج في متجرك فقط. الطلب الذي يأتي من صفحة هبوط لا يجمعها.

**عدّلت حقلاً أو حذفته. ماذا يحدث للطلبات السابقة؟** لا يتغير فيها شيء. كل طلب يحتفظ بعنوان الحقل والإجابة والسعر الإضافي كما كانت عندما طلب الزبون.

**هل يمكن للزبون أن يرسل ملف `PDF` أو نوعاً آخر من الملفات؟** لا. حقل الرفع يقبل الصور فقط: `JPG` و`PNG` و`GIF` و`WEBP`، حتى `5 MB`.