> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/ar/dlyl-alidarh/admin-guide/platform-settings/document-settings.md).

# المستندات

سلوك أداة **المستندات** في المقرر — التحميلات، الامتدادات المسموح بها، المشاركة، والقوالب.

يمكنك الوصول إلى هذه الإعدادات ضمن **الإدارة > إعدادات التهيئة > المستندات**. تحتوي هذه الفئة على **29 إعدادًا**، مُدرجة أدناه مع العنوان والتعليق المُشحن في تجهيزات إعدادات المنصة (`SettingsCurrentFixtures.php`).

> يظهر اسم المتغير في الشيفرة بخط أحادي المسافة. استخدمه عند البرمجة عبر واجهة API أو عندما تحتاج إلى تغيير تلك الإعدادات على المستوى العام بتحرير [`config/settings_override.yaml`](https://github.com/chamilo/chamilo-lms/wiki/Configurations#configsettings_overridesyaml).

## الإعدادات

### `access_url_specific_files`

**تمكين ملفات خاصة بعنوان URL**

عند تمكين هذه الميزة في تكوين متعدد عناوين URL، يمكنك الانتقال إلى عنوان URL الرئيسي وتوفير إصدارات خاصة بعنوان URL لأي ملف (في أداة المستندات). سيُستبدل الملف الأصلي بالبديل كلما عُرض من عنوان URL مختلف. يتيح لك ذلك تخصيص كل عنوان URL بدرجة أكبر، مع الاستفادة من إعادة استخدام المقررات نفسها مرات عديدة.

*القيمة الافتراضية: `false`*

### `default_document_quotum`

**مساحة القرص الصلب الافتراضية**

ما هي مساحة القرص المتاحة للمقرر؟ يمكنك تجاوز الحصة لمقرر معيّن عبر: إدارة المنصة > المقررات > تعديل

*القيمة الافتراضية: `1000`*

### `default_group_quotum`

**مساحة القرص المتاحة للمجموعة**

ما هي مساحة القرص الصلب الافتراضية المتاحة لأداة مستندات المجموعات؟

*القيمة الافتراضية: `250`*

### `documents_custom_cloud_link_list`

**تعيين قائمة مضيفين صارمة لروابط السحابة**

يمكن لأداة المستندات دمج روابط لملفات في السحابة. تقتصر قائمة خدمات السحابة على قائمة مضمّنة في الشيفرة، لكن يمكنك تعريف المصفوفة ‘links’ التي ستحتوي على قائمة خدمات/عناوين URL الخاصة بك. ستستبدل القائمة المعرَّفة هنا القائمة الافتراضية.

### `documents_default_visibility_defined_in_course`

**رؤية المستند معرَّفة في المقرر**

رؤية المستند الافتراضية لجميع المقررات

*القيمة الافتراضية: `false`*

### `documents_hide_download_icon`

**إخفاء أيقونة تنزيل المستندات**

في أداة المستندات، إخفاء أيقونة التنزيل عن المستخدمين.

*القيمة الافتراضية: `false`*

### `enable_x_sendfile_headers`

**تمكين ترويسات X-sendfile**

فعّل هذا إذا كان X-sendfile مفعّلًا على مستوى خادم الويب وتريد إضافة الترويسات المطلوبة لكي تلتقطها المتصفحات.

*القيمة الافتراضية: `false`*

### `group_category_document_access`

**تمكين خيارات المشاركة للمستند داخل فئة المجموعة**

عند التمكين، يمكن للمسؤولين تعيين صلاحيات الوصول والمشاركة للمستندات للمجموعات حسب الفئة.

*القيمة الافتراضية: `false`*

### `group_document_access`

**تمكين خيارات المشاركة لمستند المجموعة**

عند التمكين، يمكن تهيئة مشاركة المستندات وصلاحيات الوصول على مستوى المجموعة.

*القيمة الافتراضية: `false`*

### `pdf_export_watermark_by_course`

**تمكين تعريف العلامة المائية حسب المقرر**

عند تمكين هذا الخيار، يمكن للمعلمين تعريف علامتهم المائية الخاصة لمستندات مقرراتهم.

*القيمة الافتراضية: `false`*

### `pdf_export_watermark_enable`

**تمكين العلامة المائية في تصدير PDF**

بتفعيل هذا الخيار، يمكنك تحميل صورة أو نص يُضاف تلقائيًا كعلامة مائية إلى جميع صادرات PDF للمستندات على النظام.

*القيمة الافتراضية: `false`*

### `pdf_export_watermark_text`

**نص العلامة المائية لـ PDF**

سيُضاف هذا النص كعلامة مائية إلى صادرات المستندات بصيغة PDF.

### `permanently_remove_deleted_files`

**لا يمكن استعادة الملفات المحذوفة**

حذف ملف في أداة المستندات يحذفه نهائيًا. لا يمكن استعادة الملف

*القيمة الافتراضية: `false`*

### `permissions_for_new_directories`

**صلاحيات المجلدات الجديدة**

تتيح القدرة على تعريف إعدادات الصلاحيات المعيَّنة لكل مجلد يُنشأ حديثًا تحسين الأمان ضد هجمات المخترقين الذين يحمّلون محتوى خطيرًا إلى بوابتك. ينبغي أن يكفي الإعداد الافتراضي (0770) لمنح خادمك مستوى حماية معقولًا. يستخدم التنسيق المعطى مصطلحات UNIX لمالك-مجموعة-آخرون مع صلاحيات قراءة-كتابة-تنفيذ.

*القيمة الافتراضية: `0770`*

### `permissions_for_new_files`

**صلاحيات الملفات الجديدة**

تتيح القدرة على تعريف إعدادات الصلاحيات المعيَّنة لكل ملف يُنشأ حديثًا تحسين الأمان ضد هجمات المخترقين الذين يحمّلون محتوى خطيرًا إلى بوابتك. ينبغي أن يكفي الإعداد الافتراضي (0550) لمنح خادمك مستوى حماية معقولًا. يستخدم التنسيق المعطى مصطلحات UNIX لمالك-مجموعة-آخرون مع صلاحيات قراءة-كتابة-تنفيذ. إذا كنت تستخدم Oogie، فاحرص على أن يتمكن المستخدم الذي يشغّل LibreOffice من كتابة الملفات في مجلد المقرر.

*القيمة الافتراضية: `0660`*

### `send_notification_when_document_added`

**إرسال إشعار للطلاب عند إضافة مستند**

كلما أنشأ أحد عنصرًا جديدًا في أداة المستندات، أرسل إشعارًا إلى المستخدمين.

*القيمة الافتراضية: `false`*

### `show_default_folders`

**إظهار جميع المجلدات التي تحتوي على موارد الوسائط المتعددة المزوَّدة افتراضيًا في أداة المستندات**

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

*الافتراضي: `true`*

### `show_documents_preview`

**إظهار معاينة المستند**

سيؤدي إظهار معاينات المستندات في أداة المستندات إلى تجنب تحميل صفحة جديدة لمجرد عرض مستند، لكنه قد يكون غير مستقر مع بعض المتصفحات الأقدم أو الشاشات ذات العرض الأصغر.

*الافتراضي: `false`*

### `show_users_folders`

**إظهار مجلدات المستخدمين في أداة المستندات**

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

*الافتراضي: `true`*

### `students_download_folders`

**السماح للمتعلمين بتنزيل الدلائل**

السماح للمتعلمين بضغط وتنزيل دليل كامل من أداة المستندات

*الافتراضي: `true`*

### `students_export2pdf`

**السماح للمتعلمين بتصدير مستندات الويب إلى تنسيق PDF في أداتي المستندات والويكي**

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

*الافتراضي: `true`*

### `thematic_pdf_orientation`

**اتجاه PDF لتقدّم المقرر**

في أداة تقدّم المقرر، يمكنك طباعة PDF للعناصر المختلفة. عيّن ‘portrait’ أو ‘landscape’ (مصطلحات تقنية) لتغييره.

*الافتراضي: `landscape`*

### `upload_extensions_blacklist`

**القائمة السوداء - الإعداد**

تُستخدم القائمة السوداء لتصفية امتدادات الملفات بإزالة (أو إعادة تسمية) أي ملف يظهر امتداده في القائمة السوداء أدناه. يجب أن تظهر الامتدادات دون النقطة البادئة (.) ومفصولة بفاصلة منقوطة (;) مثل التالي: exe;com;bat;scr;php. تُقبل الملفات بدون امتداد. حالة الأحرف (كبيرة/صغيرة) لا تهم.

### `upload_extensions_list_type`

**نوع التصفية عند رفع المستندات**

ما إذا كنت تريد استخدام تصفية القائمة السوداء أو القائمة البيضاء. انظر وصف القائمة السوداء أو القائمة البيضاء أدناه لمزيد من التفاصيل.

*الافتراضي: `blacklist`*

### `upload_extensions_replace_by`

**امتداد الاستبدال**

أدخل الامتداد الذي تريد استخدامه لاستبدال الامتدادات الخطرة التي يكتشفها المرشح. مطلوب فقط إذا اخترت مرشحًا بالاستبدال.

*الافتراضي: `dangerous`*

### `upload_extensions_skip`

**سلوك التصفية (تخطي/إعادة تسمية)**

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

*الافتراضي: `true`*

### `upload_extensions_whitelist`

**القائمة البيضاء - الإعداد**

تُستخدم القائمة البيضاء لتصفية امتدادات الملفات بإزالة (أو إعادة تسمية) أي ملف *لا* يظهر امتداده في القائمة البيضاء أدناه. تُعتبر عمومًا نهجًا أكثر أمانًا لكنه أكثر تقييدًا للتصفية. يجب أن تظهر الامتدادات دون النقطة البادئة (.) ومفصولة بفاصلة منقوطة (;) مثل التالي: htm;html;txt;doc;xls;ppt;jpg;jpeg;gif;sxw. تُقبل الملفات بدون امتداد. حالة الأحرف (كبيرة/صغيرة) لا تهم.

### `users_copy_files`

**السماح للمستخدمين بنسخ الملفات من مقرر إلى منطقة ملفاتهم الشخصية**

يسمح للمستخدمين بنسخ الملفات من مقرر إلى منطقة ملفاتهم الشخصية، المرئية عبر الشبكة الاجتماعية أو عبر محرر HTML عندما يكونون خارج مقرر

*الافتراضي: `true`*

### `video_features`

**ميزات الفيديو**

مصفوفة من الميزات الإضافية التي يمكنك تفعيلها لمشغّل الفيديو في Chamilo. تشمل الخيارات 'speed'، التي تسمح لك بتغيير سرعة تشغيل الفيديو.