內容簡介
此簡單外掛可透過輸入簡短代碼 [html_sitemap]於網頁內容中，新增一個頁面的 HTML 網站地圖(非 XML)，但不包含文章。此外掛可設定特定深度、從特定父頁面開始、包括/排除特定子頁面的網站地圖。簡短代碼屬性包括 sort_column、sort_order、exclude、include、depth、child_of、meta_key、meta_value、authors、number、offset、post_type 和 post_status，此外還有 wp_list_pages 函數所接受的所有選項。除了 wp_list_pages 選項外，還可以設定 class、id 和 ordered_list_type 選項。
此外掛適用於將 WordPress 用作 CMS 的使用者，有關 wp_list_pages 的完整選項清單，請參閱相關文件。此外掛中可設定以下選項：
使用者可以指定 class 和 id 屬性為 HTML 網站地圖 <ul> 列表標籤設定 class 或 id 值。
child_of 的值可以是數字頁面 ID(整數)，或使用自訂的 CURRENT 或 PARENT 值。值「CURRENT」會使用當前頁面的 ID，值「PARENT」則使用當前頁面的父親 ID。
ordered_list_type 屬性是 HTML 網站地圖專屬選項，可指定有序清單類型。若未設定 ordered_list_type，將使用無序清單(預設)。
ordered_list_type="1" - 列表項目將以數字編號
ordered_list_type="A" - 列表項目將以大寫字母編號
ordered_list_type="a" - 列表項目將以小寫字母編號
ordered_list_type="I" - 列表項目將以大寫羅馬數字編號
ordered_list_type="i" - 列表項目將以小寫羅馬數字編號
注意：此外掛僅適用於分層自訂文章類型，如果您的文章類型不是分層的，此外掛將無法運作。
範例
第一個範例展示如何添加整個站點的網站地圖。
[html_sitemap]
此範例shortcode將在頁面中添加一個網站地圖，顯示深度限制為 3，並排除頁面 ID 為 708。
[html_sitemap depth=3 exclude=708]
此範例shortcode將添加一個網站地圖到頁面，僅顯示當前頁面的子頁面和孫頁面。
[html_sitemap depth=2 child_of=CURRENT]
此範例shortcode將添加一個網站地圖到頁面，顯示父頁面的子頁面和孫頁面(也包括當前頁面)。
[html_sitemap depth=2 child_of=PARENT]
此範例shortcode將添加一個網站地圖，顯示頁面修改日期，並按照選單順序號碼對頁面進行排序。
[html_sitemap show_date=modified sort_column=menu_order]
此範例shortcode將排除多個 ID 為 708、1024 和 42 的頁面。
[html_sitemap exclude="708,1024,42"]
外掛標籤
開發者團隊
原文外掛簡介
This simple plugin adds an HTML (Not XML) sitemap of your pages (not posts) by using the shortcode [html_sitemap]. This plugin can display a sitemap with specific depths, from a specific parent page and include/exclude specific pages by ID. The sitemap uses the unordered HTML list tags
- and
- .
Shortcode attributes include sort_column, sort_order, exclude, include, depth, child_of, meta_key, meta_value, authors, number, offset, post_type, and post_status parameters from the wp_list_pages function. In addition you can also set class, id, and ordered_list_type to further customize the html page sitemap.
This plugin is perfect for those who use WordPress as a CMS.
Shortcode Tag Attribute Options
The following wp_list_pages tag attribute options are supported:authors — Comma-separated list of author IDs. Default empty (all authors).
child_of — ID of child page, ‘CURRENT’, or ‘PARENT’. The value ‘CURRENT’ will use the current page ID. The value ‘PARENT’ will use the current page parent ID.
depth — -1 (any depth), 0 (all pages), 1 (top-level pages only), 2 (top-level and 2nd level pages only), etc.
date_format — e.g. ‘l, F j, Y’. See WordPress Date Format
exclude — Comma-separated list of page IDs to exclude.
include — Comma-separated list of page IDs to include.
item_spacing — Whether to preserve whitespace within the menu’s HTML. Accepts ‘preserve’ or ‘discard’.
meta_key — Limits output to pages having a specific custom field key.
meta_value — Limits output to pages having a specific custom field value.
number — Limits the number of links displayed (SQL LIMIT).
offset — Skips a specific number of pages before displaying the list.
post_type — Post type to query for. Default ‘page’
post_status — Comma-separated list or array of post statuses to include. Default ‘publish’
show_date — Whether to display the page publish or modified date for each page. Accepts ‘modified’ or any other value. An empty value hides the date.
sort_column — Comma-separated list of column names to sort the pages by. Accepts ‘post_author’, ‘post_date’, ‘post_title’, ‘post_name’, ‘post_modified’, ‘post_modified_gmt’, ‘menu_order’, ‘post_parent’, ‘ID’, ‘rand’, or ‘comment_count’. Default ‘post_title’.Please see documentation for the wp_list_pages function for reference.
In addition the following tag attributes are available exclusively for this plugin:class — Specify class values for the initial HTML Page Sitemap
- list tag.
id — Specify ID values for the initial HTML Page Sitemap- list tag.
ordered_list_type — Specify the ordered list type. Accepts ”, ‘1’, ‘A’, ‘a’, ‘I’, and ‘i’. Default empty value will display an unordered list.The ordered_list_type attribute options in more detail:
ordered_list_type="" — The list items will be unordered
ordered_list_type="1" — The list items will be numbered with numbers
ordered_list_type="A" — The list items will be numbered with uppercase letters
ordered_list_type="a" — The list items will be numbered with lowercase letters
ordered_list_type="I" — The list items will be numbered with uppercase roman numbers
ordered_list_type="i" — The list items will be numbered with lowercase roman numbersNote: This plugin only works with Hierarchical Custom Post Types such as pages. This plugin will not work if your post type is not hierarchical. Not setting an ordered_list_type will use an unordered list (default).
Examples
First example shows how to add a sitemap for the entire site.
[html_sitemap]Example shortcode will add a sitemap to a page displaying a depth limit of 3 and exclude page ID 708.
[html_sitemap depth=3 exclude=708]Example shortcode will add a sitemap to a page displaying only children and grandchildren of the current page.
[html_sitemap depth=2 child_of=CURRENT]Example shortcode will add a sitemap to a page displaying children and grandchildren of the parent page (would include the curent page as well).
[html_sitemap depth=2 child_of=PARENT]Example shortcode will add a sitemap displaying the page modified date with the pages sorted by the menu order number.
[html_sitemap show_date=modified sort_column=menu_order]Example shortcode excluding multiple pages with ids 708, 1024 and 42.
[html_sitemap exclude="708,1024,42"]Example shortcode will add a class attribute to the
- tag.
[html_sitemap class="custom-class"]Example shortcode will add an id attribute to the
- tag.
[html_sitemap id="custom-element-id"]Example shortcode will display an ordered list using lowercase letters with a depth of 1.
[html_sitemap ordered_list_type="a" depth=1]Example shortcode with roman numbering in capitalization, with custom field “featured-list” and custom value “yes”
[html_sitemap ordered_list_type="I" meta_key=featured-list meta_value=yes sort_column=post_date]For the latest information visit the website.
Contributors
Angelo Mandato, founder of Painless Analytics and FrontPup – Plugin author延伸相關外掛
