function l

cis7 l($text, $path, array $options = array())
cle7 l($text, $path, array $options = array())
elmsmedia7 l($text, $path, array $options = array())
icor7 l($text, $path, array $options = array())
meedjum_blog7 l($text, $path, array $options = array())
mooc7 l($text, $path, array $options = array())

Formats an internal or external URL link as an HTML anchor tag.

This function correctly handles aliased paths and adds an 'active' class attribute to links that point to the current page (for theming), so all internal links output by modules should be generated by this function if possible.

However, for links enclosed in translatable text you should use t() and embed the HTML anchor tag directly in the translated string. For example:

t('Visit the <a href="@url">settings</a> page', array('@url' => url('admin')));

This keeps the context of the link title ('settings' in the example) for translators.


string $text: The translated link text for the anchor tag.

string $path: The internal path or external URL being linked to, such as "node/34" or "". After the url() function is called to construct the URL from $path and $options, the resulting URL is passed through check_plain() before it is inserted into the HTML anchor tag, to ensure well-formed HTML. See url() for more information and notes.

array $options: An associative array of additional options. Defaults to an empty array. It may contain the following elements.

  • 'attributes': An associative array of HTML attributes to apply to the anchor tag. If element 'class' is included, it must be an array; 'title' must be a string; other elements are more flexible, as they just need to work in a call to drupal_attributes($options['attributes']).
  • 'html' (default FALSE): Whether $text is HTML or just plain-text. For example, to make an image tag into a link, this must be set to TRUE, or you will see the escaped HTML image tag. $text is not sanitized if 'html' is TRUE. The calling function must ensure that $text is already safe.
  • 'language': An optional language object. If the path being linked to is internal to the site, $options['language'] is used to determine whether the link is "active", or pointing to the current page (the language as well as the path must match). This element is also used by url().
  • Additional $options elements used by the url() function.

Return value

string An HTML string containing a link to the given path.

See also


411 calls to l()
accessibility_admin_existing_tests in sites/all/modules/ulmus/accessibility/
List existing accessibility tests. @todo - add a filter form
accessibility_handler_delete_link_field::render in sites/all/modules/ulmus/accessibility/views/
accessibility_handler_edit_link_field::render in sites/all/modules/ulmus/accessibility/views/
accessibility_handler_link_field::render in sites/all/modules/ulmus/accessibility/views/
accessibility_requirements in sites/all/modules/ulmus/accessibility/accessibility.install
Implements hook_requirements().

... See full list

36 string references to 'l'
better_exposed_filters_exposed_form_plugin::exposed_form_alter in sites/all/modules/ulmus/better_exposed_filters/
Tweak the exposed filter form to show Better Exposed Filter options.
date_format_date in sites/all/modules/ulmus/date/date_api/date_api.module
Formats a date, using a date type or a custom date format string.
date_format_patterns in sites/all/modules/ulmus/date/date_api/date_api.module
Constructs an array of regex replacement strings for date format elements.
date_popup_datepicker_format_replacements in sites/all/modules/ulmus/date/date_popup/date_popup.module
The format replacement patterns for the new datepicker.
date_popup_format_to_popup_time in sites/all/modules/ulmus/date/date_popup/date_popup.module
Recreate a time format string so it has the values popup expects.

... See full list


includes/, line 2432
Common functions that many Drupal modules will need to reference.


function l($text, $path, array $options = array()) {
  global $language_url;
  static $use_theme = NULL;

  // Merge in defaults.
  $options += array(
    'attributes' => array(),
    'html' => FALSE,

  // Append active class.
  if (($path == $_GET['q'] || ($path == '<front>' && drupal_is_front_page())) && (empty($options['language']) || $options['language']->language == $language_url->language)) {
    $options['attributes']['class'][] = 'active';

  // Remove all HTML and PHP tags from a tooltip. For best performance, we act only
  // if a quick strpos() pre-check gave a suspicion (because strip_tags() is expensive).
  if (isset($options['attributes']['title']) && strpos($options['attributes']['title'], '<') !== FALSE) {
    $options['attributes']['title'] = strip_tags($options['attributes']['title']);

  // Determine if rendering of the link is to be done with a theme function
  // or the inline default. Inline is faster, but if the theme system has been
  // loaded and a module or theme implements a preprocess or process function
  // or overrides the theme_link() function, then invoke theme(). Preliminary
  // benchmarks indicate that invoking theme() can slow down the l() function
  // by 20% or more, and that some of the link-heavy Drupal pages spend more
  // than 10% of the total page request time in the l() function.
  if (!isset($use_theme) && function_exists('theme')) {
    // Allow edge cases to prevent theme initialization and force inline link
    // rendering.
    if (variable_get('theme_link', TRUE)) {
      $registry = theme_get_registry(FALSE);
      // We don't want to duplicate functionality that's in theme(), so any
      // hint of a module or theme doing anything at all special with the 'link'
      // theme hook should simply result in theme() being called. This includes
      // the overriding of theme_link() with an alternate function or template,
      // the presence of preprocess or process functions, or the presence of
      // include files.
      $use_theme = !isset($registry['link']['function']) || ($registry['link']['function'] != 'theme_link');
      $use_theme = $use_theme || !empty($registry['link']['preprocess functions']) || !empty($registry['link']['process functions']) || !empty($registry['link']['includes']);
    else {
      $use_theme = FALSE;
  if ($use_theme) {
    return theme('link', array('text' => $text, 'path' => $path, 'options' => $options));
  // The result of url() is a plain-text URL. Because we are using it here
  // in an HTML argument context, we need to encode it properly.
  return '<a href="' . check_plain(url($path, $options)) . '"' . drupal_attributes($options['attributes']) . '>' . ($options['html'] ? $text : check_plain($text)) . '</a>';