docs for theme_username() are misleading about how to use it [#2196199]

API page: https://api.drupal.org/api/drupal/includes%21theme.inc/function/theme_us...

Enter a descriptive title (above) relating to function theme_username, then describe the problem you have found:

The list of variables suggests you need to pass them all in. This is not the case: eg https://api.drupal.org/api/drupal/modules!blog!blog.pages.inc/function/b...

      drupal_set_message(t('!author has not created any blog entries.', array('!author' => theme('username', array('account' => $account)))));

Furthermore, 'name' and 'extra' won't even work -- see this comment https://api.drupal.org/comment/26088#comment-26088

So while it's technically true that this theme function expects these variables, most of them are in fact supplied by https://api.drupal.org/api/drupal/includes!theme.inc/function/template_p....

Comments

Comment #1

jhodgdon

she/her

English

CreditAttribution: jhodgdon commented 14 February 2014 at 23:50

I'm unsure about whether we need to fix this in 8 -- there are very few theme functions left, as most have gone over to Twig... Also unsure about the fix, but it seems like a good issue to investigate and fix. Thanks!