object-access

Class: \CPSIT\Typo3Handlebars\DataProcessing\ObjecAccessProcessor

Resolves a property (or nested property path) from an object and stores the resulting value in the processed data. This is useful for pulling individual properties out of an Extbase domain object (or any other object) that was placed into the data processing chain by a preceding processor or controller, without having to expose the whole object to the template.

Data sources

The object property does not name a source object directly. Instead, it names the key under which the object is stored, and that key is looked up across all four data sources, tried in the order listed:

Data source identifier	Contains
`processorConfiguration`	This processor's own config block
`processedData`	Accumulated output from previous processors
`contentObjectRenderer`	Current record's field values
`contentObjectConfiguration`	Top-level `HANDLEBARSTEMPLATE` config

This is what allows object to refer to a value placed into processedData by a preceding processor's as option, or to a variable an Extbase controller assigned directly to the view.

Usage

dataProcessing also runs for Extbase plugins whose controller extends HandlebarsController, since HandlebarsView renders through the same HANDLEBARSTEMPLATE content object under the hood. An action that assigns a domain object to the view makes that object available to object-access under the assigned key:

EXT:my_extension/Classes/Controller/BlogController.php

final class BlogController extends HandlebarsController
{
    public function showAction(Post $post): ResponseInterface
    {
        $this->view->assign('post', $post);

        return $this->htmlResponse($this->renderView());
    }
}

plugin.tx_myextension_blog.handlebars {
    Blog::show {
        dataProcessing {
            # Pull the related category's title off the assigned "post" object
            10 = object-access
            10 {
                object = post
                path = category.title
                as = categoryTitle
            }
        }
    }
}

Properties

object: Key under which the source object is looked up (see Data sources). Required.
path: Property path passed to TYPO3\CMS\Extbase\Reflection\ObjectAccess::getProperty(). Supports plain property names as well as dot-separated nested paths (e.g. category.title). Required.
as: Target key in the processed data array the resolved value is stored under. Default: result.

If object is not configured, or the resolved value is not an object, or path is missing, or path is not a gettable property on the resolved object, a warning is logged and the processed data is returned unchanged.

When the resolved value is itself an array, it is run through the standard TYPO3 dataProcessing chain configured on this processor, just like TYPO3's own menu or database-query processors do for their items.