ListPages Improvements
nav_first.pngFirst: thread:131
HTML Block
Edited: 11 Oct 2012 12:06 by: GoVegan
Comments: 0
nav_prev.pngPrevious: thread:272
Anti-spam tools
Edited: 23 Feb 2010 08:52 by: pieterh
Comments: 0
Last: thread:112
Image Module
Edited: 12 Nov 2009 12:22 by: pieterh
Comments: 0
Next: thread:233
Standard Template Properties
Edited: 05 Feb 2010 11:49 by: pieterh
Comments: 0

Steven HeynderickxSteven Heynderickx wrote on 10 Nov 2009 15:45

Originally suggested by pieterhpieterh on 24 September 2009.

This is a design sketch for improvements to the ListPages module. Since we aim to always keep backwards compatibility, these are all new features, rather than changes to existing features.


Tags selector:

  • "+" means pages with any tags, visible or invisible (c.f. "-" meaning no tags)

Site selector (for CSL, Cross Site ListPages):

  • Select by site: site="site-selector"
  • Specifies a subdomain, a full domain, or a custom domain.
  • The site must be public and (eventually) be configured as a valid CSL source.

Cluster selector:

  • Select by cluster: cluster="cluster-name"
  • See cluster concept of data model.
  • Clusters are not yet implemented.

Backlink selector:

  • Select by backlink: backlink="backlink-selector"
  • "-" means pages with no backlink (i.e. orphaned pages)
  • Else specifies a list of space/comma delimited category:page values

Updated-at selector:

  • Select by last editor: updated_by="updated-by-selector"
  • "=" means by created by author of current page
  • "-=" means by not created by author of current page
  • Else, a single user name

Created-at selector:

  • Selector takes into account UTC+- site settings (new site manager setting)

Contains selector:

  • Select by last-updated content: contains="contains-selector"
  • Single string or regular expression
  • Searches first X characters of content
  • Possibly extended to searching specific content sections

Name selector:

  • Select by page name: name="name-selector"
  • Specifies a list of space/comma delimited page names
  • If no category specified, intersected with category selector

Property selector:

  • Select by form data field: property="property-selector"
  • Specifies a list of space/comma delimited field names
  • +field means where field is provided (not empty)
  • -field means where field is empty
  • field=value means where field has the value specified (value must be a single word)

Multiple selector sets

You can specify one or more sets of selectors in a [[select]] item within the module body. If you do this, any selectors in the ListPages module specification will be ignored. Note that the "order" argument is used both to select items, and to output them, and so can be specified both in the individual select set and in the module.

If you specify multiple select sets, the resulting lists of pages are merged into one list. When you do this, some constraints apply:

  • It is not possible to paginate the results.

For example:

[[module ListPages order="updated_at desc"]]
[[select site="blog" category="weneed" tags="-_deleted -_closed" order="rating desc" limit="10"]]
[[select site="bugs" category="issue" tags="-_closed" order="rating desc" limit="10"]]
... template ...

List ordering

Order criteria:

Property Meaning
parent Order by parent name
activity Order by date of last activity on page
children Order by number of children
watchers Order by number of watchers

The activity order is the last date of comment, edit, file upload, tagging, rename, or parent change.

Header and Footer

ListPages confirms/will conform to the Standard List Header and Footer specification.

Template properties

ListPages conforms/will conform to the Standard Template Properties specification.

Start a new sub-thread

Order by Wilson Score Confidence Intervals By AJMansfield 0 Comments 07 Jan 2016 21:00
Variable %%children_created_by%% By leiger 0 Comments 23 Mar 2010 13:38
List descendants By gerdami 3 Comments 05 Mar 2010 11:20
order="children desc" By leiger 0 Comments 02 Mar 2010 08:24
Order by %%_tags%% By suef 1 Comments 27 Feb 2010 00:21
Expansion of variables: %%breadcrumbs%% By Steven Heynderickx 2 Comments 19 Feb 2010 16:00
Integration of countpages By Steven Heynderickx 2 Comments 28 Jan 2010 11:17
Selector empty, notempty By Steven Heynderickx 3 Comments 19 Feb 2010 12:04
Integration of backlinks By Steven Heynderickx 0 Comments 28 Jan 2010 10:48
Multiple selector sets ordering By Steven Heynderickx 3 Comments 24 Nov 2009 13:52
Output separator text By pieterh 0 Comments 12 Nov 2009 12:57
How about %%label{field-name}%% (closed) By Steven Heynderickx 4 Comments 16 Dec 2009 21:53
tags="+" (closed) By leiger 1 Comments 11 Dec 2009 23:13
%%created_by_id%% and %%updated_by_id%% to work with User Profiles (closed) By leiger 8 Comments 09 Dec 2009 12:30
Allow logical combinations of selectors (closed) By scottplan 13 Comments 21 Nov 2009 15:42
Page selector (closed) By Steven Heynderickx 2 Comments 21 Nov 2009 22:21

We discourage direct comments on this thread: to discuss it, please start a sub-thread.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License