Post formats help text

[nacin]

If there's a UI visible, we need to show contextual help.

[jane]

Fine.

[westi]

(In [16583]) Add Post formats info to the help text. Fixes #15376 props vegasgeek

[nacin]

This should probably say that your theme may support additional formats, rather than listing Aside and Gallery explicitly. Surely not everyone who seeks help from the tab will be using Twenty Ten.

A simple current_theme_supports should be able to handle hiding this when it is irrelevant, also.

Maybe a new paragraph with a bulleted list of the supported formats, per the Codex article? Otherwise someone using an 'Aside' will need yo test for themselves that it means no title.

[vegasgeek]

Nacin, good call.

I rewrote the format bit in the publish section, added a conditional bit that shows what format types are available for the current theme and added a link to the documentation for post formats.

The other option would be to include the entire list of format types and their description (from the codex), but I'm thinking that may end up getting out of sync if one gets updated and not the other.

Thoughts?

[nacin]

I don't think it's crazy to include a simple sentence to describe each format supported, considering we're bulleting them here anyway. Linking to the Codex article (if current_theme_supports) makes sense too.

Cross referencing ​http://wordpress.org/support/topic/what-is-different-between-post-format-aside-and-status

[nacin]

Also, would want Jane to weigh in on the help text prior to re-patching, to confirm or reject my thoughts.

Aside from that, the patch will need to grab the formats, but then use the strings from get_post_format_strings(), to ensure they are properly translated.

[nacin]

Re: #15638, need help text in the meta box, like page attributes.

[dougwrites]

@Nacin: This adds the generic help text to the Formats meta box, which just refers people to the help tab.

[nacin]

(In [16969]) Post formats help text. fixes #15376.

[nacin]

(In [16971]) Italicize. see #15376.