Document default attributes for wp_playlist_shortcode()

[DrewAPicture]

The default attributes for wp_playlist_shortcode() should be documented.

Current Reference: ​http://developer.wordpress.org/reference/functions/wp_playlist_shortcode/

Contributors looking for a good starting place should take a look at the ​syntax for documenting function arguments.

For a good example of documenting shortcode attributes, see the phpDoc for wp_audio_shortcode() in trunk.

[taylorde]

$attr documentation for wp_playlist_shortcode()

[taylorde]

Uploaded a first pass at some documentation for $attr parameter of wp_playlist_shortcode().

[DrewAPicture]

Thanks for the patch. This is a really great start, nice work.

Just a few nits:

• Looks like a couple of parameters are missing defaults at the end of the description
• For the $order and $orderby parameters, we should check whether the 'asc'/'desc' values are case sensitive. In most other places in core they're full-caps, for instance.
• In the $images parameter, the parenthesis example should be inside the period of the first sentence instead of on its own.

[taylorde]

@drewapicture Appears that desc/asc gets string_to_uppered eventually, but thanks for the double check, that docs line was, ultimately incorrect. Fixed in the most recent patch.

[DrewAPicture]

Hi, 28678.2.patch​ looks much better. Thanks for the effort!

[DrewAPicture]

In 28901:

Add documentation for the default playlist shortcode attributes in wp_playlist_shortcode().

Props taylorde.
Fixes #28678.