Viewing file:  util_paginator.php (13.26 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?php
/**
* Template logic
*
* The following functions are utility functions for this template. Do not
* echo output in those functions. Output is generated above this comment block
*
* @copyright © 2005-2006 The SquirrelMail Project Team
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
* @version $Id: util_paginator.php,v 1.5 2006/01/23 18:46:27 tokul Exp $
* @package squirrelmail
*/
/**
* Generate a paginator link.
*
* @param string $box Mailbox name
* @param integer $start_msg Message Offset
* @param string $text text used for paginator link
* @return string
*/
function get_paginator_link($box, $start_msg, $text) {
sqgetGlobalVar('PHP_SELF',$php_self,SQ_SERVER);
$result = "<a href=\"$php_self?startMessage=$start_msg&mailbox=$box\" "
. ">$text</a>";
return ($result);
}
/**
* This function computes the comapact paginator string.
*
* @param string $box mailbox name
* @param integer $iOffset offset in total number of messages
* @param integer $iTotal total number of messages
* @param integer $iLimit maximum number of messages to show on a page
* @param bool $bShowAll show all messages at once (non paginate mode)
* @return string $result paginate string with links to pages
*/
function get_compact_paginator_str($box, $iOffset, $iTotal, $iLimit, $bShowAll, $javascript_on, $page_selector) {
sqgetGlobalVar('PHP_SELF',$php_self,SQ_SERVER);
/* Initialize paginator string chunks. */
$prv_str = '';
$nxt_str = '';
$pg_str = '';
$all_str = '';
$box = urlencode($box);
/* Create simple strings that will be creating the paginator. */
$spc = ' '; /* This will be used as a space. */
$sep = '|'; /* This will be used as a seperator. */
/* Make sure that our start message number is not too big. */
$iOffset = min($iOffset, $iTotal);
/* Compute the starting message of the previous and next page group. */
$next_grp = $iOffset + $iLimit;
$prev_grp = $iOffset - $iLimit;
if (!$bShowAll) {
/* Compute the basic previous and next strings. */
if (($next_grp <= $iTotal) && ($prev_grp >= 0)) {
$prv_str = get_paginator_link($box, $prev_grp, '<');
$nxt_str = get_paginator_link($box, $next_grp, '>');
} else if (($next_grp > $iTotal) && ($prev_grp >= 0)) {
$prv_str = get_paginator_link($box, $prev_grp, '<');
$nxt_str = '>';
} else if (($next_grp <= $iTotal) && ($prev_grp < 0)) {
$prv_str = '<';
$nxt_str = get_paginator_link($box, $next_grp, '>');
}
/* Page selector block. Following code computes page links. */
if ($iLimit != 0 && $page_selector && ($iTotal > $iLimit)) {
/* Most importantly, what is the current page!!! */
$cur_pg = intval($iOffset / $iLimit) + 1;
/* Compute total # of pages and # of paginator page links. */
$tot_pgs = ceil($iTotal / $iLimit); /* Total number of Pages */
$last_grp = (($tot_pgs - 1) * $iLimit) + 1;
}
} else {
$pg_str = "<a href=\"$php_self?showall=0"
. "&startMessage=1&mailbox=$box\" "
. ">" ._("Paginate") . '</a>';
}
/* Put all the pieces of the paginator string together. */
/**
* Hairy code... But let's leave it like it is since I am not certain
* a different approach would be any easier to read. ;)
*/
$result = '';
if ( $prv_str || $nxt_str ) {
/* Compute the 'show all' string. */
$all_str = "<a href=\"$php_self?showall=1"
. "&startMessage=1&mailbox=$box\" "
. ">" . _("Show All") . '</a>';
$result .= '[' . get_paginator_link($box, 1, '<<') . ']';
$result .= '[' . $prv_str . ']';
$pg_url = $php_self . '?mailbox=' . $box;
$result .= '[' . $nxt_str . ']';
$result .= '[' . get_paginator_link($box, $last_grp, '>>') . ']';
if ($page_selector) {
$result .= $spc . '<select name="startMessage"';
if ($javascript_on) {
$result .= ' onchange="JavaScript:SubmitOnSelect'
. '(this, \'' . $pg_url . '&startMessage=\')"';
}
$result .='>';
for ($p = 0; $p < $tot_pgs; $p++) {
$result .= '<option ';
if (($p+1) == $cur_pg) $result .= 'selected ';
$result .= 'value="' . (($p*$iLimit)+1) . '">'
. ($p+1) . "/$tot_pgs" . '</option>';
}
$result .= '</select>';
if ($javascript_on) {
$result .= '<noscript language="JavaScript">'
. addSubmit(_("Go"))
. '</noscript>';
} else {
$result .= addSubmit(_("Go"));
}
}
}
$result .= ($pg_str != '' ? '['.$pg_str.']' . $spc : '');
$result .= ($all_str != '' ? $spc . '['.$all_str.']' . $spc . $spc : '');
/* If the resulting string is blank, return a non-breaking space. */
if ($result == '') {
$result = ' ';
}
/* Return our final magical paginator string. */
return ($result);
}
/**
* This function computes the paginator string.
*
* @param string $box mailbox name
* @param integer $iOffset offset in total number of messages
* @param integer $iTotal total number of messages
* @param integer $iLimit maximum number of messages to show on a page
* @param bool $bShowAll show all messages at once (non paginate mode)
* @return string $result paginate string with links to pages
*/
function get_paginator_str($box, $iOffset, $iTotal, $iLimit, $bShowAll,$page_selector, $page_selector_max) {
sqgetGlobalVar('PHP_SELF',$php_self,SQ_SERVER);
/* Initialize paginator string chunks. */
$prv_str = '';
$nxt_str = '';
$pg_str = '';
$all_str = '';
$box = urlencode($box);
/* Create simple strings that will be creating the paginator. */
$spc = ' '; /* This will be used as a space. */
$sep = '|'; /* This will be used as a seperator. */
/* Make sure that our start message number is not too big. */
$iOffset = min($iOffset, $iTotal);
/* Compute the starting message of the previous and next page group. */
$next_grp = $iOffset + $iLimit;
$prev_grp = $iOffset - $iLimit;
if (!$bShowAll) {
/* Compute the basic previous and next strings. */
if (($next_grp <= $iTotal) && ($prev_grp >= 0)) {
$prv_str = get_paginator_link($box, $prev_grp, _("Previous"));
$nxt_str = get_paginator_link($box, $next_grp, _("Next"));
} else if (($next_grp > $iTotal) && ($prev_grp >= 0)) {
$prv_str = get_paginator_link($box, $prev_grp, _("Previous"));
$nxt_str = _("Next");
} else if (($next_grp <= $iTotal) && ($prev_grp < 0)) {
$prv_str = _("Previous");
$nxt_str = get_paginator_link($box, $next_grp, _("Next"));
}
/* Page selector block. Following code computes page links. */
if ($iLimit != 0 && $page_selector && ($iTotal > $iLimit)) {
/* Most importantly, what is the current page!!! */
$cur_pg = intval($iOffset / $iLimit) + 1;
/* Compute total # of pages and # of paginator page links. */
$tot_pgs = ceil($iTotal / $iLimit); /* Total number of Pages */
$vis_pgs = min($page_selector_max, $tot_pgs - 1); /* Visible Pages */
/* Compute the size of the four quarters of the page links. */
/* If we can, just show all the pages. */
if (($tot_pgs - 1) <= $page_selector_max) {
$q1_pgs = $cur_pg - 1;
$q2_pgs = $q3_pgs = 0;
$q4_pgs = $tot_pgs - $cur_pg;
/* Otherwise, compute some magic to choose the four quarters. */
} else {
/*
* Compute the magic base values. Added together,
* these values will always equal to the $pag_pgs.
* NOTE: These are DEFAULT values and do not take
* the current page into account. That is below.
*/
$q1_pgs = floor($vis_pgs/4);
$q2_pgs = round($vis_pgs/4, 0);
$q3_pgs = ceil($vis_pgs/4);
$q4_pgs = round(($vis_pgs - $q2_pgs)/3, 0);
/* Adjust if the first quarter contains the current page. */
if (($cur_pg - $q1_pgs) < 1) {
$extra_pgs = ($q1_pgs - ($cur_pg - 1)) + $q2_pgs;
$q1_pgs = $cur_pg - 1;
$q2_pgs = 0;
$q3_pgs += ceil($extra_pgs / 2);
$q4_pgs += floor($extra_pgs / 2);
/* Adjust if the first and second quarters intersect. */
} else if (($cur_pg - $q2_pgs - ceil($q2_pgs/3)) <= $q1_pgs) {
$extra_pgs = $q2_pgs;
$extra_pgs -= ceil(($cur_pg - $q1_pgs - 1) * 3/4);
$q2_pgs = ceil(($cur_pg - $q1_pgs - 1) * 3/4);
$q3_pgs += ceil($extra_pgs / 2);
$q4_pgs += floor($extra_pgs / 2);
/* Adjust if the fourth quarter contains the current page. */
} else if (($cur_pg + $q4_pgs) >= $tot_pgs) {
$extra_pgs = ($q4_pgs - ($tot_pgs - $cur_pg)) + $q3_pgs;
$q3_pgs = 0;
$q4_pgs = $tot_pgs - $cur_pg;
$q1_pgs += floor($extra_pgs / 2);
$q2_pgs += ceil($extra_pgs / 2);
/* Adjust if the third and fourth quarter intersect. */
} else if (($cur_pg + $q3_pgs + 1) >= ($tot_pgs - $q4_pgs + 1)) {
$extra_pgs = $q3_pgs;
$extra_pgs -= ceil(($tot_pgs - $cur_pg - $q4_pgs) * 3/4);
$q3_pgs = ceil(($tot_pgs - $cur_pg - $q4_pgs) * 3/4);
$q1_pgs += floor($extra_pgs / 2);
$q2_pgs += ceil($extra_pgs / 2);
}
}
/*
* I am leaving this debug code here, commented out, because
* it is a really nice way to see what the above code is doing.
* echo "qts = $q1_pgs/$q2_pgs/$q3_pgs/$q4_pgs = "
* . ($q1_pgs + $q2_pgs + $q3_pgs + $q4_pgs) . '<br />';
*/
/* Print out the page links from the compute page quarters. */
/* Start with the first quarter. */
if (($q1_pgs == 0) && ($cur_pg > 1)) {
$pg_str .= "...$spc";
} else {
for ($pg = 1; $pg <= $q1_pgs; ++$pg) {
$start = (($pg-1) * $iLimit) + 1;
$pg_str .= get_paginator_link($box, $start, $pg) . $spc;
}
if ($cur_pg - $q2_pgs - $q1_pgs > 1) {
$pg_str .= "...$spc";
}
}
/* Continue with the second quarter. */
for ($pg = $cur_pg - $q2_pgs; $pg < $cur_pg; ++$pg) {
$start = (($pg-1) * $iLimit) + 1;
$pg_str .= get_paginator_link($box, $start, $pg) . $spc;
}
/* Now print the current page. */
$pg_str .= $cur_pg . $spc;
/* Next comes the third quarter. */
for ($pg = $cur_pg + 1; $pg <= $cur_pg + $q3_pgs; ++$pg) {
$start = (($pg-1) * $iLimit) + 1;
$pg_str .= get_paginator_link($box, $start, $pg) . $spc;
}
/* And last, print the forth quarter page links. */
if (($q4_pgs == 0) && ($cur_pg < $tot_pgs)) {
$pg_str .= "...$spc";
} else {
if (($tot_pgs - $q4_pgs) > ($cur_pg + $q3_pgs)) {
$pg_str .= "...$spc";
}
for ($pg = $tot_pgs - $q4_pgs + 1; $pg <= $tot_pgs; ++$pg) {
$start = (($pg-1) * $iLimit) + 1;
$pg_str .= get_paginator_link($box, $start,$pg) . $spc;
}
}
$last_grp = (($tot_pgs - 1) * $iLimit) + 1;
}
} else {
$pg_str = "<a href=\"$php_self?showall=0"
. "&startMessage=1&mailbox=$box\" "
. ">" ._("Paginate") . '</a>';
}
/* Put all the pieces of the paginator string together. */
/**
* Hairy code... But let's leave it like it is since I am not certain
* a different approach would be any easier to read. ;)
*/
$result = '';
if ( $prv_str || $nxt_str ) {
/* Compute the 'show all' string. */
$all_str = "<a href=\"$php_self?showall=1"
. "&startMessage=1&mailbox=$box\" "
. ">" . _("Show All") . '</a>';
$result .= '[';
$result .= ($prv_str != '' ? $prv_str . $spc . $sep . $spc : '');
$result .= ($nxt_str != '' ? $nxt_str : '');
$result .= ']' . $spc ;
}
$result .= ($pg_str != '' ? $spc . '['.$spc.$pg_str.']' . $spc : '');
$result .= ($all_str != '' ? $spc . '['.$all_str.']' . $spc . $spc : '');
/* If the resulting string is blank, return a non-breaking space. */
if ($result == '') {
$result = ' ';
}
/* Return our final magical compact paginator string. */
return ($result);
}
?>
|