Showing MultiTV Data from Multiple Resources in DocLister

MultiTV works well when you are rendering one resource at a time. It becomes more complicated when you want DocLister to pull MultiTV-driven content from several resources in one listing.

The core limitation

MultiTV stores structured data per resource. DocLister can list the resources, but it does not magically merge complex MultiTV datasets across pages into one reusable output structure.

A reliable pattern

• use DocLister to fetch the resources you need
• decode or prepare the MultiTV data in prepare or in a helper snippet
• build explicit placeholders for the template

&tvList=`gallery`
&prepare=`prepareGalleryItems`

// prepareGalleryItems
$items = json_decode($data['tv.gallery'], true);
$data['gallery_count'] = is_array($items) ? count($items) : 0;
$data['gallery_first'] = $items[0]['image'] ?? '';
return $data;

Why this approach scales

You keep the listing logic in DocLister, but you move structured field interpretation into a place designed for data transformation. That is easier to debug than trying to treat MultiTV as a flat field everywhere.

If you need one combined output from many resources, build an aggregation step intentionally instead of hoping the raw TV values will line up on their own.