# Custom Actions

بالإضافة إلى عمليات CRUD القياسية، يحتوي Chamilo على عدد من متحكمات إجراءات API المخصصة (بالعشرات) التي تتعامل مع عمليات متخصصة. يختلف العدد الدقيق بين الإصدارات — قم بسرد `src/CoreBundle/Controller/Api/` للحصول على المجموعة الحالية.

## الموقع

تقع الإجراءات المخصصة في `src/CoreBundle/Controller/Api/`.

## الإجراءات المخصصة البارزة

### المستندات

| المتحكم                           | الغرض                                         |
| --------------------------------- | --------------------------------------------- |
| `CreateDocumentFileAction`        | رفع ملف أو إنشاء مجلد/رابط مستند              |
| `UpdateDocumentFileAction`        | استبدال ملف المستند                           |
| `ReplaceDocumentFileAction`       | استبدال ملف مستند مع الحفاظ على معرفاته       |
| `MoveDocumentAction`              | نقل مستند إلى مجلد مختلف                      |
| `UpdateVisibilityDocument`        | تبديل رؤية المستند للمتعلمين                  |
| `DownloadAllDocumentsAction`      | تنزيل جميع المستندات في مجلد كملف ZIP         |
| `DownloadSelectedDocumentsAction` | تنزيل مجموعة مختارة من المستندات كملف ZIP     |
| `DocumentUsageAction`             | سرد الدورات/الجلسات التي يُستخدم فيها المستند |
| `DocumentLearningPathUsageAction` | سرد مسارات التعلم التي يُستخدم فيها المستند   |

### المصطلحات

| المتحكم                           | الغرض                                      |
| --------------------------------- | ------------------------------------------ |
| `CreateCGlossaryAction`           | إنشاء مصطلح مصطلحات                        |
| `UpdateCGlossaryAction`           | تحديث مصطلح مصطلحات                        |
| `ExportCGlossaryAction`           | تصدير المصطلحات إلى ملف                    |
| `ImportCGlossaryAction`           | استيراد المصطلحات من ملف                   |
| `ExportGlossaryToDocumentsAction` | تصدير المصطلحات كمستند في الدورة           |
| `GetGlossaryCollectionController` | الحصول على مجموعة المصطلحات مع تصفية مخصصة |

### الروابط

| المتحكم                        | الغرض                                         |
| ------------------------------ | --------------------------------------------- |
| `CreateCLinkAction`            | إنشاء رابط خارجي                              |
| `UpdateCLinkAction`            | تحديث رابط خارجي                              |
| `CreateCLinkCategoryAction`    | إنشاء فئة روابط                               |
| `UpdateCLinkCategoryAction`    | تحديث فئة روابط                               |
| `CheckCLinkAction`             | التحقق من إمكانية الوصول إلى عنوان URL للرابط |
| `ExportCLinksAction`           | تصدير الروابط إلى ملف                         |
| `CLinkDetailsController`       | الحصول على تفاصيل الرابط                      |
| `CLinkImageController`         | الحصول على صورة معاينة الرابط أو تعيينها      |
| `GetLinksCollectionController` | الحصول على مجموعة الروابط مع تصفية مخصصة      |
| `UpdateVisibilityLink`         | تبديل رؤية الرابط                             |
| `UpdateVisibilityLinkCategory` | تبديل رؤية فئة الروابط                        |
| `UpdatePositionLink`           | إعادة ترتيب الروابط                           |

### مسارات التعلم

| المتحكم               | الغرض                         |
| --------------------- | ----------------------------- |
| `CreateCLpAction`     | إنشاء مسار تعلم               |
| `LpReorderController` | إعادة ترتيب عناصر مسار التعلم |

### التقويم

| المتحكم                            | الغرض                       |
| ---------------------------------- | --------------------------- |
| `UpdateCCalendarEventAction`       | تحديث حدث تقويم الدورة      |
| `CalendarMyStudentsScheduleAction` | الحصول على جدول طلاب المعلم |

### المدونة

| المتحكم                      | الغرض                  |
| ---------------------------- | ---------------------- |
| `CreateCBlogAction`          | إنشاء منشور مدونة      |
| `CreateBlogAttachmentAction` | إرفاق ملف بمنشور مدونة |
| `UpdateVisibilityBlog`       | تبديل رؤية المدونة     |

### صندوق الإرسال

| المتحكم                   | الغرض                                          |
| ------------------------- | ---------------------------------------------- |
| `CreateDropboxFileAction` | رفع ملف إلى صندوق الإرسال (أداة تبادل الملفات) |

### أعمال الطلاب (الواجبات)

| المتحكم                                        | الغرض                 |
| ---------------------------------------------- | --------------------- |
| `CreateStudentPublicationFileAction`           | تقديم ملف واجب        |
| `CreateStudentPublicationCommentAction`        | إضافة تعليق إلى تقديم |
| `CreateStudentPublicationCorrectionFileAction` | رفع ملف تصحيح لتقديم  |

### الملفات الشخصية

| المتحكم                    | الغرض                                      |
| -------------------------- | ------------------------------------------ |
| `CreatePersonalFileAction` | رفع ملف إلى مساحة الملفات الشخصية للمستخدم |
| `UpdatePersonalFileAction` | تحديث ملف شخصي                             |

### الاجتماعي

| المتحكم                                | الغرض                                                |
| -------------------------------------- | ---------------------------------------------------- |
| `LikeSocialPostController`             | الإعجاب بمنشور اجتماعي                               |
| `DislikeSocialPostController`          | إلغاء الإعجاب بمنشور اجتماعي                         |
| `CreateSocialPostAttachmentAction`     | إرفاق ملف بمنشور اجتماعي                             |
| `SocialPostAttachmentsController`      | سرد الملحقات على منشور اجتماعي                       |
| `AbstractFeedbackSocialPostController` | الفئة الأساسية لإجراءات تعليقات المنشورات الاجتماعية |

### الجلسات

| المتحكم                                  | الغرض                                             |
| ---------------------------------------- | ------------------------------------------------- |
| `CreateSessionWithUsersAndCoursesAction` | إنشاء جلسة وتسجيل مستخدمين ودورات في مكالمة واحدة |

### المستخدمون وروابط الوصول

| المتحكم                       | الغرض                            |
| ----------------------------- | -------------------------------- |
| `CreateUserOnAccessUrlAction` | إنشاء مستخدم وربطه برابط وصول    |
| `UserAccessUrlsController`    | سرد روابط الوصول التابعة لمستخدم |
| `UserSkillsController`        | سرد المهارات الممنوحة لمستخدم    |

### مؤتمرات الفيديو

| المتحكم                             | الغرض                                                             |
| ----------------------------------- | ----------------------------------------------------------------- |
| `VideoConferenceCallbackController` | التعامل مع الاستدعاءات المرتدة من مزودي مؤتمرات الفيديو الخارجيين |

### الفئات الأساسية

| الفئة                    | الغرض                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------- |
| `BaseResourceFileAction` | الفئة الأساسية لإجراءات رفع الملفات؛ تتعامل مع تحليل multipart، إنشاء عقدة المورد، والتخزين |

***

***

## تنفيذ إجراء مخصص

الإجراءات المخصصة هي وحدات تحكم Symfony قياسية يتم الإشارة إليها في تعريفات عمليات API Platform. يوجد سمة `#[ApiResource]` على **الكيان**، ويشير معامل `controller:` لكل عملية إلى فئة الإجراء:

```php
// On the entity class (e.g. src/CourseBundle/Entity/CDocument.php):
#[ApiResource(
    shortName: 'Document',
    operations: [
        new Post(
            controller: CreateDocumentFileAction::class,
            deserialize: false,
        ),
        new Put(
            uriTemplate: '/documents/{iid}/move',
            controller: MoveDocumentAction::class,
            deserialize: false,
        ),
    ]
)]
class CDocument extends AbstractResource { ... }
```

فئة الإجراء نفسها هي وحدة تحكم قابلة للاستدعاء عادية — يتم حقن الخدمات عبر معاملات طريقة `__invoke()`:

```php
namespace Chamilo\CoreBundle\Controller\Api;

use Chamilo\CourseBundle\Entity\CDocument;
use Symfony\Component\HttpFoundation\Request;

final class CreateDocumentFileAction extends BaseResourceFileAction
{
    public function __invoke(
        Request $request,
        CDocumentRepository $repo,
        // ... other injected services
    ): CDocument {
        // Handle the upload and return the entity
    }
}
```

نقاط رئيسية:

* يتم تعيين `deserialize: false` عندما يقرأ الإجراء الطلب مباشرة (مثل تحميلات الملفات متعددة الأجزاء) بدلاً من السماح لـ API Platform بتحليل جسم JSON.
* عادةً ما تمتد إجراءات تحميل الملفات من `BaseResourceFileAction`، والتي تتعامل مع تحليل متعدد الأجزاء وربط عقدة المورد.
* يتم فرض الأمان عبر معامل `security:` على العملية، وليس داخل وحدة التحكم.


---

# 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-almtwr/developer-guide/api/custom-actions.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.