zencart输出安全类型字符串函数 zen_output_string

zen cart分頁功能的類splitPageResults 位于includes\classes\split_page_results.php文件裏面定義。

分頁功能一般用于信息列表，比如商品列表 ，評論列表等。簡單介紹這個分頁類的一些功能。

該類的變量有$sql_query, $number_of_rows, $current_page_number, $number_of_pages, $number_of_rows_per_page, $page_name; 。他們的意義分别爲：

$sql_query：查詢數據庫的SQL語句，初始化該類的對象的時候會給這個變量賦值。

$number_of_rows：保存返回查詢結果數。

$current_page_number：當前頁面的數字，就是第幾頁。

$number_of_pages：總共有多少頁，計算方法 $this->number_of_pages = ceil($this->number_of_rows / $this->number_of_rows_per_page);

$number_of_rows_per_page：每頁顯示的數量。這個變量由構造函數賦值。如果要改變每頁顯示的數量，可以修改這個參數的值。

$page_name：分頁的參數名字，默認是page，就是page=?這樣。

下面是函數 功能的介紹

構造函數

function splitPageResults($query, $max_rows, $count_key = ‘*’, $page_holder = ‘page’, $debug = false)

這個構造函數，主要是對類變量賦值，其中$query這個是必須要輸入的參數值，這個就是查詢數據庫的SQL語句，$max_rows這個是每頁顯示的數量，也必須的參數。其他的可以使用默認值。

參考例子$listing_split = new splitPageResults($listing_sql, MAX_DISPLAY_PRODUCTS_LISTING, ‘p.products_id’, ‘page’);

function display_count($text_output)

該函數主要顯示查詢結果的總數。參數爲顯示的文字，這個文字裏面要有%d這樣的标識才能把這個結果數顯示出來，引用方式爲 sprintf($text_output, $from_num, $to_num, $this->number_of_rows);

function display_links($max_page_links, $parameters = ”)

第一個參數就是顯示的頁面數量，這個就是除了顯示下一頁的文字以外的數字，如果是6，那 就是顯示從1-6，第七個就是“下一頁”這樣的提示。$parameters 就是當前頁面的一些參數，可以參考zencart内部的使用方式zen_get_all_get_params(array(‘page’, ‘info’, ‘x’, ‘y’, ‘main_page’)) 這個就是當前頁面除了這些參數以外的其他參數

更多具體使用可以參考includes\templates\模闆 名字\templates\tpl_modules_product_listing.php 這個文件裏面