Wordpress基本函數(shù)之wp_list_pages().doc

7史網(wǎng)http:/7.nu Word Press Wordpress初級教程 7史網(wǎng)榮譽(yù)出品|豆丁網(wǎng)首發(fā) http:/7.nu 合作伙伴： 申明：為了便于搜索引擎收錄，本教程分開來講，每一講為一個單獨(dú)的函數(shù)。想看全部教程，請從目錄中找。 Wordpress基本函數(shù)之wp_list_pages() 函數(shù)名：wp_list_pages（）基本用法及參數(shù)解釋： 模板標(biāo)簽wp_list_pages( )將WordPress頁面作為鏈接顯示出來。該模板標(biāo)簽常用于自定義側(cè)邊欄或標(biāo)題，也常用于其他模板中。該模板標(biāo)簽在WordPress 1.5及更新版本中可用。 作 者 原 創(chuàng)：列表顯示頁面鏈接部分常用參數(shù)：post_title：按標(biāo)題字母順序排列（默認(rèn)）post_date：按創(chuàng)建時間排序post_modified：按最后修改時間排序ID：按照 id 排序post_author：按照作者 id 排序Wordpress官方：默認(rèn)參數(shù)設(shè)置為：$defaults = array( depth = 0, 顯示所有頁面和子頁面（無深度限制） show_date = , 不顯示創(chuàng)建日期 date_format = get_option(date_format), child_of = 0, 子頁面無限制 exclude = , 不刪除任何頁面 title_li = _(Pages), 頁面列表的標(biāo)題為“Pages（頁面）” echo = 1, 回顯（顯示）結(jié)果 authors = , 不局限于特定作者 sort_column = menu_order, post_title, 先按頁面順序再按頁面標(biāo)題排序 link_before = , link_after = , exclude_tree= );不刪除父級/子級樹|隱藏或改變列表標(biāo)題給title_li參數(shù)傳遞一個零值或空值，可以隱藏由wp_list_pages生成的頁面列表默認(rèn)標(biāo)題。下面的代碼可顯示所述效果： 在下面這個例子中，列表中只包含編號為9，5，23的頁面，標(biāo)題內(nèi)容被改為“Poetry”，格式為: ?phpwp_list_pages(include=5,9,23&title_li= ._(Poetry) . ); ? |將頁面按頁面順序排列下面的例子將頁面按管理欄中 Write Page 定義的頁面順序進(jìn)行排列。 如果希望將列表按頁面順序進(jìn)行排列并將“Prose”作為列表標(biāo)題（以h2格式）顯示在側(cè)邊欄中，可將以下代碼添加到sidebar.php文件中： ?phpwp_list_pages(sort_column=menu_order&title_li= . _(Prose) . ); ? 使用下列代碼段，可顯示出無標(biāo)題并以頁面順序排列的頁面： |將頁面按發(fā)表日期排列下列代碼顯示出的頁面將按發(fā)表日期進(jìn)行排列，在頁面列表項旁顯示日期。 |從列表中排除頁面用exclude參數(shù)可隱藏列表中由wp_list_pages生成的若干頁面。 |顯示列表中特定頁面若僅希望在列表中顯示特定頁面，例如編號為35，7，26和13的頁面，可使用include參數(shù)。 ?phpwp_list_pages(include=7,13,26,35&title_li=. _(Pages) . ); ? |顯示子頁面注意：即使沒有子頁面，HTML標(biāo)簽也是必要的（ul或ol）。用css設(shè)置列表時需要將這一點(diǎn)謹(jǐn)記在心。 ID.&show_date=modified &date_format=$date_format); ? 以下代碼僅在目前頁面有子頁面（將目前頁面設(shè)為父級頁面的頁面）的情況下生成列表：ID.&echo=0); if ($children) ? |在子頁面上列出子頁面上述示例都是在父級頁面上展示子頁面，卻沒有說明如何在子頁面上進(jìn)行展示?？捎孟铝写a在某一父頁面或其中一個子頁面上展示子頁面。將本代碼放在側(cè)邊欄的widget區(qū)塊后，代碼將無法運(yùn)行。post_parent) $children =wp_list_pages(title_li=&child_of=.$post-post_parent.&echo=0); else $children =wp_list_pages(title_li=&child_of=.$post-ID.&echo=0); if ($children) ? 本代碼也可用在sidebar.php中，僅顯示頂級頁面。但瀏覽到包含子頁面的頁面時，僅顯示其子頁面。瀏覽主頁時在側(cè)邊欄顯示所有頂級頁面瀏覽沒有子頁面的頂級頁面時，顯示所有頂級頁面瀏覽有子頁面的頂級頁面時，顯示所有子頁面及下一級頁面瀏覽子頁面時，顯示其父級頁面下的所有子頁面和下一級頁面?php $output =wp_list_pages(echo=0&depth=1&title_li=Top Level Pages ); if (is_page( ) $page = $post-ID; if ($post-post_parent) $page = $post-post_parent; $children=wp_list_pages( echo=0&child_of= .$page . &title_li= ); if ($children) $output = wp_list_pages (echo=0&child_of= .$page . &title_li=Child Pages); echo $output; ?頁面選項標(biāo)記與格式默認(rèn)情況下，wp_list_pages( )生成一個嵌套的、由管理欄 Write Page 生成的無序WordPress頁面列表。將title_li參數(shù)設(shè)為任意空字符后可除去最外圍選項（li.pagenav）和列表（ul）。所有wp_list_pages( )生成的列表項（li）都被標(biāo)上page_item類。顯示頁面時將調(diào)用wp_list_pages( )，這時該頁面的列表項被賦予附加類current_page_item。?php Pages title_li parent of the current Page the current Page another Page 可以用CSS選擇器為這些列表項進(jìn)行樣式設(shè)計：.pagenav /* the outermost list item;contains whole list */ .page-item-2 /* item for Page ID 2 */ .page_item /* any Page item */ .current_page_item /* the current Page */ .current_page_parent /* parent of thecurrent Page */ .current_page_ancestor /* any ancestor ofthe current Page */ 參數(shù)sort_column (字符)按不同方式對頁面列表進(jìn)行排序。默認(rèn)設(shè)置成按頁面標(biāo)題的字母順序排序。 post_title 按頁面標(biāo)題的字母順序排序默認(rèn) menu_order 按頁面順序（Page Order）進(jìn)行排序。注意頁面順序和頁面編號的區(qū)別。頁面編號是由WordPress為每篇文章或頁面設(shè)定的獨(dú)有的數(shù)字，而頁面順序則由用戶在管理欄的WritePages中設(shè)置。 post_date 按頁面創(chuàng)建日期排序。 post_modified 按最后修改時間進(jìn)行排序。 ID 按頁面序列編號排序。 post_author 按頁面創(chuàng)建者的序列編號排序。 post_name 按頁面縮略名的字母順序排序。注意：sort_column參數(shù)可按WordPress數(shù)據(jù)庫 wp_post table中任意字段的描述符來對頁面列表進(jìn)行排序。下面給出一些實(shí)用示例。sort_order (字符)更改頁面列表的排列順序（升序或降序）。默認(rèn)為升序?？赡艿闹禐椋?asc 按從低到高順序排列（默認(rèn)） desc 按從高到低順序排列exclude (字符)定義一列頁面編號并用逗號隔開，將其從已有列表中刪除（例如：exclude=3，7，1）。無默認(rèn)值。exclude_tree (整數(shù))與child_of相反，exclude_tree從結(jié)果中移除已知編號的所有子頁面。也可用于隱藏已知頁面的所有子頁面。該參數(shù)還可聯(lián)合child_of 的值以隱藏孫頁面。在2.7版本中該參數(shù)可用。include (字符)僅包含get_pages生成的特定頁面列表。include參數(shù)與exclude同樣用逗號將頁面編號隔開。無默認(rèn)值。depth(整數(shù))該參數(shù)決定wp_list_pages生成的列表中包含的頁面層次級數(shù)。默認(rèn)值為0（顯示子頁面內(nèi)的所有頁面）。 0 以層級方式（縮進(jìn)）顯示所有頁面和子頁面（默認(rèn)） -1 以平級方式（不縮進(jìn)）顯示子頁面中的頁面 1 僅顯示最上層頁面 2 該值（或更大值）表示需要顯示頁面內(nèi)部的層級數(shù)child_of (整數(shù))僅顯示單個頁面的子頁面；值為默認(rèn)編號。默認(rèn)值為0（顯示所有頁面）。注意child_of參數(shù)不僅獲取直系子頁面，也會從已知編號中獲取“孫頁面”。默認(rèn)值為0（顯示所有頁面）。show_data(字符)在每篇頁面旁顯示創(chuàng)建日期或最新修改日期。默認(rèn)值為空值（不顯示日期）?？捎玫闹蛋ǎ?不顯示日期（默認(rèn)） modified 顯示最新修改日期 xxx 任何非modified值都將顯示頁面最初創(chuàng)建的日期（post_date）。參看上文中的示例。date_format(字符)該參數(shù)對show_date參數(shù)生成的頁面日期格式（”l, F j, Y”）進(jìn)行設(shè)置。默認(rèn)格式為WordPress選項設(shè)定的日期格式。參見日期和時間設(shè)置以及php網(wǎng)站上的頁面日期格式。title_li (字符)設(shè)置頁面列表標(biāo)題的內(nèi)容與樣式。默認(rèn)值為“_（頁面）”，顯示結(jié)果為“頁面”（_(”)用于本地定位）。若傳遞值為零或為空（”），則不顯示標(biāo)題，列表也不會被ul標(biāo)簽圍繞。參見標(biāo)題示例。echo (布爾型)觸發(fā)顯示所生成的鏈接列表，或?qū)⒘斜戆碒TML文本格式返回供PHP使用。默認(rèn)值為1（顯示生成的列表項）?？赡艿闹蛋ǎ?1 (true) 默認(rèn) 0（false）hierarchical（布爾型）在上級頁面列表下以縮進(jìn)方式顯示下級頁面。默認(rèn)值為true（在父級列表項下顯示