Breaking: Partner templates carry speaking classes
Description
The frontend templates of this extension carried the classes of the theme they
were developed with - cards, list groups, form controls, spacing and display
utilities - next to block and element classes of the extension. They carry
speaking classes now, named after what an element is and shared by all academic
extensions: ace-, ace-, ace-, ace-, ace-,
ace- and so on. The outermost element of a plugin keeps the class of the
plugin. The classes of Bootstrap that a site builds on stay on purpose where
the templates render them: container on the outermost element of a page of
the page type, the grid classes row and col-*, the button classes btn and
btn-* and visually-. No other theme class is rendered any more, and
the extension ships no styles for the new classes.
The header partials take the class of the heading as the argument class,
in place of position. An override that renders one of them with
position renders the heading without that class.
The map script finds the partners of the map by the attribute
data- now, no longer by the class
map-.
| Element | Before | After |
|---|---|---|
| Item list | row academic- | ace- around the row |
| Item | card flex- with card- and card- | <article class="ace- with ace- |
| Attributes of an item | list- with list- entries | ace- with ace- entries, ace-, ace- and ace- inside |
| No result | a plain <span> | ace- |
| Filter form | academic- | ace-, the fields in an ace- |
| Filter cell | the grid column only | ace- inside the column |
| Label and select | form-, form- | ace-, ace- |
| More filters | <details class="col- | <details class="ace- inside a col-, with <summary class="ace- |
| Result count | academic- | ace- |
| Active filters | academic- with __, __, __ | <ul class="ace- with ace- entries, the remove mark ace- |
| Reset link | academic- | ace- |
| Page | academic- | academic- |
| Header and media | d- | ace- |
| Page header | academic- | <header class="ace- with ace- on the heading |
| Subtitle | academic- | ace- |
| Partnerships | academic- and academic- | <article class="ace- in an ace- |
| Address of the page | a plain paragraph | ace- with ace- and ace- |
| Pagination | academic- around pagination | f3-, the entries keep page- and page- |
| Map element | academic-, academic- at full width | academic-, layout- at full width |
| Partners of the map | <ul id="map- with map- entries | <ul id="map- with ace- entries carrying data-, the title in an ace- |
| Map without partners | academic- | ace- |
Impact
- A site stylesheet that styles the partner list, the partnerships, the filters, the partner page or the map through the classes of the column Before no longer matches.
- An override of
Partner/that renders the partners with the classMap. html map-and without the attributepartner data-shows a map without markers.academic- partners- map- partner - The list of partners next to the map is hidden by the attribute
hiddenin place of the classd-of a Bootstrap theme.none
Affected Installations
Every installation that renders the partner list, the partner map, the partnership list or teaser, or a page of the partner page type.
Migration
- Move the selectors of the site stylesheet from the classes in the
column Before to those in the column After. A site that styled the
plugins through the classes of its Bootstrap theme alone gives the new
classes the look it wants, for example with
@extendin SCSS or with rules of its own. - A template override is compared with the shipped template of 3.0 and adopts its markup. An override keeps working as it is, but renders its own classes, and nothing in the extension relies on them.
- An override of
Partner/sets the attributeMap. html data-on every partner.academic- partners- map- partner - Replace
positionwithClass classwhere an override rendersPartner/.Header. html - Flush the TYPO3 caches, so the Fluid template cache is rebuilt.