Breaking: B-ITE job 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-item, ace-list, ace-attribute, ace-label, ace-value, ace-link 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: the grid classes row and col-*, the button classes btn and btn-* and visually-hidden. 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 positionClass. An override that renders one of them with positionClass renders the heading without that class.

Element Before After
List view academic-bite-jobs-itemlist ace-itemlist ace-list-view
Card view academic-bite-jobs-itemcards ace-itemlist ace-card-view
Item academic-bite-jobs-item card with card-body <article class="ace-item"> with ace-item-content
Attributes list-group list-group-flush with list-group-item entries ace-list with ace-list-item entries, ace-label and ace-value
Table view table table-striped academic-bite-jobs-itemtable, table-primary on the head, table-group-divider table-secondary on the body ace-table, ace-head, ace-body, rows ace-item, cells ace-label and ace-value
Link card-link ace-link
No result a plain <span> ace-empty

Impact 

  • A site stylesheet that styles the three views through the classes of the column Before no longer matches, and the table renders without the striping of a Bootstrap theme.

Affected Installations 

Every installation that renders the B-ITE job list.

Migration 

  1. 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 @extend in SCSS or with rules of its own.
  2. 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.
  3. Replace positionClass with class where an override renders BiteJobs/Header.html.
  4. Flush the TYPO3 caches, so the Fluid template cache is rebuilt.