Definition

theme_filter_tips($tips, $long = FALSE)
drupal/modules/filter/filter.pages.inc, line 50

Description

Render HTML for a set of filter tips.

@see _filter_tips()

Parameters

$tips An array containing descriptions and a CSS id in the form of 'module-name/filter-id' (only used when $long is TRUE) for each filter in one or more text formats. Example:


    array(
      'Full HTML' => array(
        0 => array(
          'tip' => 'Web page addresses and e-mail addresses turn into links automatically.',
          'id' => 'filter/2',
        ),
      ),
    );
  
  

$long (optional) Whether the passed in filter tips contain extended explanations, i.e. intended to be output on the path 'filter/tips' (TRUE), or are in a short format, i.e. suitable to be displayed below a form element. Defaults to FALSE.

Related topics

Namesort iconDescription
Default theme implementationsFunctions and templates that present output to the user, and can be implemented by themes.

Code

function theme_filter_tips($tips, $long = FALSE) {
  $output = '';

  $multiple = count($tips) > 1;
  if ($multiple) {
    $output = t('Text formats') . ':';
  }

  if (count($tips)) {
    if ($multiple) {
      $output .= '<ul>';
    }
    foreach ($tips as $name => $tiplist) {
      if ($multiple) {
        $output .= '<li>';
        $output .= '<strong>' . $name . '</strong>:<br />';
      }

      if (count($tiplist) > 0) {
        $output .= '<ul class="tips">';
        foreach ($tiplist as $tip) {
          $output .= '<li' . ($long ? ' id="filter-' . str_replace("/", "-", $tip['id']) . '">' : '>') . $tip['tip'] . '</li>';
        }
        $output .= '</ul>';
      }

      if ($multiple) {
        $output .= '</li>';
      }
    }
    if ($multiple) {
      $output .= '</ul>';
    }
  }

  return $output;
}