Ditto parameters and placeholders
This is as full a list as I can find of parameters and placeholder for Ditto 2.1 and standard extensions to it. Much has been culled from the official ditto.modxcms.com site. The order is somewhat ad hoc, and is more or less in the sequence "set up Ditto, set up the retrieval, set up the retrieved list, format the display", with some of the less vital templates and less used features towards the bottom.
General placeholders
- [+author+]
- Purpose:First available of createdby->fullname, createdby->username, admin username of retrieved document
- [+title+]
- Purpose:pagetitle field of retrieved document
- [+url+]
- Purpose:link to retrieved document
- [+ditto_iteration+]
- Purpose:sequence number of retrieved document within current page
- Notes:Starts from zero
- [+ditto_sort +]
- Purpose:sequence number of retrieved document within complete retrieved set
- Notes:Not officially documented, spotted in Debug screen and it just works. Starts from zero
Placeholders for pagination
- [+next+]
- Purpose:link to next page of result
- Notes:Empty if &paginate <> 1
- [+previous+]
- Purpose:link to previous page of result
- Notes:Empty if &paginate <> 1
- [+splitter+]
- Purpose:filled with &paginateSplitterCharacter when [+previous+] and [+next+] are both active
- Notes:Empty if &paginate <> 1
- [+start+]
- Purpose:sequence number within complete set of first displayed document on page
- Notes:Empty if &paginate <> 1
- [+urlStart+]
- Purpose:number of current page as seen in URL query string (?start=[+urlStart+])
- Notes:Empty if &paginate <> 1
- [+stop+]
- Purpose:sequence number within complete set of last displayed document on page
- Notes:Empty if &paginate <> 1
- [+total+]
- Purpose:total number of retrieved documents
- Notes:Empty if &paginate <> 1
- [+pages+]
- Purpose:page-number links to all the other pages, inactive display of current page number
- Notes:Empty if &paginate <> 1
- [+currentPage +]
- Purpose:number of current page
- Notes:Empty if &paginate <> 1
- [+perPage+]
- Purpose:displayed items per page (equal to <strong>&display</strong>)
- Notes:Empty if &paginate <> 1
- [+totalPages+]
- Purpose:total number of pages in result
- Notes:Empty if &paginate <> 1
- [+ditto_pagination_set+]
- Purpose:1 if &paginate is set
- Notes:Empty if &paginate <> 1
Placeholders for summary
- [+summary+]
- Purpose:Content of introtext field, if not blank, or truncated text
- [+link+]
- Purpose:Link to full item
- Notes:Link text set by &trunctText or default from language file
Placeholders for tagging
- [+tagLinks+]
- Purpose:list of tags associated with document, separated by &tagDelimiter
- Notes:Hyperlinks to filtered view for each tag in &tagDocumentID (or current document)
- [+tags+]
- Purpose:In page containing result: tags used to filter in the displayed documents
- Notes:Reflects &tags parameter or tags supplied in URL
Placeholders for dateFilter
- [+year+]
- Purpose:selected year in filter
- Notes:Two or four-digit value as supplied
- [+month+]
- Purpose:selected month in filter
- Notes:Numerical month
- [+day+]
- Purpose:selected day in filter
- Notes:Numerical day