Override della paginazione di Joomla

Continuiamo a parlare di override per mostrare un’altra possibilità offerta da Joomla. Come sappiamo, quando sono presenti molti articoli Joomla mostra in fondo alla pagina uno strumento che permette di suddividere gli articoli su molte pagine e navigare tra di esse con facilità, la paginazione.

Se all’interno del template, nella cartella html, creiamo un file chiamato pagination.php, possiamo personalizzare il modo in cui viene gestita la paginazione.

Vediamo ad esempio come la gestisce il template rhuk_milkyway:

function pagination_list_footer($list)
{
	$html = "
<div class="\&quot;list-footer\&quot;">\n";
	$html .= "\n
<div class="\&quot;limit\&quot;">".JText::_('Display Num').$list['limitfield']."</div>
 
";
	$html .= $list['pageslinks'];
	$html .= "\n
<div class="\&quot;counter\&quot;">".$list['pagescounter']."</div>
 
";
 
	$html .= "\n
<input name="\&quot;limitstart\&quot;" type="\&quot;hidden\&quot;" value="\&quot;&quot;.$list['limitstart'].&quot;\&quot;" />";
	$html .= "\n</div>
 
";
	return $html;
}
 
function pagination_list_render($list)
{
	// Initialize variables
	$html = "<span class="\&quot;pagination\&quot;">";
	$html .= '<span>«</span>'.$list['start']['data'];
	$html .= $list['previous']['data'];
 
	foreach( $list['pages'] as $page )
	{
		if($page['data']['active']) {
			$html .= '<strong>';
		}
 
		$html .= $page['data'];
 
		if($page['data']['active']) {
			$html .= '</strong>';
		}
	}
 
	$html .= $list['next']['data'];
	$html .= $list['end']['data'];
	$html .= '<span>»</span>';
 
	$html .= "</span>";
	return $html;
}
 
function pagination_item_active(&amp;$item) {
	return "<a href="\">link."\" title=\"".$item-&gt;text."\"&gt;".$item-&gt;text."</a>";
}
 
function pagination_item_inactive(&amp;$item) {
	return "<span>".$item-&gt;text."</span>";
}

Quattro funzioni definiscono completamente come deve essere gestita la paginazione:
•    pagination_list_footer: mostra la form che permette di scegliere quanti elementi mostrare per pagina
•    pagination_list_render: mostra la paginazione, con tanto di link “Inizio”, “Prec.”, “Succ.”, “Fine”.
•    pagination_item_active: prepara e mostra il collegamento alle pagine precedenti e successive alla corrente.
•    pagination_item_inactive: mostra il riferimento alla pagina corrente, solitamente senza link.

Vediamo ad esempio come è scritto il pagination override del template Beez:

function pagination_list_footer($list)
{
	// Initialize variables
	$lang =& JFactory::getLanguage();
	$html = "
<div class="\&quot;list-footer\&quot;">\n";
 
	$html .= "\n
<div class="\&quot;limit\&quot;">".JText::_('Display Num').$list['limitfield']."</div>
 
";
	$html .= $list['pageslinks'];
	$html .= "\n
<div class="\&quot;counter\&quot;">".$list['pagescounter']."</div>
 
";
 
	$html .= "\n
<input name="\&quot;limitstart\&quot;" type="\&quot;hidden\&quot;" value="\&quot;&quot;.$list['limitstart'].&quot;\&quot;" />";
	$html .= "\n</div>
 
";
 
	return $html;
}
 
function pagination_list_render($list)
{
	// Initialize variables
	$lang =&amp; JFactory::getLanguage();
	$html = "
<ul class="\&quot;pagination\&quot;">";
 
	$html .= $list['start']['data'];
	$html .= $list['previous']['data'];
 
	foreach( $list['pages'] as $page )
	{
		if($page['data']['active']) {
			// $html .= '<strong>';
		}
 
		$html .= $page['data'];
 
		if($page['data']['active']) {
			//  $html .= '</strong>';
		}
	}
 
	$html .= $list['next']['data'];
	$html .= $list['end']['data'];
	// $html .= '«';
 
	$html .= "</ul>
 
";
	return $html;
}
 
function pagination_item_active(&amp;$item) {
	return "
<li><strong><a href="\">link."\" title=\"".$item-&gt;text."\"&gt;".$item-&gt;text."</a></strong></li>
 
";
}
 
function pagination_item_inactive(&amp;$item) {
	return "
<li>".$item-&gt;text."</li>
 
";
}