Instalacja wtyczki Integracja Credentium® dla Moodle

Ten przewodnik przeprowadzi Cię przez instalację i konfigurację wtyczki Integracja Credentium® dla Moodle.

Zanim zaczniesz

Wymagania wstępne

1. Moodle 4.5 lub wyższy zainstalowany i działający
2. PHP 7.4 lub wyższy (zalecane PHP 8.0+)
3. Dostęp administratora witryny do instalacji Moodle
4. Konto Credentiumz:
   • URL API (np. https://issuer.credentium.com/api)
   • Klucz API (format: cred_xxxxx.yyyyy)
   • Co najmniej jednym aktywnym szablonem poświadczenia

Weryfikacja wymagań

1. Sprawdź wersję Moodle: Administracja witryny > Powiadomienia
2. Sprawdź wersję PHP: Administracja witryny > Serwer > Informacje o PHP
3. Upewnij się, że cron działa: Administracja witryny > Serwer > Zaplanowane zadania

Pobieranie wtyczki

Z GitHub Releases

1. Przejdź do GitHub Releases
2. Pobierz najnowszy plik local_credentium-X.Y.Z.zip
3. Zweryfikuj pobranie używając dostarczonych sum kontrolnych (SHA256/MD5)

Metody instalacji

Metoda 1: Instalacja przez interfejs webowy

1. Zaloguj się do Moodle jako administrator witryny
2. Przejdź do Administracja witryny > Wtyczki > Instaluj wtyczki
3. Przeciągnij i upuść plik ZIP lub kliknij Wybierz plik, aby go wybrać
4. Kliknij Instaluj wtyczkę z pliku ZIP
5. Przejrzyj wyniki walidacji wtyczki
6. Kliknij Kontynuuj, aby przejść do instalacji
7. Przejrzyj informacje o aktualizacji bazy danych
8. Kliknij Zaktualizuj bazę danych Moodle
9. Po zakończeniu aktualizacji kliknij Kontynuuj

Metoda 2: Instalacja z wiersza poleceń

# Przejdź do instalacji Moodle
cd /path/to/moodle

# Rozpakuj wtyczkę do katalogu local
unzip local_credentium-X.Y.Z.zip -d local/

# Uruchom skrypt aktualizacji
php admin/cli/upgrade.php

Metoda 3: Instalacja ręczna

1. Rozpakuj zawartość pliku ZIP
2. Prześlij folder credentium do {moodle}/local/
3. Upewnij się, że struktura folderów to: {moodle}/local/credentium/version.php
4. Zaloguj się jako administrator
5. Przejdź do Administracja witryny > Powiadomienia
6. Postępuj zgodnie z komunikatami aktualizacji

Konfiguracja po instalacji

Po instalacji zostaniesz przekierowany na stronę ustawień wtyczki.

Krok 1: Włącz wtyczkę

1. Przejdź do Administracja witryny > Wtyczki > Wtyczki lokalne > Integracja Credentium®
2. Zaznacz Włącz integrację Credentium, aby aktywować wtyczkę

Krok 2: Wprowadź dane API

1. Wprowadź URL API (np. https://issuer.credentium.com/api)
2. Wprowadź Klucz API (pełny klucz wraz z kropką)
3. Kliknij Zapisz zmiany

Krok 3: Przetestuj połączenie

1. Kliknij przycisk Testuj połączenie
2. Otworzy się nowe okno pokazujące wyniki połączenia
3. Zweryfikuj, że widzisz "Połączenie udane" i listę swoich szablonów

Krok 4: Skonfiguruj opcjonalne ustawienia

• Włącz tryb kategorii - Włącz, aby umożliwić oddzielne dane API dla różnych kategorii kursów. Pozwala to na wdrożenia multi-tenant, gdzie różne wydziały lub programy mogą korzystać z własnych kont organizacji Credentium.
• Włącz logowanie debugowania - Włącz tymczasowo do rozwiązywania problemów

Weryfikacja instalacji

Sprawdź status wtyczki

1. Przejdź do Administracja witryny > Wtyczki > Przegląd wtyczek
2. Wyszukaj "Credentium® Integration"
3. Zweryfikuj, że wtyczka jest zainstalowana z prawidłową wersją

Sprawdź tabele bazy danych

Po instalacji powinny istnieć następujące tabele:

• mdl_local_credentium_issuances
• mdl_local_credentium_course_config
• mdl_local_credentium_category_config
• mdl_local_credentium_templates_cache

Sprawdź zaplanowane zadania

1. Przejdź do Administracja witryny > Serwer > Zaplanowane zadania
2. Wyszukaj "Credentium® Integration"
3. Zweryfikuj, że zadanie "Przetwarzaj oczekujące poświadczenia" jest zarejestrowane

Konfiguracja ukończenia kursu

Wtyczka wymaga śledzenia ukończenia kursu do działania.

Włącz śledzenie ukończenia dla całej witryny

1. Przejdź do Administracja witryny > Funkcje zaawansowane
2. Zaznacz Włącz śledzenie ukończenia
3. Kliknij Zapisz zmiany

Włącz ukończenie dla kursu

1. Przejdź do ustawień kursu
2. W sekcji Śledzenie ukończenia wybierz Tak
3. Ustaw kryteria ukończenia (ukończenie aktywności, ocena itp.)
4. Zapisz zmiany

Następne kroki

Po instalacji:

1. Skonfiguruj ustawienia globalne
2. Skonfiguruj pierwszy kurs
3. Przetestuj wystawianie poświadczeń

Aktualizacja wtyczki

Przed aktualizacją

1. Wykonaj kopię zapasową bazy danych Moodle
2. Sprawdź informacje o wydaniu pod kątem przełomowych zmian
3. Zweryfikuj zgodność nowej wersji z Twoją wersją Moodle

Proces aktualizacji

1. Pobierz nową wersję z GitHub Releases
2. Zastąp istniejący folder local/credentium nową wersją
3. Przejdź do Administracja witryny > Powiadomienia
4. Postępuj zgodnie z komunikatami aktualizacji bazy danych
5. Zweryfikuj, że ustawienia zostały zachowane
6. Przetestuj połączenie z API Credentium

Odinstalowywanie wtyczki

Przed odinstalowaniem

• Cała historia wystawień zostanie usunięta
• Konfiguracje kursów zostaną usunięte
• Tej operacji nie można cofnąć

Proces odinstalowania

1. Przejdź do Administracja witryny > Wtyczki > Przegląd wtyczek
2. Wyszukaj "Credentium® Integration"
3. Kliknij Odinstaluj
4. Potwierdź odinstalowanie
5. Przejrzyj, co zostanie usunięte
6. Kliknij Kontynuuj

Rozwiązywanie problemów z instalacją

"Wtyczka brakuje na dysku"

Przyczyna: Pliki nie są w prawidłowej lokalizacji

Rozwiązanie:

• Zweryfikuj, że struktura folderów to local/credentium/version.php
• Sprawdź uprawnienia plików (serwer web musi mieć dostęp do odczytu)

"Wymaga Moodle 4.5 lub wyższej"

Przyczyna: Wersja Moodle jest zbyt stara

Rozwiązanie:

• Zaktualizuj Moodle do wersji 4.5 lub wyższej
• Lub użyj starszej wersji wtyczki zgodnej z Twoim Moodle

"Walidacja wtyczki nie powiodła się"

Przyczyna: Uszkodzone pobieranie lub niekompletne rozpakowanie

Rozwiązanie:

• Pobierz wtyczkę ponownie
• Zweryfikuj sumę kontrolną
• Rozpakuj ponownie upewniając się, że nie ma błędów

Aktualizacja bazy danych kończy się niepowodzeniem

Przyczyna: Uprawnienia bazy danych lub konflikty

Rozwiązanie:

• Sprawdź, czy użytkownik bazy danych ma uprawnienia ALTER TABLE
• Przejrzyj logi błędów Moodle
• Spróbuj uruchomić aktualizację z wiersza poleceń z --verbose

Potrzebujesz pomocy?

Jeśli napotkasz problemy z instalacją, skontaktuj się z:

Wsparcie Credentium Email: support@credentium.com

Dołącz:

• Wersję Moodle
• Wersję PHP
• Komunikaty o błędach
• Kroki, które już próbowałeś

Ostatnia aktualizacja: Styczeń 2026