{"id":123813,"date":"2020-06-30T23:13:00","date_gmt":"2020-06-30T23:13:00","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/pagemagic-page-lists\/"},"modified":"2020-06-30T23:13:00","modified_gmt":"2020-06-30T23:13:00","slug":"pagemagic-page-lists","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/pagemagic-page-lists\/","author":18108807,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0","stable_tag":"1.0","tested":"5.4.19","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"PageMagic - Page Lists","header_author":"PageMagic","header_description":"Shortcodes to create lists and trees of site pages","assets_banners_color":"5d5d5e","last_updated":"2020-06-30 23:13:00","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/pagemagic.dev\/donate","header_plugin_uri":"https:\/\/pagemagic.dev\/pagelistsplugin","header_author_uri":"https:\/\/pagemagic.dev\/","rating":5,"author_block_rating":0,"active_installs":20,"downloads":1582,"num_ratings":7,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"7"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"2333219","resolution":"128x128","location":"assets","locale":"","width":128,"height":128}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":"2333217","resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"2333167","resolution":"1","location":"assets","locale":"","width":1647,"height":874},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"2333167","resolution":"2","location":"assets","locale":"","width":1343,"height":351},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"2333167","resolution":"3","location":"assets","locale":"","width":712,"height":884},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"2333167","resolution":"4","location":"assets","locale":"","width":2376,"height":2466}},"screenshots":{"1":"Page Magic Custom Excerpt Meta Box","2":"Page Magic [pagemagic_listall] Shortcode","3":"Page Magic [pagemagic_listall] Preview","4":"Page Magic [pagemagic_image_excerpt] Preview"}},"plugin_section":[],"plugin_tags":[32191,187731,187732,23472,3955],"plugin_category":[],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-123813","plugin","type-plugin","status-closed","hentry","plugin_tags-list-pages","plugin_tags-listpages","plugin_tags-page-nav","plugin_tags-page-navigation","plugin_tags-page-tree"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/pagemagic-page-lists_5d5d5e.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/pagemagic-page-lists\/assets\/screenshot-1.png?rev=2333167","caption":"Page Magic Custom Excerpt Meta Box"},{"src":"https:\/\/ps.w.org\/pagemagic-page-lists\/assets\/screenshot-2.png?rev=2333167","caption":"Page Magic [pagemagic_listall] Shortcode"},{"src":"https:\/\/ps.w.org\/pagemagic-page-lists\/assets\/screenshot-3.png?rev=2333167","caption":"Page Magic [pagemagic_listall] Preview"},{"src":"https:\/\/ps.w.org\/pagemagic-page-lists\/assets\/screenshot-4.png?rev=2333167","caption":"Page Magic [pagemagic_image_excerpt] Preview"}],"raw_content":"<!--section=description-->\n<p>Create visual hierarchies of site pages. Options to list all pages, subpages, current page siblings. Also able to show page featured image and custom excerpts.<\/p>\n\n<h4>Quick Shortcodes<\/h4>\n\n<ul>\n<li><strong>[pagemagic_listall]<\/strong> - hierarchical tree of all pages on site (useful to show sitemap of the site)<\/li>\n<li><strong>[pagemagic_subpages]<\/strong> - hierarchical tree of subpages to the current page<\/li>\n<li><strong>[pagemagic_siblings]<\/strong> - hierarchical tree of sibling pages to the current page<\/li>\n<li><strong>[pagemagic_image_excerpt]<\/strong> - list of pages with featured image and with excerpt<\/li>\n<\/ul>\n\n<h4>Example Parameters<\/h4>\n\n<ul>\n<li><code>[pagemagic_listall child_of=\"4\" depth=\"2\" exclude=\"6,7,8\"]<\/code><\/li>\n<li><code>[pagemagic_image_excerpt child_of=\"4\" exclude=\"6,7,8\" image_width=\"50\" image_height=\"50\"]<\/code><\/li>\n<\/ul>\n\n<h4>Page List Parameters<\/h4>\n\n<ul>\n<li><strong>[pagemagic_listall]<\/strong> - list of all pages as the hierarchical list<\/li>\n<li><strong>[pagemagic_subpages]<\/strong> - list of subpages to the current page as the hierarchical list; Same as: <code>[pagemagic_listall child_of=\"current\"]<\/code><\/li>\n<li><strong>[pagemagic_siblings]<\/strong> - list of sibling pages to the current page as the hierarchical list; Same as: <code>[pagemagic_listall child_of=\"parent\"]<\/code><\/li>\n<li><strong>depth<\/strong> - how many levels in the hierarchy of pages are to be included in the list: <code>[pagemagic_listall depth=\"3\"]<\/code>; by default depth is unlimited (depth=\"0\"); Displays pages at any depth and arranges them in a flat list: <code>[pagemagic_listall depth=\"-1\"]<\/code><\/li>\n<li><strong>child_of<\/strong> - displays the sub-pages of a single Page by ID: <code>[pagemagic_listall child_of=\"4\"]<\/code><\/li>\n<li><strong>exclude<\/strong> - define a comma-separated list of Page IDs to be excluded from the list: <code>[pagemagic_listall exclude=\"6,7,8\"]<\/code>; You may exclude current page: <code>[pagemagic_listall exclude=\"current\"]<\/code><\/li>\n<li><strong>exclude_tree<\/strong> - define a comma-separated list of parent Page IDs and all its subpages to be excluded: <code>[pagemagic_listall exclude_tree=\"7,10\"]<\/code><\/li>\n<li><strong>include<\/strong> - include a comma-separated list of Page IDs into the list: <code>[pagemagic_listall include=\"6,7,8\"]<\/code><\/li>\n<li><strong>title_li<\/strong> - set the text and style of the Page list's heading: <code>[pagemagic_listall title_li=\"&lt;h2&gt;List of pages&lt;\/h2&gt;\"]<\/code>; by default there is no title (title_li=\"\")<\/li>\n<li><strong>authors<\/strong> - only include pages authored by the authors in this comma-separated list of author IDs: <code>[pagemagic_listall authors=\"2,5\"]<\/code>; by default all authors are included (authors=\"\")<\/li>\n<li><strong>number<\/strong> - sets the number of pages to display: <code>[pagemagic_listall number=\"10\"]<\/code>; by default the number is unlimited (number=\"\")<\/li>\n<li><strong>offset<\/strong> - the number of pages to pass over (or displace) before collecting the set of pages: <code>[pagemagic_listall offset=\"5\"]<\/code>; by default there is no offset (offset=\"\")<\/li>\n<li><strong>post_type<\/strong> - list associated with a certain hierarchical Post Type <code>[pagemagic_listall post_type=\"page\"]<\/code>; by default: (post_type=\"page\"); possible values: page, revision, Hierarchical Custom Post Types ('post' is not a Hierarchical Post Type)<\/li>\n<li><strong>post_status<\/strong> - a comma-separated list of all post status types: <code>[pagemagic_listall post_status=\"private\"]<\/code>; by default: (post_status=\"publish\"); possible values: publish, private, draft<\/li>\n<li><strong>meta_key<\/strong> and <strong>meta_value<\/strong> - only include the pages that have this Custom Field Key and this Custom Field Value: <code>[pagemagic_listall meta_key=\"metakey\" meta_value=\"metaval\"]<\/code><\/li>\n<li><strong>show_date<\/strong> - display creation or last modified date next to each Page: <code>[pagemagic_listall show_date=\"created\"]<\/code>; possible values: created, modified, updated<\/li>\n<li><strong>date_format<\/strong> - the format of the Page date set by the show_date parameter: <code>[pagemagic_listall date_format=\"l, F j, Y\"]<\/code>; by default use the date format configured in your WordPress options<\/li>\n<li><strong>sort_column<\/strong> - sort the list of pages by column: <code>[pagemagic_listall sort_column=\"menu_order\"]<\/code>; 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)<\/li>\n<li><strong>sort_order<\/strong> - the sort order of the list of pages (either ascending or descending): <code>[pagemagic_listall sort_order=\"desc\"]<\/code>; by default: (sort_order=\"asc\"); possible values: asc, desc<\/li>\n<li><strong>link_before<\/strong> - sets the text or html that precedes the link text inside link tag: <code>[pagemagic_listall link_before=\"&lt;span&gt;\"]<\/code>; you may specify html tags only in the <code>HTML<\/code> tab in your Rich-text editor<\/li>\n<li><strong>link_after<\/strong> - sets the text or html that follows the link text inside link tag: <code>[pagemagic_listall link_after=\"&lt;\/span&gt;\"]<\/code>; you may specify html tags only in the <code>HTML<\/code> tab in your Rich-text editor<\/li>\n<li><strong>class<\/strong> - the CSS class for list of pages: <code>[pagemagic_listall class=\"listclass\"]<\/code>; by default the class is empty (class=\"\")<\/li>\n<li><strong>columns<\/strong> - for splitting list of pages into columns: <code>[pagemagic_listall class=\"pagemagic-cols-2\"]<\/code>; available classes: pagemagic-cols-2, pagemagic-cols-3, pagemagic-cols-4, pagemagic-cols-5; works in all modern browsers and IE10+; columns are responsive and become 1 column at less than 768px<\/li>\n<\/ul>\n\n<p>[More info] about parameters (https:\/\/developer.wordpress.org\/reference\/functions\/get_pages\/#parameters) for [pagemagic_listall].<\/p>\n\n<h4>Parameters for Page List Excerpts<\/h4>\n\n<ul>\n<li><strong>[pagemagic_image_excerpt]<\/strong> - by default shows list of subpages to current page; but if there is no subpages than all pages will be shown<\/li>\n<li><strong>show_image<\/strong> - show or hide featured image <code>[pagemagic_image_excerpt show_image=\"0\"]<\/code>; \"show_image\" have higher priority than \"show_first_image\"; by default: show_image=\"1\"<\/li>\n<li><strong>show_first_image<\/strong> - show or hide first image from content if there is no featured image <code>[pagemagic_image_excerpt show_first_image=\"1\"]<\/code>; by default: show_first_image=\"0\"<\/li>\n<li><strong>show_title<\/strong> - show or hide title <code>[pagemagic_image_excerpt show_title=\"0\"]<\/code>; by default: show_title=\"1\"<\/li>\n<li><strong>show_content<\/strong> - show or hide content <code>[pagemagic_image_excerpt show_content=\"0\"]<\/code>; by default: show_content=\"1\"<\/li>\n<li><strong>more_tag<\/strong> - output all content before and after more tag: <code>[pagemagic_image_excerpt more_tag=\"0\"]<\/code>; 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<\/li>\n<li><strong>limit_content<\/strong> - content is limited by \"more-tag\" if it is exist or by \"limit_content\" parameter <code>[pagemagic_image_excerpt limit_content=\"100\"]<\/code>; by default: limit_content=\"250\"<\/li>\n<li><strong>image_width<\/strong> - width of the image <code>[pagemagic_image_excerpt image_width=\"80\"]<\/code>; by default: image_width=\"50\"<\/li>\n<li><strong>image_height<\/strong> - height of the image <code>[pagemagic_image_excerpt image_height=\"80\"]<\/code>; by default: image_height=\"50\"<\/li>\n<li><strong>child_of<\/strong> - displays the sub-pages of a single Page by ID: <code>[pagemagic_image_excerpt child_of=\"4\"]<\/code>; by default it shows subpages to the current page<\/li>\n<li><strong>parent<\/strong> - list those pages that have the provided single page only ID as parent: <code>[pagemagic_image_excerpt parent=\"4\"]<\/code>; by default parent=\"-1\" and depth is unlimited<\/li>\n<li><strong>sort_column<\/strong> - sort the list of pages by column: <code>[pagemagic_image_excerpt sort_column=\"menu_order\"]<\/code>; 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)<\/li>\n<li><strong>sort_order<\/strong> - the sort order of the list of pages (either ascending or descending): <code>[pagemagic_image_excerpt sort_order=\"desc\"]<\/code>; by default: (sort_order=\"asc\"); possible values: asc, desc;* <strong>hierarchical<\/strong> - display subpages below their parent page <code>[pagemagic_image_excerpt hierarchical=\"0\"]<\/code>; by default: hierarchical=\"1\"<\/li>\n<li><strong>hierarchical<\/strong> - display subpages below their parent page <code>[pagemagic_image_excerpt hierarchical=\"0\"]<\/code>; by default: hierarchical=\"1\"<\/li>\n<li><strong>exclude<\/strong> - define a comma-separated list of Page IDs to be excluded from the list: <code>[pagemagic_image_excerpt exclude=\"6,7,8\"]<\/code><\/li>\n<li><strong>exclude_tree<\/strong> - define a comma-separated list of parent Page IDs and all its subpages to be excluded: <code>[pagemagic_image_excerpt exclude_tree=\"7,10\"]<\/code><\/li>\n<li><strong>include<\/strong> - include a comma-separated list of Page IDs into the list: <code>[pagemagic_image_excerpt include=\"6,7,8\"]<\/code><\/li>\n<li><strong>meta_key<\/strong> and <strong>meta_value<\/strong> - only include the pages that have this Custom Field Key and this Custom Field Value: <code>[pagemagic_image_excerpt meta_key=\"metakey\" meta_value=\"metaval\"]<\/code><\/li>\n<li><strong>authors<\/strong> - only include the pages written by the given author(s) <code>[pagemagic_image_excerpt authors=\"6,7,8\"]<\/code><\/li>\n<li><strong>number<\/strong> - sets the number of pages to display: <code>[pagemagic_image_excerpt number=\"10\"]<\/code>; by default the number is unlimited (number=\"\")<\/li>\n<li><strong>offset<\/strong> - the number of pages to pass over (or displace) before collecting the set of pages: <code>[pagemagic_image_excerpt offset=\"5\"]<\/code>; by default there is no offset (offset=\"\")<\/li>\n<li><strong>post_type<\/strong> - list associated with a certain hierarchical Post Type <code>[pagemagic_image_excerpt post_type=\"page\"]<\/code>; by default: (post_type=\"page\"); possible values: page, revision, Hierarchical Custom Post Types ('post' is not a Hierarchical Post Type)<\/li>\n<li><strong>post_status<\/strong> - a comma-separated list of all post status types: <code>[pagemagic_image_excerpt post_status=\"private\"]<\/code>; by default: (post_status=\"publish\"); possible values: publish, private, draft<\/li>\n<li><strong>class<\/strong> - the CSS class for list of pages: <code>[pagemagic_image_excerpt class=\"listclass\"]<\/code>; by default the class is empty (class=\"\")<\/li>\n<li><strong>strip_tags<\/strong> - strip tags or not: <code>[pagemagic_image_excerpt strip_tags=\"0\"]<\/code>; by default the tags are stripped (strip_tags=\"1\")<\/li>\n<li><strong>strip_shortcodes<\/strong> - strip registered shortcodes or not: <code>[pagemagic_image_excerpt strip_shortcodes=\"0\"]<\/code>; by default shortcodes are stripped (strip_shortcodes=\"1\") and all registered shortcodes are removed<\/li>\n<li><strong>show_child_count<\/strong> - show count of subpages: <code>[pagemagic_image_excerpt show_child_count=\"1\"]<\/code>; by default the child_count is disabled (show_child_count=\"0\"); If show_child_count=\"1\", but count of subpages=0, than child count is not shown<\/li>\n<li><strong>child_count_template<\/strong> - the template of child_count: <code>[pagemagic_image_excerpt show_child_count=\"1\" child_count_template=\"Subpages: %child_count%\"]<\/code>; by default child_count_template=\"Subpages: %child_count%\"<\/li>\n<li><strong>show_meta_key<\/strong> - show or hide meta key: <code>[pagemagic_image_excerpt show_meta_key=\"your_meta_key\"]<\/code>; by default the show_meta_key is empty (show_meta_key=\"\"); If show_meta_key is enabled, but meta_value is empty, than meta_key is not shown<\/li>\n<li><strong>meta_template<\/strong> - the template of meta: <code>[pagemagic_image_excerpt show_meta_key=\"your_meta_key\" meta_template=\"Meta: %meta%\"]<\/code>; by default meta_template=\"%meta%\"<\/li>\n<li><strong>columns<\/strong> - for splitting list of pages into columns: <code>[pagemagic_image_excerpt class=\"pagemagic-cols-2\"]<\/code>; available classes: pagemagic-cols-2, pagemagic-cols-3, pagemagic-cols-4, pagemagic-cols-5; works in all modern browsers and IE10+;  columns are responsive and become 1 column at less than 768px<\/li>\n<\/ul>\n\n<p>[More info] about parameters (https:\/\/developer.wordpress.org\/reference\/functions\/get_pages\/#parameters) for [pagemagic_image_excerpt].<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin on the Plugins page.<\/li>\n<li>Add shortcodes to pages: <code>[pagemagic_listall]<\/code>, <code>[pagemagic_subpages]<\/code>, <code>[pagemagic_this_siblings]<\/code>, <code>[pagemagic_image_excerpt]<\/code><\/li>\n<li>Use the Page Magic Custom Excerpt meta box in the page builder to set a custom excerpt.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt><h3>What's the difference between [pagemagic_listall], [pagemagic_subpages] and [pagemagic_siblings]?<\/h3><\/dt>\n<dd><p>Shortcodes [pagemagic_listall], [pagemagic_subpages] and [pagemagic_siblings] accept the same parameters. The only difference is that [pagemagic_subpages] and [pagemagic_siblings] do not accept <code>child_of<\/code> parameter, because [pagemagic_subpages] shows subpages to the current page and [pagemagic_siblings] shows subpages to the parent page.<\/p><\/dd>\n<dt><h3>How do I create a sitemap.xml file?<\/h3><\/dt>\n<dd><p>To create a sitemap.xml file you can use <a href=\"https:\/\/www.xml-sitemaps.com\/\">XML-Sitemaps.com<\/a>.<\/p><\/dd>\n<dt><h3>What do I do if I need to change the plugin's code?<\/h3><\/dt>\n<dd><p>When you changed the plugin's code you should also change the plugin's version to '100' (for example) to avoid updates, which could override and delete your code.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Create visual hierarchies of site pages. Options to list all pages, subpages, current page siblings. Also able to show page featured image and custom  &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/123813","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=123813"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/anonymized-18108807"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=123813"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=123813"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=123813"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=123813"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=123813"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=123813"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}