..  _important-1790323400:

=========================================================================
Important: The job plugins leave the content element header to the layout
=========================================================================

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

A :guilabel:`Jobs List`, :guilabel:`Jobs Detail` or :guilabel:`Jobs New`
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 templates of the three plugins 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 templates now render the header only when the site switches it on:

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

    plugin.tx_academicjobs.renderContentElementHeader = 1

The same is the site setting :guilabel:`Render the content element header in
the plugins` of the set `fgtclb/academic-jobs`. 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
three content elements appears once, and the markup of the plugins 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 content elements. Switch
:typoscript:`renderContentElementHeader` on for such a site.

Projects that copied :file:`Job/List.html`, :file:`Job/Show.html` or
:file:`Job/New.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 templates:

..  code-block:: html

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

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