..  _important-1790323401:

=======================================================================
Important: The job list leaves the content element header to the layout
=======================================================================

Description
===========

A :guilabel:`Job list` content element renders through the content element
layout of the site, like any other content element. The layouts of
:guilabel:`EXT:fluid_styled_content` and of the bootstrap package render the
header and the subheader an editor enters, and the template of the plugin
rendered them a second time:

..  code-block:: html

    <f:render partial="Header/All" arguments="{_all}" />

With an explicit header layout the header and the subheader appeared twice.
With the header layout :guilabel:`Default` the plugin left an empty
:html:`<header></header>` element behind, because the header partial takes the
heading level for that layout from a setting the plugin settings did not carry.

The template now renders the header only when the site switches it on:

..  code-block:: typoscript
    :caption: TypoScript constants

    plugin.tx_academicbitejobs.renderContentElementHeader = 1

It is off by default.

The plugin settings now also carry :typoscript:`settings.defaultHeaderType`,
mapped from the constant :typoscript:`styles.content.defaultHeaderType` of
:guilabel:`EXT:fluid_styled_content`, so with the switch on the header layout
:guilabel:`Default` renders a heading. See
:ref:`configuration-general-content-element-header`.

Impact
======

On a site whose content element layout renders the header, the header of the
job list appears once, and the markup of the plugin no longer contains a
:html:`<header>` element.

Affected Installations
======================

Installations whose content element layout renders **no** header - a site
package that renders the header in its element templates instead - lose the
header of the job list. Switch :typoscript:`renderContentElementHeader` on for
such a site.

Projects that copied :file:`BiteJobs/List.html` keep rendering the header in
their copy. On a site whose layout renders the header, drop the
:html:`<f:render partial="Header/All" … />` line from the copy; on any other
site, keep it or wrap it in the same condition as the shipped template:

..  code-block:: html

    <f:if condition="{settings.renderContentElementHeader}">
        <f:render partial="Header/All" arguments="{_all}" />
    </f:if>

.. index:: Frontend, Fluid, TypoScript, ext:academic_bite_jobs