Rosea Grid Course

01 / Instalacja

Rosea Grid Course (format_roseagrid) zamienia sekcje kursu w kafelki z podglądem natywnych aktywności Moodle. Jest niezależny od Video Course i nie wymaga mod_videolesson.

1. Pobierz osobną, aktualną paczkę format_roseagrid. Ta instrukcja opisuje wydanie 0.2.0-alpha; archiwum katalogu z 30 października nie zawiera tego pluginu.
2. Sprawdź version.php: obecny kod wymaga Moodle build 2026091600 lub nowszego oraz zainstalowanego formatu format_topics. To wymaganie kodu, a nie deklaracja przetestowania wszystkich nowszych wersji.
3. Jako administrator otwórz Administracja serwisu → Wtyczki → Zainstaluj wtyczki, wybierz ZIP i wykonaj kroki instalatora.
4. Przy instalacji ręcznej katalog pluginu ma trafić do course/format/roseagrid (w instalacji z katalogiem publicznym: public/course/format/roseagrid). Następnie otwórz Powiadomienia administracyjne i dokończ aktualizację.

Wydanie alpha: instalację i pierwszą konfigurację wykonaj na kopii testowej. Przed zmianą środowiska produkcyjnego zachowaj kopię bazy i moodledata.

02 / Uruchomienie kursu

1. Otwórz kurs i przejdź do Ustawienia → Format kursu.
2. Wybierz Rosea Grid Course, ustaw wygląd kart i zapisz formularz.
3. Włącz tryb edycji. Dodaj sekcje, nadaj im nazwy i umieść w nich zwykłe aktywności Moodle, np. Stronę, Plik, Folder, Quiz lub Zadanie.
4. W menu danej sekcji wybierz Edytuj sekcję, aby ustawić jej opis i okładkę.
5. Wyłącz tryb edycji, aby zobaczyć kafelki. Edycja oraz pełny widok pojedynczej sekcji korzystają z układu Topics.

Każda widoczna dla użytkownika sekcja jest modułem. Pusta sekcja ogólna bez aktywności i opisu nie otrzymuje kafelka. Ograniczenia dostępu i widoczność nadal ustawia się w standardowych formularzach Moodle.

03 / Wybór wyglądu kart

W ustawieniach kursu znajdziesz poniższe opcje formatu. Dotyczą wszystkich kart w tym kursie.

Cała karta jest jednym odnośnikiem do podglądu modułu. Zmiana układu nie zmienia aktywności, ocen ani warunków ukończenia.

04 / Zdjęcie, kolor i napis na okładce

Włącz edycję kursu, otwórz Edytuj sekcję, ustaw okładkę i zapisz. Każda sekcja ma własne ustawienia.

Zdjęcie okładki / Cover image

Wgraj jeden obraz JPG, PNG, WebP lub GIF w natywnym selektorze plików Moodle. Obraz dopasowuje się do karty i może zostać przycięty. Najważniejszy element zdjęcia warto umieścić blisko środka.

Plugin wybiera źródło w tej kolejności:

1. Plik w polu Zdjęcie okładki.
2. Obraz z pola Adres zdjęcia okładki / Cover image URL — pełny adres HTTP lub HTTPS.
3. Pierwsze zdjęcie w opisie sekcji.
4. Tło z numerem, nazwą sekcji lub bez napisu.

Aby usunąć zdjęcie, usuń je w selektorze i zapisz sekcję. Jeżeli obraz nadal się pojawia, wyczyść również adres URL i usuń pierwsze zdjęcie z opisu — może działać kolejne źródło z powyższej listy.

Kolor okładki (HEX) / Cover colour (HEX)

Kliknij pole koloru, aby użyć pickera, lub wpisz #RGB albo #RRGGBB, np. #DDE8FF. Wyczyść pole, aby przywrócić automatyczne pastelowe tło. Kolor jest widoczny, gdy karta nie ma zdjęcia.

Alpha5, Space5, XY i Monocolor5 mogą udostępniać własny picker motywu. Gdy biblioteki nie ma, plugin używa systemowego selektora koloru obok HEX oraz przycisku Automatyczny. Bez JavaScript można nadal wpisać HEX. Wygląd systemowego pickera zależy od przeglądarki.

Formaty plików

Powyższe ograniczenia dotyczą uploadu okładki. Adres URL jest renderowany jako zwykły obraz, bez odtwarzacza wideo; poprawny podgląd zależy od pliku i przeglądarki. Dodanie pliku do materiałów nie gwarantuje jego odtworzenia w przeglądarce.

Napis na okładce / Cover label

• Numer sekcji — domyślne 01, 02….
• Nazwa sekcji / Section name — automatycznie używa nazwy sekcji. Zmiana nazwy sekcji aktualizuje napis; nie ma osobnego pola tekstowego.
• Bez napisu — pozostaje zdjęcie lub samo tło, bez dodatkowej etykiety.

Każda karta pokazuje nazwę tylko raz. W układzie Klasycznym opcja Section name przenosi główny tytuł z treści na okładkę; na zdjęciu używany jest gradient. W Immersive pozostaje jeden główny tytuł na zdjęciu, bez drugiej etykiety z tą samą nazwą. Klasyczny tytuł okładki jest ograniczony wizualnie do trzech wierszy. Numer pojawia się tylko bez zdjęcia. Główny tytuł pozostaje widoczny przy opcji Bez napisu. Pole „Custom cover text” zostało usunięte. Aby zmienić napis, zmień nazwę sekcji w jej formularzu i zapisz. Przy pustej nazwie używana jest domyślna nazwa Moodle. Dawny wybór „Custom text” automatycznie korzysta z „Section name”; dawny dowolny tekst nie jest już wyświetlany. Nie trzeba ponownie wgrywać zdjęcia. Opcja „Bez napisu” dotyczy wyłącznie dodatkowej etykiety, nie tytułu karty.

05 / Otwieranie i obsługa podglądu

Wygaszenie gradientowe obejmuje zarówno zdjęcie, jak i jednolity kolor okładki. Dolna krawędź tła płynnie przechodzi do tła galerii przy 60dvh i 100dvh, niezależnie od wybranego tła panelu.

Siatka kafelków dobiera liczbę kolumn do dostępnej szerokości treści, także przy otwartej nawigacji i indeksie kursu. Preferowana minimalna szerokość karty wynosi 17,5rem; mniejszy kontener otrzymuje jedną kartę na całą szerokość. Długie tytuły zawijają się w karcie. Nie ma osobnego ustawienia liczby kolumn.

Statystyki, pasek kontynuacji, materiały i klasyczne karty dziedziczą kolor tekstu aktywnego motywu. Delikatne powierzchnie są wyliczane z tego koloru, dzięki czemu dark mode oparty na klasie theme-dark nie pobiera jasnego tła z nieprzełączonych zmiennych Bootstrap. Ramki korzystają z tokenów motywu.

Terminy aktywności w podglądzie mają ikonę kalendarza 16 px, stonowane etykiety i wyraźniejsze wartości. Etykieta i data są w naturalnym układzie tekstowym, bez siatki i sztywnych kolumn; długie terminy zawijają się wewnątrz panelu. Zmiana nie modyfikuje dat ani stref czasowych.

Jak skonfigurować

1. Otwórz kurs Rosea Grid i wybierz Ustawienia → Format kursu.
2. Ustaw Wygląd podglądu modułu → Immersive — galeria ze zdjęciem w tle.
3. Wybierz Tło panelu Immersive: kolor kontenera motywu (domyślnie) lub przezroczystość z rozmyciem.
4. Ustaw Wysokość zdjęcia w tle Immersive: 60dvh albo 100dvh.
5. Wybierz kolory zgodne z motywem lub wymuszoną jasną/ciemną paletę. Zapisz i kliknij tytuł lub okładkę kafelka.

dvh odnosi się do bieżącej wysokości widocznego obszaru przeglądarki: 60dvh = 60%, 100dvh = pełna wysokość. Zmienia się tylko wysokość zdjęcia, nie panelu treści ani kafelka. Pozostają kadrowanie cover i gradient. Przezroczysty wariant jest półprzezroczysty, z rozmyciem. Te opcje nie zmieniają zwykłego dialogu.

Brak efektu? Sprawdź styl podglądu Immersive, nie tylko układ kart. Zamknij i ponownie otwórz podgląd. Po aktualizacji pluginu wyczyść cache Moodle. Bez zdjęcia sekcji efekt fotograficzny nie będzie widoczny.

„Tło panelu Immersive”: pełny kolor kontenera motywu (domyślnie) albo przezroczystość z rozmyciem tła. Tryb automatyczny korzysta z --bs-container-bg, a przy braku zmiennej z tła strony. Wymuszenie jasnej/ciemnej palety ma pierwszeństwo. „Wysokość zdjęcia w tle Immersive”: 60dvh (domyślnie) lub 100dvh. Cała galeria zawsze zajmuje 100dvh. Bez obsługi rozmycia panel jest pełny. Tytuł kafelka otwiera podgląd, a link w stopce pełną sekcję.

Immersive: w ustawieniach formatu wybierz „Wygląd podglądu modułu → Immersive”. Zdjęcie sekcji wypełni tło i zaniknie gradientem do przezroczystości; bez zdjęcia używane jest tło okładki. Lista aktywności pojawi się w centralnym panelu. Przyciski ×, ‹ i › mają 56 × 56 px. Panel dopasowuje szerokość do ekranu; nie ma przycisku powiększania. Escape lub kliknięcie poza panelem zamyka podgląd. Strzałki klawiatury działają, gdy fokus jest na kontrolkach galerii; na telefonie nawigacja znajduje się pod panelem.

• Kliknij dowolne miejsce karty, aby otworzyć podgląd modułu. Przy wyłączonym JavaScript odnośnik otwiera pełną sekcję.
• Kliknięcie dostępnego wiersza osi otwiera aktywność. Jej natywne przyciski i odnośniki działają osobno.
• Strzałki w nagłówku przełączają poprzedni i następny widoczny moduł. Na początku lub końcu odpowiednia strzałka jest nieaktywna.
• Lista przewija się wewnątrz okna; nagłówek i odnośnik Otwórz pełny widok modułu pozostają dostępne.
• Zamknij podgląd przyciskiem × lub klawiszem Escape. Opisy aktywności są widoczne bez dodatkowego rozwijania.

Podgląd korzysta z natywnych aktywności Moodle, w tym dostępnych dla użytkownika dat, opisów i kontrolek ukończenia. Nie jest odrębnym odtwarzaczem aktywności.

06 / Materiały do kursu i prywatne pliki

Panel Materiały do kursu / Course materials zbiera dostępne zasoby typu Plik i Folder z sekcji ogólnej (sekcja 0).

1. Jako nauczyciel użyj Dodaj plik lub Dodaj folder. Te same zasoby można dodać standardowo w sekcji ogólnej.
2. Wgraj materiał. Aby udostępnić własny prywatny plik, wybierz Prywatne pliki w natywnym selektorze, jeżeli to repozytorium jest dostępne.
3. Zapisz zasób i sprawdź jego widoczność oraz ograniczenia dostępu.

Moje prywatne pliki otwiera osobiste pliki bieżącego użytkownika. Samo kliknięcie tego przycisku nie udostępnia pozostałych prywatnych plików uczestnikom. Przyciski zarządzania są pokazywane zgodnie z uprawnieniami Moodle. Sposób pobierania lub wyświetlania pliku zależy od ustawień zasobu.

07 / Postęp i „Oznacz jako ukończone”

1. W ustawieniach kursu włącz śledzenie ukończenia, jeśli kurs ma mierzyć postęp.
2. W ustawieniach każdej aktywności wybierz sposób ukończenia: ręczny albo automatyczny, zgodnie z możliwościami danego modułu.
3. Sprawdź działanie na koncie rzeczywiście zapisanego uczestnika, dla którego Moodle śledzi ukończenie.

Pasek oraz procent obejmują dostępne, widoczne aktywności ze śledzeniem. Sukces oznacza stan ukończony lub ukończony z zaliczeniem; ukończenie z niezaliczeniem nie jest liczone jako sukces. Aktywności bez śledzenia nie zwiększają mianownika postępu.

Na osi podglądu ręczny przycisk ukończenia pojawia się tylko wtedy, gdy udostępnia go Moodle. Zwykła kropka lub znacznik stanu nie zapisuje ukończenia. Aktywności z automatycznym ukończeniem należy zrealizować według ich warunków.

Po udanym ręcznym oznaczeniu aktualizują się oś i licznik podglądu. Odśwież stronę, aby zaktualizować podsumowanie oraz kafelki; automatyczne ukończenie również może wymagać odświeżenia. Konto administratora bez śledzenia nie pokazuje osobistego procentu.

Przycisk Kontynuuj prowadzi do pierwszej dostępnej, niezaliczonej aktywności ze śledzeniem; przy wyłączonym ukończeniu kursu — do pierwszej dostępnej aktywności. Format nie zapamiętuje pozycji odtwarzania i nie wystawia samodzielnie certyfikatów.

08 / Pomoc, dane i ograniczenia

Nie widzę kafelków.

Wyłącz tryb edycji, otwórz główną stronę kursu zamiast pojedynczej sekcji i sprawdź wybrany format kursu. Potem sprawdź dostępność sekcji dla danego użytkownika.

Nie widzę nowych opcji albo wygląd jest stary.

Sprawdź, czy zainstalowano aktualny ZIP, dokończono wymaganą aktualizację Moodle i zapisano ustawienia. Administrator może wyczyścić cache Moodle. Ponownie otwórz formularz lub odśwież stronę.

Gdzie jest Custom cover text?

Pole zostało zastąpione opcją Cover label → Section name. Zmień nazwę sekcji, aby zmienić napis. Nazwa może być widoczna także na zdjęciu; numer nadal jest pomijany przy obrazie.

Kolor nie zmienia okładki.

Zdjęcie ma pierwszeństwo. Sprawdź upload, URL oraz pierwszy obraz w opisie sekcji. Użyj prawidłowego HEX lub pustego pola.

Brakuje „Oznacz jako ukończone”.

Sprawdź zapis uczestnika, śledzenie ukończenia w kursie i reguły danej aktywności. Administrator nie zawsze jest użytkownikiem śledzonym. Automatyczna aktywność nie otrzyma ręcznego przełącznika.

Materiału nie ma w panelu.

Panel zbiera wyłącznie Pliki i Foldery z sekcji 0. Sprawdź widoczność, dostępność i czy zasób nie jest oznaczony jako stealth.

Dane: ustawienia kursu i sekcji zapisuje natywny mechanizm Moodle. Okładki są plikami kursu; plugin usuwa je przy usunięciu sekcji. Postęp korzysta z natywnych danych ukończenia. Plugin nie tworzy własnych tabel postępu. Serwer zewnętrznego zdjęcia otrzymuje żądania z przeglądarek uczestników; wgranie pliku do Moodle pozwala uniknąć takiego żądania.

Znane ograniczenia: brak wyszukiwania modułów i automatycznego powiązania certyfikatu. Podglądy aktywności są częścią początkowego HTML, więc duże kursy mogą ładować więcej treści. Dodano obsługę plików okładek w backup/restore, ale pełne odtworzenie nie zostało jeszcze zweryfikowane integracyjnie. Nie deklarujemy pełnej zgodności WCAG AAA.

Zakres sprawdzenia: renderowanie i formularze przez CLI, zapis i usuwanie okładek na tymczasowym kursie oraz lokalny podgląd kart desktop/mobile i ciemnej palety. Test CLI potwierdził również nazwę sekcji na istniejącym wgranym zdjęciu oraz zgodność dawnej opcji Custom text. Nie zastępuje to testu pełnego kursu na koncie uczestnika. Szczegóły wydania zawierają README.md i README.en.md wewnątrz ZIP.

01 / Installation

Rosea Grid Course (format_roseagrid) presents course sections as cards with previews of native Moodle activities. It is independent of Video Course and does not require mod_videolesson.

1. Obtain the current format_roseagrid ZIP separately. This guide covers 0.2.0-alpha; the 30 October catalogue archive does not contain this plugin.
2. Check version.php: the current code requires Moodle build 2026091600 or later and the installed format_topics format. This is the code requirement, not a claim that every later Moodle version has been tested.
3. As an administrator, go to Site administration → Plugins → Install plugins, select the ZIP and complete the installer.
4. For manual installation, place the plugin in course/format/roseagrid (or public/course/format/roseagrid when using a public directory). Open administrative Notifications and complete the upgrade.

Alpha release: install and configure it on a test copy first. Back up the database and moodledata before changing a production installation.

02 / Set up a course

1. Open the course and go to Settings → Course format.
2. Select Rosea Grid Course, choose the card layout and save.
3. Turn editing on. Add named sections and standard Moodle activities, such as Page, File, Folder, Quiz or Assignment.
4. Choose Edit section in a section menu to set its summary and cover.
5. Turn editing off to view the cards. Editing and the full view of a single section use the Topics layout.

Each section visible to the user is a module. The general section has no card when it contains neither activities nor a summary. Configure availability and visibility through the usual Moodle forms.

03 / Choose a card layout

The following course-format options apply to all cards in the course.

Each entire card is a single link to the module preview. Changing the layout does not change activities, grades or completion rules.

04 / Cover image, colour and label

Turn editing on, choose Edit section, configure the cover and save. Every section has its own settings.

Cover image

Upload one JPG, PNG, WebP or GIF through the native Moodle file picker. The image fills its card area and may be cropped. Keep the main subject near the centre.

The source order is:

1. The uploaded Cover image file.
2. Cover image URL — a full HTTP or HTTPS image address.
3. The first image in the section summary.
4. The background with a number, section name or no label.

To remove an uploaded cover, delete it from the picker and save the section. If an image still appears, also clear the image URL and remove the first summary image: the next available source may be taking over.

Cover colour (HEX)

Click the colour field to use the picker, or enter #RGB or #RRGGBB, such as #DDE8FF. Clear it to restore the automatic pastel background. Colour is visible when the card has no image.

Alpha5, Space5, XY and Monocolor5 can supply their existing theme picker. When the library is unavailable, the plugin provides a browser colour selector beside HEX and an Automatic button. The HEX field remains usable without JavaScript. The native selector appearance depends on the browser.

File formats

These restrictions concern cover uploads. An image URL renders as an ordinary image, without a video player; preview depends on the file and browser. Adding a course material does not guarantee browser playback.

Cover label

• Section number — the default 01, 02….
• Section name — automatically uses the native section name. Renaming the section updates the label; no separate text field is needed.
• No label — leaves the image or background without an additional label.

Each card shows its name only once. In Classic, Section name moves the main title from the content onto the cover, with a gradient over images. Immersive retains one main title over the image without a duplicate name badge. Classic cover titles are visually limited to three lines. Numbers appear only without an image. No label does not hide the main title. Custom cover text was removed. To change the label, change the native section name and save. An empty section name uses the Moodle default. The previous Custom text choice automatically uses Section name; the former arbitrary text is no longer displayed. No cover re-upload is needed. No label controls the additional label, not the card title.

05 / Use the module preview

The gradient fade applies to both cover images and solid cover colours. The lower edge blends into the gallery surface at 60dvh and 100dvh, independently of the panel background.

The card grid derives its column count from available content width, including open navigation and course-index drawers. Its preferred minimum card width is 17.5rem; narrower containers use one full-width card. Long titles wrap inside cards. There is no separate column-count setting.

Statistics, the continue banner, materials and classic cards inherit the active theme text colour. Subtle surfaces derive from that colour, so class-based theme-dark does not pick up light backgrounds from stale Bootstrap variables. Borders use the theme tokens.

Activity dates in the preview use a 16 px calendar icon, muted labels and stronger values. Labels and dates share a natural inline text flow, without a grid or fixed columns; long dates wrap inside the panel. Deadlines and timezones are not modified.

Configure the preview

1. Open a Rosea Grid course and select Settings → Course format.
2. Set Module preview style → Immersive — image gallery background.
3. Choose Immersive panel background: theme container colour (default) or translucent with backdrop blur.
4. Set Immersive background image height to 60dvh or 100dvh.
5. Follow the current theme or force a light/dark palette. Save, then click a card title or cover.

dvh refers to the current visible browser viewport height: 60dvh = 60%, 100dvh = full height. Only the background image height changes, not the content panel or card. Cover cropping and gradient fading remain. The translucent variant is partially transparent with blur. These options do not change the regular dialog.

No visible effect? Check the Immersive preview style, not just the card layout. Close and reopen the preview. Purge Moodle caches after updating the plugin. Without a section image, the photographic effect will not be visible.

Immersive panel background: solid theme container colour (default) or translucent with backdrop blur. Automatic colours use --bs-container-bg, falling back to the page background. Forced light/dark palettes take precedence. Immersive background image height: 60dvh (default) or 100dvh. The entire gallery always occupies 100dvh. Without blur support, the panel is solid. Clicking a card title opens its preview; the footer link opens the full section.

Immersive: choose Module preview style → Immersive in course format settings. The section image fills the background and fades towards transparency; without an image, its cover background is used. Activities appear in a central panel. Close, previous and next controls are 56 × 56 px. The panel width adapts to the screen; there is no expand control. Escape or clicking outside the panel closes the preview. Arrow keys navigate while focus is on gallery controls; mobile navigation sits beneath the panel.

• Click anywhere on a card to open its preview. Without JavaScript, the link opens the full section.
• Click an available timeline row to open the activity. Native controls and links work independently.
• Header arrows switch to the previous or next visible module. The corresponding arrow is disabled at either end.
• The list scrolls inside the window while the header and Open full module view link remain available.
• Close with × or Escape. Activity descriptions appear without another disclosure control.

The preview uses native Moodle activities, including dates, descriptions and completion controls available to the user. It is not a separate activity player.

06 / Course materials and private files

Course materials collects available File and Folder resources from the general section (section 0).

1. As a teacher, use Add file or Add folder. You can also add these resources through the normal general-section editor.
2. Upload the material. To share a selected private file, choose Private files in the native file picker when that repository is available.
3. Save the resource and check its visibility and access restrictions.

My private files opens the current user's personal file area. Opening it does not share the rest of that area with learners. Management actions follow Moodle permissions. Whether a resource downloads or opens in a viewer depends on its own settings.

07 / Progress and “Mark as done”

1. Enable completion tracking in course settings if the course should measure progress.
2. Set each activity's completion method: manual or automatic, according to the activity module's capabilities.
3. Test using an actually enrolled learner account whose completion Moodle tracks.

Progress includes available, visible activities with completion tracking. A successful state is complete or complete with a pass; completion with a fail is not counted as success. Untracked activities do not increase the progress denominator.

The timeline shows a manual completion button only when Moodle provides one. A plain status marker does not save completion. Complete automatic activities according to their configured conditions.

After a successful manual change, the preview timeline and count update. Reload the page to refresh course statistics and cards; automatic completion may also require a refresh. An administrator account without tracking does not show a personal percentage.

Continue opens the first available unfinished tracked activity; when course completion is disabled, it opens the first available activity. The format does not remember video playback position or issue certificates itself.

08 / Help, data and limitations

I cannot see the cards.

Turn editing off, open the course overview rather than a single section, and check the selected course format. Then check section availability for that user.

New options are missing or the styling is old.

Check that the current ZIP is installed, any required Moodle upgrade is complete and settings are saved. An administrator can purge Moodle caches. Reopen the form or reload the page.

Where is Custom cover text?

It was replaced with Cover label → Section name. Rename the section to change its label. Names can also appear over images; numbers remain omitted when an image is present.

The colour does not change the cover.

Images take precedence. Check the upload, URL and first summary image. Enter valid HEX or leave the field empty.

“Mark as done” is missing.

Check enrolment, course completion tracking and the activity rules. Administrators are not always tracked users. An automatic activity does not get a manual toggle.

A resource is missing from Course materials.

The panel collects only Files and Folders from section 0. Check visibility, availability and whether the resource is marked as stealth.

Data: course and section options use native Moodle storage. Covers are course files and are removed when their section is deleted. Progress uses native completion data; the plugin has no separate progress tables. External image servers receive requests from learner browsers; uploading the file to Moodle avoids that external image request.

Known limitations: no module search or automatic certificate linking. Activity previews are included in the initial HTML, so large courses may load more content. Cover-file backup/restore hooks are included, but a full restore has not yet been integration-tested. Full WCAG AAA compliance is not claimed.

Validation covered CLI rendering and forms, cover-file saving and deletion on a temporary course, and local desktop/mobile card previews with a dark palette. A CLI test also verified section names on an existing uploaded cover and compatibility with the previous Custom text mode. It does not replace testing a complete course as a learner. README.md and README.en.md inside the plugin ZIP provide release details.