the_author('idmode'), idmode is deprecated

[MichaelH]

Using the_author('idmode') returns just the display_name, no matter the value entered in the 'idmode' parameter.

According to ​http://codex.wordpress.org/Template_Tags/the_author the 'idmode' parameter allows you to control what gets returned by this function. It looks like it was there in 1.5.2 so here's a patch to put it back.

If this doesn't belong in the function, I'll fix Codex. Thanks.

[MichaelH]

adds idmode ability to the_author in template-functions-author.php

[MichaelH]

Additional note--I used nickname but somewhere I remember discussion that user_nickname will eventually work.

Function will return display_name if no parameter is passed.

[westi]

For reference this was removed by matt in changeset [2633] while doing all the new user stuff for 2.0.

It was also removed from get_author_name in functions-post.php in the same changeset so will need fixing there as well.

[MichaelH]

Not to sure if get_author_name needs changing.

It seems somewhere along the line, the_author was changed from having no parameters to having the idmode and echo parameters.

I've made a note in Codex that currently, only the display_name value gets displayed/returned by this function. Based on the inclusion of this Ticket in subsequent releases, I'll revise Codex accordingly.

Thanks westi!

[MichaelH]

Also tested the 2386.diff fix with the_author_posts_link() and the various idmode settings decribed in ​http://codex.wordpress.org/Template_Tags/the_author_posts_link and it works.

Again I've explained on the Codex page that the idmode isn't working now. And, I'll also revise that Codex page on disposition of this ticket.

[westi]

Patch rebased against trunk

[ryan]

Can we make those ifs if ... else if ... else if ... or a switch to avoid unnecessary comparisons?

[westi]

Use switch not if if if if if if

[ryan]

(In [4140]) Resurrect idmode. Props MichaelH and westi. fixes #2386

[matt]

This was a deliberate removal. Please revert 4140 and update the documentation.

[ryan]

Deliberately broken. This is a back compat issue that comes up often.

[ryan]

idmode is used extensively in the author API. I wish it had never existed, but it does and leaving it broken seems lame. Regardless, I'll roll it back and comment the API.

[ryan]

(In [4146]) Deprecate idmode. fixes #2386

[matt]

It has been gone for close to a year, compat issues have already passed and I'd rather not reintroduce cruft.

[foolswisdom]

Summary
the_author('idmode'), idmode is deprecated
was
the_author('idmode') only returns display_name

I have updated the Codex.

[ryan]

(In [4234]) Deprecate idmode. fixes #2386

[(none)]

Milestone 2.0.5 deleted