Integracja Credentium® - Przegląd wtyczki dla Moodle

Ten artykuł zawiera przegląd wtyczki Integracja Credentium® dla Moodle, jej funkcji i sposobu integracji z systemem zarządzania nauczaniem Moodle.

Czym jest wtyczka Integracja Credentium®?

Integracja Credentium® (wyświetlana jako "Integracja Credentium®" w Moodle) to lokalna wtyczka integrująca Moodle z platformą cyfrowych poświadczeń Credentium. Automatycznie wystawia weryfikowalne cyfrowe poświadczenia studentom po ukończeniu kursów.

Kluczowe korzyści:

• Automatyczne wystawianie - Poświadczenia są wystawiane automatycznie po ukończeniu kursu
• Integracja ocen - Opcjonalne dołączanie ocen kursu do poświadczeń
• Wsparcie multi-tenant - Oddzielne dane API dla różnych kategorii kursów (v2.0+)
• Europejskie standardy - Wystawia poświadczenia zgodne z European Digital Credentials (EDC)

Wymagania

Wersja Moodle

• Minimum: Moodle 4.5
• Obsługiwane: Moodle 4.5 i 5.0

Wersja PHP

• Minimum: PHP 7.4
• Zalecane: PHP 8.0+

Wymagane funkcje Moodle

• Włączone śledzenie ukończenia kursów
• Regularnie działające zaplanowane zadania (cron)
• Wychodzące połączenie HTTPS do API Credentium

Wymagania Credentium

• Aktywne konto organizacji Credentium
• Dane dostępowe API (URL API i klucz API)
• Co najmniej jeden aktywny szablon poświadczenia

Aktualna wersja

Wersja: 2.0.4 Build: 2026012700 Dojrzałość: Stabilna Najnowsze wydania: GitHub Releases

Kluczowe funkcje

Automatyczne wystawianie poświadczeń

Gdy student ukończy kurs:

1. Moodle wywołuje zdarzenie ukończenia kursu
2. Wtyczka tworzy żądanie wystawienia
3. Zadanie w tle przetwarza żądanie
4. Poświadczenie jest wystawiane przez API Credentium
5. Student otrzymuje poświadczenie w swoim Portfelu Credentium

Integracja ocen

Opcjonalne dołączanie końcowej oceny kursu do poświadczenia:

• Ocena jest pobierana po zdarzeniu ukończenia
• Zaawansowana walidacja świeżości oceny zapewnia dokładność
• Obsługuje oczekiwanie na agregację dziennika ocen

Wsparcie multi-tenant (v2.0+)

Dla organizacji z wieloma działami lub programami:

• Konfiguracja oddzielnych danych API dla każdej kategorii kursów
• Każda kategoria może łączyć się z inną organizacją Credentium
• Kategorie dziedziczą ustawienia z kategorii nadrzędnych
• Limitowanie częstotliwości per kategoria

Buforowanie szablonów

Wtyczka buforuje szablony poświadczeń z Credentium:

• Zmniejsza liczbę wywołań API
• Czas buforowania: 1 godzina
• Izolacja bufora per kategoria w trybie multi-tenant

Jak to działa

Przepływ wysokopoziomowy

Student ukańcza kurs
        ↓
Moodle wywołuje zdarzenie course_completed
        ↓
Wtyczka tworzy rekord wystawienia (status: pending)
        ↓
Zadanie w tle przetwarza żądanie
        ↓
Wywołanie API do Credentium wystawia poświadczenie
        ↓
Student otrzymuje poświadczenie w Portfelu Credentium

Szczegóły przetwarzania

1. Wykrywanie zdarzenia: Wtyczka nasłuchuje zdarzenia course_completed w Moodle
2. Walidacja: Sprawdza, czy kurs jest skonfigurowany do wystawiania poświadczeń
3. Kolejkowanie: Tworzy rekord oczekujący i kolejkuje zadanie w tle
4. Obsługa ocen: Jeśli wysyłanie ocen jest włączone, czeka na agregację ocen
5. Wywołanie API: Wysyła dane użytkownika i ocenę do API Credentium
6. Aktualizacja statusu: Aktualizuje rekord wystawienia z sukcesem lub niepowodzeniem

Architektura wtyczki

Struktura plików

local/credentium/
├── classes/
│   ├── api/client.php          # Integracja API
│   ├── observer.php            # Obsługa zdarzeń
│   └── task/                   # Zadania w tle
├── db/
│   ├── install.xml             # Schemat bazy danych
│   ├── events.php              # Rejestracje zdarzeń
│   └── tasks.php               # Zaplanowane zadania
├── lang/
│   ├── en/                     # Ciągi angielskie
│   └── pl/                     # Ciągi polskie
├── settings.php                # Konfiguracja globalna
├── course_settings.php         # Konfiguracja kursu
├── category_settings.php       # Konfiguracja kategorii
├── index.php                   # Raport administracyjny
└── version.php                 # Metadane wtyczki

Tabele bazy danych

Role użytkowników i uprawnienia

Uprawnienia

Obsługiwane języki

• Angielski (en)
• Polski (pl)

Co nowego w wersji 2.0

Wsparcie multi-tenant

• Konfiguracja oddzielnych danych API dla każdej kategorii kursów
• Kursy dziedziczą ustawienia z kategorii nadrzędnych
• Limitowanie częstotliwości per kategoria
• Wstrzymywanie/wznawianie wystawień per kategoria

Ulepszona obsługa ocen

• Zaawansowana walidacja świeżości ocen
• Logika ponawiania dla opóźnień agregacji ocen
• Przechowywanie znacznika czasu ukończenia dla walidacji ocen

Ulepszenia bezpieczeństwa

• Klucze API szyfrowane w spoczynku
• Mechanizm blokady zapobiega duplikatom wystawień
• Ulepszona obsługa błędów i logowanie

Rozpoczęcie pracy

1. Zainstaluj wtyczkę - Zobacz Przewodnik instalacji
2. Skonfiguruj ustawienia globalne - Wprowadź URL API i klucz
3. Skonfiguruj kursy - Wybierz szablony poświadczeń dla każdego kursu
4. Włącz śledzenie ukończenia - Upewnij się, że kursy mają kryteria ukończenia
5. Przetestuj - Ukończ kurs, aby zweryfikować wystawianie poświadczeń

Powiązana dokumentacja

• Przewodnik instalacji
• Przewodnik konfiguracji
• Prywatność i zgodność z RODO
• Rozwiązywanie problemów

Potrzebujesz pomocy?

Jeśli masz pytania dotyczące wtyczki Integracja Credentium® dla Moodle, skontaktuj się z:

Wsparcie Credentium Email: support@credentium.com

Ostatnia aktualizacja: Styczeń 2026