respondage_vanilla/README.md
Tammo ter Hark b6a9ac74db feat(options): logo top margin (logotopmargin)
- config.xml: new duration option "logotopmargin" in the Images category (default 15px).
- custom_header.twig: sets padding-top of the header logos, so 0px aligns a logo
  exactly with the top of the screen.

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-11-16 19:51:19 +01:00

2.1 KiB

Respondage Vanilla — LimeSurvey theme (version 6/7 compatible), extension of the core Vanilla theme.

This is the MOTHER theme. Client-specific variants (e.g. <client>_vanilla) extend this theme via <extends>respondage_vanilla</extends> and contain only a generated config.xml plus their own files/ (logos). LimeSurvey inherits all files (views, css, js, images, options page) from the mother theme, so any change to a file in this theme automatically applies to all variants — no copying of files needed.

What's in here

  • config.xml — theme manifest incl. all theme options (colors, fonts, font sizes/weights/colors, header logos, ...).
  • views/ — twig overrides (header with left/center/right logos and navbar menu color, survey list, question, group description).
  • sass/ → css/plain.css — theme styles (keep both in sync; plain.css is the compiled output of sass/plain.sass).
  • css/custom.css, scripts/custom.js — loaded last, safe for project tweaks.
  • options/ — options page assets.
  • variants/ — build/export tooling only. Client variant definitions (variants/*.json) hold confidential house-style values, are gitignored (see .gitignore) and live in the private variants repo, not here.

Header logos (left / center / right)

Three independent logo options in the Images category: brandlogo(+brandlogofile) left, centerlogo(+centerlogofile) center, rightlogo(+rightlogofile) right. The center logo is absolutely centered in the navbar (see sass/plain.sass). Logo files are looked up in the theme's own files/ folder first, then in the mother theme's files/ folder.

Menu item color in the top bar

Option navbarfontcolor (Colors category) sets the text color of the menu items in the navbar; it is applied in views/subviews/header/custom_header.twig and should contrast with headerbackgroundcolor.

Distance from the logo to the top of the screen

Option logotopmargin (Images category, e.g. 15px or 0px) sets the top padding of the header logos, applied in custom_header.twig. Use 0px to align a logo exactly with the top of the screen.