TutuDocs · مكوّن قابل للتضمين

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

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

جرّبه مباشرةً عرض الكود إنشاء مفتاح (بلا مراجعة)
انسخ والصق — قبل وسم </body> صفحتك 
<script src="https://tutudocs.com/embed.js"
        data-key="pk_live_YOUR_KEY"
        data-mount="#tutudocs-editor" defer></script>

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

جرّبه مباشرةً

انقر الزر أدناه لتجربة محرّر المستندات المُضمَّن هنا مباشرةً.

‏JS API (لدوال الاستدعاء / التخصيص)

<script src="https://tutudocs.com/embed.js"></script>
<script>
  const editor = TutuDocs.mount('#tutudocs-editor', {
    key: 'pk_live_YOUR_KEY',
    theme: 'auto',            // auto | light | dark
    onSave: (file) => {
      // file.dataUrl = the exported Word document (.docx, base64)
      upload(file.dataUrl);
    }
  });
  // After the user clicks Done, onSave returns the .docx; or call it directly:
  // const { dataUrl } = await editor.export();
</script>

إعدادات المعطيات الكاملة

المعطىالنوعالوصف
keystringمفتاحك العام pk_ (يُنشأ في لوحة التحكم). مطلوب.
theme'auto'|'light'|'dark'السمة؛ يتبع auto وضع الفاتح/الداكن للمضيف/النظام.
saveTextstringنص زر «تم» (الافتراضي «إنهاء وإرجاع»، ≤16 حرفًا). يظهر في الشريط العلوي الأصلي للمحرّر (بجوار مشاركة/السجل).
hideSuitebooleanإخفاء مشغّل الحزمة (مخفي افتراضيًا عند التضمين لتقليل التشتيت).

الطرق

  • editor.export()صدّر المستند الحالي بصيغة .docx ‏→ Promise<{dataUrl,mime,size}>.
  • editor.setTheme('dark')تبديل السمة أثناء التشغيل.
  • editor.destroy()إزالة المكوّن (يزيل iframe).

دوال استدعاء الأحداث

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

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

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