How do you programmatically register custom tags through the adminapi?

Question

Hello,
I am not able to find much documentation out on the net on how to write codes to programmatically register custom tags through the adminapi (extensions.cfc). The only examples I have been seeing involve setting up datasources. Any advice you can provide is appreciated. Thanks.
Best regards,
C. Lee

Answer 1

Short answer:
The problem is that the login method is a bit goofy in that it requires the password first and the username second. Assuming you are using a valid password (and not the string "password" you are showing), reversing them should solve your problem.
Long answer:
As background for those interested, in order to call any method in any of the Admin API CFCs, one does have to log in programmatically, providing a valid CF Admin password, or password/username combination if you have enabled multiple user logins for the CF Admin. (Multiple user logins in the Admin is an optional feature since CF 8.)
If one does not setup multiple user names, then you only need to pass a password to the login method (just as on the login page of the CF Admin). Technically, the default username in that case is "admin", and you can specify it if you want to, but again it has to be password then username, on this login method. (The Admin API was added in CF 7, before the multiple usernames feature was added, so it looks like they just added it as a new argument.)
You can learn more about multiple user logins in the CF Admin (and an option to change or remove the default "admin" username) an Adobe DevCenter article linked to from http://www.carehart.org/articles/#2009_1.
Note finally that the username/password field values are case-sensitive, even on Windows, and the default username really is "admin" not "Admin".
This discussion of needing to login is documented on the page that Adam pointed to (see the "using" and "examples" sections of the page). There's even a comment from someone pointing out the need to put them in password/username order (because it's not mentioned in the docs). I also just added a comment there about the case sensitivity, either of which could bite someone. Let's hope they update the docs in the next release to clarify both these points.
/charlie