Upgrade to KH 3.1.3.1
This commit is contained in:
Deon George
@@ -1,285 +0,0 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
/**
|
||||
* Pagination links generator.
|
||||
*
|
||||
* @package Kohana/Pagination
|
||||
* @category Base
|
||||
* @author Kohana Team
|
||||
* @copyright (c) 2008-2009 Kohana Team
|
||||
* @license http://kohanaphp.com/license.html
|
||||
*/
|
||||
class Kohana_Pagination {
|
||||
|
||||
// Merged configuration settings
|
||||
protected $config = array(
|
||||
'current_page' => array('source' => 'query_string', 'key' => 'page'),
|
||||
'total_items' => 0,
|
||||
'items_per_page' => 10,
|
||||
'view' => 'pagination/basic',
|
||||
'auto_hide' => TRUE,
|
||||
'first_page_in_url' => FALSE,
|
||||
);
|
||||
|
||||
// Current page number
|
||||
protected $current_page;
|
||||
|
||||
// Total item count
|
||||
protected $total_items;
|
||||
|
||||
// How many items to show per page
|
||||
protected $items_per_page;
|
||||
|
||||
// Total page count
|
||||
protected $total_pages;
|
||||
|
||||
// Item offset for the first item displayed on the current page
|
||||
protected $current_first_item;
|
||||
|
||||
// Item offset for the last item displayed on the current page
|
||||
protected $current_last_item;
|
||||
|
||||
// Previous page number; FALSE if the current page is the first one
|
||||
protected $previous_page;
|
||||
|
||||
// Next page number; FALSE if the current page is the last one
|
||||
protected $next_page;
|
||||
|
||||
// First page number; FALSE if the current page is the first one
|
||||
protected $first_page;
|
||||
|
||||
// Last page number; FALSE if the current page is the last one
|
||||
protected $last_page;
|
||||
|
||||
// Query offset
|
||||
protected $offset;
|
||||
|
||||
/**
|
||||
* Creates a new Pagination object.
|
||||
*
|
||||
* @param array configuration
|
||||
* @return Pagination
|
||||
*/
|
||||
public static function factory(array $config = array())
|
||||
{
|
||||
return new Pagination($config);
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a new Pagination object.
|
||||
*
|
||||
* @param array configuration
|
||||
* @return void
|
||||
*/
|
||||
public function __construct(array $config = array())
|
||||
{
|
||||
// Overwrite system defaults with application defaults
|
||||
$this->config = $this->config_group() + $this->config;
|
||||
|
||||
// Pagination setup
|
||||
$this->setup($config);
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieves a pagination config group from the config file. One config group can
|
||||
* refer to another as its parent, which will be recursively loaded.
|
||||
*
|
||||
* @param string pagination config group; "default" if none given
|
||||
* @return array config settings
|
||||
*/
|
||||
public function config_group($group = 'default')
|
||||
{
|
||||
// Load the pagination config file
|
||||
$config_file = Kohana::config('pagination');
|
||||
|
||||
// Initialize the $config array
|
||||
$config['group'] = (string) $group;
|
||||
|
||||
// Recursively load requested config groups
|
||||
while (isset($config['group']) AND isset($config_file->$config['group']))
|
||||
{
|
||||
// Temporarily store config group name
|
||||
$group = $config['group'];
|
||||
unset($config['group']);
|
||||
|
||||
// Add config group values, not overwriting existing keys
|
||||
$config += $config_file->$group;
|
||||
}
|
||||
|
||||
// Get rid of possible stray config group names
|
||||
unset($config['group']);
|
||||
|
||||
// Return the merged config group settings
|
||||
return $config;
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads configuration settings into the object and (re)calculates pagination if needed.
|
||||
* Allows you to update config settings after a Pagination object has been constructed.
|
||||
*
|
||||
* @param array configuration
|
||||
* @return object Pagination
|
||||
*/
|
||||
public function setup(array $config = array())
|
||||
{
|
||||
if (isset($config['group']))
|
||||
{
|
||||
// Recursively load requested config groups
|
||||
$config += $this->config_group($config['group']);
|
||||
}
|
||||
|
||||
// Overwrite the current config settings
|
||||
$this->config = $config + $this->config;
|
||||
|
||||
// Only (re)calculate pagination when needed
|
||||
if ($this->current_page === NULL
|
||||
OR isset($config['current_page'])
|
||||
OR isset($config['total_items'])
|
||||
OR isset($config['items_per_page']))
|
||||
{
|
||||
// Retrieve the current page number
|
||||
if ( ! empty($this->config['current_page']['page']))
|
||||
{
|
||||
// The current page number has been set manually
|
||||
$this->current_page = (int) $this->config['current_page']['page'];
|
||||
}
|
||||
else
|
||||
{
|
||||
switch ($this->config['current_page']['source'])
|
||||
{
|
||||
case 'query_string':
|
||||
$this->current_page = isset($_GET[$this->config['current_page']['key']])
|
||||
? (int) $_GET[$this->config['current_page']['key']]
|
||||
: 1;
|
||||
break;
|
||||
|
||||
case 'route':
|
||||
$this->current_page = (int) Request::current()->param($this->config['current_page']['key'], 1);
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
// Calculate and clean all pagination variables
|
||||
$this->total_items = (int) max(0, $this->config['total_items']);
|
||||
$this->items_per_page = (int) max(1, $this->config['items_per_page']);
|
||||
$this->total_pages = (int) ceil($this->total_items / $this->items_per_page);
|
||||
$this->current_page = (int) min(max(1, $this->current_page), max(1, $this->total_pages));
|
||||
$this->current_first_item = (int) min((($this->current_page - 1) * $this->items_per_page) + 1, $this->total_items);
|
||||
$this->current_last_item = (int) min($this->current_first_item + $this->items_per_page - 1, $this->total_items);
|
||||
$this->previous_page = ($this->current_page > 1) ? $this->current_page - 1 : FALSE;
|
||||
$this->next_page = ($this->current_page < $this->total_pages) ? $this->current_page + 1 : FALSE;
|
||||
$this->first_page = ($this->current_page === 1) ? FALSE : 1;
|
||||
$this->last_page = ($this->current_page >= $this->total_pages) ? FALSE : $this->total_pages;
|
||||
$this->offset = (int) (($this->current_page - 1) * $this->items_per_page);
|
||||
}
|
||||
|
||||
// Chainable method
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generates the full URL for a certain page.
|
||||
*
|
||||
* @param integer page number
|
||||
* @return string page URL
|
||||
*/
|
||||
public function url($page = 1)
|
||||
{
|
||||
// Clean the page number
|
||||
$page = max(1, (int) $page);
|
||||
|
||||
// No page number in URLs to first page
|
||||
if ($page === 1 AND ! $this->config['first_page_in_url'])
|
||||
{
|
||||
$page = NULL;
|
||||
}
|
||||
|
||||
switch ($this->config['current_page']['source'])
|
||||
{
|
||||
case 'query_string':
|
||||
return URL::site(Request::current()->uri).URL::query(array($this->config['current_page']['key'] => $page));
|
||||
|
||||
case 'route':
|
||||
return URL::site(Request::current()->uri(array($this->config['current_page']['key'] => $page))).URL::query();
|
||||
}
|
||||
|
||||
return '#';
|
||||
}
|
||||
|
||||
/**
|
||||
* Checks whether the given page number exists.
|
||||
*
|
||||
* @param integer page number
|
||||
* @return boolean
|
||||
* @since 3.0.7
|
||||
*/
|
||||
public function valid_page($page)
|
||||
{
|
||||
// Page number has to be a clean integer
|
||||
if ( ! Validate::digit($page))
|
||||
return FALSE;
|
||||
|
||||
return $page > 0 AND $page <= $this->total_pages;
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders the pagination links.
|
||||
*
|
||||
* @param mixed string of the view to use, or a Kohana_View object
|
||||
* @return string pagination output (HTML)
|
||||
*/
|
||||
public function render($view = NULL)
|
||||
{
|
||||
// Automatically hide pagination whenever it is superfluous
|
||||
if ($this->config['auto_hide'] === TRUE AND $this->total_pages <= 1)
|
||||
return '';
|
||||
|
||||
if ($view === NULL)
|
||||
{
|
||||
// Use the view from config
|
||||
$view = $this->config['view'];
|
||||
}
|
||||
|
||||
if ( ! $view instanceof Kohana_View)
|
||||
{
|
||||
// Load the view file
|
||||
$view = View::factory($view);
|
||||
}
|
||||
|
||||
// Pass on the whole Pagination object
|
||||
return $view->set(get_object_vars($this))->set('page', $this)->render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Renders the pagination links.
|
||||
*
|
||||
* @return string pagination output (HTML)
|
||||
*/
|
||||
public function __toString()
|
||||
{
|
||||
return $this->render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a Pagination property.
|
||||
*
|
||||
* @param string URI of the request
|
||||
* @return mixed Pagination property; NULL if not found
|
||||
*/
|
||||
public function __get($key)
|
||||
{
|
||||
return isset($this->$key) ? $this->$key : NULL;
|
||||
}
|
||||
|
||||
/**
|
||||
* Updates a single config setting, and recalculates pagination if needed.
|
||||
*
|
||||
* @param string config key
|
||||
* @param mixed config value
|
||||
* @return void
|
||||
*/
|
||||
public function __set($key, $value)
|
||||
{
|
||||
$this->setup(array($key => $value));
|
||||
}
|
||||
|
||||
} // End Pagination
|
||||
@@ -1,3 +0,0 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
class Pagination extends Kohana_Pagination {}
|
||||
@@ -1,15 +0,0 @@
|
||||
<?php defined('SYSPATH') or die('No direct script access.');
|
||||
|
||||
return array(
|
||||
|
||||
// Application defaults
|
||||
'default' => array(
|
||||
'current_page' => array('source' => 'query_string', 'key' => 'page'), // source: "query_string" or "route"
|
||||
'total_items' => 0,
|
||||
'items_per_page' => 10,
|
||||
'view' => 'pagination/basic',
|
||||
'auto_hide' => TRUE,
|
||||
'first_page_in_url' => FALSE,
|
||||
),
|
||||
|
||||
);
|
||||
@@ -1,37 +0,0 @@
|
||||
<p class="pagination">
|
||||
|
||||
<?php if ($first_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($first_page)) ?>" rel="first"><?php echo __('First') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('First') ?>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($previous_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($previous_page)) ?>" rel="prev"><?php echo __('Previous') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('Previous') ?>
|
||||
<?php endif ?>
|
||||
|
||||
<?php for ($i = 1; $i <= $total_pages; $i++): ?>
|
||||
|
||||
<?php if ($i == $current_page): ?>
|
||||
<strong><?php echo $i ?></strong>
|
||||
<?php else: ?>
|
||||
<a href="<?php echo HTML::chars($page->url($i)) ?>"><?php echo $i ?></a>
|
||||
<?php endif ?>
|
||||
|
||||
<?php endfor ?>
|
||||
|
||||
<?php if ($next_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($next_page)) ?>" rel="next"><?php echo __('Next') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('Next') ?>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($last_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($last_page)) ?>" rel="last"><?php echo __('Last') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('Last') ?>
|
||||
<?php endif ?>
|
||||
|
||||
</p><!-- .pagination -->
|
||||
@@ -1,94 +0,0 @@
|
||||
<?php
|
||||
/*
|
||||
First Previous 1 2 3 ... 22 23 24 25 26 [27] 28 29 30 31 32 ... 48 49 50 Next Last
|
||||
*/
|
||||
|
||||
// Number of page links in the begin and end of whole range
|
||||
$count_out = ( ! empty($config['count_out'])) ? (int) $config['count_out'] : 3;
|
||||
// Number of page links on each side of current page
|
||||
$count_in = ( ! empty($config['count_in'])) ? (int) $config['count_in'] : 5;
|
||||
|
||||
// Beginning group of pages: $n1...$n2
|
||||
$n1 = 1;
|
||||
$n2 = min($count_out, $total_pages);
|
||||
|
||||
// Ending group of pages: $n7...$n8
|
||||
$n7 = max(1, $total_pages - $count_out + 1);
|
||||
$n8 = $total_pages;
|
||||
|
||||
// Middle group of pages: $n4...$n5
|
||||
$n4 = max($n2 + 1, $current_page - $count_in);
|
||||
$n5 = min($n7 - 1, $current_page + $count_in);
|
||||
$use_middle = ($n5 >= $n4);
|
||||
|
||||
// Point $n3 between $n2 and $n4
|
||||
$n3 = (int) (($n2 + $n4) / 2);
|
||||
$use_n3 = ($use_middle && (($n4 - $n2) > 1));
|
||||
|
||||
// Point $n6 between $n5 and $n7
|
||||
$n6 = (int) (($n5 + $n7) / 2);
|
||||
$use_n6 = ($use_middle && (($n7 - $n5) > 1));
|
||||
|
||||
// Links to display as array(page => content)
|
||||
$links = array();
|
||||
|
||||
// Generate links data in accordance with calculated numbers
|
||||
for ($i = $n1; $i <= $n2; $i++)
|
||||
{
|
||||
$links[$i] = $i;
|
||||
}
|
||||
if ($use_n3)
|
||||
{
|
||||
$links[$n3] = '…';
|
||||
}
|
||||
for ($i = $n4; $i <= $n5; $i++)
|
||||
{
|
||||
$links[$i] = $i;
|
||||
}
|
||||
if ($use_n6)
|
||||
{
|
||||
$links[$n6] = '…';
|
||||
}
|
||||
for ($i = $n7; $i <= $n8; $i++)
|
||||
{
|
||||
$links[$i] = $i;
|
||||
}
|
||||
|
||||
?>
|
||||
<p class="pagination">
|
||||
|
||||
<?php if ($first_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($first_page)) ?>" rel="first"><?php echo __('First') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('First') ?>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($previous_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($previous_page)) ?>" rel="prev"><?php echo __('Previous') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('Previous') ?>
|
||||
<?php endif ?>
|
||||
|
||||
<?php foreach ($links as $number => $content): ?>
|
||||
|
||||
<?php if ($number === $current_page): ?>
|
||||
<strong><?php echo $content ?></strong>
|
||||
<?php else: ?>
|
||||
<a href="<?php echo HTML::chars($page->url($number)) ?>"><?php echo $content ?></a>
|
||||
<?php endif ?>
|
||||
|
||||
<?php endforeach ?>
|
||||
|
||||
<?php if ($next_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($next_page)) ?>" rel="next"><?php echo __('Next') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('Next') ?>
|
||||
<?php endif ?>
|
||||
|
||||
<?php if ($last_page !== FALSE): ?>
|
||||
<a href="<?php echo HTML::chars($page->url($last_page)) ?>" rel="last"><?php echo __('Last') ?></a>
|
||||
<?php else: ?>
|
||||
<?php echo __('Last') ?>
|
||||
<?php endif ?>
|
||||
|
||||
</p><!-- .pagination -->
|
||||
Reference in New Issue
Block a user