Changeset 23467

Timestamp:

02/21/2013 10:48:09 PM (12 years ago)

Author:

helen

Message:

Implement theme support for structured-post-formats, which will supercede theme support for post-formats. Usage is the same as declaring support for post-formats: add_theme_support( 'structured-post-formats', array( 'quote', 'video' ) ). Adding structured-post-formats support also adds post-formats support for the given format(s) underneath.

Declaring support for a given format indicates that the theme handles format-specific metadata; admin UI will not change based on theme-declared support of either variety as it did previously. If no structured-post-formats support is explicitly declared for a format, a post in that format will have fallback output utilizing that metadata applied. In this way, a theme can style core-provided output for a full post format experience without having to handle metadata in any way.

props nacin. see #23347.

File:

• trunk/wp-includes/theme.php (modified) (2 diffs)

trunk/wp-includes/theme.php

@@ -1258 +1258 @@
 
     switch ( $feature ) {
+        case 'structured-post-formats' :
+            if ( is_array( $args[0] ) )
+                $args[0] = array_intersect( $args[0], array_keys( get_post_format_slugs() ) );
+            // structured-post-formats support automatically adds support for post-formats.
+            $_wp_theme_features['post-formats'] = $args;
         case 'post-formats' :
-            if ( is_array( $args[0] ) )
+            // An existing structured-post-formats support declaration overrides post-formats.
+            if ( current_theme_supports( 'structured-post-formats' ) )
+                $args = get_theme_support( 'structured-post-formats' );
+            elseif ( is_array( $args[0] ) )
                 $args[0] = array_intersect( $args[0], array_keys( get_post_format_slugs() ) );
             break;
@@ -1546 +1554 @@
             break;
 
+        case 'structured-post-formats':
         case 'post-formats':
             // specific post formats can be registered by passing an array of types to