Steven Heynderickx wrote on 10 Nov 2009 15:45
Originally suggested by pieterh 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.
Selectors
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 wikidot.com 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 ...
[[/module]]
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.
| 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.
How about beeing able to say what the separator should be?
separate="|" separatecontainer="no"
would give
Note: smart programming will remove last "|"
separate="[[div class='new']]" separatecontainer="yes"
Note: NO <p>!!
default with no separate defined
A - S I M P L E - P L A N by ARTiZEN a startingpoint for simple wikidot solutions.
Use case?
And the pipe symbol is already being used, so likely that it is protected and you'll have to find another symbol to use as the 'separator'.
~ Leiger - Wikidot Community Admin - Volunteer
Wikidot: Official Documentation | Wikidot Discord server | NEW: Wikiroo, backup tool (in development)