Tutorials » Upgrading from Ditto 1 to 2

  1. Upgrade Ditto per the instructions in install.txt
  2. Make sure you change the deprecated parameters to their new equivalents using the following list or use &config=compatibility (if you are using the latest SVN version):

Changed:

startID => parents dateFormatType => dateSource descendentDepth => depth tplAltRow => tplAlt tplFirstRow => tplFirst tplLastRow => tplLast tplArchivePrevious => tplPaginatePrevious tplArchiveNext => tplPaginatePrevious emptyText => noResults

No longer exists:

mode - no longer needed truncChars - no longer needed multiLevel - no longer needed displayArchive - handled by Reflect archiveDateType - handled by Reflect archivePlaceholder - handled by Reflect tplArch - handled by Reflect archiveText - Reflect is template-able hiddenTVs - replaced by hiddenFields which should be needed less often
  1. If you are using [+summary+] or [+link+] in your templates append &extenders=summary to your Ditto call
  2. If you have inside of make sure those same fields are either in the template as or included in the &hiddenFields parameter
  3. (optional) Remove the "tv" prefix from Template Variables (TV) used in your templates/calls. For example, if you were using a "foo" TV, Ditto pre-2.0 required prepending it with "tv": &param=tvfoo. Ditto 2 deprecates this requirement so you could write it as &param=foo. The same holds true for Ditto templates. [+tvfoo+] would more simply and intuitively be just [+foo+].