1 filter.module _filter_tips($format_id, $long = FALSE)

Retrieves the filter tips.

Parameters

$format_id: The ID of the text format for which to retrieve tips, or -1 to return tips for all formats accessible to the current user.

$long: (optional) Boolean indicating whether the long form of tips should be returned. Defaults to FALSE.

Return value

An associative array of filtering tips, keyed by filter name. Each: filtering tip is an associative array with elements:

  • tip: Tip text.
  • id: Filter ID.

File

core/modules/filter/filter.module, line 1582
Framework for handling the filtering of content.

Code

function _filter_tips($format_id, $long = FALSE) {
  global $user;

  $formats = filter_formats($user);
  $filter_info = filter_get_filters();

  $tips = array();

  // If only listing one format, extract it from the $formats array.
  if ($format_id != -1) {
    $formats = array($formats[$format_id]);
  }

  foreach ($formats as $format) {
    $tips[$format->name] = array();
    foreach ($format->filters as $name => $filter) {
      if ($filter->status && isset($filter_info[$name]['tips callback'])) {
        $tip = $filter_info[$name]['tips callback']($filter, $format, $long);
        if (isset($tip)) {
          $tips[$format->name][$name] = array('tip' => $tip, 'id' => $name);
        }
      }
    }
  }

  return $tips;
}