1. Evo Documentation
      1. Administration
        1. Admin Users
          1. Admin Roles And Groups
          2. Reset your Password - Unblock your User
          3. Why Admin Users, Roles and Groups
        2. Friendly URL Solutions
        3. Moving Site
        4. Taking sites down for maintenance
        5. Upgrading
        6. Web Users
          1. Creating a Web User
          2. Web User Groups and Document Groups
          3. Why Web Users and Groups
      2. Content Editing
        1. Editing Resources
          1. Creating a Resource
          2. Edit a Resource
          3. Move a Resource
          4. Publishing a Resource
          5. Select a Template
        2. Evo Tags
          1. Document Variables
        3. Terminology
        4. The Admin Interface
        5. Who Should Read This
      3. Designing
        1. Adding Chunks
        2. Adding Snippets
        3. Adding Tags
          1. Resource Fields
        4. Cross References
        5. Document Caching
        6. Modifiers
          1. @ Modifiers
        7. Template Basics
      4. Developer's Guide
        1. API Reference
          1. DBAPI
            1. delete
            2. escape
            3. getInsertId
            4. query
            5. select
            6. update
          2. Document Object
          3. DocumentParser Object
            1. addEventListener
            2. changeWebUserPassword
            3. documentContent
            4. documentGenerated
            5. documentIdentifier
            6. documentListing
            7. documentMethod
            8. documentObject
            9. evalSnippet
            10. getAllChildren
            11. getCachePath
            12. getChildIds
            13. getDocumentChildren
            14. getDocumentChildrenTVarOutput
            15. getDocumentChildrenTVars
            16. getLoginUserID
            17. getLoginUserName
            18. getLoginUserType
            19. getManagerPath
            20. getParent
            21. getParentIds
            22. getUserData
            23. hasPermission
            24. isBackend
            25. isFrontend
            26. logEvent
            27. maxParserPasses
            28. minParserPasses
            29. regClientCSS
            30. runSnippet
            31. table_prefix
            32. tstart
            33. webAlert
        2. Chunks
        3. Modules
          1. How to create and run a module from within the Admin Interface
          2. Managing module dependencies
          3. Setting up configuration parameters
          4. Writing the module code
        4. Plugins
        5. Snippets
        6. Template Variables
          1. @ Bindings
            1. (at)CHUNK
            2. (at)DIRECTORY
            3. (at)DOCUMENT
            4. (at)EVAL
            5. (at)FILE
            6. (at)INHERIT
            7. (at)SELECT
            8. What are (at) Bindings
          2. Creating a Template Variable
          3. What are Template Variables
          4. Widgets
            1. DataGrid Widget
            2. Floater Widget
            3. Hyperlink Widget
            4. Marquee Widget
            5. Misc. Widget
            6. RichTextBox Widget
            7. Ticker Widget
            8. Viewport Widget
            9. What are Widgets
      5. Getting Started
        1. About Evo
        2. Basic Installation
    2. Evo Extras
      1. AjaxSearch
      2. AnythingRating
      3. Breadcrumbs
      4. directResize
      5. Ditto
        1. Examples
        2. Extenders
        3. Parameters
        4. Placeholders
      6. DocLister
        1. Examples
        2. Filters
        3. Main Parameters
        4. Notes for Developers
        5. Output Parameters
        6. Processing Before Output
      7. Easy 2 Gallery
      8. eForm
      9. EvoGallery
      10. FirstChildRedirect
      11. Jot
      12. MaxiGallery
      13. multiTV
        1. Examples
        2. Extras
        3. Installation
        4. Module
        5. Snippet
        6. Template Variable
      14. PHx
        1. Custom Modifiers
      15. Quill
      16. tagLinks
      17. TinyMCE
      18. TvTagCloud
      19. Wayfinder
        1. Examples
      20. Weblogin
      21. WebLoginPE
        1. API
        2. Parameters
        3. Placeholders
        4. Typical Errors
        5. Views (Templates)
        6. Working with Forms
      22. YAMS
        1. Configuration
        2. How To
          1. YAMS + Breadcrumbs
          2. YAMS + Ditto
          3. YAMS + Ditto + PHx
          4. YAMS + eForm
          5. YAMS + Jot
          6. YAMS + Snippets
          7. YAMS + Wayfinder
          8. YAMS Custom Multilingual TVs, Chunks, Snippets
          9. YAMS Language Dependent Layout
          10. YAMS Language Flag List
          11. YAMS Language Select Landing Page
          12. YAMS Mime-type Dependent Alias Suffixes
          13. YAMS Multilingual Weblinks
          14. YAMS XML Sitemap
        3. Installation
        4. Language Modes
        5. Language Settings
        6. Placeholders
        7. Setup
        8. Snippet
        9. Technical Details
    3. Evo Tutorials
      1. Extras - How To
        1. Ditto Tutorials
          1. Add Ditto Pagination
          2. Basic RSS feed
          3. Category Tagging with Ditto
          4. Create a Custom Ditto Template
          5. Custom Placeholders
          6. Dropdown Menu with Ditto
          7. Dynamically Show Related Posts
          8. Promote to Home Page
          9. Sort by a date tv
          10. Tagged blogging with Ditto (ex.1)
          11. Tagged blogging with Ditto (ex.2)
          12. Tagging Screencast


This is a user-contributed Extra. If you find issues or would like more info or help, please contact the author.

Parameter description for Ditto version 2.x

Main parameters

Parameter Description Options Default
config Load a custom configuration "default" - default blank config file
CONFIG_NAME - Other configs installed in the configs folder or in any folder within the Evo base path via @FILE
dateFormat Format the [+date+] placeholder in human readable form Any valid format for PHP function strftime $_lang["dateFormat"] - From Ditto language file. Default for English language is `%d-%b-%y %H:%M`
dateSource Source of the [+date+] placeholder Any UNIX timestamp from Evo fields or TVs such as createdon, pub_date, or editedon `createdon`
debug Output debugging information 0 (off), 1 (on) `0`
depth Depth of document tree levels to fetch from positive integer (0 for unlimited) `1`
display Number of documents to display
(per page if pagination is on)
positive integer, `all` (all documents found) `all`
ditto_base Location of Ditto files Any valid folder location containing the Ditto source code with a trailing slash [(base_path)]assets/snippets/ditto/
documents IDs of documents for Ditto to retrieve. Overrides &parents property. Comma-separated list of IDs of resources to list none
extenders Load an extender which adds functionality to Ditto Any extender in the extenders folder or in any folder within the Evo base path via @FILE. May be a comma separated list of extenders. none
format Output format to use html, json, xml, atom, rss `html`
hiddenFields Allow Ditto to retrieve fields its template parser cannot handle such as nested placeholders and [*fields*] Any valid Evo fieldnames or TVs comma separated none
hideFolders Don't show folders in the returned results 0 - show folders
1 - hide folders
hidePrivate Don't show documents the guest or user does not have permission to see 0 - show private documents
1 - hide private documents
id Unique ID for this Ditto instance for connection with other scripts (like Reflect) and unique URL parameters Any combination of characters a-z, underscores, and numbers 0-9 (This is case sensitive) blank
keywords Enable fetching of associated keywords for each document. Can be used as [+keywords+] or as a tagData source 0 (off), 1 (on) `0`
language language for defaults, debug, and error messages Any language name with a corresponding file in the &ditto_base/lang folder `english`
noResults Text or chunk to display when there are no results Any valid chunk name or text $_lang['no_documents'] - From Ditto language file. Default for English language is `<p>No documents found.</p>`
orderBy Sort the result set Any valid MySQL style orderBy statement `createdon DESC`
parents IDs of containers for Ditto to retrieve their children to &depth depth Comma-separated list of resource IDs current resource
phx Use PHx formatting 0 (off), 1 (on) `1`
queryLimit Number of documents to retrieve from the database, same as MySQL LIMIT positive integer, `0` (automatic) `0`
randomize Randomize the order of the output 0 (off), 1 (on), Any Evo field or TV name (for weighted random by that field) `0`
removeChunk Name of chunks to be stripped from content separated by commas. Commonly used to remove comments. Any valid chunkname that appears in the output none
save Saves the ditto object and results set to placeholders for use by other snippets 0 - off; returns output
1 - remaining; returns output
2 - all;
3 - all; returns ph only
seeThruUnpub See through unpublished folders to retrive their children. Used when depth is greater than 1. 0 (off), 1 (on) `0`
showInMenuOnly Show only documents visible in the menu 0 - show all documents
1 - show only documents with the "show in menu" flag checked
showPublishedOnly Show only published documents 0 - show only unpublished documents
1 - show both published and unpublished documents
start Number of documents to skip in the results positive integer, `0` (don't skip) `0`
total Number of documents to retrieve positive integer, `all` (all documents found) `all`
where Custom MySQL WHERE statement A valid MySQL WHERE statement using only document object items (no TVs) blank


Parameter Description Options Default
filter Removes items not meeting a critera. Thus, if pagetitle == joe then it will be removed. Use in the format "field,criteria,mode" with the comma being the local delimiter.

Mode - Meaning
  1. != (not equal)
  2. == (equals)
  3. < (lower than)
  4. > (greater than)
  5. <= (lower than or equal)
  6. >= (greater than or equal)
  7. Text not in field value
  8. Text in field value
  9. case insenstive version of #7
  10. case insenstive version of #8
  11. checks leading character of the field
@EVAL in filters works the same as it does in Evo except it can only be used with basic filtering, not custom filtering (tagging, etc). Make sure that you return the value you wish Ditto to filter by and that the code is valid PHP.
globalFilterDelimiter Filter delimiter used to separate filters in the filter string Any character not used in the filters `|`
localFilterDelimiter Delimiter used to separate individual parameters within each filter string Any character not used in the filter itself `,`


Parameter Description Options Default
paginate Paginate the results set into pages of &display length.
Use &total to limit the number of documents retrieved.
0 (off), 1 (on) `0`
paginateAlwaysShowLinks Determine whether or not to always show previous next links 0 (off), 1 (on) `0`
paginateSplitterCharacter Splitter to use if always show is disabled Any valid character $_lang['button_splitter'] - From Ditto language file. Default for English language is `|`
tplPaginateCurrentPage Template for the current page link - Any valid chunk name
- Code via @CODE
- File via @FILE
`<span class='ditto_currentpage'>[+page+]</span>`
tplPaginateNext Template for the next link - Any valid chunk name
- Code via @CODE
- File via @FILE
`<a href='[+url+]' class='ditto_next_link'>[+lang:next+]</a>`
tplPaginateNextOff Template for the next link when it is off - Any valid chunk name
- Code via @CODE
- File via @FILE
`<span class='ditto_next_off ditto_off'>[+lang:next+]</span>`
tplPaginatePage Template for the page link - Any valid chunk name
- Code via @CODE
- File via @FILE
`<a class='ditto_page' href='[+url+]'>[+page+]</a>`
tplPaginatePrevious Template for the previous link - Any valid chunk name
- Code via @CODE
- File via @FILE
`<a href='[+url+]' class='ditto_previous_link'>[+lang:previous+]</a>`
tplPaginatePreviousOff Template for the previous link when it is off - Any valid chunk name
- Code via @CODE
- File via @FILE
`<span class='ditto_previous_off ditto_off'>[+lang:previous+]</span>`


Parameter Description Options Default
outerTpl User defined outer template chunk for the snippet output - Any valid chunk name
- Code via @CODE
- File via @FILE
tpl User defined chunk to format the documents

&tpl can take three kinds of values:

  1. If the value does not begin with "@CODE" or "@FILE" then it is interpreted as the name of a chunk which contains the desired template.

  2. If the value begins with "@FILE", then it is interpreted as the pathname of a file which contains the desired template.

  3. If the value begins with "@CODE", then the value is interpreted as the template itself; right there in the snippet call.

- Any valid chunk name
- Code via @CODE
- File via @FILE
HTML code block $_lang['default_template'] from Ditto language file (using @CODE).
tplAlt User defined chunk to format every other document - Any valid chunk name
- Code via @CODE
- File via @FILE
value of &tpl
tplCurrentDocument User defined chunk to format the current document - Any valid chunk name
- Code via @CODE
- File via @FILE
value of &tpl
tplFirst User defined chunk to format the first document - Any valid chunk name
- Code via @CODE
- File via @FILE
value of &tpl
tplLast User defined chunk to format the last document - Any valid chunk name
- Code via @CODE
- File via @FILE
value of &tpl

Suggest an edit to this page.