TutuEdit · أداة قابلة للتضمين

سطر واحد من التعليمات البرمجية —أضف محرر صور إلى موقعك في ثوانٍ

ادمج محرر TutuEdit الاحترافي (قص / فلاتر / اقتصاص / نص) في أي موقع. يحرر الزوار الصور مباشرة على موقعك؛ اضبط السمة والأدوات، وتُطبَّق تحديثات المنتج تلقائيًا دون أي صيانة.

جرّبه مباشرة عرض كود التضمين أنشئ مفتاحًا (بدون مراجعة)

جاهز للنسخ واللصق · الصقه قبل وسم </body> في موقعك

<script src="https://tutuedit.com/embed.js"
        data-key="pk_live_YOUR_KEY"
        data-mount="#dd-editor" defer></script>

استبدل pk_live_YOUR_KEY بالمفتاح العام الذي تنشئه بنفسك في وحدة التحكم (أي مستخدم مسجّل — بدون مراجعة، فوري)؛ الحاوية #dd-editor تحتاج إلى عرض وارتفاع. عند التضمين، سجّل عناوين URL للتضمين (قائمة السماح؛ للتطوير المحلي استخدم localhost)؛ يظهر فقط على المواقع التي سجّلتها.

جرّبه مباشرة

اضغط الزر أدناه لتجربة محرر صور المضمّن مباشرة على هذه الصفحة.

JS API (لمعاودة النداء / التخصيص)

<script src="https://tutuedit.com/embed.js"></script>
<script>
  const dd = TutuEdit.mount('#dd-editor', {
    key: 'pk_live_YOUR_KEY',
    theme: 'auto',            // auto | light | dark
    onSave: (file) => {
      // file.dataUrl = الصورة المحرَّرة (base64)
      upload(file.dataUrl);
    }
  });
  dd.open('https://your.site/photo.jpg'); // فتح صورة
</script>

الإعداد الكامل

المعامل	النوع	الوصف
key	string	مفتاحك العام pk_ (المُنشأ في وحدة التحكم). مطلوب.
theme	'auto'\|'light'\|'dark'	السمة؛ auto يتبع الوضع الفاتح أو الداكن للمضيف/النظام.
hideToolbar	boolean	إخفاء شريط الأدوات الأيسر (سيناريوهات العرض المبسّط / التصدير بنقرة واحدة).
hideHeader	boolean	إخفاء الشريط العلوي (عندما تبني واجهتك الخاصة وتصدّر عبر export()).
hideOpen	boolean	إخفاء زر «Open image» (السماح بالصور فقط عبر dd.open).
hideExport	boolean	إخفاء زر «Export & download» (استخدام «Done & send back» فقط).
saveText	string	نص زر «Done» (الافتراضي «Done & send back»، ≤16 حرفًا).
exportFormat	'png'\|'jpg'\|'webp'	تنسيق التصدير عند الإكمال.
exportQuality	number 0..1	جودة JPG/WebP.

الطرق

dd.open(url, name?)فتح صورة في المحرر (url أو dataURL).
dd.export(format?, quality?)تصدير النتيجة الحالية → Promise<{dataUrl,mime,size}>.
dd.setTheme('dark')تبديل السمة أثناء التشغيل.
dd.destroy()إلغاء تحميل الأداة (يزيل iframe).

معاودات نداء الأحداث

onReady()المحرر جاهز.
onSave(file)ينقر المستخدم «Done» → file.dataUrl هو النتيجة المحرَّرة.
onError(e)e.message مفهوم للبشر (معطّل / غير مصرّح / فشل التحميل).
onClose()تم إغلاق التراكب بملء الشاشة.

الأمان · التحديثات التلقائية

· خدمة ذاتية، موافقة تلقائية: أي مستخدم مسجّل يسجّل اسم موقع + عنوان URL للتضمين في وحدة التحكم للحصول على مفتاح، يسري مفعوله فورًا.
· المفتاح العام علني؛ وهو محميّ بواسطة قوائم السماح/الحظر لعناوين URL المسجّلة ضد سوء الاستخدام (قائمة الحظر لها الأولوية)؛ تُرفض الطلبات من النطاقات غير المسجّلة مع مطالبة بالتسجيل؛ فعّل/عطّل في أي وقت.
· تحليلات المصدر الحقيقي: يُحتسب كل تحميل حسب Origin (بما في ذلك المحظورة)؛ تعرض وحدة التحكم تفصيلًا لكل مصدر، ويمكن إضافة النطاقات غير المسجّلة إلى قائمة السماح بنقرة واحدة.
· يعمل المحرر على نطاق TutuEdit الخاص (معزول)؛ لا يمكن لصفحتك الوصول إلى أي بيانات اعتماد لـ TutuEdit، ولا تظهر أعمال الزوار الخاصة في TutuEdit داخل الأداة أبدًا.
· الأداة مستضافة ذاتيًا ومحدَّثة تلقائيًا بواسطة TutuEdit — لا تتطلب ترقيات الميزات أي تغييرات في الكود من جانبك، صيانة صفرية.