Using a TV Value as the documents Source for Ditto

This pattern is useful for “featured products”, “top picks”, or “hits” blocks. One document stores a list of resource IDs in a TV, and Ditto should render those specific resources everywhere else.

The key detail

If you call Ditto with &documents=`` on another page, it may not work because the TV is being read from the current resource instead of the dedicated source document.

Practical fix

First fetch the TV from the document that owns the list, then pass that value into Ditto’s &documents parameter.

$hits = $modx->getTemplateVarOutput('hit', $sourceDocId);
echo $modx->runSnippet('Ditto', array(
    'documents' => $hits['hit'],
    'tpl' => 'hit-tpl'
));