{"id":1392,"date":"2009-03-04T17:10:57","date_gmt":"2009-03-04T17:10:57","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/list-pages-shortcode\/"},"modified":"2023-02-21T20:48:32","modified_gmt":"2023-02-21T20:48:32","slug":"list-pages-shortcode","status":"publish","type":"plugin","link":"https:\/\/scn.wordpress.org\/plugins\/list-pages-shortcode\/","author":31667,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.7.7","stable_tag":"1.7.7","tested":"6.1.10","requires":"4.4.0","requires_php":"","requires_plugins":"","header_name":"List Pages Shortcode","header_author":"Ben Huson, Aaron Harp","header_description":"","assets_banners_color":"d54e21","last_updated":"2023-02-21 20:48:32","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=aaron%40freshwebs%2enet&item_name=Fotobook%20Donation&no_shipping=0&no_note=1&tax=0&currency_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8","header_plugin_uri":"http:\/\/wordpress.org\/extend\/plugins\/list-pages-shortcode\/","header_author_uri":"http:\/\/www.aaronharp.com","rating":4.9,"author_block_rating":0,"active_installs":5000,"downloads":123475,"num_ratings":14,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"aaron_guitar","date":"2009-03-04 17:14:08"},"1.1":{"tag":"1.1","author":"husobj","date":"2011-01-28 22:13:56"},"1.2":{"tag":"1.2","author":"husobj","date":"2011-02-22 23:11:51"},"1.3":{"tag":"1.3","author":"husobj","date":"2011-06-09 14:22:54"},"1.4":{"tag":"1.4","author":"husobj","date":"2012-07-10 08:21:13"},"1.5":{"tag":"1.5","author":"husobj","date":"2012-09-24 10:17:20"},"1.6":{"tag":"1.6","author":"husobj","date":"2013-10-03 23:04:48"},"1.7":{"tag":"1.7","author":"husobj","date":"2014-02-07 09:29:33"},"1.7.1":{"tag":"1.7.1","author":"husobj","date":"2014-04-27 22:44:06"},"1.7.2":{"tag":"1.7.2","author":"husobj","date":"2015-04-23 07:16:49"},"1.7.3":{"tag":"1.7.3","author":"husobj","date":"2016-02-24 22:15:13"},"1.7.4":{"tag":"1.7.4","author":"husobj","date":"2019-11-05 07:47:34"},"1.7.5":{"tag":"1.7.5","author":"husobj","date":"2023-01-10 20:11:25"},"1.7.6":{"tag":"1.7.6","author":"husobj","date":"2023-01-16 10:46:40"},"1.7.7":{"tag":"1.7.7","author":"husobj","date":"2023-02-21 20:48:32"}},"upgrade_notice":{"1.7.7":"<p>Fix sort order validation to allow for multiple sort columns.<\/p>","1.7.6":"<p>Security Update: Validate all shortcode attributes and escape output.<\/p>","1.7.5":"<p>Security Update: Sanitize HTML attributes before outputting.<\/p>","1.7.2":"<p>Add short code arguments to the shortcode_list_pages_before\/after actions.<\/p>","1.7.1":"<p>Update List_Pages_Shortcode_Walker_Page class with changes made to the WordPress Walker_Page class.<\/p>","1.7":"<p>Add &#039;list-pages-shortcode&#039; class to all lists.<\/p>","1.6":"<p>Added <code>shortcode_list_pages_before<\/code> and <code>shortcode_list_pages_after<\/code> actions and <code>list_pages_shortcode_item<\/code> filter.<\/p>","1.5":"<p>Added support for showing excerpt and filtering of excerpt output using &#039;list_pages_shortcode_excerpt&#039; filter. Added support for outputting as ordered list.<\/p>","1.4":"<p>Added support for &#039;post_status&#039;.<\/p>","1.3":"<p>Added &#039;shortcode_list_pages_attributes&#039; filter and allow &#039;child_of&#039; to be overridden by shortcode parameter.<\/p>","1.2":"<p>Added support for extra wp_list_pages() parameters: include, sort_order, meta_key, meta_value and offset.<\/p>","1.1":"<p>Added &#039;shortcode_list_pages&#039; filter and [sibling-pages] shortcode.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":2,"5":12},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":1142967,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":1142967,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":1142967,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":1142967,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3","1.4","1.5","1.6","1.7","1.7.1","1.7.2","1.7.3","1.7.4","1.7.5","1.7.6","1.7.7"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[9660,32191,243,357,16623],"plugin_category":[43],"plugin_contributors":[79195,77999],"plugin_business_model":[],"class_list":["post-1392","plugin","type-plugin","status-publish","hentry","plugin_tags-child-pages","plugin_tags-list-pages","plugin_tags-pages","plugin_tags-shortcodes","plugin_tags-sibling-pages","plugin_category-customization","plugin_contributors-aaron_guitar","plugin_contributors-husobj","plugin_committers-aaron_guitar","plugin_committers-husobj"],"banners":{"banner":"https:\/\/ps.w.org\/list-pages-shortcode\/assets\/banner-772x250.png?rev=1142967","banner_2x":"https:\/\/ps.w.org\/list-pages-shortcode\/assets\/banner-1544x500.png?rev=1142967","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/list-pages-shortcode\/assets\/icon-128x128.png?rev=1142967","icon_2x":"https:\/\/ps.w.org\/list-pages-shortcode\/assets\/icon-256x256.png?rev=1142967","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Introduces the [list-pages], [sibling-pages] and [child-pages] <a href=\"http:\/\/codex.wordpress.org\/Shortcode_API\">shortcodes<\/a> for easily displaying a list of pages within a post or page.  Both shortcodes accept all parameters that you can pass to the <a href=\"http:\/\/codex.wordpress.org\/Template_Tags\/wp_list_pages\"><code>wp_list_pages()<\/code><\/a> function with the addition of a class parameter.<\/p>\n\n<h4>Example Usage<\/h4>\n\n<p><em>List pages sorted by title<\/em><\/p>\n\n<pre><code>[list-pages sort_column=\"post_title\"]\n<\/code><\/pre>\n\n<p><em>List pages but exclude certain IDs and set the class of the list to \"my-page-list\"<\/em><\/p>\n\n<pre><code>[list-pages exclude=\"17,38\" class=\"my-page-list\"]\n<\/code><\/pre>\n\n<p><em>Show excerpt (for pages excerpt support will need adding manually or via the <a href=\"https:\/\/wordpress.org\/plugins\/page-excerpt\/\">Page Excerpt<\/a> plugin)<\/em><\/p>\n\n<pre><code>[list-pages excerpt=\"1\"]\n<\/code><\/pre>\n\n<p><em>List the current page's children, but only show the top level<\/em><\/p>\n\n<pre><code>[child-pages depth=\"1\"]\n<\/code><\/pre>\n\n<p><em>List the current page's siblings and their subpages<\/em><\/p>\n\n<pre><code>[sibling-pages depth=\"2\"]\n<\/code><\/pre>\n\n<h4>Default Arguments<\/h4>\n\n<p>The default values are the same as for the <a href=\"http:\/\/codex.wordpress.org\/Template_Tags\/wp_list_pages\">wp_list_pages()<\/a> function except for title_li which defaults to nothing.  If a class is not specified, a default class of either \"list-pages\", \"sibling-pages\" or \"child-pages\" is given to the UL tag.  In addition, the echo parameter has no effect.<\/p>\n\n<p>In addition to the <a href=\"http:\/\/codex.wordpress.org\/Template_Tags\/wp_list_pages\">wp_list_pages()<\/a> arguments, you can also specify:<\/p>\n\n<ul>\n<li><strong>list_type<\/strong> <em>(string)<\/em> List tag. Defaults to <code>&lt;ul&gt;<\/code>.<\/li>\n<li><strong>exclude_current_page<\/strong> <em>(int)<\/em> Exclude the current page. Defaults to <code>0<\/code>.<\/li>\n<li><strong>excerpt<\/strong> <em>(int)<\/em> Show the page excerpt. Defaults to <code>0<\/code>.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Download and unzip the most recent version of this plugin<\/li>\n<li>Upload the list-pages-shortcode folder to \/path-to-wordpress\/wp-content\/plugins\/<\/li>\n<li>Login to your WP Admin panel, click Plugins, and activate \"List Pages Shortcode\"<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20do%20i%20include%20a%20page%20excerpt%3F'><h3>How do I include a page excerpt?<\/h3><\/dt>\n<dd><p>Firstly you will need to add support for excerpt for your pages. You can either you this by using the <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/add_post_type_support\">add_post_type_support()<\/a> function or using a plugin like <a href=\"http:\/\/wordpress.org\/extend\/plugins\/page-excerpt\/\">Page Excerpt<\/a>.<\/p>\n\n<p>You can also use the 'list_pages_shortcode_excerpt' filter to return or customize the excerpt for specific pages. The following example:\n    <\/p>\n\n<p>You can then include the excerpt via your shortcode.\n    [list-pages excerpt=\"1\"]<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p>= 1.7.7=<\/p>\n\n<ul>\n<li>Fix sort order validation to allow for multiple sort columns.<\/li>\n<\/ul>\n\n<h4>1.7.6<\/h4>\n\n<ul>\n<li>Security Update: Validate all shortcode attributes and escape output.<\/li>\n<\/ul>\n\n<h4>1.7.5<\/h4>\n\n<ul>\n<li>Security Update: Sanitize HTML attributes before outputting.<\/li>\n<\/ul>\n\n<h4>1.7.4<\/h4>\n\n<ul>\n<li>Fix fatal error: validate_list_type() needs to be public!<\/li>\n<\/ul>\n\n<h4>1.7.3<\/h4>\n\n<ul>\n<li>Use PHP7 constructors.<\/li>\n<li>Validate list type and convert <code>&lt;li&gt;<\/code> tags if not <code>&lt;ul&gt;<\/code> list type.<\/li>\n<li>Checked WordPress 4.4.2 compatibility.<\/li>\n<\/ul>\n\n<h4>1.7.2<\/h4>\n\n<ul>\n<li>Add short code arguments to the shortcode_list_pages_before\/after actions.<\/li>\n<li>Checked WordPress 4.2 compatibility.<\/li>\n<\/ul>\n\n<h4>1.7.1<\/h4>\n\n<ul>\n<li>When no list type specified don't wrap in list tags.<\/li>\n<li>Update List_Pages_Shortcode_Walker_Page class with changes made to the WordPress Walker_Page class.<\/li>\n<li>Checked WordPress 3.9 compatibility.<\/li>\n<\/ul>\n\n<h4>1.7<\/h4>\n\n<ul>\n<li>Add 'list-pages-shortcode' class to all lists.<\/li>\n<\/ul>\n\n<h4>1.6<\/h4>\n\n<ul>\n<li>Add default arg values to start_el() Walker method. Props eceleste.<\/li>\n<li>Added <code>shortcode_list_pages_before<\/code> action.<\/li>\n<li>Added <code>shortcode_list_pages_after<\/code> action.<\/li>\n<li>Added <code>list_pages_shortcode_item<\/code> filter.<\/li>\n<li>Allow specifying of <code>post_type<\/code>.<\/li>\n<\/ul>\n\n<h4>1.5<\/h4>\n\n<ul>\n<li>Added support for showing excerpt <code>[list-pages excerpt=\"1\"]<\/code>.<\/li>\n<li>Allow filtering of excerpt output using 'list_pages_shortcode_excerpt' filter.<\/li>\n<li>Added support for outputting as ordered list <code>[list-pages list_type=\"ol\"]<\/code>.<\/li>\n<li>Allow HTML in 'title_li' attribute.<\/li>\n<\/ul>\n\n<h4>1.4<\/h4>\n\n<ul>\n<li>Added support for 'post_status'.<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>Added 'shortcode_list_pages_attributes' filter. Useful if you need to tweak any attributes based on context or current post type.<\/li>\n<li>Allow 'child_of' to be overridden by shortcode parameter.<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Added shortcode support for 'exclude_current_page' parameter.<\/li>\n<li>Added support for extra wp_list_pages() parameters: include, sort_order, meta_key, meta_value and offset.<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Added 'shortcode_list_pages' filter.<\/li>\n<li>Added [sibling-pages] shortcode.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Introduces the [list-pages], [sibling-pages] and [child-pages] shortcodes for easily displaying a list of pages within a post or page.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/1392","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=1392"}],"author":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/aaron_guitar"}],"wp:attachment":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=1392"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=1392"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=1392"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=1392"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=1392"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=1392"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}