Page-list

• Page-list
• all Page-list params
• Пожертвовать
• GitHub

shortcodes:

• [pagelist] — hierarchical tree of all pages on site (useful to show sitemap of the site);
• [subpages] — hierarchical tree of subpages to the current page;
• [siblings] — hierarchical tree of sibling pages to the current page;
• [pagelist_ext] — list of pages with featured image and with excerpt;

examples with aditional parameters:

• [pagelist child_of="4" depth="2" exclude="6,7,8"]
• [pagelist_ext child_of="4" exclude="6,7,8" image_width="50" image_height="50"]
• all Page-list params

Parameters for [pagelist], [subpages] and [siblings]:

• [pagelist] — list of all pages as the hierarchical list;
• [subpages] — list of subpages to the current page as the hierarchical list; Same as: [pagelist child_of="current"];
• [siblings] — list of sibling pages to the current page as the hierarchical list; Same as: [pagelist child_of="parent"];
• depth — how many levels in the hierarchy of pages are to be included in the list: [pagelist depth="3"]; by default depth is unlimited (depth=»0″); Displays pages at any depth and arranges them in a flat list: [pagelist depth="-1"];
• child_of — displays the sub-pages of a single Page by ID: [pagelist child_of="4"];
• exclude — define a comma-separated list of Page IDs to be excluded from the list: [pagelist exclude="6,7,8"]; You may exclude current page: [pagelist exclude="current"];
• exclude_tree — define a comma-separated list of parent Page IDs and all its subpages to be excluded: [pagelist exclude_tree="7,10"];
• include — include a comma-separated list of Page IDs into the list: [pagelist include="6,7,8"];
• title_li — set the text and style of the Page list’s heading: [pagelist title_li="<h2>List of pages</h2>"]; by default there is no title (title_li=»»);
• authors — only include pages authored by the authors in this comma-separated list of author IDs: [pagelist authors="2,5"]; by default all authors are included (authors=»»);
• number — sets the number of pages to display: [pagelist number="10"]; by default the number is unlimited (number=»»);
• offset — the number of pages to pass over (or displace) before collecting the set of pages: [pagelist offset="5"]; by default there is no offset (offset=»»);
• post_type — list associated with a certain hierarchical Post Type [pagelist post_type="page"]; by default: (post_type=»page»); possible values: page, revision, Hierarchical Custom Post Types (‘post’ is not a Hierarchical Post Type);
• post_status — a comma-separated list of all post status types: [pagelist post_status="private"]; by default: (post_status=»publish»); possible values: publish, private, draft;
• meta_key and meta_value — only include the pages that have this Custom Field Key and this Custom Field Value: [pagelist meta_key="metakey" meta_value="metaval"];
• show_date — display creation or last modified date next to each Page: [pagelist show_date="created"]; possible values: created, modified, updated;
• date_format — the format of the Page date set by the show_date parameter: [pagelist date_format="l, F j, Y"]; by default use the date format configured in your WordPress options;
• sort_column — sort the list of pages by column: [pagelist sort_column="menu_order"]; by default: (sort_column=»menu_order, post_title»); possible values: post_title, menu_order, post_date (sort by creation time), post_modified, ID, post_author, post_name (sort by page slug);
• sort_order — the sort order of the list of pages (either ascending or descending): [pagelist sort_order="desc"]; by default: (sort_order=»asc»); possible values: asc, desc;
• link_before — sets the text or html that precedes the link text inside link tag: [pagelist link_before="<span>"]; you may specify html tags only in the HTML tab in your Rich-text editor;
• link_after — sets the text or html that follows the link text inside link tag: [pagelist link_after="</span>"]; you may specify html tags only in the HTML tab in your Rich-text editor;
• class — the CSS class for list of pages: [pagelist class="listclass"]; by default the class is empty (class=»»);
• columns — for splitting list of pages into columns: [pagelist class="page-list-cols-2"]; available classes: page-list-cols-2, page-list-cols-3, page-list-cols-4, page-list-cols-5; works in all modern browsers and IE10+; columns are responsive and become 1 column at less than 768px;

Больше информации о параметрах для [pagelist], [subpages], [siblings].

Parameters for [pagelist_ext]:

• [pagelist_ext] — by default shows list of subpages to current page; but if there is no subpages than all pages will be shown;
• show_image — show or hide featured image [pagelist_ext show_image="0"]; «show_image» have higher priority than «show_first_image»; by default: show_image=»1″;
• show_first_image — show or hide first image from content if there is no featured image [pagelist_ext show_first_image="1"]; by default: show_first_image=»0″;
• show_title — show or hide title [pagelist_ext show_title="0"]; by default: show_title=»1″;
• show_content — show or hide content [pagelist_ext show_content="0"]; by default: show_content=»1″;
• more_tag — output all content before and after more tag: [pagelist_ext more_tag="0"]; this parameter does not add «more-link» to the end of content, it just cut content before more-tag; «more_tag» parameter have higher priority than «limit_content»; by default the more_tag is enabled (more_tag=»1″) and showing only content before more tag;
• limit_content — content is limited by «more-tag» if it is exist or by «limit_content» parameter [pagelist_ext limit_content="100"]; by default: limit_content=»250″;
• image_width — width of the image [pagelist_ext image_width="80"]; by default: image_width=»50″;
• image_height — height of the image [pagelist_ext image_height="80"]; by default: image_height=»50″;
• child_of — displays the sub-pages of a single Page by ID: [pagelist_ext child_of="4"]; by default it shows subpages to the current page;
• parent — list those pages that have the provided single page only ID as parent: [pagelist_ext parent="4"]; by default parent=»-1″ and depth is unlimited;
• sort_column — sort the list of pages by column: [pagelist_ext sort_column="menu_order"]; by default: (sort_column=»menu_order, post_title»); possible values: post_title, menu_order, post_date (sort by creation time), post_modified, ID, post_author, post_name (sort by page slug);
• sort_order — the sort order of the list of pages (either ascending or descending): [pagelist_ext sort_order="desc"]; by default: (sort_order=»asc»); possible values: asc, desc;* hierarchical — display subpages below their parent page [pagelist_ext hierarchical="0"]; by default: hierarchical=»1″;
• hierarchical — display subpages below their parent page [pagelist_ext hierarchical="0"]; by default: hierarchical=»1″;
• exclude — define a comma-separated list of Page IDs to be excluded from the list: [pagelist_ext exclude="6,7,8"];
• exclude_tree — define a comma-separated list of parent Page IDs and all its subpages to be excluded: [pagelist_ext exclude_tree="7,10"];
• include — include a comma-separated list of Page IDs into the list: [pagelist_ext include="6,7,8"];
• meta_key and meta_value — only include the pages that have this Custom Field Key and this Custom Field Value: [pagelist_ext meta_key="metakey" meta_value="metaval"];
• authors — only include the pages written by the given author(s) [pagelist_ext authors="6,7,8"];
• number — sets the number of pages to display: [pagelist_ext number="10"]; by default the number is unlimited (number=»»);
• offset — the number of pages to pass over (or displace) before collecting the set of pages: [pagelist_ext offset="5"]; by default there is no offset (offset=»»);
• post_type — list associated with a certain hierarchical Post Type [pagelist_ext post_type="page"]; by default: (post_type=»page»); possible values: page, revision, Hierarchical Custom Post Types (‘post’ is not a Hierarchical Post Type);
• post_status — a comma-separated list of all post status types: [pagelist_ext post_status="private"]; by default: (post_status=»publish»); possible values: publish, private, draft;
• class — the CSS class for list of pages: [pagelist_ext class="listclass"]; by default the class is empty (class=»»);
• strip_tags — strip tags or not: [pagelist_ext strip_tags="0"]; by default the tags are stripped (strip_tags=»1″);
• strip_shortcodes — strip registered shortcodes or not: [pagelist_ext strip_shortcodes="0"]; by default shortcodes are stripped (strip_shortcodes=»1″) and all registered shortcodes are removed;
• show_child_count — показывает количество дочерних страниц: [pagelist_ext show_child_count="1"]; по умолчанию child_count неактивен (show_child_count=»0″); если show_child_count=»1″, но количество дочерних страниц=0, тогда счетчик дочерних страниц не будет показан;
• child_count_template — шаблон child_count: [pagelist_ext show_child_count="1" child_count_template="Subpages: %child_count%"]; по умолчанию child_count_template=»Subpages: %child_count%»;
• show_meta_key — показать или скрыть ключи мета: [pagelist_ext show_meta_key="your_meta_key"]; по умолчанию значение show_meta_key пустое (show_meta_key=»»); если show_meta_key доступно, но значение meta_value пустое, тогда meta_key не будет отображаться;
• meta_template — шаблон мета: [pagelist_ext show_meta_key="your_meta_key" meta_template="Meta: %meta%"]; по умолчанию meta_template=»%meta%»;
• Колонки — для объединения списка страниц в колонки: [pagelist_ext class="page-list-cols-2"]; доступны классы: page-list-cols-2, page-list-cols-3, page-list-cols-4, page-list-cols-5; работает во всех современных браузерах и IE10+; колонки масштабируемы: 1 колонка не превышает 768px;

Больше информации о параметрах для [pagelist_ext].