---
title: "Job List b-ite"
manual: "Academic Bite Jobs"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:integrator-job-list-bite@main"
source: "Integrator/JobListBite.rst"
rendered: "2026-10-26T19:20:41+00:00"
---

# Job List b-ite {#integrator-job-list-bite}

![Icon of the Job List b-ite content element](../Images/Icons/bite-jobs.svg)

-   *CType:* `academicbitejobs_list`
-   *Plugin:*

    `AcademicBiteJobs`, plugin `List`, action
    `BiteJobsController::listAction()`

-   *Set:*

    `fgtclb/academic-bite-jobs-list`, or the aggregate set
    `fgtclb/academic-bite-jobs`

-   *Templates:*

    `Templates/BiteJobs/List.html`, with the partials
    `BiteJobs/Header.html` and `BiteJobs/View/List.html`,
    `BiteJobs/View/Card.html` or `BiteJobs/View/Table.html`, see
    [Templates](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:templates@main)

The job list shows the postings of one job listing on the B-ITE eRecruiting
platform. Each posting shows its title, linked to the posting on B-ITE, and the
day its application period ends. The postings are not records of the TYPO3
installation: the content element asks the search API of B-ITE for them each
time the page is rendered, and an editor maintains them in B-ITE.

It is the content element for an institution that publishes its vacancies in
B-ITE and wants them on its website, without entering them twice. To show only
part of a job listing, a group of positions for example, a project narrows the
request with an event listener, see [For developers](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:developers@main).

The list is cached with its page, and a cached page does not ask B-ITE again.
A new posting therefore appears when the cache entry of the page ends, so set
the field **Cache Lifetime** of the page to how current the list has
to be.

When B-ITE answers with no postings, or the request fails, the list shows the
text "There are currently no job vacancies." instead. A failed request is
logged as an error.

![The text "There are currently no job vacancies." in place of the list](../Images/Screenshots/job-list-bite-empty.png)

The content element works on its own. It has no detail page in TYPO3, the
titles link to B-ITE. Its header is rendered by the content element layout of
the site, see [The header of the content element](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:configuration-general-content-element-header@main).

<a id="configuration-general-view"></a>

## Settings {#integrator-job-list-bite-settings}

-   **Job listing key**

    -   *Type:* text
    -   *Default:* empty

    The key of the job listing in B-ITE whose postings the list shows. The
    key is sent with every request and decides which postings B-ITE answers
    with. It is usually found in the address or the source of an existing
    B-ITE job advertisement of the institution.

    Empty, the request names no job listing and the list shows its empty
    state. The key is read from the content element only, a TypoScript value
    does not replace it.

-   **Select view**

    -   *Type:* select
    -   *Default:* List

    How the postings are shown. **List** and **Card** render
    the same content in a list of articles, which differ by their class only,
    `ace-list-view` and `ace-card-view`. The extension ships no
    stylesheet, so the stylesheet of the site decides how the two look, see
    [The job list](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:styling-list@main). **Table** renders a table with the title and
    the end of the application period as columns, and opens a posting in a new
    window.

    Use the table for a long listing that visitors scan, and the list or the
    cards for a few postings on a page with other content.

    The stored values are `List`, `Card` and `Table`. Content elements saved
    with version 2.0 store `ListView`, `CardView` or `TableView`. They render
    the corresponding view, and a content element with an empty or unknown
    value renders the list view. Templates always receive the normalised value
    in `{settings.jobs.view}`.

    The upgrade wizard `academicBiteJobs_listViewFlexFormUpgradeWizard`
    rewrites the stored values of existing content elements, so their backend
    form shows the view the frontend renders.

-   **Sort by**

    -   *Type:* select
    -   *Default:* Ends on

    The field B-ITE sorts the postings by: **Ends on**, the end of the
    application period, or **Title**. The value is sent with the
    request, B-ITE sorts.

    Sort by the end of the application period for a list that puts the most
    urgent postings first, by title for a long list that visitors search by
    name.

-   **Sort direction**

    -   *Type:* select
    -   *Default:* Ascending

    **Ascending** or **Descending**, sent with the request
    together with [Sort by](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:confval-job-list-bite-sort-by@main). Ascending by the
    end of the application period lists the postings that end first at the top.

-   **Maximum number of job offers**

    -   *Type:* number
    -   *Default:* empty

    The most postings the list shows. Empty or `0` shows every posting B-ITE
    answers with.

    The limit is applied after the event listeners handled the postings, so a
    listener that removes postings still leaves the list as many as the limit
    allows. Use it for a teaser of the latest vacancies on a start page.