Loading...
 

Plugin List

Introduced in Tiki7. If you are searching for the list of all plugins, see All Plugins.



Introductionary Remarks


LIST is a very powerful and flexible wiki plugin that can return and output data (a listing) of information using various sorts, filters etc. It uses the search data provided by the improved search index so it should be emphasized that this means that only the data that has actually been indexed by the Unified Index can be accessed. A good knowledge of how Unified Index works is therefore recommended.

By utilizing a full-text search across most major Tiki features, which is then enhanced by programmable filter, OUTPUT, DISPLAY, and SORT commands, this combination can render almost any information in the database in any format desired. This means that LIST is similar in some respects to Pretty Trackers output of TrackerList plugin but it is not limited to just the Tracker data. When combined with the PluginCustomSearch plugin, LIST can replace TrackerList and TrackerFilter plugin usage and can considerably extend it!! Please also see PluginListExecute.

Commands vs. Wiki Plugins


"Commands" are quite similar to "wiki plugins", as they use the very same syntax of parameters and values.
The positions of the parameters can be switched around aswell in wiki plugins as in List commands. Both allow to leave the the quotation marks around the values of the parameters away, when the values contain no empty spaces.

However, for both, commands and wiki plugins, it makes sense to stick to some best practice in respect of a consistent sort order. This is not mandatory, but makes it easier to understand the prinicple, to read the own code and to work together in teams. This is especially valid for the LIST commands, as there are usually a lot of commands used in one LIST plugin.

The difference between "commands" and "wiki plugins" is, that you cannot use a "command" stand alone outside one of the plugins, which use the "PluginList" syntax, as there are "PluginList", "PluginCustomSearch" and "PluginListExecute". If you would place a single List "command" stand alone on a wiki page it would happen either nothing or you got an error message.

"Wiki plugins" instead are used stand alone everwhere, where you can use wiki syntax and to some extend, you can nest them aswell.

Clarifying a potential confusion


One potentially confusing fact is the difference between a command and a parameter both called "format":

The parameter "format" (in lower case) inside the command "{display}" is responsible for how the displayed result is rendered. Maybe it also could have been named "render" instead of "format", but "format" was the naming decision of our coders and that makes sense aswell, maybe even better sense on some reason.

The command "{FORMAT(name=...)}" (in upper case) wraps around the command "{display}" and is for example responsible for the reference to the command column (when we consider the example of a tracker table display).

The other potentially confusing fact is, is the difference and same time similarity of the parameters "field" and "name", where we use always "field" in the {filter} and in the {column} inside the "{OUTPUT(template=table)})" command.
Contrarily we use "name" in the optional ''{display} and {FORMAT()}'' commands.

When we use this ...

{filter field="tracker_id" content="10"}
  {OUTPUT(template="table")}
     {column field="tracker_field_permanent_name_1" label="columntitle" mode="raw"}
     {column field="tracker_field_permanent_name_2" label="columntitle" mode="raw"}
  {OUTPUT}


... then the "field"' parameter contains a "Unified Index field"'' - in this case a tracker field which we want to display.

But when we use this ...

{filter field="tracker_id" content="10"}
  {OUTPUT(template="table")}
     {column field="reference_1" label="columntitle" mode="raw"}
     {column field="reference_2" label="columntitle" mode="raw"}
  {OUTPUT}
     {FORMAT(name="reference_1")}{display name="tracker_field_permanent_name_1" format=trackerrender editable=inline default="n.a."}{FORMAT}
     {FORMAT(name="reference_2")}{display name="tracker_field_permanent_name_2" format=trackerrender editable=inline default="n.a."}{FORMAT}


... we referenced (passed) the actual value of the "field" parameter of command "{column ...}" to the subcommand "{display ...}" inside the command '"{FORMAT(...)", where we for some reason cannot use a parameter '"field"''.

When we reference the orignal content of "field" from one to another command, both commands need to "know" about each other, which you see as obvious, when you have more than only one column.
So the content of the column's field parameter will be replaced with a reference string and this reference string has to be repeated in the FORMAT's name parameter. Now the column command and the FORMAT command are interlinked with each other. Finally the original content of the columns field parameter (which is a "Unified Index field") has to be placed into the display's name parameter.

In other words:

"Unified Index field string" goes from "column field" to "display name"
And a "reference string" is added to "column field" and "FORMAT name"

Important to know is the content of the page Unified Index, where you find a list of all available "Unified Index fields" for which you can filter and in respect of tracker based tables you can use to create columns.

Additional child pages of the LIST documentation




Syntax Overview


The overall format is the same as any other plugin:
{LIST()}
body content
{LIST}


Any of the following commands with their own plugin-like syntax are placed in the body of the LIST plugin to define the search query that will be carried out and how the resulting list will be presented :

plugin-like command
description
version
default or required
see below for more detail
list or pagination The LIST plugin will display 50 results by default but depending on the output you might want to decrease the visible amount of results to improve performance. pagination from Tiki 11 default is 50 items see the child page LIST - list or pagination command for full details and worked examples
filter is a required command in the LIST body content and is used to define the search query that will be carried out ie what objects from the complete set that have been indexed by the Unified Search will be included in the resultant list
required
see the child page LIST - filter command for full details and worked examples
OUTPUT defines what the output 'template' will be by either using one of several standard/built-in templates eg table, medialist or carousel or by referencing a user defined wiki or smarty template. For the table template for example, the body content is used to define which columns/fields are shown
optional
see the child pages LIST - output command and LIST - advanced output command for full details and worked examples
ALTERNATE used in conjunction with the OUTPUT command it can define an alternative output when an individual item (row) from a search/listing has no value
optional
see the child page LIST - output command for more details and worked examples
FORMAT The FORMAT command is used to create individually templated objects that can then be used in any of the individual OUTPUT methods.
optional
see the child page LIST - format command for full details and worked examples
DISPLAY: Used to define placement and formatting of individual objects
optional
see the child page LIST - display command for full details and worked examples
SORT: allows the resultant list of objects to be sorted in a specified order
optional
see the child page LIST - sort command for full details and worked examples


Basic worked example


step by step instructions to be added here for a basic worked example


In the meantime, you can see a basic working example here: GeoLocation (or play in your tiki with a similar basic example after applying the profile Easy Geoblog, which is available at the Profiles Wizard ).

Body content elements of the LIST Plugin


Each of the principle plugin-like commands are described in more detail in the following set of child pages:


Additional General Notes on the Syntax


  • The field argument in the content filter can contain multiple fields separated by commas.

Available Fields


All the fields that are indexed can be referenced by the various plugin-like commands e.g. filter , FORMAT, etc and a complete list of fields for each object type can be found in the Unified Index documentation.

More Worked Examples


Example Blog Post List
This code:

{LIST()}
	{list max="10"}
	{filter type="blog post"}
	{filter content="1" field="blog_id"}
{LIST}


Would produce on this site:



Tutorials


Aliases

doc.tiki.org


Bootstrap

AdminGuide

UserGuide

Keywords

Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

Accessibility (WAI and 508)
Accounting (7.x)
Articles and Submissions
Backlinks
Banners
Batch (6.x)
BigBlueButton audio/video/chat/screensharing (5.x)
Blog
Bookmark
Browser Compatibility
Link Cache
Calendar
Category
Chat
Clean URLs
Comments
Communication Center
Compression (gzip)
Contacts (Address Book)
Contact us
Content Templates
Contribution (2.x)
Cookie
Copyright
Credit (6.x)
Custom Home and Group Home Page
Date and Time
Debugger Console
Directory of hyperlinks
Documentation link from Tiki to doc.tiki.org (Help System)
Docs 8.x
Draw 7.x
Dynamic Content
Dynamic Variable
External Authentication
FAQ
Featured links
File Gallery
Forum
Friendship Network (Community)
Gmap Google maps
Groups
Hotword
HTML Page
i18n (Multilingual, l10n, Babelfish)
Image Gallery
Import-Export
Install
Integrator
Interoperability
Inter-User Messages
InterTiki
Kaltura video management (4.x)
Karma
Live Support
Login
Logs (system & action)
Look and Feel
Lost edit protection
Mail-in
Map with Mapserver
Menu
Meta Tags
Mobile Tiki and Voice Tiki
Mods
Module
MultiTiki
MyTiki
Newsletter
Notepad
Payment
Performance Speed / Load
Permissions
Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
Polls
Profiles
Profile Manager
Report
Toolbar
Quiz
Rating
Feeds
Score
Search engine optimization
Search
Search and Replace
Security
Semantic links (3.x)
Shadowbox
Shadow Layers
Share
Shopping cart
Shoutbox
Slideshow
Smiley
Social Networks
Spam protection (Anti-bot CATPCHA)
Spellcheck
Spreadsheet
Stats
Surveys
Tags (2.x)
Task
Tell a Friend, alert + Social Bookmarking
TikiTests (2.x)
Theme CSS & Smarty
Trackers
Transitions (5.x)
TRIM
User Administration including registration and banning
User Files
User Menu
Watch
WebHelp
WebDAV (5.x)
Webmail
Web Services
Wiki 3D
Wiki History, page rename, etc
Wiki Page Staging and Approval (2.x)
Wiki Plugin extends basic syntax
Wiki Syntax
Wiki structure (book and table of content)
Workspace
WSOD
WYSIWYCA
WYSIWYG (2.x)
XMLRPC


Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki