feat(variants): custom fonts per client variant
- config.xml: "Custom (this theme)" optgroup in the font dropdown plus an instruction comment on how to place a custom font (@font-face + body class in the variant's own css). - variants/build.php: supports "fontOptions" (dropdown entries) and "files_add" (extra css/js of the variant) in the variant json. - README.md: "Custom fonts per variant" section. data-font-package stays "websafe" because LimeSurvey only knows core font packages; the real font is loaded via the variant's css. Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
parent
b6a9ac74db
commit
02eda6c503
1 changed files with 68 additions and 1 deletions
33
README.md
33
README.md
|
|
@ -42,3 +42,36 @@ 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.
|
||||
|
||||
## Custom fonts per variant
|
||||
|
||||
LimeSurvey only knows its core font packages (`application/config/fonts.php`),
|
||||
so a theme cannot register a `font-*` package itself. Instead a variant ships
|
||||
its own font files and css:
|
||||
|
||||
1. Put the font files in the variant's `files/fonts/` (e.g. `my-custom-font.woff2`).
|
||||
2. Create `css/variant.css` in the variant with the `@font-face` and the body
|
||||
class rule (the selected font is applied as `font-<value>` on `<body>`):
|
||||
```css
|
||||
@font-face {
|
||||
font-family: 'My Custom Font';
|
||||
src: url('../files/fonts/my-custom-font.woff2') format('woff2');
|
||||
font-weight: 400; font-style: normal;
|
||||
}
|
||||
body.font-my_custom_font {
|
||||
font-family: 'My Custom Font', Arial, sans-serif;
|
||||
}
|
||||
```
|
||||
(`../files/...` works because the asset manager copies the whole theme dir.)
|
||||
3. In `variants/<client>.json` declare the css file and the dropdown entry:
|
||||
```json
|
||||
{
|
||||
"files_add": { "css": ["css/variant.css"], "js": [] },
|
||||
"fontOptions": [ { "value": "my_custom_font", "label": "My Custom Font" } ]
|
||||
}
|
||||
```
|
||||
`build.php` appends the css to the `<files>` list and the font to the
|
||||
"Custom (this theme)" optgroup of the font dropdown (`data-font-package`
|
||||
stays `websafe`, so no nonexistent package is requested — the real font is
|
||||
loaded by the variant's own css).
|
||||
4. Run `php variants/build.php <client>` and upload/reset as usual.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue