# المستندات

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

الوصول إلى هذه الإعدادات تحت **Administration > Configuration settings > Documents**. تحتوي هذه الفئة على **29 إعدادًا**، مدرجة أدناه مع العنوان والتعليق المرسل في إعدادات المنصة (`SettingsCurrentFixtures.php`).

> يتم عرض اسم المتغير في الكود بحرف monospace. استخدمه عند البرمجة عبر 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’ التي ستحتوي على قائمة خدمات/روابط خاصة بك. ستحل القائمة المعرفة هنا محل القائمة الافتراضية.

### `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 لـ Owner-Group-Others مع صلاحيات Read-Write-Execute.

*افتراضي: `0770`*

### `permissions_for_new_files`

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

القدرة على تعريف إعدادات الصلاحيات لتعيينها لكل ملف جديد تم إنشاؤه تسمح لك بتحسين الأمان ضد هجمات الهاكرز الذين يقومون بتحميل محتوى خطير إلى بوابتك. يجب أن يكون الإعداد الافتراضي (0550) كافيًا لإعطاء خادمك مستوى حماية معقول. يستخدم التنسيق المعطى مصطلحات UNIX لـ Owner-Group-Others مع صلاحيات Read-Write-Execute. إذا كنت تستخدم Oogie، تأكد من أن المستخدم الذي يقوم بتشغيل LibreOffice يمكنه كتابة الملفات في مجلد الدورة.

*افتراضي: `0660`*

### `send_notification_when_document_added`

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

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

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

***

### `show_default_folders`

**عرض جميع المجلدات التي تحتوي على موارد متعددة الوسائط مقدمة افتراضيًا في أداة المستندات**

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

*الافتراضي: `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»، والتي تتيح لك تغيير سرعة تشغيل الفيديو.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-ar/dlyl-alidarh/admin-guide/platform-settings/document-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
