Templating Best Practices

In order to make page templating as easy as possible, keep these best practices in mind:

  • Repurpose content as often as possible to reduce the number of files that need to be changed. This can be accomplished using includes in the TCF, as well as calling the same TMPL as often as possible.
  • Use clear naming conventions for templates. When trying to determine the purpose of a template, the filename can go a long way.
  • Create contextual New Page Wizard images to help users make the proper selections.
  • Utilize the Styles drop-down to help give users flexibility while keeping them locked into the institution’s CSS.
  • Plan out group access, general access settings, and binary management in order to determine what attributes need to be passed in the TCF and if empty folders need to be created upon the creation of new directories.
  • When possibly, share templates across sites to keep the website as a whole consistent.
  • Remember to carefully review code. All tags must close, and proper quotations must be used.
  • Be conscientious of XML rules in order to avoid errors.
  • Keep things simple. When templates get overly complicated, it is easy to encounter errors because there are so many moving parts.