Item14369: Document parameters for USERNAME, WIKINAME and WIKIUSERNAME macros.

%USERNAME% returns the username of the current user.

It would be convenient if %USERNAME{SomeBody}% would return the username of the user with WIKINAME = SomeBody.

I realize that this information can be gotten from %USERINFO%, but not quite as conveniently.

-- VickiBrown - 03 Apr 2017

Note that not on only USERNAME but also WIKINAME and WIKIUSERNAME should receive the same treatment if at all. While your feature proposal seems and obvious suggestion, please keep in mind that USERINFO combines and supersedes all of the individual macros such as USERNAME, WIKINAME, and WIKIUSERNAME. It is more in line with GROUPINFO as well.

-- MichaelDaum - 04 Apr 2017

Actually these macros are all marked as Deprecated, in Foswiki 1.1.0, and planned to be removed in Foswiki 2.0, and moved to a compatibility plugin. At least that seems to be in the code comments. The way going forward is to use the USERINFO macro. I've not found the feature proposal though where this was announced, and it's not in the release notes. So some work is needed there.

There is a lot of security checking in USERINFO to make sure that inappropriate information does not leak to guests or other users.

-- GeorgeClark - 04 Apr 2017

And... looking at how they are actually implemented. All they are is aliases to USERINFO with an override on the format= parameter. It appears that they will already accept a parameter.

• %USERNAME{WikiGuest}% guest
• %WIKIUSERNAME{WikiGnome}% WikiGnome
• %WIKINAME{guest}% WikiGuest

-- GeorgeClark - 04 Apr 2017

And one more comment. As there seems to have been no formal deprecation announced, and these macros are all widely used, I don't see any real benefit to their deprecation.

I suggest that we remove the deprecation notices from the code, and update the documentation to state that they are aliases for USERINFO with a fixed format, and can take a wikiname or login username as a parameter.

Note that they are also marked as deprecated in the TWiki code, planned for removal in TWiki 5.x. This was done prior to the Foswiki fork.

-- GeorgeClark - 04 Apr 2017

Please remove the plan to deprecate. SImple macros are easier to use.

MIchael - I know about USERINFO. I said so in my original report, but I forgot the <nop>

Also, why would WIKINAME need to be modified? What would it return? %WIKINAME{WikiName}% makes no sense.

-- VickiBrown - 04 Apr 2017

George: "I suggest that we remove the deprecation notices from the code, and update the documentation to state that they are aliases for USERINFO with a fixed format, and can take a wikiname or login username as a parameter."

I love this!

-- VickiBrown - 04 Apr 2017

> > they are also marked as deprecated in the TWiki code, planned for removal in TWiki 5.x.

It didn't happen.

-- VickiBrown - 04 Apr 2017

Vicki, WIKINAME{loginName} does make, sense don't you think?

-- MichaelDaum - 04 Apr 2017

Michael - I suppose it might be useful to someone. I wouldn;t complain if it was possible. However, it doesn't make sense to me. I'm in the wiki. I have FirstLast as WikiNames. I neither want nor need login names in the wiki,

But when LDAP shoves user login names into the author metadata, I need to convert back.

-- VickiBrown - 05 Apr 2017

Commenting is disabled while not logged in