Advanced Iframe ProPage-listDonateGitHub
Plugin helps you to show list of pages of your web-site with [pagelist], [subpages], [siblings] and [pagelist_ext] shortcodes. Very usefull for adding sitemap or list of subpages or list of products with thumbnails on your web-site.
Documentation
Shortcodes [pagelist], [subpages], [siblings] are based on wp_list_pages('title_li=') function and show hierarchical tree of pages;
You can use aditional parameters: [pagelist depth="2" child_of="4" exclude="6,7,8"]
.
Shortcodes [pagelist], [subpages] and [siblings] accept the same parameters. The only difference is that [subpages] and [siblings] not accept child_of
parameter, because [subpages] shows subpages to the current page and [siblings] shows subpages to the parent page.
Shortcode [pagelist_ext] is based on get_pages() function and show list of pages with featured image and with excerpt;
You can use aditional parameters: [pagelist_ext child_of="4" exclude="6,7,8" image_width="50" image_height="50"]
.
Parameters for [pagelist], [subpages] and [siblings]:
- depth - means how many levels in the hierarchy of pages are to be included in the list, by default depth is unlimited (depth=0), but you can specify it like this:
[pagelist depth="3"]
; If you want to show flat list of pages (not hierarchical tree) you can use this shortcode:[pagelist depth="-1"]
; - child_of - if you want to show subpages of the specific page you can use this shortcode:
[pagelist child_of="4"]
where4
is the ID of the specific page; If you want to show subpages of the current page you can use this shortcodes:[subpages]
or[pagelist child_of="current"]
or[pagelist child_of="this"]
; If you want to show sibling pages of the current page you can use this shortcodes:[siblings]
or[pagelist child_of="parent"]
; - exclude - if you want to exclude some pages from the list you can use this shortcode:
[pagelist exclude="6,7,8"]
whereexclude
parameter accepts comma-separated list of Page IDs; You may exclude current page with this shortcode:[pagelist exclude="current"]
; - exclude_tree - if you want to exclude the tree of pages from the list you can use this shortcode:
[pagelist exclude_tree="7,10"]
whereexclude_tree
parameter accepts comma-separated list of Page IDs (all this pages and their subpages will be excluded); - include - if you want to include certain pages into the list of pages you can use this shortcode:
[pagelist include="6,7,8"]
whereinclude
parameter accepts comma-separated list of Page IDs; - title_li - if you want to specify the title of the list of pages you can use this shortcode:
[pagelist title_li="<h2>List of pages</h2>"]
; by default there is no title (title_li=""); - number - if you want to specify the number of pages to be included into list of pages you can use this shortcode:
[pagelist number="10"]
; by default the number is unlimited (number=""); - offset - if you want to pass over (or displace) some pages you can use this shortcode:
[pagelist offset="5"]
; by default there is no offset (offset=""); - meta_key - if you want to include the pages that have this Custom Field Key you can use this shortcode:
[pagelist meta_key="metakey" meta_value="metaval"]
; - show_date - if you want to show the date of the page you can use this shortcode:
[pagelist show_date="created"]
; you can use this values forshow_date
parameter: created, modified, updated; - menu_order - if you want to specify the column by what to sort you can use this shortcode:
[pagelist sort_column="menu_order"]
; by default order columns aremenu_order
andpost_title
(sort_column="menu_order, post_title"); you can use this values forsort_column
parameter: post_title, menu_order, post_date (sort by creation time), post_modified (sort by last modified time), ID, post_author (sort by the page author's numeric ID), post_name (sort by page slug); - sort_order - if you want to change the sort order of the list of pages (either ascending or descending) you can use this shortcode:
[pagelist sort_order="desc"]
; by default sort_order isasc
(sort_order="asc"); you can use this values forsort_order
parameter: asc, desc; - link_before - if you want to specify the text or html that precedes the link text inside the link tag you can use this shortcode:
[pagelist link_before="<span>"]
; you may specify html tags only in theHTML
tab in your Rich-text editor; - link_after - if you want to specify the text or html that follows the link text inside the link tag you can use this shortcode:
[pagelist link_after="</span>"]
; you may specify html tags only in theHTML
tab in your Rich-text editor; - class - if you want to specify the CSS class for list of pages you can use this shortcode:
[pagelist class="listclass"]
; by default the class is empty (class="");
Parameters for [pagelist_ext]:
- 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 - if you want to output all content before and after more tag use this shortcode:
[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 - if you want to show subpages of the specific page you can use this shortcode:
[pagelist_ext child_of="4"]
where4
is the ID of the specific page; by default it shows subpages to the current page; - parent - if you want to show subpages of the specific page only you can use this shortcode:
[pagelist_ext parent="4"]
where4
is the ID of the specific page and the depth will be only one level; by default parent="-1" and depth is unlimited; - sort_order - if you want to change the sort order of the list of pages (either ascending or descending) you can use this shortcode:
[pagelist_ext sort_order="desc"]
; by default: sort_order="asc"; you can use this values forsort_order
parameter: asc, desc; - sort_column - if you want to specify the column by what to sort you can use this shortcode:
[pagelist_ext sort_column="menu_order"]
; by default order columns aresort_column
andpost_title
(sort_column="menu_order, post_title"); you can use this values forsort_column
parameter: post_title, menu_order, post_date (sort by creation time), post_modified (sort by last modified time), ID, post_author (sort by the page author's numeric ID), post_name (sort by page slug); - hierarchical - display sub-pages below their parent page
[pagelist_ext hierarchical="0"]
; by default: hierarchical="1"; - exclude - if you want to exclude some pages from the list you can use this shortcode:
[pagelist_ext exclude="6,7,8"]
whereexclude
parameter accepts comma-separated list of Page IDs; - exclude_tree - if you want to exclude the tree of pages from the list you can use this shortcode:
[pagelist_ext exclude_tree="7,10"]
whereexclude_tree
parameter accepts comma-separated list of Page IDs (all this pages and their subpages will be excluded); - include - if you want to include certain pages into the list of pages you can use this shortcode:
[pagelist_ext include="6,7,8"]
whereinclude
parameter accepts comma-separated list of Page IDs; - meta_key - if you want to include the pages that have this Custom Field Key you can use this shortcode:
[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 - if you want to specify the number of pages to be included into list of pages you can use this shortcode:
[pagelist_ext number="10"]
; by default the number is unlimited (number=""); - offset - if you want to pass over (or displace) some pages you can use this shortcode:
[pagelist_ext offset="5"]
; by default there is no offset (offset=""); - post_type -
[pagelist_ext post_type="page"]
; - post_status -
[pagelist_ext post_status="publish"]
; - class - if you want to specify the CSS class for list of pages you can use this shortcode:
[pagelist_ext class="listclass"]
; by default the class is empty (class=""); - strip_tags - if you want to output the content with tags use this shortcode:
[pagelist_ext strip_tags="0"]
; by default the strip_tags is enabled (strip_tags="1"); - strip_shortcodes - if you want to output the content with shortcode use this shortcode:
[pagelist_ext strip_shortcodes="0"]
; by default the strip_shortcodes is enabled (strip_shortcodes="1") and all registered shortcodes are removed; - show_child_count - if you want to show child count you can use this shortcode:
[pagelist_ext show_child_count="1"]
; 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 showing; - child_count_template - if you want to specify the template of child_count you can use this shortcode:
[pagelist_ext show_child_count="1" child_count_template="Subpages: %child_count%"]
; by default child_count_template="Subpages: %child_count%"; - show_meta_key - if you want to show meta key you can use this shortcode:
[pagelist_ext show_meta_key="your_meta_key"]
; 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 showing; - meta_template - if you want to specify the template of meta you can use this shortcode:
[pagelist_ext show_meta_key="your_meta_key" meta_template="Meta: %meta%"]
; by default meta_template="%meta%";
Is it possible to add a frame on each segment of the list?
I use: [pagelist_ext image_width="70" image_height="70" show_content="0"]
There is only a picture of the page and the Title
I don't understand the question.
Can you explain it with more details?
Hi, for sure, i want to set a table between each pages, something like this:
https://www.mikeslessons.com/index.php/videolessons/packs/ghost-notes
(scroll down: see Lesson Packs)
Its like a frame or table with coloured background and lines....
best wishes and thanks a lot!!
Malt
You can style list of pages with css like on the link you provided.
Thanks! Can you give me a tip trick how this willl work? I am not that big css guy;) thanks!!!!
Hi,
I love this plugin! Is so easy to use and ready-made.
I would like to split the page-list in 2 columns. Is that possible? Any guess on how to do it?
Thanks
Check out this topic about multiple columns.
Thank you, webvitaly !
As you can see,the sitemap is a rather flat alphabethical summary. Addition of parameters has no influence. What am i doing wrong???
Thanks in advance!!!
Piet Giel
I did not understood your problem.
Please provide the link with the problem.
Also please write what you expected to see and what exactly you got.
I would like to see this structure, which is made very tiresome by hand: http://beterzeist.nl/?page_id=2902
In stead I see this: http://beterzeist.nl/?page_id=1356
Your pages first need to be put into a hierarchy of page and subpages, parent pages and child pages.
Right now, all your pages are in a single hierarchy. So they will display flat.
Here's a plugin that will help you quickly create parent and child pages very.
CMS Tree Page View
http://wordpress.org/plugins/cms-tree-page-view/
As I can understand you have flat list of pages in the admin section and that is why you are getting flat (not hierarchical) list.
Page-list plugin show the list of pages like in your admin section.
If you want to make hierarchical list - you should edit for example 'Page A' and set 'Parent page' to 'Page B', click save and than in the list of pages 'Page A' will have indent under 'Page B'.
Write me back if you will have some more questions.
When I put the below code on my page it does not showing any pages as a list. But once I removed the number="100" it shows the entire page list. Why this is happening? How can I limit the number of pages in to 100. Also same thing working fine with [page_ext]. I want to do this with [pagelist]. Please advise.
[pagelist child_of="12" number="100"] *Not working
[pagelist child_of="12" ] *Working
[pagelist_ext child_of="12" number="100"] *Working
is it possible to only show subpages with a certain order number?
I have a large collection of subpages and want to "classify" them somehow to only show one subset, another subset, etc. depending on some argument I provide. like maybe [subpages pagetype=1].
thank you!
Hi I am not getting a tree-like structure for my page list and even when using sort_column="menu_order" the pages are all over the place and are definitely not set out in menu order or indented where there are sub pages
[pagelist child_of="21" sort_column="menu_order" exclude_tree="156"]
try to show the post_type, and i got this one.
Page-list plugin does not work with post_types. It works only with pages.
And also: Warning is not an error. It is better to disable warning notices on live site.
The pagelist_ext number="1" isn't working correctly. I put in 5 and only 3 show, for example.
It works great
i want to show menu as my menu. but its shows home page after portfolio :(
even i give this code
[pagelist sort_column="menu_order"];
The sort order worked for me in my tests. Did you put the correct numbers in the Page Attributes input box in WordPress?
Is it possible to make this work in the template vs the short code?
I just remembered how to do that:
can you limit depth with [pagelist_ext]?
if you want to show subpages of the specific page only you can use this shortcode: [pagelist_ext parent="4"] where 4 is the ID of the specific page and the depth will be only one level; by default parent="-1" and depth is unlimited;
That worked great.... thanks!
Is there a possibility to sort the pages random?
This plugin is great. For me it is an essential plugin, I use it on 3 sites. Websites are more dynamic, interesting and navigation between pages and sub-pages with images and text look good. Works very well on smartphones. Thank you very much!
Hello!
Great plugin, THANKS.
How can the page-list be displayed in a widget-area?
Greetings,
Tamás
I have found a solution (might be useful for others, as wel...):
http://www.wprecipes.com/how-to-add-shortcodes-in-sidebar-widgets
And it works now in the widget area as well!
Cool.
Thnx
Tamás
Hi folks. Could you please help me with a formatting issue. I would like to use the pagelist-ext because I can add images to it but I would like it to the lay out to be similar to the subpages where the child pages are slightly indented to the right.
Thank you.
Sorry, but [pagelist_ext] does not have tree-structure. It has only flat nesting.
Thank you. Is there a way to add images to the left of the page titles using [subpages] ?
Sorry, but it is not possible to add images to [subpages] or [pagelist] shortcodes.
Ok thanks.
Is there any way to stop calling the css? I want to copy the css into the main style.css and not make this plugin call the css on everypage.
Thanks.
IMHO it is useless micro-optimization, because browser loads css file only once on first time.
Next time browser uses cached file.
But if you still want to change it - the only way to do this is manually.
Don't forget to change plugin version to '100' for avoid updating the plugin and prevent losing your code.
Hi guys
I have just installed this with about 3 clicks...WOW...wish I had found this a while a go :D as you can see on my site I have loads of pages and would like some pages to stand out...I know HTML and CSS but script very vague on... How can I make the top Parent of each sub list go bold...I assume I will have to change the script but rather scared to do it... :S
http://www.krissharmsworth.com/full-page-list/
Thanks in advance for any help
Kriss :)
Try to add this css code to main theme style.css file:
.page-list > li > a { font-weight: bold; }
Woohoo...that worked! But how about the next sub title? I know asking a lot...sorry..
The ones I mean are Stargate, TV Films, TV Shows...
If you look on my site you will see why as this site is going to end up with so many pages and just want to make it easier for quick glancing...actually thinking... maybe making some of the lists as collapsable as well...mmmm
Once again thanks for that.. :D
Kriss :)
try to add this css code also:
.page-list > li > ul > li > a { font-weight: bold; }
Thank you!
Works beautifully!
Kriss :)
Thanks for a great plugin... I was wondering if you know how to get an id as well as a class in the div so I can change the background colour.
I tried changing the code to
$list_pages_html .= 'ID.'">';
Which adds the post ID as an id, but can't get it to set a different background colour through CSS using this....
#22.page-list-ext-item{
background-color: #ff3f51 !important;
}
Any help would be great....
Thanks
...I tried changing the code to
$list_pages_html .= 'ID.'">';....
first of all #id cannot start from the number;
you can add your #id to line #328 - http://plugins.trac.wordpress.org/browser/page-list/trunk/page-list.php#L328
something like this:
and use it in css:
Thanks... I'll give it a try. Didn't know that you couldn't start with a number.