Zum Inhalt springen

Wiki-Quellcode von Eigenes Kurslayout verwenden

Zuletzt geändert von Carina Enke am 23.02.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 |(% style="width:1130px" %)(((
33 Erstellen Sie zunächst Ihre eigene CSS-Datei und laden Sie diese in den **Kursordner** Ihres Kurses hoch. Diesen finden Sie im Kurseditor.
34 )))|(% style="width:600px" %)(((
35 [[image:https://www.bps-system.de/help/download/attachments/55574597/Kurseditor%20-%20Aufruf%20Kursablageordner_de.png?version=1&modificationDate=1632463074362&api=v2||alt="Ablageordner im Kurseditor" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
36 )))
37
38 **Schritt 2: CSS-Datei einbinden**
39
40 Um das Kurslayout aus dieser CSS-Datei zu aktivieren, gehen Sie nun wie folgt vor:
41
42 |(% style="width:962px" %)(((
43 Ö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.
44 )))|(% 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"]]
45 |(% style="width:962px" %)Wählen Sie den ersten Eintrag **Einstellungen **aus. Es öffnet sich der Dialog **Kurseinstellungen**.
46 |(% 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" %)(((
47 [[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"]]
48 )))
49 |(% 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"]]
50 |(% style="width:962px" %)Speichern Sie Ihre Änderungen und schließen Sie den Dialog.
51
52
53
54 == Beispiele für Layoutanpassungen ==
55
56 === (% style="color:inherit; font-family:inherit; font-size:max(18px, min(22px, 10.8889px + 0.925926vw))" %)Anpassungen an das Corporate Design(%%) ===
57
58 ==== Logo im Header austauschen ====
59
60 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".
61
62
63 {{code language="none"}}
64 .logo {
65     width: 200px;
66     background-image: url(logo-bps.svg);
67     background-size: 150px;
68 }
69 {{/code}}
70
71
72 ==== Hintergrundfarbe der Navigationsleiste ändern (inkl. mobile Version) ====
73
74 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.
75
76 {{code language="none"}}
77 .page .mobile-page-header,
78 .nav-container,
79 .nav-container + .clearfix {
80 background-color: #008079;
81 }
82 {{/code}}
83
84
85 ==== Schrift-/Icon-Farbe von Links und Buttons anpassen ====
86
87 Wählen Sie für die Interaktionsmöglichkeiten wie hover und focus eine andere Farbe, um Nutzenden Feedback zu geben.
88
89
90 {{code language="none"}}
91 a, .btn {color: #008079;}
92 a:hover, a:focus, a:active,
93 .btn:hover, .btn:focus, .btn:active {color: #004A46;}
94 {{/code}}
95
96
97
98 [[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"]]
99
100
101
102 === Hauptnavigation ausblenden ===
103
104 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.
105
106
107 {{code language="none"}}
108 .nav-container {display: none;}
109 .mobile .nav-container {display: block;}
110 {{/code}}
111
112
113 [[image:Kursdesign - Navigation ausblenden_de.png||alt="Hauptnavigation ausblenden" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
114
115
116 === Hintergrundbild für den Kurs einbinden ===
117
118 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]]
119
120 Bei [[W3Schools>>url:https://www.w3schools.com/cssref/css3_pr_background.asp]] finden Sie weitere Informationen zum Einbinden von Hintergrundbildern in CSS.
121
122
123 {{code language="none"}}
124 #wrap {
125 background: url(background.jpg) no-repeat 0 0;
126 }
127 {{/code}}
128
129 [[image:Kursdesign - Hintergrundbild_de.png||alt="Kurs mit Hintergrundbild" data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
130
131
132 === Einfärben von Kursbausteinen im Menü ===
133
134 Wenn Sie alle Kursbausteine eines Typs, z. B. alle Blogs im Menü auf der linken Seite, hervorheben möchten, nutzen Sie folgenden Code:
135
136
137 {{code language="none"}}
138 .jstree-default>.jstree-container-ul a.node-blog {
139 background: darkblue;
140 color: #fff;
141 }
142 {{/code}}
143
144 Eine Liste der der restlichen Kursbausteine bietet die Seite [[CSS-Klassen der Kursbausteine>>doc:.CSS-Klassen der Kursbausteine.WebHome]].
145
146 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:
147
148 {{code language="none"}}
149 .jstree-default #id84915228820561_anchor {
150 background: darkblue;
151 color: #fff;
152 }
153 {{/code}}
154
155
156 [[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"]]
157
158
159 === Status-Farben für den Kursfortschritt anpassen ===
160
161 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]].
162
163
164 **Farben im Kursmenü anpassen**
165
166 {{code language="none"}}
167 .jstree-anchor.progress-0 {border-left-color: #fa9370;}
168 .jstree-anchor.progress-50 {border-left-color: #FBDFBD;}
169 .jstree-anchor.progress-100 {border-left-color: #5caa7f;}
170 {{/code}}
171
172 **Farben im Kopfbereich des Kursbausteins anpassen**
173
174 {{code language="none"}}
175 .resource-header.progress-0 {border-left-color: #fa9370;}
176 .resource-header.progress-50 {border-left-color: #FBDFBD;}
177 .resource-header.progress-100 {border-left-color: #5caa7f;}
178 {{/code}}
179
180
181
182 === Button "Test starten" für Tests oder Selbsttests umbenennen ===
183
184 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:
185
186 {{code language="none"}}
187 .iqself .run-container .btn-big .fonticon+span {display: none;}
188 .iqself .run-container .btn-big:after {content: "Mission starten";}
189 {{/code}}
190
191 Für einen Kursbaustein Test nutzen Sie die Klasse iqtest:
192
193 {{code language="none"}}
194 .iqtest .run-container .btn-big .fonticon+span {display: none;}
195 .iqtest .run-container .btn-big:after {content: "Mission starten";}
196 {{/code}}
197
198 {{warning}}
199 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:
200
201 * der Originaltext bleibt technisch weiterhin im DOM bestehen
202 * Screenreader und Suchfunktionen greifen weiterhin auf den Originaltext zu
203 * Updates können solche Workarounds jederzeit beeinträchtigen
204
205 Eine echte Änderung von Systemmeldungen ist nur über die Anpassungen der Sprachressourcen bzw. durch eine Softwareanpassung möglich.
206
207 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.
208 {{/warning}}
209
210
211
212 === Box "Lösungsversuche" neben dem Button "Test starten" für Selbsttests ausblenden ===
213
214 Sie können die Box mit den Informationen zu den Lösungsversuchen z. B. für Selbsttests (Klasse iqself) mit folgendem Code ausblenden:
215
216 {{code language="none"}}
217 .iqself .run-container .box-light {display: none;}
218 {{/code}}
219
220 [[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"]]
221
222
223 === Bewertungsinformationen für Selbsttests ausblenden ===
224
225 Nutzen Sie folgenden Code, um alle Bewertungsinformationen bei Selbsttests (Klasse iqself) auszublenden:
226
227 {{code language="none"}}
228 .iqself .assess-container {display: none;}
229 {{/code}}
230
231 [[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"]]
232
233
234 === Informationen auf der Startseite des Kurses ausblenden ===
235
236 Um z. B. die Angaben zur Institution und zum Semester sowie die Metadaten auszublenden, können Sie den folgenden Code verwenden:
237
238 **Institution und Semester ausblenden**
239
240 {{code language="none"}}
241 .root .resource-details .content-preview-main>small {display: none;}
242 {{/code}}
243
244 **Metadaten ausblenden**
245
246 {{code language="none"}}
247 .root .resource-details .content-preview-info {display: none;}
248 {{/code}}
249
250 [[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"]]
251
252
253 Weitere Möglichkeiten, die angezeigten Informationen auf der Startseite anzupassen:
254
255 **Beschreibung von der Detailseite ausblenden**
256
257 {{code language="none"}}
258 .root .resource-details .repo-desc {display: none;}
259 {{/code}}
260
261 **Kursverantwortliche ausblenden**
262
263 {{code language="none"}}
264 .root .resource-details .content-preview-author {display: none;}
265 {{/code}}
266
267 **Gesamten Bereich auf der Startseite ausblenden**
268
269 {{code language="none"}}
270 .root .resource-details {display: none;}
271
272 {{/code}}