YAMS + FirstChildRedirect

<?php
/**
 * @name FirstChildRedirect
 * @author Jason Coward <[email protected]>
 * @modified-by Ryan Thrash <[email protected]>
 * @license Public Domain
 * @version 1.0
 * 
 * This snippet redirects to the first child document of a folder in which this
 * snippet is included within the content (e.g. [!FirstChildRedirect!]).  This
 * allows MODx folders to emulate the behavior of real folders since MODx
 * usually treats folders as actual documents with their own content.
 * 
 * Modified to make Doc ID a required parameter... now defaults to the current 
 * Page/Folder you call the snippet from.
 * 
 * &docid=`12` 
 * Use the docid parameter to have this snippet redirect to the
 * first child document of the specified document.
 * 
 * &yams
 * Whether to use YAMS for the redirct URL construction
 */

$docid = (isset($docid))? $docid: $modx->documentIdentifier;
$yams = (isset($yams))? true : false;

$children= $modx->getActiveChildren($docid, 'menuindex', 'ASC');
if (!$children === false) {
    $firstChild= $children[0];
    $firstChildUrl= $modx->makeUrl($firstChild['id']);
} else {
    $firstChildUrl= $modx->makeUrl($modx->config['site_start']);
}
if ($yams) {
	$yams = YAMS::GetInstance();
	$firstChildUrl = $yams->ConstructUrl($yams->GetCurrentLangId(), $firstChild['id']);
}
return $modx->sendRedirect($firstChildUrl);
?>

[[FirstChildRedirect? &yams=`1`]]

<?php
// Get current language from YAMS
$yams = YAMS::GetInstance();
$lang = $yams->GetCurrentLangId();

// Create a Ditto call getting the children of  the current document
$firstChild = $modx->runSnippet(
        "Ditto",
        array(
            "parents" => $modx->documentIdentifier,
// Sort the results
            "orderBy" => "menuindex ASC",
            "noResults" => " ",
// Filter them to only display those with a pagetitle set in the current language
            "filter" => "pagetitle_$lang,,2",
// Leave just the first one
            "display" => "1",
// Get the id of the one selected document
            "tpl" => "@CODE [+id+]"
        )
);
if(trim($firstChild) != ''){
// If the Ditto call result is not empty, construct the url
    $firstChildUrl = $yams->ConstructUrl($lang, $firstChild);
} else {
// If the Ditto call result is empty, construct the url to the site start in the current language
    $firstChildUrl= $yams->ConstructUrl($lang, $modx->config['site_start']);
}
// Generate the redirect
return $modx->sendRedirect($firstChildUrl);
?>

<?php
$docid = (isset($docid))? $docid: $modx->documentIdentifier;

$children = $modx->getActiveChildren($docid, 'menuindex', 'ASC');
if (!$children === false)
{
    $firstChild = $children[0];
    $yams = YAMS::GetInstance();
    $firstChildUrl = $yams->ConstructUrl($yams->GetCurrentLangId(), $firstChild['id']);
}
else
{
    $firstChildUrl= $modx->makeUrl($modx->config['site_start']);
}
return $modx->sendRedirect($firstChildUrl);
?>

[[yamsFirstChild]]