[wp-hackers] echo and return

[Kitty]

On Mon, 2004-07-26 at 14:53 +0200, Brian Meidell wrote:
> About the url encoded parameter lists, though:
> Since user friendliness seems to be an issue (an approach I agree with), 
> I can't understand why we would go with url encoded argument strings.
> 
> I can't think of anything much more user hostile than asking the user 
> not only learn the parameters for the method, but also the name of the 
> parameters, and then try to get the encoding right.
> 
> I will would be shaken at my foundation if users weren't more confused 
> by url encoded parameter lists than either $echo parameters or double 
> functions.

Prepare to have your foundation shaken. 

One of my plugins, "Show Categories" is pretty widely used. If someone
wants a mini-blog in a side bar, they either use this, or Matt's asides.
Somewhere around the second release, I was was in param list hell. So I
went to the 'url' style param list. 

I've not had *one* support request/feedback asking how to use it! And
with the nature of the plugin you *have to* pass params. 

Some of the functions that most widely modified in #menu also take 'url'
params, and tend not to be a problem for users. It's a fairly intuitive
way of passing params, believe it or not. The users can see exactly what
they're setting, and don't have to worry about the positional aspect.

So don't underestimate the users. Don't develop for "grandma," as a lot
of people in the open source world are. I try an stick with this
assumption:
"Anyone interested in customising their blog will be able to digest the
the few technical bits that are needed to make things work. So document
accordingly."
-- 
Cheers!
Kitty <kitty at mookitty.co.uk>
http://blog.mookitty.co.uk/
http://mookitty.co.uk/devblog/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : /pipermail/hackers_wordpress.org/attachments/20040726/47f32fb0/attachment.bin