Zum Inhalt springen

Wiki-Quellcode von Eigenes Kurslayout verwenden

Zuletzt geändert von Carina Enke am 15.06.2026
Zeige letzte Bearbeiter
1 {{section}}
2 {{column width="60%"}}
3 Mithilfe von CSS können Sie das Aussehen Ihres Kurses individuell anpassen, z. B. an das Corporate Design Ihrer Institution. Unter anderem ist es möglich, Schrift- und Hintergrundfarben anzupassen oder bestimmte Bedienelemente neu zu positionieren.
4
5 (% class="box warningmessage" %)
6 (((
7 **Achtung**
8
9 Sie sollten das Kurslayout nur anpassen, wenn Sie gute Kenntnisse in HTML und CSS haben. Beachten Sie bitte, dass viele Klassen mehrfach verwendet werden und möglicherweise nicht alle Änderungen auf den ersten Blick sichtbar sind. Testen Sie Ihre Anpassungen mit verschiedenen Bildschirmgrößen und mobilen Endgeräten.
10
11 Achten Sie zur Unterstützung der Barrierefreiheit außerdem auf einen ausreichenden [[Kontrast zwischen Schriftfarbe und Hintergrund>>doc:LMS.Benutzerhandbuch OPAL.Barrierefreiheit.WebHome]].
12 )))
13 {{/column}}
14
15 {{column width="30%"}}
16 {{panel title="Inhalt"}}
17 {{toc depth="3" start="2"/}}
18 {{/panel}}
19 {{/column}}
20 {{/section}}
21
22
23 == Kurslayout aktivieren ==
24
25 (% class="box infomessage" %)
26 (((
27 Mit dem Release OPAL 11.3 ist die Funktion zum Ändern des Kurslayouts in der neuen Benutzeroberfläche verfügbar. Wie Sie das Kurslayout in der alten Benutzeroberfläche aktivieren, erläutert der Abschnitt Kurslayout aktivieren (alte Benutzeroberfläche).
28 )))
29
30 **Schritt 1: CSS-Datei in den Kursordner laden**
31
32 Erstellen Sie zunächst Ihre eigene CSS-Datei und laden Sie diese in den **Kursordner** Ihres Kurses hoch. Diesen finden Sie im Kurseditor.
33
34 [[image:Kurseditor - Aufruf Kursablageordner_de.png||alt="Ablageordner im Kurseditor" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
35
36
37 **Schritt 2: CSS-Datei einbinden**
38
39 Um das Kurslayout aus dieser CSS-Datei zu aktivieren, gehen Sie nun wie folgt vor:
40
41 |(% style="width:962px" %)(((
42 Öffnen Sie in der Kursansicht das Menü [[image:LMS.Benutzerhandbuch OPAL.Icons.WebHome@Icon_zweiRädchen.png||data-xwiki-image-style="img-icon"]] **Weitere Einstellungen** oben rechts im Kurs.
43 )))|(% colspan="1" rowspan="2" style="width:507px" %)[[image:Kursrun - Kurseinstellungen aufrufen_de.png||alt="Einstellungen zum Kurs öffnen" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="282" width="308"]]
44 |(% style="width:962px" %)Wählen Sie den ersten Eintrag **Einstellungen **aus. Es öffnet sich der Dialog **Kurseinstellungen**.
45 |(% style="width:962px" %)Klicken Sie in diesem Dialog im Abschnitt Kurs-Layout in der Box** CSS aus Ablageordner** auf das kleine Dreieck. Es öffnet sich eine Liste der verfügbaren CSS-Dateien. Wählen Sie nun die gewünschte CSS-Datei aus.|(% style="width:507px" %)(((
46 [[image:Kursrun - CSS auswählen_de.png||alt="Kursrun -CSS auswählen_de" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
47 )))
48 |(% style="width:962px" %)Automatisch erscheint der gewählte Dateiname in der nun farbig hervorgehobenen Auswahlbox.|(% colspan="1" rowspan="2" style="width:507px" %)[[image:Kursrun - gewählte CSS_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
49 |(% style="width:962px" %)Speichern Sie Ihre Änderungen und schließen Sie den Dialog.
50
51 == Beispiele für Layoutanpassungen ==
52
53 === (% style="color:inherit; font-family:inherit; font-size:max(18px, min(22px, 10.8889px + 0.925926vw))" %)Anpassungen an das Corporate Design(%%) ===
54
55 ==== Logo im Header austauschen ====
56
57 Fügen Sie Ihr Logo (png, jpg, svg) in den gleichen Ordner ein, in dem auch Ihre CSS-Datei liegt. Passen Sie bei Bedarf die Breite (width) sowie die Größe des Bildes (background-size) an. Im Beispiel nutzen wir das Logo "logo-bps.svg".
58
59
60 {{code language="none"}}
61 .logo {
62     width: 200px;
63     background-image: url(logo-bps.svg);
64     background-size: 150px;
65 }
66 {{/code}}
67
68
69 ==== Hintergrundfarbe der Navigationsleiste ändern (inkl. mobile Version) ====
70
71 Die Schriftfarbe und die Gestaltung weiterer Elemente ist auf eine dunkle Navigationsleiste ausgerichtet. Bei einer hellen Hintergrundfarbe müssen Sie ggf. weitere Elemente anpassen. Im Beispiel wird auch die Farbe des Headers in der mobilen Version geändert.
72
73 {{code language="none"}}
74 .page .mobile-page-header,
75 .nav-container,
76 .nav-container + .clearfix {
77 background-color: #008079;
78 }
79 {{/code}}
80
81
82 ==== Schrift-/Icon-Farbe von Links und Buttons anpassen ====
83
84 Wählen Sie für die Interaktionsmöglichkeiten wie hover und focus eine andere Farbe, um Nutzenden Feedback zu geben.
85
86
87 {{code language="none"}}
88 a, .btn {color: #008079;}
89 a:hover, a:focus, a:active,
90 .btn:hover, .btn:focus, .btn:active {color: #004A46;}
91 {{/code}}
92
93
94
95 [[image:Kursdesign - Logo und Farben_de.png||alt="Corporate Design Anpassungen" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="300" width="778"]]
96
97
98
99 === Hauptnavigation ausblenden ===
100
101 Sie können bei Bedarf die Navigationsleiste ausblenden. Beachten Sie dabei bitte, dass die Navigation z. B. zu Lehren & Lernen oder anderen geöffneten Kursen dann nicht mehr möglich ist. Für die mobile Version sollten Sie das Ausblenden wie im Beispiel rückgängig machen.
102
103
104 {{code language="none"}}
105 .nav-container {display: none;}
106 .mobile .nav-container {display: block;}
107 {{/code}}
108
109
110 [[image:Kursdesign - Navigation ausblenden_de.png||alt="Hauptnavigation ausblenden" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
111
112
113 === Hintergrundbild für den Kurs einbinden ===
114
115 Fügen Sie Ihr Hintergrundbild (png, jpg, svg) in den gleichen Ordner ein, in dem auch Ihre CSS-Datei liegt. Achten Sie dabei auf die Dateigröße, um ein schnelles Laden des Kurses zu ermöglichen. [[Hinweise zur Dateigröße.>>url:https://www.bps-system.de/help/display/LMS/Usability+Barrierefreiheit#UsabilityBarrierefreiheit-Dateigr%C3%B6%C3%9Fe]]
116
117 Bei [[W3Schools>>url:https://www.w3schools.com/cssref/css3_pr_background.asp]] finden Sie weitere Informationen zum Einbinden von Hintergrundbildern in CSS.
118
119
120 {{code language="none"}}
121 #wrap {
122 background: url(background.jpg) no-repeat 0 0;
123 }
124 {{/code}}
125
126 [[image:Kursdesign - Hintergrundbild_de.png||alt="Kurs mit Hintergrundbild" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
127
128
129 === Einfärben von Kursbausteinen im Menü ===
130
131 Wenn Sie alle Kursbausteine eines Typs, z. B. alle Blogs im Menü auf der linken Seite, hervorheben möchten, nutzen Sie folgenden Code:
132
133
134 {{code language="none"}}
135 .jstree-default>.jstree-container-ul a.node-blog {
136 background: darkblue;
137 color: #fff;
138 }
139 {{/code}}
140
141 Eine Liste der der restlichen Kursbausteine bietet die Seite [[CSS-Klassen der Kursbausteine>>doc:.CSS-Klassen der Kursbausteine.WebHome]].
142
143 Wenn Sie nur einen bestimmten Kursbaustein im Menü, z. B. den Abschlusstest, hervorheben möchten, können Sie die ID des Kursbausteins verwenden. Im Beispiel wird die ID  **84915228820561** genutzt:
144
145 {{code language="none"}}
146 .jstree-default #id84915228820561_anchor {
147 background: darkblue;
148 color: #fff;
149 }
150 {{/code}}
151
152
153 [[image:Kursrun - Menü mit Beispiel CSS_de.png||alt="Beispiel zur CSS-Verwendung" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
154
155
156 === Status-Farben für den Kursfortschritt anpassen ===
157
158 Der Fortschritt für einzelne Kursbausteine wird im Menü des Kurses und im oberen Bereich des Inhalts angezeigt. Über //border-left-color// können Sie die Farben anpassen. [[Weitere Informationen zur Fortschrittsanzeige im Kurs>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kurs.Kurs bearbeiten.Kursfortschritt.WebHome]].
159
160
161 **Farben im Kursmenü anpassen**
162
163 {{code language="none"}}
164 .jstree-anchor.progress-0 {border-left-color: #fa9370;}
165 .jstree-anchor.progress-50 {border-left-color: #FBDFBD;}
166 .jstree-anchor.progress-100 {border-left-color: #5caa7f;}
167 {{/code}}
168
169 **Farben im Kopfbereich des Kursbausteins anpassen**
170
171 {{code language="none"}}
172 .resource-header.progress-0 {border-left-color: #fa9370;}
173 .resource-header.progress-50 {border-left-color: #FBDFBD;}
174 .resource-header.progress-100 {border-left-color: #5caa7f;}
175 {{/code}}
176
177
178
179 === Button "Test starten" für Tests oder Selbsttests umbenennen ===
180
181 Wenn Sie statt **Test starten** z. B. **Mission starten** als Beschriftung für den Button zum Starten von Selbsttests (Klasse iqself) nutzen möchten, können Sie folgenden Code verwenden:
182
183 {{code language="none"}}
184 .iqself .run-container .btn-big .fonticon+span {display: none;}
185 .iqself .run-container .btn-big:after {content: "Mission starten";}
186 {{/code}}
187
188 Für einen Kursbaustein Test nutzen Sie die Klasse iqtest:
189
190 {{code language="none"}}
191 .iqtest .run-container .btn-big .fonticon+span {display: none;}
192 .iqtest .run-container .btn-big:after {content: "Mission starten";}
193 {{/code}}
194
195 {{warning}}
196 CSS dient der Darstellung von Inhalten, also z. B. Layout, Farben, Abstände, Schriftarten oder das Ein- und Ausblenden von Elementen. Zwar lassen sich mit CSS über ::before oder ::after auch andere Inhalte einblenden oder bestehender Text visuell ausblenden, jedoch handelt sich nicht um eine saubere oder barrierefreie Lösung:
197
198 * der Originaltext bleibt technisch weiterhin im DOM bestehen
199 * Screenreader und Suchfunktionen greifen weiterhin auf den Originaltext zu
200 * Updates können solche Workarounds jederzeit beeinträchtigen
201
202 Eine echte Änderung von Systemmeldungen ist nur über die Anpassungen der Sprachressourcen bzw. durch eine Softwareanpassung möglich.
203
204 In manchen Fällen können ergänzende Erläuterungen im Beschreibungstext des Bausteins (z. B. mit Hinweisen wie „Im Kontext dieses Bewerbungsverfahrens bedeutet ‚Lösung‘ Ihre Bewerbungsunterlagen“) hilfreich sein.
205 {{/warning}}
206
207
208
209 === Box "Lösungsversuche" neben dem Button "Test starten" für Selbsttests ausblenden ===
210
211 Sie können die Box mit den Informationen zu den Lösungsversuchen z. B. für Selbsttests (Klasse iqself) mit folgendem Code ausblenden:
212
213 {{code language="none"}}
214 .iqself .run-container .box-light {display: none;}
215 {{/code}}
216
217 [[image:Kursrun - Test-Infobox per CSS ausblenden_de.png||alt="Beispiel zur CSS-Verwendung" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
218
219
220 === Bewertungsinformationen für Selbsttests ausblenden ===
221
222 Nutzen Sie folgenden Code, um alle Bewertungsinformationen bei Selbsttests (Klasse iqself) auszublenden:
223
224 {{code language="none"}}
225 .iqself .assess-container {display: none;}
226 {{/code}}
227
228 [[image:Kursrun - Bewertungsbox per CSS ausblenden_de.png||alt="Beispiel zur CSS-Verwendung" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
229
230
231 === Informationen auf der Startseite des Kurses ausblenden ===
232
233 Um z. B. die Angaben zur Institution und zum Semester sowie die Metadaten auszublenden, können Sie den folgenden Code verwenden:
234
235 **Institution und Semester ausblenden**
236
237 {{code language="none"}}
238 .root .resource-details .content-preview-main>small {display: none;}
239 {{/code}}
240
241 **Metadaten ausblenden**
242
243 {{code language="none"}}
244 .root .resource-details .content-preview-info {display: none;}
245 {{/code}}
246
247 [[image:Kursrun - Infobox-CSS_de.png||alt="Beispiel zur CSS-Verwendung" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
248
249
250 Weitere Möglichkeiten, die angezeigten Informationen auf der Startseite anzupassen:
251
252 **Beschreibung von der Detailseite ausblenden**
253
254 {{code language="none"}}
255 .root .resource-details .repo-desc {display: none;}
256 {{/code}}
257
258 **Kursverantwortliche ausblenden**
259
260 {{code language="none"}}
261 .root .resource-details .content-preview-author {display: none;}
262 {{/code}}
263
264 **Gesamten Bereich auf der Startseite ausblenden**
265
266 {{code language="none"}}
267 .root .resource-details {display: none;}
268
269 {{/code}}