Course Tool Plugins

Τα πρόσθετα εργαλείων μαθήματος προσθέτουν νέα εργαλεία στην αρχική σελίδα του μαθήματος δίπλα στα ενσωματωμένα εργαλεία όπως τα Documents, Exercises και Forums.

Πώς Λειτουργούν τα Πρόσθετα Εργαλείων Μαθήματος

Όταν ένα πρόσθετο καταχωρείται ως εργαλείο μαθήματος:

1. Εμφανίζεται στη μπάρα εργαλείων της αρχικής σελίδας του μαθήματος

2. Οι διδάσκοντες μπορούν να το εμφανίζουν/να το αποκρύπτουν όπως οποιοδήποτε άλλο εργαλείο

3. Κάνοντας κλικ στο εργαλείο ανοίγει η διεπαφή του πρόσθετου στο πλαίσιο του μαθήματος

Καταχώριση ως Εργαλείο Μαθήματος

Στην κλάση του πρόσθετου σας, ορίστε $isCoursePlugin = true. Για να προστεθεί αυτόματα εικονίδιο εργαλείου στην αρχική σελίδα του μαθήματος, ορίστε επίσης $addCourseTool = true:

class MyToolPlugin extends Plugin
{
    protected function __construct()
    {
        parent::__construct('1.0', 'Author');
        $this->isCoursePlugin = true;
        $this->addCourseTool = true;
    }
}

Ρυθμίσεις Ανά Μάθημα

Ορίστε πεδία ρυθμίσεων επιπέδου μαθήματος μέσω της ιδιότητας $course_settings:

public array $course_settings = [
    ['name' => 'my_plugin_enabled', 'type' => 'checkbox', 'default' => false],
    ['name' => 'my_plugin_limit',   'type' => 'text',     'default' => '10'],
];

Αυτά εμφανίζονται στον πίνακα ρυθμίσεων του μαθήματος και μπορούν να επικυρωθούν με την επανεγγραφή της validateCourseSetting(string $variable) (επιστροφή false για απόρριψη τιμής) ή να επεξεργαστούν μέσω της course_settings_updated(array $values).

Εγκατάσταση και Απεγκατάσταση

Για να καταχωρηθούν τα πεδία του πρόσθετου σε όλα τα υπάρχοντα μαθήματα κατά την εγκατάσταση:

public function install(): void
{
    $this->install_course_fields_in_all_courses(add_tool_link: true);
}

Για εγκατάσταση σε ένα μόνο μάθημα (π.χ. όταν δημιουργείται νέο μάθημα):

$this->course_install(courseId: $courseId, addToolLink: true);

Για αφαίρεση πεδίων από συγκεκριμένο μάθημα:

$this->uninstall_course_fields(courseId: $courseId);

Σημεία Ενσωμάτωσης

Τα πρόσθετα εργαλείων μαθήματος ενσωματώνονται μέσω:

• LegacyPluginCourseTool (src/CoreBundle/Tool/LegacyPluginCourseTool.php) — Καταχωρεί το πρόσθετο ως εργαλείο στο μάθημα

• CToolStateProvider (src/CoreBundle/State/CToolStateProvider.php) — Καθορίζει ποια εργαλεία (συμπεριλαμβανομένων των εργαλείων πρόσθετων) εμφανίζονται στην αρχική σελίδα του μαθήματος

• Το εργαλείο εμφανίζεται στη συλλογή CTool για το μάθημα

Πλαίσιο Μαθήματος

Όταν ένας μαθητής κάνει κλικ στο εργαλείο του πρόσθετου σας, ο κώδικας του πρόσθετου εκτελείται στο πλαίσιο του μαθήματος. Μπορείτε να έχετε πρόσβαση σε:

• Το τρέχον μάθημα (μέσω api_get_course_id() ή του αποθηκευτικού χώρου αιτήματος CID)

• Την τρέχουσα συνεδρία (αν υπάρχει)

• Τον τρέχοντα χρήστη

• Ρυθμίσεις πρόσθετου επιπέδου μαθήματος

Παραδείγματα

Ενσωματωμένα πρόσθετα εργαλείων μαθήματος:

• BigBlueButton (Bbb/) — Βιντεοδιάσκεψη εντός μαθημάτων

• Zoom (Zoom/) — Συναντήσεις Zoom εντός μαθημάτων

• OnlyOffice (Onlyoffice/) — Επεξεργασία εγγράφων εντός μαθημάτων