api_generator / branches / master / views / elements / function_summary.ctp

history
<?php
/**
 * Function documentation element
 *
 */
?>
<a id="function-<?php echo $doc->name; ?>"></a>
<div class="function-info">
	<div class="doc-head">
		<h2><?php echo $doc->name; ?></h2>
		<a class="top-link scroll-link" href="#top-functions">top</a>
	</div>

	<div class="doc-body">
		<div class="markdown-block"><?php echo $doc->info['comment']['description']; ?></div>
	<dl>
		<?php if (count($doc->params)): ?>
		<dt><?php __('Parameters:'); ?></dt>
		<dd>
			<table>
				<tbody>
				<?php $i = 0; ?>
				<?php foreach ($doc->params as $name => $paramInfo): ?>
					<tr class="<?php echo ($i % 2) ? 'even' : 'odd'; ?>">
						<td>$<?php echo $name; ?></td>
						<td><?php echo $paramInfo['type']; ?></td>
						<td><?php echo $paramInfo['comment']; ?></td>
						<td><?php echo ($paramInfo['optional']) ? 'optional' : 'required'; ?></td>
						<td><?php echo ($paramInfo['hasDefault']) ? var_export($paramInfo['default'], true) : __('(no default)', true); ?></td>
					</tr>
					<?php $i++;?>
				<?php endforeach; ?>
				</tbody>
			</table>
		</dd>
		<?php endif; ?>
		
		<dt><?php __('Function defined in file:'); ?></dt>
		<dd><?php 
			echo $apiDoc->fileLink($doc->info['declaredInFile']);
			$pseudoClass = basename($doc->info['declaredInFile']);
			if ($apiDoc->inClassIndex($pseudoClass)):
				__(' on line ');
				echo $html->link($doc->info['startLine'], array(
					'controller' => 'api_classes',
					'action' => 'view_source', 
					$pseudoClass,
					'#line-'. $doc->info['startLine']
				));
			endif;
		?> </dd>
	</dl>
	<?php 
		unset($doc->info['comment']['tags']['param']);
		echo $this->element('tag_block', array('tags' => $doc->info['comment']['tags'])); 
	?>
	</div>
</div>