_filter_tips

_filter_tips($format_id, $long = FALSE)

Retrieves the filter tips.

Parameters

string $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.

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

Return value

array 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 337: Framework for handling the filtering of content.

Code

function _filter_tips($format_id, $long = FALSE) {
  $formats = filter_formats(\Drupal::currentUser());

  $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) {
    foreach ($format->filters() as $name => $filter) {
      if ($filter->status) {
        $tip = $filter->tips($long);
        if (isset($tip)) {
          $tips[$format->label()][$name] = array(
            'tip' => array('#markup' => $tip),
            'id' => $name,
          );
        }
      }
    }
  }

  return $tips;
}

Links:

https://api.drupal.org/api/drupal/core%21modules%21filter%21filter.module/function/_filter_tips/8.2.x

doc_Drupal

2016-10-29 09:57:13

Comments