ModifyPluginViewEvent 

When it is dispatched 

The Job List b-ite dispatches the event once each time it renders, after the request and the result event ran and the postings are assigned to the view. The context names the extension AcademicBiteJobs, the plugin List and the action list.

The view holds {jobs} , the postings after the result listeners and the limit, {data} , the content element as an array, and {record} , the content element as a record. {settings} carries the view of the content element already normalised, see Select view.

What this extension passes in 

Example: when the postings were fetched 

The job list is cached with its page, so a visitor may see postings that were fetched hours ago. A site states the time of the request below the list. The listener runs when the page is rendered for the cache, which is when the postings were asked for, and hands that time to the view:

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use FGTCLB\AcademicBase\Event\ModifyPluginViewEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;
use TYPO3\CMS\Core\Context\Context;

final class AddFetchTimeToBiteJobList
{
    public function __construct(
        private readonly Context $context,
    ) {}

    #[AsEventListener(identifier: 'my-extension/add-fetch-time-to-bite-job-list')]
    public function __invoke(ModifyPluginViewEvent $event): void
    {
        $actionContext = $event->getPluginControllerActionContext();
        if ($actionContext->getControllerExtensionName() !== 'AcademicBiteJobs') {
            return;
        }
        $event->getView()->assign(
            'postingsFetchedAt',
            $this->context->getPropertyFromAspect('date', 'full'),
        );
    }
}

An override of Templates/BiteJobs/List.html renders it, see Templates:

<p class="ace-note">
    As of <f:format.date format="d.m.Y H:i">{postingsFetchedAt}</f:format.date>
</p>

Rules and pitfalls 

Change the postings in the result event. A listener that replaces {jobs} here works around the limit of the content element, and the postings it assigns reach no other listener. Remove, sort and enrich them in ModifyBiteJobPostingsEvent.

The event runs for the cache. Like the request and the result event, it runs when the page is rendered, not for every visitor of a cached page.

Introduced in 

• Feature: The plugin dispatches the plugin view event
• Breaking: The B-ITE jobs controller is final: the controller is final, a project assigns further view variables with this event instead of a subclass.