- CSS 86.2%
- Twig 12.7%
- Shell 1.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| dist | ||
| docs | ||
| scripts | ||
| unistuttgart_de | ||
| LICENSE | ||
| README.md | ||
LimeSurvey-Vorlage im Corporate Design der Universität Stuttgart
Mit dieser Vorlage erstellst du in wenigen Minuten eine Online-Umfrage in LimeSurvey, die dem Corporate Design (CD) der Universität Stuttgart entspricht: Hausfarben, Hausschrift Uni Stuttgart Sans, Uni-Logo, ein DSGVO-Hinweis mit Einwilligung und Beispielfragen für die gängigen Fragetypen. Du ersetzt nur noch die Platzhalter und legst deine eigenen Fragen an.
Inhalt
- Was enthält das Repository?
- Voraussetzungen
- Schnellstart
- Schritt 1 · Designvorlage installieren
- Schritt 2 · Umfragevorlage importieren
- Schritt 3 · Designvorlage prüfen
- Schritt 4 · Platzhalter ersetzen
- Schritt 5 · Eigene Fragen anlegen
- Schritt 6 · Testen und aktivieren
- Datenschutz
- Gestaltung anpassen
- Fehlerbehebung
- Für Maintainer
- Logo, Schrift und Lizenz
Was enthält das Repository?
| Pfad | Inhalt | Wofür? |
|---|---|---|
dist/unistuttgart_de.zip |
Fertig gepackte Designvorlage (Theme) | Herunterladen und in LimeSurvey importieren (Schritt 1) |
dist/umfragevorlage_uni_stuttgart_de.lss |
Umfragevorlage auf Deutsch | Herunterladen und als Umfrage importieren (Schritt 2) |
theme/unistuttgart_de/ |
Quelldateien des Themes: config.xml, css/custom.css, Schrift, Logo, Vorschaubild |
Nur relevant, wenn du das Theme weiterentwickeln willst |
scripts/build-theme-zip.sh |
Baut die ZIP aus den Quelldateien neu | Nur für Maintainer |
docs/vorschau.png |
Screenshot für dieses README | — |
Das Theme ist eine Kind-Vorlage des LimeSurvey-Standardthemes Fruity TwentyThree. Alle Gestaltungsregeln stehen in css/custom.css. Alles andere, zum Beispiel Seitenaufbau, Skripte und Fragedarstellung, erbt das Theme vom Standardtheme.
Voraussetzungen
- LimeSurvey 6 oder 7. Getestet mit LimeSurvey 7.0.13. Das Standardtheme Fruity TwentyThree muss installiert sein, das ist es bei jeder normalen Installation.
- Ein Benutzerkonto mit dem Recht, Umfragen zu erstellen.
- Für Schritt 1 einmalig pro LimeSurvey-Instanz: die globale Berechtigung Designvorlagen → Importieren (oder Superadmin-Rechte).
- Nutzt du eine gemeinsame Instanz (z. B. die des Lehrstuhls), hast du dieses Recht meist nicht. Das ist kein Problem: Die Designvorlage muss nur einmal von einer Administratorin oder einem Administrator installiert werden. Danach können alle sie verwenden. Schick der Person den Link zu Schritt 1. Ist das Theme schon installiert, überspringst du Schritt 1.
- Auf einer eigenen Instanz bist du ohnehin Superadmin.
Schnellstart
dist/unistuttgart_de.zipherunterladen und unter Konfiguration → Designvorlagen → Importieren hochladen. Das ist einmalig pro Instanz nötig, die ZIP nicht entpacken.dist/umfragevorlage_uni_stuttgart_de.lssherunterladen und unter Umfragen → Umfrage erstellen → Importieren hochladen.- In der Umfragevorschau prüfen, ob Titel und Buttons blau sind und das Uni-Logo erscheint.
- Alle Platzhalter in
[eckigen Klammern]ersetzen, eigene Fragen anlegen, testen und aktivieren.
Die einzelnen Schritte sind im Folgenden genau beschrieben.
Schritt 1 · Designvorlage installieren
Einmal pro LimeSurvey-Instanz, mit Admin-Recht. Ist
Universität Stuttgart (Deutsch)in der Liste der Designvorlagen schon vorhanden, überspringe diesen Schritt.
- ZIP herunterladen. Öffne in diesem Repository die Datei
dist/unistuttgart_de.zipund lade sie über die Schaltfläche Raw bzw. das Download-Symbol herunter.- ⚠️ Die Datei muss
unistuttgart_de.zipheißen. LimeSurvey verwendet den Dateinamen als Namen des Themes, und die Umfragevorlage sucht genau nachunistuttgart_de. Hängt dein Browser etwas an, etwaunistuttgart_de (1).zip, benenne die Datei zurück. - ⚠️ Nicht entpacken und neu packen. In der ZIP muss
config.xmldirekt auf oberster Ebene liegen. Safari auf dem Mac entpackt ZIP-Dateien teilweise automatisch. Lade die Datei in diesem Fall mit einem anderen Browser herunter oder schalte „Sichere Dateien nach dem Laden öffnen“ aus.
- ⚠️ Die Datei muss
- In LimeSurvey: Konfiguration → Designvorlagen.
- Oben auf Importieren klicken, die ZIP auswählen und hochladen.
- LimeSurvey zeigt eine Liste der importierten Dateien. Anschließend erscheint in der Liste der Umfrage-Designvorlagen der Eintrag Universität Stuttgart (Deutsch) mit blauem Vorschaubild.
Schritt 2 · Umfragevorlage importieren
dist/umfragevorlage_uni_stuttgart_de.lssherunterladen (wieder über Raw bzw. das Download-Symbol).- In LimeSurvey: Umfragen → Umfrage erstellen → Reiter Importieren.
- Die
.lss-Datei auswählen und Importieren klicken.
Es entsteht eine neue, noch nicht aktivierte Umfrage mit dem Titel [Titel der Studie]. Sie enthält drei Abschnitte:
| Abschnitt | Inhalt |
|---|---|
| Einwilligung und Datenschutz | Datenschutzhinweis und Pflicht-Kästchen zur Einwilligung (EW01) |
| Abschnitt 1: [Thema des Abschnitts] | Beispielfragen: Matrix (A03), Dropdown (A04), Zahl (A05), Ja/Nein (A06) mit bedingter Folgefrage (A06A) |
| Abschluss | Offene Abschlussfrage (S01), Wunsch nach Ergebnisinformation (S02) mit optionaler E-Mail-Adresse (S03) |
Bereits voreingestellt: anonymisierte Antworten, keine Speicherung der IP-Adresse, seitenweise Darstellung, Fortschrittsbalken, Zurück-Button.
XSS-Filter: Du musst ihn nicht abschalten. Die Vorlage ist so gebaut, dass alle Texte den HTML-Filter von LimeSurvey unverändert passieren. Die Gestaltung kommt aus dem Theme.
Schritt 3 · Designvorlage prüfen
- Öffne in der Umfrage Einstellungen → Generell. Unter Designvorlage muss
unistuttgart_destehen. Normalerweise ist das schon so. Wenn das Theme beim Import noch nicht installiert war, hat LimeSurvey auf das Standardtheme zurückgeschaltet. Dann stellst du es hier um und speicherst. - Unter Einstellungen → Designvorlage-Optionen musst du nichts ändern. Lass die Einstellung auf Geerbt.
- ⚠️ Falls du dort doch etwas anpasst, muss die Farbvariante („Theme color“) auf „Apple“ bleiben. Das Stylesheet färbt genau diese Variante in die Uni-Farben um. Andere Varianten erscheinen teilweise violett oder rot.
- Öffne die Umfragevorschau. So muss es aussehen:
- Titel und Überschriften sind blau (
#004191) und in der serifenlosen Hausschrift gesetzt. - Das Uni-Logo steht auf der Startseite oben links, darüber ein Farbverlauf von Dunkel- nach Hellblau.
- Buttons und ausgewählte Antworten sind blau, nirgends grün.
- Titel und Überschriften sind blau (
Sieht es anders aus, hilft die Fehlerbehebung.
Schritt 4 · Platzhalter ersetzen
Alle Stellen, die du anpassen musst, stehen in [eckigen Klammern]. Am schnellsten findest du sie, indem du in jedem Textfeld nach [ suchst.
| Wo in LimeSurvey | Platzhalter | Was eintragen |
|---|---|---|
| Einstellungen → Textelemente: Titel | [Titel der Studie] |
Titel deiner Umfrage |
| Textelemente: Beschreibung | [X] |
Bearbeitungsdauer in Minuten (vorher selbst testen) |
| Textelemente: Willkommensnachricht | [Leitfrage oder Titel der Studie] |
Überschrift der Startseite, gern als Frage formuliert |
[Worum geht es in der Studie …] |
Zwei bis drei Sätze: Thema, Relevanz, Zielgruppe | |
[X], [Wer soll an der Befragung teilnehmen?], [Wie und wo werden die Ergebnisse veröffentlicht …] |
Dauer, Zielgruppe, Veröffentlichung | |
[INSTITUT / LEHRSTUHL], [NAME], [E-MAIL] |
Durchführende Einrichtung, Ansprechperson, Kontaktadresse | |
| Textelemente: Endnachricht | [Kurz beschreiben: Wann wird ausgewertet …] |
Was nach der Befragung passiert |
[NAME], [E-MAIL] |
wie oben | |
| Abschnitt „Einwilligung und Datenschutz“ → Gruppe bearbeiten → Beschreibung | [INSTITUT / LEHRSTUHL], [NAME], [E-MAIL] |
wie oben (mehrfach vorhanden) |
[THEMA DER STUDIE] |
Forschungszweck | |
[unvollständige Antworten werden nicht ausgewertet / werden in die Auswertung einbezogen] |
Eine der beiden Varianten wählen | |
[Optional: Ein anonymisierter Datensatz …] |
Behalten (ohne Klammern) oder löschen | |
| Abschnitt 1: Gruppenname und Beschreibung | [Thema des Abschnitts], [Kurze Einleitung zu diesem Abschnitt.] |
Eigener Abschnittstitel und Einleitung |
Beispielfragen A03–A06A |
[Beispiel …], [Aussage 1], [Bereich 1], [Einheiten] … |
Durch eigene Fragen ersetzen oder löschen (Schritt 5) |
| Einstellungen → Datenschutzerklärung | [INSTITUT / LEHRSTUHL], [NAME], [E-MAIL], [E-MAIL DATENSCHUTZBEAUFTRAGTE*R], [THEMA DER STUDIE] … |
Dieses Feld wird Teilnehmenden nicht angezeigt, der Hinweis steht im ersten Abschnitt. Entweder genauso ausfüllen oder leeren. |
| E-Mail-Vorlagen | [THEMA DER STUDIE], [X] |
Nur nötig, wenn du Einladungen über LimeSurvey verschickst |
Speicherort im Datenschutzhinweis: Der Absatz „Speicherung und Veröffentlichung“ nennt einen LimeSurvey-Server beim Landesdienst bw-Cloud-OS. Läuft deine Umfrage auf einer anderen Instanz, passe diesen Satz an.
Schritt 5 · Eigene Fragen anlegen
Am einfachsten: eine passende Beispielfrage kopieren (Fragenübersicht → Frage → Kopieren) und Text, Code und Antworten anpassen. So bleiben Skalen, Hilfetexte und Gestaltung erhalten. Nicht benötigte Beispielfragen löschst du.
-
EW01(Einwilligung) nicht löschen. Ohne Einwilligung darfst du keine Antworten erheben. -
Fragecodes sprechend wählen, z. B.
A01,B02. Sie werden zu den Spaltennamen im Export. -
Bewertungsskalen: Die Beispielmatrix
A03nutzt eine sechsstufige Skala ohne Mittelkategorie, ergänzt um „Kann ich nicht beurteilen“. Diese Antwortoption behandelst du in der Auswertung als fehlenden Wert. -
Bedingte Fragen:
A06Azeigt, wie eine Folgefrage nur bei einer bestimmten Antwort erscheint. Die Bedingung steht in der Frage unter Relevanzgleichung, z. B.A06 == "Y". -
Neue Abschnitte legst du als neue Fragengruppe an. Für einen blauen Hinweiskasten in der Gruppenbeschreibung wechselst du im Editor in die Quelltext-Ansicht und fügst ein:
<div class="us-note"><strong>Kurzer Hinweis.</strong> Erläuterung zu diesem Abschnitt.</div>
Schritt 6 · Testen und aktivieren
Vor dem Aktivieren:
- Die Umfrage in der Vorschau einmal komplett durchklicken, auch auf dem Smartphone.
- Jede bedingte Frage auslösen und prüfen, ob sie erscheint und wieder verschwindet.
- Nach
[suchen: Es dürfen keine Platzhalter mehr übrig sein. - Die Bearbeitungszeit messen und in Beschreibung und Willkommensnachricht eintragen.
- Bei Abschlussarbeiten: die Umfrage mit der Betreuerin oder dem Betreuer abstimmen.
Dann Umfrage aktivieren. Beim Aktivieren fragt LimeSurvey, ob die Antworten anonymisiert gespeichert werden sollen. Die Vorlage ist bereits auf anonymisiert eingestellt. Das lässt sich nach der Aktivierung nicht mehr ändern.
Datenschutz
Der Datenschutzhinweis der Vorlage ist für anonyme Befragungen formuliert. Er stimmt mit den Einstellungen überein: anonymisierte Antworten, keine IP-Adressen und keine Pflichtangaben, die auf Personen schließen lassen.
- Freiwillige E-Mail-Adresse (
S03): Wer am Ende eine E-Mail-Adresse angibt, ist nicht mehr anonym. LimeSurvey speichert die Adresse in derselben Antwortzeile wie alle anderen Antworten. Der Datenschutzhinweis sagt das ausdrücklich. Entferne die SpalteS03vor der Auswertung aus dem Datensatz und lösche die Adressen, sobald die Ergebnisse verschickt sind. Brauchst du keine Ergebnisinformation, löscheS02undS03und den Absatz „Freiwillige Kontaktdaten“. - Personenbezogene Daten: Erhebst du Namen, Matrikelnummern, E-Mail-Adressen als Pflichtangabe oder nutzt Zugangscodes mit Zuordnung zu Personen, ist die Umfrage nicht mehr anonym. Dann muss der Datenschutzhinweis angepasst werden. Stimme dich in diesem Fall mit deiner Betreuung und gegebenenfalls mit dem Datenschutzbeauftragten der Universität ab.
- Freiwilligkeit: Die Teilnahme muss freiwillig sein. Die Einwilligung (
EW01) ist dafür die Grundlage.
Gestaltung anpassen
Farben und Schrift sind durch das CD vorgegeben und sollten nicht verändert werden.
Partnerlogo ergänzen (z. B. bei einer Kooperation): Lade das Logo als PNG hoch, SVG wird nicht angenommen. Am einfachsten geht das im Texteditor der Willkommensnachricht über das Bild-Symbol. Füge es dann in der Quelltext-Ansicht innerhalb des Kopfbereichs <div class="us-head" …> hinter dem Uni-Logo ein und gib ihm die Klasse us-partner:
<img class="us-partner" src="PFAD-ZUM-HOCHGELADENEN-LOGO.png" alt="Name des Partners">
Das Stylesheet ordnet das Partnerlogo rechts an und hält es kleiner als das Uni-Logo, weil das CD die Universität als Dachmarke vorsieht.
Logo auf jeder Seite: Unter Designvorlage-Optionen → Bilder kannst du „Logo“ auf Ja stellen. Als Datei ist unistuttgart_logo_de.png voreingestellt. Das Logo erscheint dann zusätzlich in der Kopfzeile jeder Seite.
Logogröße auf der Startseite (nur mit Theme-Rechten, gilt für alle Umfragen der Instanz): In css/custom.css die letzte Zahl in height:clamp(52px, 9vw, 88px) ändern. Das ist die Höhe auf großen Bildschirmen.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| Buttons und Auswahl sind grün, der Titel hat Serifen | Die Umfrage nutzt nicht das Uni-Theme | Schritt 3: Designvorlage auf unistuttgart_de stellen |
| Einzelne Elemente sind violett oder rot | Farbvariante wurde geändert | Designvorlage-Optionen: „Theme color“ auf Apple bzw. alles auf Geerbt |
| Logo fehlt, stattdessen steht dort „Universität Stuttgart“ | Theme nicht zugewiesen, oder das Theme wurde unter anderem Namen importiert | Schritt 3 prüfen. In der Theme-Liste muss das Theme unistuttgart_de heißen, sonst mit korrekt benannter ZIP neu importieren |
| Schrift wirkt wie Arial | Schriftdateien fehlen im Theme | Theme aus dist/unistuttgart_de.zip neu installieren. Arial ist laut CD die zulässige Ersatzschrift, die Umfrage ist also trotzdem korrekt |
| Import: „Can not import a theme that already exists!“ | Das Theme ist bereits installiert | Nichts zu tun, mit Schritt 2 weitermachen. Zum Aktualisieren das alte Theme vorher löschen |
| Import: „… because 'fruity_twentythree' is not installed“ | Standardtheme fehlt oder LimeSurvey ist älter als Version 6 | Administration kontaktieren |
| Import: „This ZIP archive contains no valid template files“ oder das Theme heißt anders | ZIP wurde entpackt und neu gepackt oder umbenannt | Original-ZIP erneut herunterladen (Schritt 1) |
| Kein Recht zum Theme-Import | Fehlende Berechtigung Designvorlagen → Importieren | Administration bitten, Schritt 1 einmalig auszuführen |
Für Maintainer
- Quelle:
theme/unistuttgart_de/. Gestaltungsänderungen gehören ausschließlich incss/custom.css. - ZIP neu bauen:
./scripts/build-theme-zip.sherzeugtdist/unistuttgart_de.zipmitconfig.xmlauf oberster Ebene. Packe die ZIP nicht von Hand, sonst landet die Struktur in einem Unterordner. - Version: Bei Änderungen
<version>und<lastUpdate>inconfig.xmlerhöhen und den Stand als Release taggen. Die ZIP zusätzlich als Release-Asset anzuhängen erleichtert den Download. - Aktualisieren auf einer Instanz: Unter Konfiguration → Designvorlagen im Designvorlagen-Editor von
unistuttgart_deden Inhalt voncss/custom.cssersetzen und speichern. Der Asset-Cache wird dabei automatisch zurückgesetzt. Alternativ das Theme löschen und neu importieren. Umfragen, die es nutzen, müssen dann neu zugewiesen werden. - Farblogik: Der erste Teil von
custom.cssfärbt alle Farbangaben der Variante Apple von Fruity TwentyThree in CD-Blautöne um. Diesen Teil hat ein Skript aus dem Original-Stylesheet abgeleitet. Er gilt für Fruity TwentyThree in LimeSurvey 7.0.x. Prüfe die Farben nach einem größeren LimeSurvey-Update.
Logo, Schrift und Lizenz
- Theme-Code (
config.xml,css/custom.css, Skripte): GNU General Public License, Version 2 oder später, sieheLICENSE. Das Theme baut auf Fruity TwentyThree der LimeSurvey GmbH auf, das ebenfalls unter der GPL steht. - Logo der Universität Stuttgart und Schrift Uni Stuttgart Sans fallen nicht unter diese Lizenz. Die Rechte liegen bei der Universität Stuttgart. Die Schrift stellt die Universität lizenzfrei zur Verfügung, ausdrücklich auch für externes Hosting.
- Nutzung des Logos: nur für Umfragen im Rahmen von Studium, Lehre und Forschung an der Universität Stuttgart und gemäß den Vorgaben des Corporate Designs der Universität Stuttgart. Für private oder kommerzielle Umfragen darf das Uni-Logo nicht verwendet werden.
