- fixed an issue regarding forms in Contao 4.13 69c0aa78a588697cbd8c56ce1e15bb3b06c07a9b
### Update
* Updated `form_wrapper` template to match the latest Contao `5.3.11` release 015ad24b976789fe6e7ca5153cef631ece500dce 25bdddc40158b194a7b0cc3d462a06a79450fdbb
### Update
Updated template for the latest Contao `5.3.10` release regarding double form submission and script evaluation in ajax forms
- Consider list-styles for `mod-newsmenu` fae38e4fccb57ec30cecc5ef01ff0718f1b12d20 (implements #36)
### Bugfix / Feature
- Consider bottom spacings within *_full templates https://github.com/contao-thememanager/core/pull/37 94baeac9a36e3a5f9e59ab25f0f5506f6d0d98a4
> If you are using content-elements within events or news details, this will now create a grid within the text-element. You are now able to also set up grid columns and leverage the flex-grid that you know from articles.
- Add a margin-bottom to `
`-elements created with tinymce 746d31aac3e88d6dc3e5a437cade19dbbec767ab
* Rewrite responsive classes to properly introduce aspect-ratios for videos without image sizes 048a0987147f0d144c22ce5d7d2083808cf5bf9a
* Allow border-styles within inner dividers 9ae830af170186d66722311d7a7bb1cdbe9a3983
## Bugfixes
* (Do not output numeric classes in the legacy gallery html template) b244929618da32a93cccafbd39f9b3b125ab3417
___
## Upgrading Version 2.0.* to ^2.1.*
### Twig
> [!IMPORTANT] > If you have overwritten the HTML-Templates for following contao components, you'll have to rewrite them into twig. > Getting used to twig right now is the best long-term goal to provide proper updates from contao elements without > relying on modifying too many tempplates. > > ```php > \Contao\ContentHeadline::class; > \Contao\ContentList::class; > \Contao\ContentText::class; > \Contao\ContentTable::class; > \Contao\ContentHyperlink::class; > \Contao\ContentToplink::class; > \Contao\ContentImage::class; > \Contao\ContentGallery::class; > \Contao\ContentPlayer::class; > \Contao\ContentYouTube::class; > \Contao\ContentVimeo::class; > \Contao\ContentDownloads::class; > \Contao\ContentDownload::class; > \Contao\ContentTeaser::class;
### But I want to go back to HTML5!
Please refer to the upgrade.md from Contao if you want to restore the classes, additionally you can just install plugins like: https://github.com/zoglo/contao-legacy-templates
> Please note that support for html templates will be dropped when Contao 4.13 support ends - get used to twig
### Classname changes with BC layer
The legacy `.ce_*`-classnames are reintroduced into the Twig-Templates. Please refer to the new ones when using Contao 5.3 in your own skin as they will be removed in version 2.2.
- use content-headings in all multi-column sections 4ed1fa7208a05ce7ca3397bb5faa68ff787609c8 > they will now work in `#left` and `#right` as well
- sort generated background image-options by filename f86372820a094407856cd63c065813cbcc6df79a
- reintroduced `
> [!NOTE] > The grid-gutter class for `fieldSetStart` is now a template variable. A BC-layer is included in the new template and will properly assign the class within the element. Saving the element will properly reassign it into the stylemanager blob.
### Updates
- Reverted `fieldSetStart` to type `fieldset` again ad4efa2bb1a6c992b7c021be2ed1d74643fbbe46
- Added `overflow: visible` and `overflow: hidden` to components and modules 2c255655714eb05f86b74f180e93441a18d374d0 d5097b81802b5b7a27a6eabea05f5f6377d4d663 a789e75ca4c4d9e17336531a6f8914c20a8507b9 - `.ov-h`: hidden - `.ov-v`: visible
- Added `$video-bg` and `aspect-ratio` to media elements f22b23a8b3a7d646954e7e4ffb54879a6feac803 175e499fba4d711a3709fade9613ba91d4f5bbbe > This should properly handle video posters
### Bugfixes
- Use `legend` in fieldsets 679a1ddf2038436b176b8abdca8a9c6149a15fa0
- Fixed a bug with dynamic property generation for background-sizes b631803c64be2cd500f84eb3d3930662ce6f22dc ec0fd1e0eaf5f4b6ba483f324072dd2feae21d6c 2c0038ac730bc92e81be4dcee3bacde52a932308
### Bugfixes
- Use `legend` in fieldsets 6e17f473598652a40d4c09f22b2e833cc873c471
- Allow basicEntities in headline2 (Contao 5 Bug) a45c8792464f1ebfc92c23f7db1bd5c5f060eb9f
### Feature
- Reordered typography compiler settings and added regular and invert colors for `` 23fdb9fa651bc5bbdea2826cfa1da2711252579d
### Improvement
- Performance optimizations to reduce compile time in `oveleon/contao-theme-compiler-bundle` https://github.com/oveleon/contao-theme-compiler-bundle/releases/tag/1.8.0 > Previously, every generated css file was synced with DBAFS, this has been rewritten to save on Database calls when the files already exist. > The old behavior can be restored with > ```yaml > # config/config.yml > contao_theme_compiler: > file_sync: true > ```
> [!IMPORTANT] > **Please check your theme configuration and check if you had unitless values within the configuration. This release fixes an issue where they will now be taken into consideration!**
___
### Fixes
* dropped restriction for empty units in [contao-theme-compiler-bundle](https://github.com/oveleon/contao-theme-compiler-bundle/releases/tag/1.7.2) to fix an issue with unitless config values (SCSS variables always worked, other values did not) bb37a1d78357ac9cc97c942cc571a4147a93a5cb
* fixed horizontal and vertical item padding regression from 584e9cae3e124ef23c4d06b63cf65881ef064088 > This most likely never had any visual bugs unless you were overwriting the custom property for your own needs
### Multi column layout changes
* Properly reset bottom-paddings within the main layout 0c7ffb4c3152de07d1a8a4fb561c119cc6d1c21a > `$article-main-spacing-bottom` should now work properly and you could assign the dynamic values such as `var(--art-py-1)`
* Rewrite column layout to column-gap instead of using ``calc()`` 06449eb3755426acfd61f873ebf77d81f835ea35
* Added row-gap to fix spacing issues between left / right / main on mobile devices 06449eb3755426acfd61f873ebf77d81f835ea35
### Features
* Added `` to headline units d752dfee61b6d3af19ade87842d3cb2d7af437c5
* Added overwriteMeta settings to image-components f867602dc5c4209801652fbb60505f74deea8b83
### Fixes
* Fix wrong table footer alignment in Contao 5.x 263a5a4460149ead5f42c8c618ad439c3a4601e7
* Fix line breaks in the theme configuration mask a158b195f3e605b58add19d3eabd7bd1d9e95e97 10b93b27319b8af85506169f6cfaee3e5ac2343f
* Fix potential warning within tl_settings (if the icon font does not exist anymore) 441e4edc5a5aee29f2c0162e4ea1a3a522cfd388
* Consider ``$form-label-spacing`` in labels e20fe2f545d04484028029ccb9f8ffdf192fd8f0
* Introduce ``$icon-rounded-border-radius`` in theme configuration to fix naming convention (should have been named icon circled) 39a4f7977e7a5f8812858e28d40bee1ee717b9d2
* Do not show style-manager options in fieldsetStop 68cf8d4fdcca38b422040962a331d9dca3e77c9e ___
### Features
* Add dynamic background-sizes 463b1594ff3e82fe8a062dae85eb09c8d53d687e > You can now [generate additional custom background-sizes](https://contao-thememanager.github.io/docs/pages/docs/configuration/theme/miscellaneous/#weitere-hintergrund-groen) under miscellaneous that will be available in all background-settings
* Allow all valid image extensions within image elements ce5b9bddc89e42aadd17dd3a527c59783f7c2363 > You can now choose all available image extensions within the custom image components
* Add display utilities to generate display-classes dynamically for all breakpoints fafae5004cdde17f689cd709b9b615e9b78e46de > You can now generate display: block / none / whatever across all breakpoints. Check the [documentation](https://contao-thememanager.github.io/docs/pages/docs/configuration/theme/miscellaneous/#dynamische-display-eigenschaften) for more information
* Add responsive navigation directions 05450d8df36e701961e945a15120a65945858b75 > Sometimes you want the navigation to open left on the medium breakpoint but right on the large breakpoint
* Introduce article-heights for ``wrapperStart (article)`` e4b7e1b9ff37d6392feca0c9c8630ca0632a1776 > This also takes the dynamic article heights into account
___
### Changes
* Load images via figure in custom image elements 8ff2271ba8376655801ce2ae26e67cff26d381ee > This way, additional data can be output within the custom image components
* Simplify custom element templates 20ed1c6124efde7d7c7f83e2c04866d5915b8444 > Less lines of code and more readable :)
* Preparation for CSS units within container configuration e2fa5bb47b1d4328ebd5361cef6b579170c10425 > First prep for removing $GLOBALS
- Update dependencies
- Update dependencies
### Bugfix
- Vertically align items again https://github.com/contao-thememanager/core/commit/e2c9745eb2ff59b3fe9baf7537db44bb844115c3 https://github.com/contao-thememanager/core/commit/8ef111d481519be222453e877de8ec1f1679defb
### Template change
- Update `form_captcha.html5` template for the latest captcha update https://github.com/contao-thememanager/core/commit/26eba391545318ff6ffb780f8564eeed6661a75b ___
This release adds new optimizations regarding article-spacings, icons and fixes issues regarding forms and form-field-icons
### Bugfixes
- Fixed a loading order issue when using form-field-icons https://github.com/contao-thememanager/core/commit/e9e7bd1fda168c3fd4cfb1d513ccb027fe8a7e42 https://github.com/contao-thememanager/core/commit/9563b1686000f4d7e603d90679d78eb0eb9a3f35
- Invert `:-webkit-autofill` color on `text-color-invert` https://github.com/contao-thememanager/core/commit/5b87fd1aab6464f3cc7df84b242f96c4a2e64ecf
### Optimizations
- Article spacings that match the same value are not compiled anymore https://github.com/contao-thememanager/core/commit/80a6f225752a6204c3cbba1cd1b5df554581493b
- Use shorthand icon font styles and add `-moz-osx-font-smoothing: grayscale` for Safari rendering https://github.com/contao-thememanager/core/commit/9563b1686000f4d7e603d90679d78eb0eb9a3f35
- Introduce custom property `--form-bdr-wdth` and use `calc()` for form-field-icon calculations
This release addresses issues that users have been experiencing creating and differentiating between the mentioned `default` and `content` layouts and fixes the custom font-family stripping quotes.
### Bugfix
* Correctly handle quoted strings within interpolation (fixed body font-family removing quotes)
* Notify users on wrong configurations within layouts https://github.com/contao-thememanager/core/commit/68a4f00fff3cdd7f1b0afee11b57b01a225368e2
### Optimizations
- Updated translations and changed `Headings (content)` to `Headings (Main column / Left column / Right column)` 5e01767d5744d00a14d0a6b0dfe9b76e2681b5a0
- Dropped `Layout column` option within the layout as it has been confusing users 3e141d4eb173811c686163c9c7c55ac9de647d30 be7008188006c23bb5369da75ea7dc0d8e3af53c
> This now works out of the box. The classes `layout-content`, `layout-content-1` and `layout-content-2` have been removed and are backwards compatible, `fe_page.html5` has been updated so `#container` is only shown when any previous `content-layout` has been used.
> The CSS has been adapted, the `#main` width has been rewritten to be more simple
- Added a checkbox so only normal heading settings are being used 1cdf5143d329a0326d2f82d9cafeeae92398aced 1cdf5143d329a0326d2f82d9cafeeae92398aced
> This is based on user feedback from 2+ people, a migration will take place when updating to this patch so old configurations won't be affected.
- fixed an issue with `font-size-base` not allowing the `rem` value https://github.com/contao-thememanager/core/commit/3a0b184ebb804a3f63b98c6ed0e7aafe8a882dfe
- fixed teaser not being shown in `news_short` and `event_teaser` https://github.com/contao-thememanager/core/commit/a699d33dde564816badd092e4a6075367647dd04
___
Addition
- added Contao 5.3 support https://github.com/contao-thememanager/core/commit/2ef8a8f9e1c4449bd067ad3a557542279b64553a https://github.com/contao-thememanager/core/commit/33ba6819ab14c2c5c139ca03cc58221c0b47ac1c
> Please mind that the ThemeManager will still run on the legacy HTML templates. Twig support has been planned in the next minor
- enable missing vertical text-alignment for icon-list and icon-text-list https://github.com/contao-thememanager/core/commit/6dd70119b8e2a72824e4cb10840b0c443a81b866
- replaced obsolete `$article-min-height` with dynamic option `$article-options-height` https://github.com/contao-thememanager/core/commit/0fd91cd286dcd2784b0f261384f2e7fb0d975443
> dynamic options generate after compilation: See: https://contao-thememanager.github.io/docs/pages/docs/configuration/theme/layout/#artikel-hohen
> You have to run a database migration for this to take effect. Once the migration happened, everything will stay the same but values from `$article-spacing-xs-*` will be moved into `$article-spacing-*` and replaced with the previous value.
Minor tweaks
- adjusted names for style manager groups https://github.com/contao-thememanager/core/commit/f96bce9f1c05461764add967ebddfba0ce85c71f
- Fixed img-inset not working for single box elements https://github.com/contao-thememanager/core/commit/89a967078e4499bf8c9a7d1d057d6d366f864ba7
- Fixed text-decoration wavy not working https://github.com/contao-thememanager/core/commit/b1abe8cf5e8de9cfa3c26363d478721198ab3149
- Added missing text-decorations `dotted` and `dashed` https://github.com/contao-thememanager/core/commit/b1abe8cf5e8de9cfa3c26363d478721198ab3149
- Added `woff2` support for Icon set generation https://github.com/contao-thememanager/core/commit/16fb487dee76ae730daae69c946475edc67f9c51
- Fixed an issue with toggle fieldset in theme config not working in contao 5 ([Config Driver](https://github.com/oveleon/contao-config-driver-bundle/releases/tag/1.3.1))
- added `.c_link` to every link component within modules and elements ea54119c56cfdccda465d99c7a094eb22d66b325
- make configGenerator methods available (public) b44a1d86130407d50d1a7f6284efa470d35f3434
- move dynamic options into bundle configuration 18241fc25414ea0c0f9623305c93314f104b052e
- redesign of the StyleManagerXML builder to simplify usage to allow overriding of dynamically added options c28d731de042209afe5c84a092877c54969861fb 1e3d46a399c6b7e7a5a8ac37a3a6eb5dac5becca 7718e3d6938a0ffda0508a0a36a9ce67f8bc4ee1
- Added a use-statement within image_list 146a6523efe33e7268be40a90457d7c90190a573
Dependency Updates
- Updated dependencies to fix bugs and enhance UX 5c8f9c84409b7f9dd22061a1c3a7e733766455ce
- Allow saving & compiling on newly created themes [(Theme Compiler - v.1.7.0)](https://github.com/oveleon/contao-theme-compiler-bundle/releases/tag/1.7.0)
- Fixed an issue with overriding values from bundle configs through imported style manager archives [(StyleManager - v3.4.1)](https://github.com/oveleon/contao-component-style-manager/releases/tag/3.4.1)
- Consider simultaneous top and bottom divider 3c70095483941c4ca3bfd68020a11d3dfb87e97d ede33ae8ab92e9639fc7730d7b1173d7260e607a - Consider auto-height for ce_image 55772730c897b7866177b234603291c6bd68084e - Fully support dark-mode 54430b462fd156306efc5b21840da3d5d0aa11f5 265e40a56383893e6c812e1e47565fab2e251ba6 > Contao ^5.2 only
Translations
- Changed ``Spacing`` to ``Margin`` for better comprehension 00746b4a7f40d97175f02ed7617c8a51d774446a - Removed ``ThemeManager``-prefix within Icon-Font settings 75cee58933531f69e147ed1aebbf9bcf21061731 - Renamed ``skin`` to ``theme`` 75cee58933531f69e147ed1aebbf9bcf21061731
## Notice An upgrade from the previous 1.x is **NOT possible and NOT recommended**.
_____
## Upgrade and Migration from 1.x Due to major breaking changes in the ThemeManager, such as new and reordered StyleManager options, major template changes, new class names, deprecations, and removals, we decided to release the ThemeManager as version 2. Upgrading is nearly impossible and not recommended. In case you accidentally upgraded from version 1.x, please follow this documentation on how to [restore from a backup](https://docs.contao.org/manual/en/cli/db-backups/).
_____
## What's New in 2.x
### Global / Quality of Life Changes - Simultaneous support for Contao 4.13.x, 5.1.x, 5.2.x - Complete rewrite of the framework to use [CSS custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/--*) - Configure images within the filesystem as backgrounds and automatically generate the CSS after compiling - Prefilled layout settings when creating a new layout - "main-below" is now the default when creating new articles - CSS inheritance to pass down options into child templates: > List items can now use image text settings, get paddings, borders, backgrounds, and more by inheritance using CSS custom properties. - New list settings for vertical & horizontal flexbox properties - Added default image sizes > Make sure to have an image library installed and/or change it to another image_service [[1]](https://github.com/contao/contao/issues/641#issuecomment-522635797) [[2]](https://github.com/contao/docs/issues/464) - Reworked wrappers to allow infinite nesting - Added color preview for text and background colors (user settings) - Background-images and colors can now be set within content-elements, modules, layouts, and pages - Box (previously known as boxed) can be set on every eligible component or their children - Box-elements are no longer text-color-regular by default and can be changed within the StyleManager options - Generated icons are now available within lists, downloads, and forms - All forms are now grid by default (login, password, comments, etc.) - You no longer need to select the image URL for image-list and image-text-lists to add the lightbox URL - Dynamic Style-Manager options after compilation (style-manager-tm-config) - Buttons now react to text-color-invert - New asset compiler overview - Reworked default theme configuration
_____
### ThemeManager Configuration - New ThemeManager configuration for better overview - Added text-transform for headlines - Added colors, font-weights, letter-spacings, and text-transform for content-headlines - Added image-text-behavior and image-text-ratio-options (dynamic property): - Added aspect-ratios for images (dynamic property) - Added min-height for articles and article vertical height (dynamic property) > Dynamic properties are available within the StyleManager options after compilation - Added article outer padding for more spacing on mobile devices - Added the possibility to change the select dropdown and checkbox symbol within ThemeManager config - Added table styles - Added header options - Added breadcrumb separator styles
_____
### StyleManager Options - New StyleManager groups - Global (outer scope) - Component (component scope) - Element (children scope) - New header options (fixed, undocked) - New article spacings (self-overlap, next-overlap) - Added article heights (vertical height) - New grid alignments (horizontal-items and vertical-items) - Added headline colors - Added pagination options - Added background options for global, component, and element scope - New background options (image, attachment, repeat, size, horizontal position, vertical position) - New image-text options for image-text, image-text-list, newslist, eventlist (cards) - Added responsive spacings (margins for every direction) for components and elements - Added responsive paddings for components and elements - Added box-mode for list-items - Added vertical alignment for list-items - Added options for lists and downloads (grid-list, direction, gutter, style, flex, markercolor) - Added vertical alignment for texts
_____
### Framework - New structure and CSS (base, components, layout, modules, overrides, styles, utils) - Changed classnames for better readability - Now based on custom properties - Added download styles - Added image-text styles - Added pagination styles - Added breadcrumb styles - Added table styles - Added background options - Added image options - Added header options - Added list options - Added responsive margins and paddings - And more...
_____
### Content Elements and Modules - Added icon content-element - Added support for almost every Contao core component - Added support for [faq](https://github.com/contao/faq-bundle) - Added support for [news](https://github.com/contao/news-bundle) - Added support for [comments](https://github.com/contao/comments-bundle) - Added support for [listing](https://github.com/contao/listing-bundle) - Added support for [events](https://github.com/contao/calendar-bundle)
_____
### Modifications
#### Gallery - Integrated ThemeManager framework into the gallery component
#### News - Added the possibility to hide the author name within the newslist - Added the possibility to remove the "by" prefix from news - Added the possibility to set a custom time format for news
#### FAQ - Added the possibility to change headline types (h1-h6) of FAQ page through style manager options
#### Comments - Added new translations ('1' comment and 'n' comments)
