/**
  * Trims a string to a specified length.
  * It will allow tags listed in 'KeepTags' to remain and will intelligently
  * append the trimmed text with '...' or '-' depending on if the trim ends on a word or a space.
  *
  * Expected Params:
  *  len      integer The length to trim the string to
  *  value    string  The string to trim
  *  KeepTags string  A list of tags (like '<p><a>') that are allowed in the trimmed text.
  *
  * @return string
  */
 public function trim()
 {
     return StringUtils::trim($this->getParameter('value'), $this->getParameter('len'), $this->getParameter('keeptags'), $this->getParameter('decodehtml'), $this->getParameter('stripurls'));
 }