public function getElementsByName($name, $tags = '*')
{
// what are we doing?
$tag = $this->convertTagsToString($tags);
$log = usingLog()->startAction("get '{$tag}' elements with name '{$name}'");
// prepare the list of tags
if (is_string($tags)) {
$tags = array($tags);
}
// build up the xpath to use
$xpathList = array();
foreach ($tags as $tag) {
$xpathList[] = 'descendant::' . $tag . '[@name = "' . $name . '"]';
}
// find the matches
$elements = $this->getElementsByXpath($xpathList);
// log the result
$log->endAction(count($elements) . " element(s) found");
// return the elements
return $elements;
}